Production guide section restyling

umh.docs.umh.app/archetypes/tasks.md

@@ -2,23 +2,29 @@
 title: "{{ replace .Name "-" " " | title }}"
 content_type: task
 description: |
-    Add a description of the task here.
+    This page describes how to
 weight: 50
 ---
 
 <!-- overview -->
 
 ## {{% heading "prerequisites" %}}
 
-{{< include "task-tutorial-prereqs.md" >}}
+<!-- Use the include shortcode for the prerequisites, depending
+     on the type of task. For example, if the task happens after installation,
+     use the {{< include "task-aftinst-prereqs.md" >}} shortcode, and if the
+     task happens before installation, use the {{< include "task-befinst-prereqs.md" >}}
+     shortcode. If the task has no prerequisites, delete the {{% heading "prerequisites" %}}
+-->
 
 <!-- If you set the minimum_version or maximum_version parameter in the page's
      front matter, add the version check shortcode {{< version-check >}}.
 -->
 
 <!-- steps -->
 
-<!-- discussion -->
+<!-- Optional section, but recommended; write the problem/question in H3 -->
+## {{% heading "troubleshooting" %}}
 
 <!-- Optional section; add links to information related to this topic. -->
 ## {{% heading "whatsnext" %}}

umh.docs.umh.app/archetypes/upgrading.md

@@ -0,0 +1,73 @@
+---
+title: "Upgrade to v{{ .Name }}"
+content_type: upgrading
+description: "This page describes how to upgrade the United Manufacturing Hub
+to version {{ .Name }}"
+weight: 1000
+---
+
+This page describes how to upgrade the United Manufacturing Hub to version
+{{ .Name }}. Before upgrading, remember to backup the
+[database](/docs/production-guide/backup_recovery/backup-timescale/),
+[Node-RED flows](/docs/production-guide/backup_recovery/import-export-node-red/),
+and your cluster configuration.
+
+## Add Helm repo in {{% resource type="lens" name="name" %}}
+
+Check if the UMH Helm repository is added in {{% resource type="lens" name="name" %}}.
+To do so, from the top-left menu, select **FIle** > **Preferences** (or press `CTRL + ,`).
+Click on the **Kubernetes** tab and check if the **Helm Chart** section contains
+the `https://repo.umh.app` repository.
+
+If it doesn't, click the **Add Custom Helm Repo** button and fill in the following
+values:
+
+- Helm repo name: {{% resource type="helm" name="repo" %}}
+- URL: {{% resource type="helm" name="repo-url" %}}
+
+Then click **Add**.
+
+<!-- Add here any steps needed before deleting the deployments and statefulsets -->
+
+## Clear Workloads
+
+Some workloads need to be deleted before upgrading. This process _do not_ delete
+any data. If a workload is missing, it means that it was not enabled in your
+cluster, therefore you can skip it.
+
+To delete a resource, you can select it using the box on the left of the
+resource name and click the **-** button on the bottom right corner.
+
+1. Open the **Workloads** tab.
+2. From the **Deployment** section, delete the following deployments:
+   - {{% resource type="deployment" name="barcodereader" %}}
+   - {{% resource type="deployment" name="factoryinsight" %}}
+   - {{% resource type="deployment" name="kafkatopostgresql" %}}
+   - {{% resource type="deployment" name="mqttkafkabridge" %}}
+   - {{% resource type="deployment" name="mqttsimulator" %}}
+   - {{% resource type="deployment" name="opcuasimulator" %}}
+3. From the **StatefulSet** section, delete the following statefulsets:
+   - {{% resource type="statefulset" name="mqttbridge" %}}
+   - {{% resource type="statefulset" name="mqttbroker" %}}
+   - {{% resource type="statefulset" name="nodered" %}}
+   - {{% resource type="statefulset" name="sensorconnect" %}}
+
+<!-- Add here any steps needed before upgrading the Helm Chart -->
+
+## Upgrade Helm Chart
+
+Now everything is ready to upgrade the Helm chart.
+
+1. Navigate to the **Helm** > **Releases** tab.
+2. Select the {{% resource type="helm" name="release" %}} release and click
+   **Upgrade**.
+3. In the **Helm Upgrade** window, make sure that the `Upgrade version` field
+   contains the version you want to upgrade to.
+4. You can also change the values of the Helm chart, if needed.
+   <!-- Add here any changes needed to the values.yaml -->
+5. Click **Upgrade**.
+
+The upgrade process can take a few minutes. The upgrade is complete when the
+**Status** field of the release is Deployed.
+
+<!-- Add here any steps needed after upgrading the Helm Chart -->

umh.docs.umh.app/content/en/docs/production-guide/_index.md

@@ -1,9 +1,8 @@
-+++
-title = "Production Guide"
-menuTitle = "Production Guide"
-description = "These pages describe how to move from development to production and how to use the stack in a production environment."
-weight = 3000
-+++
-
-
-
+---
+title: Production Guide
+menuTitle: Production Guide
+description: |
+    This section contains information about how to use the stack in a production
+    environment.
+weight: 3000
+---

umh.docs.umh.app/content/en/docs/production-guide/administration/access-database.md

@@ -25,7 +25,7 @@ you just want to see the data in a dashboard and don't need to manupulate it.
 
 ## {{% heading "prerequisites" %}}
 
-{{< include "task-tutorial-prereqs.md" >}}
+{{< include "task-aftinst-prereqs.md" >}}
 
 ### Get the database credentials
 

umh.docs.umh.app/content/en/docs/production-guide/administration/access-kafka-outside-cluster.md

@@ -3,7 +3,7 @@ title: "Access Kafka Outside the Cluster"
 content_type: task
 description: |
   This page describes how to access Kafka from outside the cluster.
-weight: 21
+weight: 22
 ---
 
 <!-- overview -->
@@ -15,7 +15,7 @@ You can enable external access from the Kafka configuration.
 
 ## {{% heading "prerequisites" %}}
 
-{{< include "task-tutorial-prereqs.md" >}}
+{{< include "task-aftinst-prereqs.md" >}}
 
 <!-- steps -->
 

umh.docs.umh.app/content/en/docs/production-guide/administration/access-services-from-cluster.md

@@ -13,7 +13,7 @@ easy to connect them together.
 
 ## {{% heading "prerequisites" %}}
 
-{{< include "task-tutorial-prereqs.md" >}}
+{{< include "task-aftinst-prereqs.md" >}}
 
 <!-- steps -->