Contour is an ingress controller for Kubernetes that works by deploying the Envoy proxy as a reverse proxy and load balancer. Contour supports dynamic configuration updates out of the box while maintaining a lightweight profile.
Contour supports multiple configuration APIs in order to meet the needs of as many users as possible:
- Ingress - A stable upstream API that enables basic ingress use cases.
- HTTPProxy - Contour's Custom Resource Definition (CRD) which expands upon the functionality of the Ingress API to allow for a richer user experience as well as solve shortcomings in the original design.
- Gateway API (beta) - A new CRD-based API managed by the Kubernetes SIG-Network community that aims to evolve Kubernetes service networking APIs in a vendor-neutral way.
NOTES:
1. The file as follows just for illustrative purposes only, please do not use directly!!!
2. The argo-rollouts >= v1.5.0-rc1
Steps:
- Run the
yaml/rbac.yamlto add the role for operate on theHTTPProxy. - Build this plugin.
- Put the plugin somewhere & mount on to the container for
argo-rollouts:
apiVersion: apps/v1
kind: Deployment
metadata:
name: argo-rollouts
namespace: argo-rollouts
spec:
template:
spec:
volumes:
- name: contour-plugin
hostPath:
path: /CHANGE-ME/rollouts-trafficrouter-contour-plugin
type: ''
containers:
- name: argo-rollouts
volumeMounts:
- name: contour-plugin
mountPath: /CHANGE-ME/rollouts-trafficrouter-contour-plugin
- Create a ConfigMap to let
argo-rolloutsknow the plugin's location:
apiVersion: v1
kind: ConfigMap
metadata:
name: argo-rollouts-config
namespace: argo-rollouts
data:
trafficRouterPlugins: |-
- name: "argoproj-labs/contour"
location: "file://CHANGE-ME/rollouts-trafficrouter-contour-plugin/contour-plugin"
binaryData: {}
- Create the
CR/Rolloutand put it into the operated services` namespace:
apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
name: rollouts-demo
namespace: rollouts-demo
spec:
replicas: 6
selector:
matchLabels:
app.kubernetes.io/instance: rollouts-demo
strategy:
canary:
canaryService: canaryService
stableService: stableService
steps:
- setWeight: 30
- pause:
duration: 10
trafficRouting:
plugins:
argoproj-labs/contour:
httpProxy: rollouts-demo
namespace: rollouts-demo
workloadRef:
apiVersion: apps/v1
kind: Deployment
name: canary
- Enjoy It.