From 166b63d4fbd7030e7517f709fe5adab461640ce1 Mon Sep 17 00:00:00 2001 From: Sam Naser Date: Wed, 24 Mar 2021 12:55:13 -0400 Subject: [PATCH] Add revision tag documentation to canary upgrade docs (#9376) --- content/en/docs/setup/upgrade/canary/index.md | 31 ++++++++++++++++++ .../setup/upgrade/canary/revision-tag-1.png | Bin 0 -> 24131 bytes .../setup/upgrade/canary/revision-tag-2.png | Bin 0 -> 26493 bytes 3 files changed, 31 insertions(+) create mode 100644 content/en/docs/setup/upgrade/canary/revision-tag-1.png create mode 100644 content/en/docs/setup/upgrade/canary/revision-tag-2.png diff --git a/content/en/docs/setup/upgrade/canary/index.md b/content/en/docs/setup/upgrade/canary/index.md index c7b4fdfaa3..70c83b2977 100644 --- a/content/en/docs/setup/upgrade/canary/index.md +++ b/content/en/docs/setup/upgrade/canary/index.md @@ -111,6 +111,37 @@ istiod-canary-6956db645c-vwhsk The output confirms that the pod is using `istiod-canary` revision of the control plane. +## Stable revision labels (experimental) + +Manually relabeling namespaces when moving them to a new revision can be tedious and error-prone. [Revision tags](/docs/reference/commands/istioctl/#istioctl-experimental-tag) are a solution to this. [Revision tags](/docs/reference/commands/istioctl/#istioctl-experimental-tag) are stable identifiers that point to revisions and can be used to avoid relabeling namespaces. Rather than relabeling the namespace, a mesh operator can simply change the tag to point to a new revision. All namespaces with that tag will be updated at the same time. + +Consider a cluster with two revisions installed, `1-7-6` and `1-8-0`. The cluster operator creates a revision tag `prod`, pointed at the older, stable `1-7-6` version, and a revision tag `canary` pointed at the newer `1-8-0` revision. That state could be reached via these commands: + +{{< text bash >}} +$ istioctl x tag set canary --revision 1-7-6 +$ istioctl x tag set prod --revision 1-8-0 +{{< /text >}} + +{{< image width="40%" + link="/docs/setup/upgrade/canary/revision-tag-1.png" + caption="Namespaces A and B pointed to 1-7-6, namespace C pointed to 1-8-0" + >}} + +After the operator is satisfied with the stability of the `canary` tagged control planes, namespaces labeled `istio.io/rev=prod` can be updated with one action by modifying the `prod` revision tag to point to the newer `1-8-0` revision. + +{{< text bash >}} +$ istioctl x tag set prod --revision 1-8-0 +{{< /text >}} + +Now, the situation is as shown in the diagram below: + +{{< image width="40%" + link="/docs/setup/upgrade/canary/revision-tag-2.png" + caption="Namespaces A, B, and C pointed to 1-8-0" + >}} + +Restarting the injected workloads in namespaces `A` and `B` will result in those workloads using the `1.8.0` control plane. + ## Uninstall old control plane After upgrading both the control plane and data plane, you can uninstall the old control plane. For example, the following command uninstalls a control plane of revision `1-6-5`: diff --git a/content/en/docs/setup/upgrade/canary/revision-tag-1.png b/content/en/docs/setup/upgrade/canary/revision-tag-1.png new file mode 100644 index 0000000000000000000000000000000000000000..5a479b52eadb8f32a90e01f3d27b643610266e49 GIT binary patch literal 24131 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 R_+iT@4hrC~%UMys`~|WSC$<0p literal 0 HcmV?d00001 diff --git a/content/en/docs/setup/upgrade/canary/revision-tag-2.png b/content/en/docs/setup/upgrade/canary/revision-tag-2.png new file mode 100644 index 0000000000000000000000000000000000000000..ddfaaf88925d8ccefa3eaaf2ee1b47981912264b GIT binary patch literal 26493 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 cy1FihX-?C1S82@UgQ