Merge pull request #512 from Suse-KevinKlinger/main

Adding upgrade guide for SAP edge

Author: chabowski

adoc/SAP-EIC-General.adoc

@@ -176,4 +176,33 @@ kubectl apply -f application-name-certificate.yaml
 When you deploy your applications via Helm Charts, you can use the generated certificate. 
 In the Kubernetes Secret Certificate, three files are stored. These are the files _tls.crt_, _tls.key_ and _ca.crt_, which you can use in the _values.yaml_ file of your application.
 
-# end::use-cert-manager[]
+# end::use-cert-manager[]
+
+# tag::rancher-cleanup[]
+
+While a *helm uninstall* will trigger the removal of the {rancher} components, it is known that timeouts may be execeeded and some components may remain on your cluster.
+Therefore we recommend to uninstall {rancher} fully from your Kubernetes cluster, by using the cleanup scipt at https://github.com/rancher/rancher-cleanup .
+
+To run the script without cloning the repository, you can use the following command:
+
+[source, bash]
+----
+kubectl create -f https://raw.githubusercontent.com/rancher/rancher-cleanup/refs/heads/main/deploy/rancher-cleanup.yaml
+----
+
+To keep track of the deletion process, you can run:
+
+[source, bash]
+----
+kubectl  -n kube-system logs -l job-name=cleanup-job  -f
+----
+
+To verify the deletion was sucessfull, run the following commands where you should get an empty output:
+
+[source, bash]
+----
+kubectl create -f https://raw.githubusercontent.com/rancher/rancher-cleanup/refs/heads/main/deploy/verify.yaml
+kubectl  -n kube-system logs -l job-name=verify-job  -f | grep -v "is deprecated"
+----
+
+# end::rancher-cleanup[]

adoc/SAP-EIC-Harvester-main.adoc

@@ -297,6 +297,13 @@ At this point, you should be ready to deploy {eic}.
 Follow the instructions at https://help.sap.com/docs/integration-suite/sap-integration-suite/setting-up-and-managing-edge-integration-cell
 to install {eic} in your prepared environments.
 
+++++
+<?pdfpagebreak?>
+++++
+
+== Day 2 operations
+
+include::SAP-Edge-Upgrade.adoc[tags=**, leveloffset=+1]
 
 ++++
 <?pdfpagebreak?>
@@ -329,6 +336,9 @@ include::SAP-EIC-General.adoc[tags=k8s-upload-certificates]
 
 include::SAP-EIC-General.adoc[tags=use-cert-manager]
 
+==== Fully removing {rancher}
+
+include::SAP-EIC-General.adoc[tags=rancher-cleanup]
 
 
 ++++

adoc/SAP-EIC-Main.adoc

@@ -248,6 +248,14 @@ to install {eic} in your prepared environments.
 <?pdfpagebreak?>
 ++++
 
+== Day 2 operations
+
+include::SAP-Edge-Upgrade.adoc[tags=!harvester, leveloffset=+1]
+
+++++
+<?pdfpagebreak?>
+++++
+
 [#Appendix]
 == Appendix
 
@@ -274,6 +282,11 @@ include::SAP-EIC-General.adoc[tags=k8s-upload-certificates]
 
 include::SAP-EIC-General.adoc[tags=use-cert-manager]
 
+
+==== Fully removing {rancher}
+
+include::SAP-EIC-General.adoc[tags=rancher-cleanup]
+
 ++++
 <?pdfpagebreak?>
 ++++

adoc/SAP-Edge-Registry.adoc

@@ -0,0 +1,40 @@
+== Install the SUSE private Registry
+
+
+
+=== Prerequisites
+
+Make sure to have you meet the requirements for your desired setup:
+
+* link:https://documentation.suse.com/en-us/cloudnative/suse-private-registry/html/private-registry/pr-deployment.html#pr-deployment-prerequisites[non-HA setups]
+* link:https://documentation.suse.com/en-us/cloudnative/suse-private-registry/html/private-registry/pr-deployment-ha.html#pr-deployment-ha-prerequisites[HA setups]
+
+
+== Deployment
+
+
+
+[source, yaml]
+----
+expose:
+  type: nodePort
+  nodePort:
+    annotations: {}
+    labels: {}
+    name: harbor
+    ports:
+      http:
+        nodePort: 30002
+        port: 80
+      https:
+        nodePort: 30003
+        port: 443
+  tls:
+    auto:
+      commonName: lu0411v9
+externalURL: https://lu0411v9
+harborAdminPassword: Harbor12345
+imagePullPolicy: IfNotPresent
+imagePullSecrets:
+- name: suse-registry
+----