Skip to content

Commit

Permalink
docs: update upgrade to consul-dataplane docs on k8s
Browse files Browse the repository at this point in the history
  • Loading branch information
ishustava committed Jun 23, 2023
1 parent f16c5d8 commit ad7cbd5
Showing 1 changed file with 13 additions and 1 deletion.
14 changes: 13 additions & 1 deletion website/content/docs/k8s/upgrade/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ In earlier versions, Consul on Kubernetes used client agents in its deployments.

If you upgrade Consul from a version that uses client agents to a version the uses dataplanes, complete the following steps to upgrade your deployment safely and without downtime.

1. Before you upgrade, edit your Helm chart to enable Consul client agents by setting `client.enabled` and `client.updateStrategy`:
1. Before you upgrade, edit your Helm chart configuration to enable Consul client agents by setting `client.enabled` and `client.updateStrategy`:

```yaml filename="values.yaml"
client:
Expand All @@ -228,6 +228,18 @@ If you upgrade Consul from a version that uses client agents to a version the us
type: OnDelete
```

1. Update the `connect-injector` to not log out on restart.
We need to do it to make sure that the ACL tokens that existing services are using are still valid while we are migrating them to `consul-dataplane`.
Note that this token will need to be cleaned up manually.

```bash
kubectl config set-context --current --namespace=<consul installation namespace>
INJECTOR_DEPLOYMENT=$(kg deploy -l "component=connect-injector" -o=jsonpath='{.items[0].metadata.name}')
kubectl patch deploy $INJECTOR_DEPLOYMENT --type='json' -p='[{"op": "remove", "path": "/spec/template/spec/containers/0/lifecycle"}]'
```

This will trigger the deployment rollout. We need to wait for the rollout to complete before proceeding to next step.

1. Follow our [recommended procedures to upgrade servers](#upgrade-consul-servers) on Kubernetes deployments to upgrade Helm values for the new version of Consul.

1. Run `kubectl rollout restart` to restart your service mesh applications. Restarting service mesh application causes Kubernetes to re-inject them with the webhook for dataplanes.
Expand Down

0 comments on commit ad7cbd5

Please sign in to comment.