diff --git a/docs/versioned/.nav.yml b/docs/versioned/.nav.yml index 75968b917d..c9fe881b44 100644 --- a/docs/versioned/.nav.yml +++ b/docs/versioned/.nav.yml @@ -254,7 +254,6 @@ nav: - Configuring Knative Eventing CRDs: install/operator/configuring-eventing-cr.md - Installing plugins: - Install Istio for Knative: install/installing-istio.md - # TODO: docs for kourier, contour, gateway-api - Install Kafka for Knative: install/eventing/kafka-install.md - Install RabbitMQ for Knative: install/eventing/rabbitmq-install.md # N.B. this duplicates an "eventing" topic above, cross-referenced here. @@ -273,6 +272,7 @@ nav: - Configure domain names: serving/using-a-custom-domain.md - Istio Authorization: serving/istio-authorization.md - Extending Queue Proxy image with QPOptions: serving/queue-extensions.md + - Configure Contour adapter: ./install/installing-contour.md - Serving configuration: - Configure Deployment resources: serving/configuration/deployment.md - Configure gradual rollout of traffic to Revisions: serving/configuration/rolling-out-latest-revision-configmap.md @@ -291,7 +291,7 @@ nav: - Configure Kafka Broker features: eventing/brokers/broker-types/kafka-broker/configuring-kafka-features.md - Configure event source defaults: eventing/configuration/sources-configuration.md - Configure Sugar Controller: eventing/configuration/sugar-configuration.md - - Configure KEDA Autoscaling of Knative Kafka Resources: eventing/configuration/keda-configuration.md + - Configure KEDA Autoscaling of Knative Kafka Resources: eventing/configuration/ - Flagged features: - Serving Features: serving/configuration/feature-flags.md - Eventing Features: diff --git a/docs/versioned/install/installing-contour.md b/docs/versioned/install/installing-contour.md new file mode 100644 index 0000000000..dd48e1e2a7 --- /dev/null +++ b/docs/versioned/install/installing-contour.md @@ -0,0 +1,52 @@ +--- +audience: administrator +components: + - serving +function: how-to +--- + +# Configure Contour adapter + +This page describes how to install and configure the Contour adapter for Knative: `net-contour`. + +## Before you begin + +This installation requires a Kubernetes cluster with [Contour](https://projectcontour.io/docs/) installed. + +For information about Contour versions, see the Contour [Compatibility Matrix](https://projectcontour.io/resources/compatibility-matrix/). + +## Install and configure the adapter + +1. Install the Knative Contour controller: + + ```bash + kubectl apply -f {{ artifact(repo="net-contour",org="knative-extensions",file="net-contour.yaml")}} + ``` + +1. Configure Knative Serving to use Contour by default: + + ```bash + kubectl patch configmap/config-network \ + --namespace knative-serving \ + --type merge \ + --patch '{"data":{"ingress-class":"contour.ingress.networking.knative.dev"}}' + ``` + +1. Get the External IP address or full qualified domain name (CNAME): + + ```bash + kubectl --namespace contour-external get service envoy + ``` + + Use this value to configure your external DNS records. + +The adapter's configurations are performed natively through Contour. For more information and resources see [Contour](https://projectcontour.io/) home page. + +## Visibility + +The following table shows the classes and services that expose Contour networking. + +| ExternalIP | ClusterLocal | +| --- | --- | +| class: contour-external | class: contour-internal | +| service: contour-external/envoy | service: contour-internal/envoy |