Upgrade Styra DAS
The following sections describe how to upgrade Styra DAS.
Upgrading Helm Release
Upgrading Self-Hosted Styra DAS can be accomplished using Helm Upgrade. Because the
helm upgrade command supports a
helm upgrade can be made to work for both the initial installation and future upgrade of charts. As such, the instructions in Installing Styra DAS can be repeated to upgrade a chart. This section will include recommendations specific to the upgrade process.
For existing installations using versions of Styra DAS previous to 0.10.0, please contact your Styra Customer Success Manager for support during the upgrade of your Helm charts.
When upgrading from an older version of Styra DAS to a newer one, it can be tempting to re-use the previous
values.yaml file. This can sometimes work, but when a version difference contains changes to the
values.yaml file format, doing so can quickly lead to difficult to diagnose compatibility issues. As such, Styra recommends the following process for preparing a
values.yaml file for upgrade:
- Download a fresh
values.yamlfile for the intended upgrade target by following the instructions in Downloading Default Values.
- Compare the
values.yamlused for the previous installation to the new default ones, noting which differences are due to different field values, and which, if any, are due to differences in the fields themselves.
- Using the previous
values.yamlas a reference, fill in the newer
values.yamlwith all values that are required for your specific installation.
- Use the new
Once the new
values.yaml file is ready, repeat the steps in either Installing from Styra’s Helm Repository or Installing From Local System as appropriate. It can be helpful to specify a
--version argument to
helm upgrade when doing so, so as to make the upgrade target explicit.
An example command to upgrade a Helm Repository based installation may look like the following:
helm upgrade --install styra-das styra/styra-das –version <TARGET_STYRA_DAS_VERSION> -n styra-das -f <NEW_VALUES_FILE>
Upgrading Custom Deployments
Custom methods of deploying Styra DAS to a target cluster will have different sets of best practices based on the particularities of each deployment system. Updating the Styra DAS version within a custom, non-Helm deployment should start with repeating the steps in Custom Installation, while also adhering to the following suggestions as best possible:
- Download a fresh default
values.yamland modify settings as needed to match your old
values.yaml. Attempting to re-use an existing
values.yamlcan lead to difficult to diagnose incompatibility issues if the
values.yamlformat has changed between versions.
- Perform a side-by-side deployment of the new chart and
values.yamlcombination, running it in a different namespace than the previous deployment. This is generally recommended to allow validation of the new installation, as well as provide easy rollback in the case of misconfiguration.