From b582363511f5ce0aa18db1fbb4a2fff8e32da6fd Mon Sep 17 00:00:00 2001 From: Nick Greenfield Date: Tue, 3 Aug 2021 15:58:16 -0700 Subject: [PATCH 1/2] Add downgrade language to the dapr upgrade cli docs --- .../content/en/reference/cli/dapr-upgrade.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/daprdocs/content/en/reference/cli/dapr-upgrade.md b/daprdocs/content/en/reference/cli/dapr-upgrade.md index fb76b402d..0af153b47 100644 --- a/daprdocs/content/en/reference/cli/dapr-upgrade.md +++ b/daprdocs/content/en/reference/cli/dapr-upgrade.md @@ -7,7 +7,11 @@ description: "Detailed information on the upgrade CLI command" ## Description -Upgrade Dapr on supported hosting platforms. +Upgrade or downgrade Dapr on supported hosting platforms. + +> Note: Version steps should be done incrementally, including minor versions as you upgrade or downgrade. + +> Note: Prior to downgrading, confirm components are backwards compatible and application code does ultilize APIs that are not supported in previous versions of Dapr. ## Supported platforms @@ -23,8 +27,8 @@ dapr upgrade [flags] | Name | Environment Variable | Default | Description | --- | --- | --- | --- | | `--help`, `-h` | | | Print this help message | -| `--kubernetes`, `-k` | | `false` | Upgrade Dapr in a Kubernetes cluster | -| `--runtime-version` | | `latest` | The version of the Dapr runtime to upgrade to, for example: `1.0.0` | +| `--kubernetes`, `-k` | | `false` | Upgrade/Downgrade Dapr in a Kubernetes cluster | +| `--runtime-version` | | `latest` | The version of the Dapr runtime to upgrade/downgrade to, for example: `1.0.0` | | `--set` | | | Set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2) | ## Examples @@ -34,15 +38,16 @@ dapr upgrade [flags] dapr upgrade -k ``` -### Upgrade specified version of Dapr runtime in Kubernetes +### Upgrade or downgrade to a specified version of Dapr runtime in Kubernetes ```bash dapr upgrade -k --runtime-version 1.2 ``` -### Upgrade specified version of Dapr runtime in Kubernetes with value set +### Upgrade or downgrade to a specified version of Dapr runtime in Kubernetes with value set ```bash dapr upgrade -k --runtime-version 1.2 --set global.logAsJson=true ``` + # Related links -- [Upgrade Dapr on a Kubernetes cluster]({{< ref kubernetes-upgrade.md >}}) +- [Upgrade Dapr on a Kubernetes cluster]({{< ref kubernetes-upgrade.md >}}) \ No newline at end of file From 05999f009cd24532d092cae6150719927f9512b1 Mon Sep 17 00:00:00 2001 From: Nick Greenfield Date: Tue, 10 Aug 2021 09:17:16 -0700 Subject: [PATCH 2/2] Add alert shortcode for note --- daprdocs/content/en/reference/cli/dapr-upgrade.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/daprdocs/content/en/reference/cli/dapr-upgrade.md b/daprdocs/content/en/reference/cli/dapr-upgrade.md index 0af153b47..f9135ca76 100644 --- a/daprdocs/content/en/reference/cli/dapr-upgrade.md +++ b/daprdocs/content/en/reference/cli/dapr-upgrade.md @@ -9,9 +9,11 @@ description: "Detailed information on the upgrade CLI command" Upgrade or downgrade Dapr on supported hosting platforms. -> Note: Version steps should be done incrementally, including minor versions as you upgrade or downgrade. +{{% alert title="Warning" color="warning" %}} +Version steps should be done incrementally, including minor versions as you upgrade or downgrade. -> Note: Prior to downgrading, confirm components are backwards compatible and application code does ultilize APIs that are not supported in previous versions of Dapr. +Prior to downgrading, confirm components are backwards compatible and application code does ultilize APIs that are not supported in previous versions of Dapr. +{{% /alert %}} ## Supported platforms