Architecture and Traffic Flow
When you provision a {{page.netscaler-cpx-short}} instance on a Docker host, the Docker engine creates a virtual interface, eth0, on the CPX instance. This eth0 interface is directly connected to a virtual interface (veth*) on the docker0 bridge. The Docker engine also assigns an IP address to the {{page.netscaler-cpx-short}} instance in the network 172.17.0.0/16.
The default gateway for the CPX instance is the IP address of the docker0 bridge, which means that any communication with the {{page.netscaler-cpx-short}} instance is done through the Docker network. All incoming traffic received from the docker0 bridge is received by the eth0 interface on the {{page.netscaler-cpx-short}} instance and processed by the {{page.netscaler-cpx-short}} packet engine.
The following figure illustrates the architecture of a {{page.netscaler-cpx-short}} instance on a Docker host.
How Single IP Address Works on
A regular NetScaler MPX™ or VPX appliance requires at least three IP addresses to function:
-
Management IP address called the NetScaler® IP (NSIP) address
-
Subnet IP (SNIP) address for communicating with the server farm
-
Virtual server IP (VIP) address(es) for accepting client requests
A {{page.netscaler-cpx-short}} instance operates with one single IP address that is used for management as well as for data traffic.
During provisioning, only one private IP address (single IP address) is assigned to a {{page.netscaler-cpx-short}} instance by the Docker engine. The three IP functions of a NetScaler instance are multiplexed onto one IP address. This single IP address uses different port numbers to function as the NSIP, SNIP, and VIP(s).
The following image illustrates how a single IP address is used to perform the functions of NSIP, SNIP, and VIP(s).
Traffic Flow for Requests Originating from the {{page.netscaler-cpx-short}} Instance
Docker implicitly configures IP tables and a NAT rule to direct traffic originating from the {{page.netscaler-cpx-short}} instance to the docker0 IP address.
The following figure illustrates how a ping request originating from a {{page.netscaler-cpx-short}} instance reaches the destination.
In this example, the ping request is sent by the packet engine on eth0 interface with source IP address as the {{page.netscaler-cpx-short}} IP address (172.17.0.4). The Docker host, then, performs network address translation (NAT) to add the host IP address (192.68.x.x) as the source IP address and sends the request to the destination (216.58.x.x). The response from the destination IP address follows the same path in reverse. The Docker host performs NAT on the response and forwards the response to the {{page.netscaler-cpx-short}} instance on the eth0 interface.
Traffic Flow for Requests Originating from the External Network
To enable external communication, while provisioning {{page.netscaler-cpx-short}}, you have to set parameters such that Docker exposes certain ports such as 80, 22, and any other port you want. If you have not set any port to be exposed during provisioning, then you have to configure NAT rules on the Docker host to make these ports available.
The client request that originates from the Internet is received by the Docker host, which then performs port address translation (PAT) to map the public IP address and port to the single IP address and port of the {{page.netscaler-cpx-short}} instance, and forwards the traffic to the instance.
The following figure shows how the Docker host performs port address translation to direct traffic to the {{page.netscaler-cpx-short}} single IP address and port.
In this example, the Docker host IP address is 192.68.x.x and the single IP address of the {{page.netscaler-cpx-short}} instance is 172.17.0.4. The SSH port 22 of {{page.netscaler-cpx-short}} instance is mapped to port 1100 on the Docker host. The SSH request from the client is received on IP address 192.68.x.x at port 1100. The Docker host performs port address translation to map this address and port to the single IP address 172.17.0.4 on port 22 and forwards the client request.