- HTTPProxy Fundamentals
- Ingress v1 Support
- Virtual Hosts
- Inclusion and Delegation
- TLS Termination
- Upstream TLS
- Request Routing
- External Service Routing
- Request Rewriting
- Upstream Health Checks
- Client Authorization
- TLS Delegation
- Rate Limiting
- Access logging
- Annotations Reference
- Cookie Rewriting
- API Reference
- Deployment Options
- Contour Configuration
- Upgrading Contour
- Enabling TLS between Envoy and Contour
- Redeploy Envoy
- AWS with NLB
- External Authorization
- JSON logging
- Migrating to HTTPProxy
- Prometheus Metrics
- PROXY Protocol Support
- Resource Limits
- Envoy Administration Access
- Contour Debug Logging
- Envoy Debug Logging
- Visualize the Contour Graph
- Show Contour xDS Resources
- Profiling Contour
- Contour Operator
- Support Policy
- Compatibility Matrix
- Contour Deprecation Policy
- Release Process
- Frequently Asked Questions
The Envoy process, the data path component of Contour, at times needs to be re-deployed. This could be due to an upgrade, a change in configuration, or a node-failure forcing a redeployment.
When implementing this roll out, the following steps should be taken:
- Stop Envoy from accepting new connections
- Start draining existing connections in Envoy by sending a
- Wait for connections to drain before allowing Kubernetes to
Contour implements an
envoy sub-command named
shutdown-manager whose job is to manage a single Envoy instances lifecycle for Kubernetes.
shutdown-manager runs as a new container alongside the Envoy container in the same pod.
It exposes two HTTP endpoints which are used for
livenessProbe as well as to handle the Kubernetes
preStop event hook.
- livenessProbe: This is used to validate the shutdown manager is still running properly. If requests to
/healthzfail, the container will be restarted.
- preStop: This is used to keep the Envoy container running while waiting for connections to drain. The
/shutdownendpoint blocks until the connections are drained.
- name: shutdown-manager command: - /bin/contour args: - envoy - shutdown-manager image: ghcr.io/projectcontour/contour:main imagePullPolicy: Always lifecycle: preStop: exec: command: - /bin/contour - envoy - shutdown livenessProbe: httpGet: path: /healthz port: 8090 initialDelaySeconds: 3 periodSeconds: 10
The Envoy container also has some configuration to implement the shutdown manager.
preStop hook is configured to use the
/shutdown endpoint which blocks the Envoy container from exiting.
Finally, the pod’s
terminationGracePeriodSeconds is customized to extend the time in which Kubernetes will allow the pod to be in the
The termination grace period defines an upper bound for long-lived sessions.
If during shutdown, the connections aren’t drained to the configured amount, the
terminationGracePeriodSeconds will send a
SIGTERM to the pod killing it.
Shutdown Manager Config Options
shutdown-manager runs as another container in the Envoy pod.
When the pod is requested to terminate, the
preStop hook on the
shutdown-manager executes the
contour envoy shutdown command initiating the shutdown sequence.
The shutdown manager has a single argument that can be passed to change how it behaves:
|integer||8090||Port to serve the http server on|
|string||/admin/ok||File to poll while waiting shutdown to be completed.|
Shutdown Config Options
shutdown command does the work of draining connections from Envoy and polling for open connections.
The shutdown command has a few arguments that can be passed to change how it behaves:
|duration||5s||Time interval to poll Envoy for open connections.|
|duration||60s||Time wait before polling Envoy for open connections.|
|duration||60s||Time wait before draining Envoy connections.|
|integer||0||Min number of open connections when polling Envoy.|
|integer||9001||Deprecated: No longer used, Envoy admin interface runs as a unix socket.|
|string||/admin/admin.sock||Path to Envoy admin unix domain socket.|
|string||/admin/ok||File to write when shutdown is completed.|