Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/versioned/.nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd move this under Installing plugins > Install Istio for Knative

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

- Serving configuration:
- Configure Deployment resources: serving/configuration/deployment.md
- Configure gradual rollout of traffic to Revisions: serving/configuration/rolling-out-latest-revision-configmap.md
Expand All @@ -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/
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this change seems unrelated

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the change is gone now

- Flagged features:
- Serving Features: serving/configuration/feature-flags.md
- Eventing Features:
Expand Down
52 changes: 52 additions & 0 deletions docs/versioned/install/installing-contour.md
Original file line number Diff line number Diff line change
@@ -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 |
Loading