Skip to content

Commit

Permalink
gatewayapi: recommend the "config" approach
Browse files Browse the repository at this point in the history
The "config" approach is much more convenient than
to have to concatenate flags in the extraFlags field.

Signed-off-by: Maël Valais <[email protected]>
  • Loading branch information
maelvls committed Aug 6, 2024
1 parent cfe96fa commit 0ff4697
Showing 1 changed file with 18 additions and 12 deletions.
30 changes: 18 additions & 12 deletions content/docs/usage/gateway.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,22 +54,28 @@ To install v1.5.1 Gateway API bundle (Gateway CRDs and webhook), run the followi
kubectl apply -f "https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.0.0/standard-install.yaml"
```

To enable the feature in cert-manager, turn on the `GatewayAPI` feature gate:
Since cert-manager 1.15, the Gateway API support is no longer gated behind a
feature flag, but you still need to enable the Gateway API support.

- If you are using Helm:
To enable on the Gateway API support, use the [file-based
configuration](../configuration/configuring-components.md#configuration-file) using the
following `config` Helm value:

```sh
helm upgrade --install cert-manager jetstack/cert-manager --namespace cert-manager \
--set "extraArgs={--enable-gateway-api}"
```
```yaml
config:
apiVersion: controller.config.cert-manager.io/v1alpha1
kind: ControllerConfiguration
enableGatewayAPI: true
```
- If you are using the raw cert-manager manifests, add the following flag to the
cert-manager controller Deployment:
The corresponding Helm command is:
```yaml
args:
- --enable-gateway-api
```
```sh
helm upgrade --install cert-manager jetstack/cert-manager --namespace cert-manager \
--set apiVersion="controller.config.cert-manager.io/v1alpha1" \
--set config.kind=ControllerConfiguration" \
--set config.enableGatewayAPI=true
```

The Gateway API CRDs should either be installed before cert-manager starts or
the cert-manager Deployment should be restarted after installing the Gateway API
Expand Down

0 comments on commit 0ff4697

Please sign in to comment.