Document how to configure cluster-scoped ArgoCD instances

appuio · Aug 9, 2024 · 2febebb · 2febebb
1 parent fe327b3
commit 2febebb
Show file tree

Hide file tree

Showing 2 changed files with 27 additions and 0 deletions.
diff --git a/docs/modules/ROOT/pages/how-tos/gitops/cluster-scope-argocd.adoc b/docs/modules/ROOT/pages/how-tos/gitops/cluster-scope-argocd.adoc
@@ -0,0 +1,24 @@
+= Configure an ArgoCD instance to be cluster-scoped
+
+== Prerequisites
+
+* Access to tenant repository
+* Knowledge of the namespace in which the cluster-scoped ArgoCD shall be deployed
+
+== Configure ArgoCD component
+
+. Add the following configuration to the cluster's config file in the tenant repository:
++
+[source,yaml]
+--
+  argocd:
+    operator:
+      cluster_scope_namespaces:
+        - [NAMESPACE NAME]
+--
+
+. Commit your change and create a pull request.
+
+. After merge, wait for the catalog to be compiled.
+
+. Inform the customer that they may now deploy their ArgoCD instance as per https://docs.appuio.ch/managed-openshift/gitops/howto-argocd.html[our documentation].
diff --git a/docs/modules/ROOT/partials/nav.adoc b/docs/modules/ROOT/partials/nav.adoc
@@ -182,6 +182,9 @@
 ** xref:oc4:ROOT:how-tos/monitoring/handle_alerts.adoc[]
 ** xref:oc4:ROOT:how-tos/monitoring/remove_rules.adoc[]
 
+* GitOps
+** xref:oc4:ROOT:how-tos/gitops/cluster-scope-argocd.adoc[Configure Cluster Scope ArgoCD Instances]
+
 // Scalability and performance
 // Specialized hardware and driver enablement