NGINX dynamic module for Istio Mixer

Dependencies

Build system use Docker to generate the module binary.

Compatibility

1.11.x (last tested with 1.13.5)

Synopsis

 http   {
 
 	 mixer_server istio-mixer.istio-system;
     mixer_port   9091;

 
	 server {
	 
	      mixer_source_ip     10.0.0.0;
          mixer_source_uid    kubernetes://productpage-v1-2213572757-758cs.beta1;
          mixer_source_service productpage.beta1.svc.cluster.local;
          mixer_destination_service abc.ns.svc.cluster.local;
          mixer_destination_uid details;
         
         
          location /  {
              mixer_report on;
              proxy_pass http://service1;
          }
         
            
			
	 }
		
 }

Directives

mixer_server

-	-
Syntax	mixer_server <mixer_url_or_ip>
Default	-
Context	http

Description: Specify the mixer server address

mixer_port

-	-
Syntax	mixer_port <port_number>
Default	-
Context	http

Description: Specify the mixer server port

mixer_source_ip

-	-
Syntax	mixer_source_ip <ip_address>
Default	-
Context	server, location
Mixer attribute	source.ip

Description: Standard mixer attribute Client IP address

mixer_source_uid

-	-
Syntax	mixer_source_uid
Default	-
Context	server, location
Mixer attribute	source.uid

Description: Standard mixer attribute Platform-specific unique identifier for the client instance of the source service

mixer_source_service

-	-
Syntax	mixer_source_service
Default	-
Context	server, location
Mixer attribute	source.service

Description: Standard mixer attribute The fully qualified name of the service that the client belongs to

mixer_source_port

-	-
Syntax	mixer_source_port
Default	-
Context	server, location
Mixer attribute	source.service

Description: Standard mixer attribute The fully qualified name of the service that the client belongs to

mixer_source_labels

-	-
Syntax	mixer_source_labels
Default	-
Context	server
Mixer attribute	source.labels

Description: Standard mixer attribute The map of key-value pairs attached to the client instance.

mixer_destination_service

-	-
Syntax	mixer_destination_service
Default	-
Context	server, location
Mixer attribute	destination.servicee

Description: Standard mixer attribute The fully qualified name of the service that the server belongs to

mixer_destination_uid

-	-
Syntax	mixer_destination_service
Default	-
Context	server, location
Mixer attribute	destination.uid

Description: Standard mixer attribute Platform-specific unique identifier for the server instance of the destination service.

mixer_destination_labels

-	-
Syntax	mixer_destination_labels
Default	-
Context	server
Mixer attribute	destination.labels

Description: Standard mixer attribute A map of key-value pairs attached to the server instance.

Installation

Clone the git repository

shell> git clone git@github.com:nginmesh/ngx-istio-mixer.git

Build the dynamic module

shell> make build-base;make build-module

This copies the generated .so file into module/release directory

Running unit test

make test-unit

nginxinc/ngx-istio-mixer