feat: added upgrade notes for v4.4.4 issues (#120)

Author: ElderMatt

docs/for-ops/upgrade-instructions.md

@@ -0,0 +1,23 @@
+---
+slug: upgrade-instructions
+title: Upgrade Instructions
+sidebar_label: Upgrade Instructions
+---
+
+The Akamai App Platform is regularly updated to provide new features, improvements, and security enhancements. This page outlines the recommended approach for performing an upgrade.
+
+## Upgrading through the Platform Dashboard
+
+The primary method to upgrade the Akamai App Platform is via the platform dashboard. Within the dashboard you can see your current version in the top right corner, there is also a table listing all available versions, each accompanied by a brief description of the changes introduced in that release. To see the full release notes of that version you can click on the version tag. To initiate the upgrade, simply click the `Upgrade to vX.Y.Z` button to upgrade to the latest version.
+
+1. As a platform admin go to the platform view.
+
+2. In the left menu, click on `Dashboard`.
+
+3. Click the `Upgrade to vX.Y.Z` button and the Akamai App Platform will be upgraded to the newest version.
+
+![Upgrade through the dashboard](../img/upgrade-version-dashboard.png)
+
+:::note
+If there is no newer version a message will be displayed instead showing that there are no new updates for your version.
+:::

docs/for-ops/upgrade-notes.md

@@ -0,0 +1,69 @@
+---
+slug: upgrade-notes
+title: Upgrade Notes
+sidebar_label: Upgrade Notes
+---
+
+## About upgrade notes
+
+In some cases between versions upgrades there are issues that can occur, on this page you will find fixes on how to deal with those issues.
+
+## v4.4.4 to v4.7.0 or higher
+
+From v4.4.4 to a higher version there might occur an issue with the harbor redis, which results in the harbor-redis-0 pod restarting indefinitely.
+
+To solve this issue you have to delete the harbor redis data according to the following steps.
+
+### Disable ArgoCD autoSync on harbor-harbor
+```shell
+kubectl patch application harbor-harbor \
+  -n argocd \
+  --type='json' \
+  -p='[{"op": "remove", "path": "/spec/syncPolicy/automated"}]'
+```
+
+### Scale down harbor-jobservice, harbor-core to zero
+```shell
+kubectl scale deploy harbor-jobservice --replicas=0 -n harbor
+kubectl scale deploy harbor-core --replicas=0 -n harbor
+```
+
+:::note
+If the version you are going to upgrade to is of v4.7.0 or higher you also have to scale down the apl-operator
+:::
+
+```shell
+kubectl scale deploy apl-operator --replicas=0 -n apl-operator
+```
+
+### Scale down the harbor redis to zero
+```shell
+kubectl scale sts harbor-redis --replicas=0 -n harbor
+```
+
+### PVC data-harbor-redis-0 is deleted
+```shell
+kubectl delete pvc data-harbor-redis-0 -n harbor
+```
+
+### Scale up harbor-redis to one
+```shell
+kubectl scale sts harbor-redis --replicas=1 -n harbor
+```
+
+### Wait for pod ready status
+:::note
+If the version you are going to upgrade to is of v4.7.0 or higher you also have to scale up the apl-operator
+:::
+
+```shell
+kubectl scale deploy apl-operator --replicas=1 -n apl-operator
+```
+
+### Enable ArgoCD autoSync on harbor-harbor
+```shell
+kubectl patch application harbor-harbor \
+  -n argocd \
+  --type='json' \
+  -p='[{"op": "add", "path": "/spec/syncPolicy/automated", "value": {"prune": true,"selfHeal": true}}]'
+  ```

docs/img/upgrade-version-dashboard.png

@@ -130,6 +130,8 @@ module.exports = {
           "for-ops/disaster-recovery/platform-reinstall",
         ],
       },
+      "for-ops/upgrade-instructions",
+      "for-ops/upgrade-notes",
       "for-ops/known-issues",
       "for-ops/security-best-practices",
     ],