Merge pull request #13655 from hashicorp/docs/add-envoy-to-standard-upgrade-instructions

docs: add Envoy upgrade step to std upgrade docs
This commit is contained in:
Jared Kirschner 2022-07-14 13:11:12 -04:00 committed by GitHub
commit 6d047c453a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 5 deletions

View File

@ -34,15 +34,23 @@ Consul is A, and version B is released.
there are no compatibility issues that will affect your workload. If there there are no compatibility issues that will affect your workload. If there
are plan accordingly before continuing. are plan accordingly before continuing.
2. On each server, install version B of Consul. 2. On each Consul server agent, install version B of Consul.
3. One server at a time, shut down version A via `consul leave` and restart with version B. Wait until 3. One Consul server agent at a time, shut down version A via `consul leave` and restart with version B. Wait until
the server is healthy and has rejoined the cluster before moving on to the the server agent is healthy and has rejoined the cluster before moving on to the
next server. next server agent.
4. Once all the servers are upgraded, begin a rollout of clients following 4. Once all the server agents are upgraded, begin a rollout of client agents following
the same process. the same process.
-> **Upgrade Envoy proxies:** If a client agent has associated Envoy proxies (e.g., sidecars, gateways),
install a [compatible Envoy version](/docs/connect/proxies/envoy#supported-versions)
for Consul version B.
After stopping client agent version A,
stop its associated Envoy proxies.
After restarting the client agent with version B,
restart its associated Envoy proxies with the compatible Envoy version.
5. Done! You are now running the latest Consul agent. You can verify this 5. Done! You are now running the latest Consul agent. You can verify this
by running `consul members` to make sure all members have the latest by running `consul members` to make sure all members have the latest
build and highest protocol version. build and highest protocol version.