Interlock architectureEstimated reading time: 2 minutes
The layer 7 routing solution for swarm workloads is known as Interlock, and has three components:
- Interlock-proxy: This is a proxy/load-balancing service that handles the requests from the outside world. By default this service is a containerized NGINX deployment.
- Interlock-extension: This is a helper service that generates the configuration used by the proxy service.
- Interlock: This is the central piece of the layer 7 routing solution. It uses the Docker API to monitor events, and manages the extension and proxy services.
This is what the default configuration looks like, once you enable layer 7 routing in UCP:
The Interlock service starts a single replica on a manager node. The Interlock-extension service runs a single replica on any available node, and the Interlock-proxy service starts two replicas on any available node.
If you don’t have any worker nodes in your cluster, then all Interlock components run on manager nodes.
By default layer 7 routing is disabled, so an administrator first needs to enable this service from the UCP web UI.
Once that happens:
- UCP creates the
- UCP deploys the
ucp-interlockservice and attaches it both to the Docker socket and the overlay network that was created. This allows the Interlock service to use the Docker API. That’s also the reason why this service needs to run on a manger node.
ucp-interlockservice starts the
ucp-interlock-extensionservice and attaches it to the
ucp-interlocknetwork. This allows both services to communicate.
ucp-interlock-extensiongenerates a configuration to be used by the proxy service. By default the proxy service is NGINX, so this service generates a standard NGINX configuration.
ucp-interlockservice takes the proxy configuration and uses it to start the
At this point everything is ready for you to start using the layer 7 routing service with your swarm workloads.
Once the layer 7 routing service is enabled, you apply specific labels to your swarm services. The labels define the hostnames that are routed to the service, the ports used, and other routing configurations.
Once you deploy or update a swarm service with those labels:
ucp-interlockservice is monitoring the Docker API for events and publishes the events to the
- That service in turn generates a new configuration for the proxy service, based on the labels you’ve added to your services.
ucp-interlockservice takes the new configuration and reconfigures the
ucp-interlock-proxyto start using it.
This all happens in milliseconds and with rolling updates. Even though services are being reconfigured, users won’t notice it.routing, proxy