Contour Package ¶

This package provides an ingress controller using Contour.

Supported Providers ¶

The following tables shows the providers this package can work with.

Components ¶

• Contour controller
• Envoy reverse proxy and load balancer

Installation ¶

Environments with support for LoadBalancer services (AWS, Azure, vSphere) ¶

1. Install the Contour package using default configuration options:

   tanzu package install contour \
     --package-name contour.community.tanzu.vmware.com \
     --version 1.18.1
   

Environments without support for LoadBalancer services (Docker) ¶

1. Create a configuration file that sets the Envoy service type to ClusterIP:

   cat <<EOF >contour-values.yaml
   envoy:
     service:
       type: ClusterIP
   EOF
   

2. Install the Contour package using the configuration file:

   tanzu package install contour \
     --package-name contour.community.tanzu.vmware.com \
     --version 1.18.1 \
     --values-file contour-values.yaml
   

For additional configuration options, see the Configuration Reference section.

Usage Example ¶

The follow is a basic guide for getting started with Contour. You must deploy the package before attempting this walkthrough.

⚠️ Note: For more advanced use cases and documentation, see the official Contour documentation.

1. Create a namespace for the example workload:

   kubectl create namespace contour-example-workload
   

2. Create an example deployment, in this case, nginx, to route traffic to via Contour:

   kubectl create deployment nginx-example --image nginx --namespace contour-example-workload
   

3. Create a service for nginx. This will map port 80 of the service to port 80 of the nginx app.

   kubectl create service clusterip nginx-example --tcp 80:80 --namespace contour-example-workload
   

4. Create a Contour HTTPProxy that directs traffic to the nginx instance:

   kubectl apply -f - <<EOF
   apiVersion: projectcontour.io/v1
   kind: HTTPProxy
   metadata:
     name: nginx-example-proxy
     namespace: contour-example-workload
     labels:
       app: ingress
   spec:
     virtualhost:
       fqdn: nginx-example.projectcontour.io
     routes:
     - conditions:
       - prefix: /
       services:
       - name: nginx-example
         port: 80
   EOF
   

5. Get the address to send traffic to. If you are using a LoadBalancer Envoy service, get the service’s external IP:

   kubectl --namespace projectcontour get service envoy
   NAME    TYPE           CLUSTER-IP    EXTERNAL-IP            PORT(S)                      AGE
   envoy   LoadBalancer   10.12.10.93   <ENVOY-EXTERNAL-IP>    80:31232/TCP,443:32459/TCP   1h
   

   If you are using a NodePort or ClusterIP Envoy service, in a separate terminal, set up a port forward from your local machine to the service:

   kubectl --namespace projectcontour port-forward svc/envoy <LOCAL-PORT>:80
   

6. Make a request. If you are using a LoadBalancer Envoy service:

   curl -s -H "Host: nginx-example.projectcontour.io" <ENVOY-EXTERNAL-IP> | grep title
   <title>Welcome to nginx!</title>
   

   If you are using a NodePort or ClusterIP Envoy service:

   curl -s -H "Host: nginx-example.projectcontour.io" http://localhost:<LOCAL-PORT> | grep title
   <title>Welcome to nginx!</title>
   

Configuration Reference ¶

You can configure the following: