Upgrade SPK from v1.7.12 to v1.7.13¶

SPK version 1.7.13 contains an updated version of the Cert manager, Rabbitmq, CWC, and F5ingress pod. To successfully move from SPK v1.7.12 to v1.7.13, please follow the steps below.

Important:

The Helm Upgrade is not supported. Therefore, the recommended method to upgrade SPK v1.7.12 to v1.7.13 is to uninstall and install the necessary releases.

When you uninstall the f5-cert-manager, the leaf certificates and secrets will remain and can still be used until their expiration date without the need for renewal. Upon reinstallation or upgrade of f5-cert-manager in the same namespace, the previous CA secret will automatically be recognized and utilized to generate or renew certificates by default. As it is the same CA, there will be no impact on communications.

Note: The dSSM and Toda versions remain unchanged in both SPK v1.7.12 and v1.7.13, therefore no instructions for upgrading these pods are included.

Procedure¶

Follow the steps below to upgrade the SPK from v1.7.12 to v1.7.13. Remove and then reinstall all the global components and spk product specific components in the specified order below:

Uninstall the global components and spk product specific components¶

Uninstall the f5ingress helm chart.

In this example, the f5ingress helm chart is installed in the spk-utils Project.
```
helm uninstall f5ingress -n spk-utils
```
Sample Output
```
release "f5ingress" uninstalled
```
Uninstall the CWC helm chart.

In this example, the CWC helm chart is installed in the spk-global-components Project.
```
helm uninstall cwc -n spk-global-components
```
Sample Output
```
release "cwc" uninstalled
```
Uninstall the RabbitMQ helm chart.

In this example, the rabbtimq helm chart is installed in the spk-global-components Project.
```
helm uninstall rabbtimq  -n spk-global-components
```
Sample Output
```
release "rabbitmq" uninstalled
```
Uninstall the Cert Manager helm chart.

In this example, the f5-certificate-manager helm chart is installed in the spk-global-components Project.
```
helm uninstall f5-certificate-manager  -n spk-global-components
```
Sample Output
```
release "f5-certificate-manager" uninstalled
```

See the list of releases.

In this example, the below command shows the list of available releases in spk-global-components Project.

helm list -n spk-global-components

Sample Output

NAME                    NAMESPACE                       REVISION        UPDATED                                 STATUS          CHART                           APP VERSION

Reinstall the global components and spk product specific components¶

Reinstall the Cert Manager using the new certificate-manager helm chart version mentioned in the SPK v1.7.13. tarball.

In this example, the new version of certificate-manager helm chart is 0.5.12-0.0.5

helm install f5-certificate-manager tar/f5-cert-manager-0.5.12-0.0.5.tgz --namespace spk-global-components -f cm_overrides_1.7.13.yaml

Sample Output

NAME: f5-certificate-manager
LAST DEPLOYED: Mon Jan 20 11:24:05 2025
NAMESPACE: spk-global-components
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
# Modified from and/or generated from (possibly modified), cert-manager source
# f5-cert-manager

Please see: https://my.aspenmesh.io/client/docs/latest/releases/certificate-orchestrator/1.3.2/release-notes/

Reinstall the RabbitMQ using the new rabbitmq helm chart version mentioned in the SPK v1.7.13. tarball.

In this example, the new version of rabbitmq helm chart is 2.0.8

helm install rabbitmq tar/rabbitmq-2.0.8.tgz --namespace spk-global-components -f rmq_overrides_1.7.13.yaml --set cert-orchestrator.enabled=true

Sample Output

NAME: rabbitmq
LAST DEPLOYED: Mon Jan 20 11:26:49 2025
NAMESPACE: spk-global-components
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
The RabbitMQ has been installed.

Reinstall the CWC using the new cwc helm chart version mentioned in the SPK v1.7.13. tarball.

In this example, the new version of CWC helm chart is 2.0.21

helm install cwc tar/cwc-2.0.21.tgz -n spk-global--set rabbitmqNamespace=spk-global-components -f cwc_overrides_1.7.13.yaml

Sample Output

NAME: cwc
LAST DEPLOYED: Mon Jan 20 11:29:38 2025
NAMESPACE: spk-global-components
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
The Cluster Wide Controller has been installed.

See the installed releases in spk-global-components namespace.

helm list -n spk-global-components

In this example, the below command shows the installed releases in spk-global-components Project.

Sample Output

NAME                    NAMESPACE                       REVISION        UPDATED                                 STATUS          CHART                           APP VERSION
cwc                     spk-global-components           1               2025-01-20 11:29:38.6620847 +0000 UTC   deployed        cwc-2.0.21                      2.0.21     
f5-certificate-manager  spk-global-components           1               2025-01-20 11:24:05.112014803 +0000 UTC deployed        f5-cert-manager-0.5.12-0.0.5    v1.3.2     
rabbitmq                spk-global-components           1               2025-01-20 11:26:49.595164289 +0000 UTC deployed        rabbitmq-2.0.8                  2.0.8      

Reinstall the f5ingress using the new f5ingress helm chart version mentioned in the SPK v1.7.13 tarball.

In this example, the new version of f5ingress helm chart is 10.0.144

helm install f5ingress tar/f5ingress-10.0.144.tgz --namespace spk-utils -f f5ingress_1.7.13.yaml

Sample Output

NAME: f5ingress
LAST DEPLOYED: Mon Jan 20 11:42:04 2025
NAMESPACE: spk-utils
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
The F5Ingress Controller has been installed.
TMM debug sidecar is deployed. To access: kubectl exec -it deployment/f5-tmm -c debug -n spk-utils -- bash

See the installed releases in spk-utils namespace.

In this example, the below command shows the installed releases in spk-utils Project.

Sample Output

NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
f5ingress       spk-utils       1               2025-01-20 11:42:04.438966624 +0000 UTC deployed        f5ingress-10.0.155      v10.0.155  

Feedback¶

Provide feedback to improve this document by emailing spkdocs@f5.com.