Merge pull request #65212 from openshift/revert-65181-switch-gitops-to-standalone

Revert "Switch GitOps to standalone "

Author: gabriel-rh

_topic_maps/_topic_map.yml

@@ -1947,8 +1947,50 @@ Topics:
   Dir: gitops
   Distros: openshift-enterprise
   Topics:
-  - Name: About OpenShift GitOps
-    File: about-redhat-openshift-gitops
+  - Name: OpenShift GitOps release notes
+    File: gitops-release-notes
+  - Name: Understanding OpenShift GitOps
+    File: understanding-openshift-gitops
+  - Name: Installing OpenShift GitOps
+    File: installing-openshift-gitops
+  - Name: Uninstalling OpenShift GitOps
+    File: uninstalling-openshift-gitops
+  - Name: Setting up a new Argo CD instance
+    File: setting-up-argocd-instance
+  - Name: Monitoring Argo CD instances
+    File: monitoring-argo-cd-instances
+  - Name: Using Argo Rollouts for progressive deployment delivery
+    File: using-argo-rollouts-for-progressive-deployment-delivery
+  - Name: Configuring an OpenShift cluster by deploying an application with cluster configurations
+    File: configuring-an-openshift-cluster-by-deploying-an-application-with-cluster-configurations
+  - Name: Deploying a Spring Boot application with Argo CD
+    File: deploying-a-spring-boot-application-with-argo-cd
+  - Name: Argo CD custom resource properties
+    File: argo-cd-custom-resource-properties
+  - Name: Configuring secure communication with Redis
+    File: configuring-secure-communication-with-redis
+  - Name: Monitoring application health status
+    File: health-information-for-resources-deployment
+  - Name: Configuring SSO for Argo CD using Dex
+    File: configuring-sso-on-argo-cd-using-dex
+  - Name: Configuring SSO for Argo CD using Keycloak
+    File: configuring-sso-for-argo-cd-using-keycloak
+  - Name: Configuring Argo CD RBAC
+    File: configuring-argo-cd-rbac
+  - Name: Configuring Resource Quota
+    File: configuring-resource-quota
+  - Name: Monitoring Argo CD custom resource workloads
+    File: monitoring-argo-cd-custom-resource-workloads
+  - Name: Viewing Argo CD logs
+    File: viewing-argo-cd-logs
+  - Name: Running Control Plane Workloads on Infra nodes
+    File: run-gitops-control-plane-workload-on-infra-nodes
+  - Name: Sizing requirements for GitOps Operator
+    File: about-sizing-requirements-gitops
+  - Name: Collecting debugging data for a support case
+    File: collecting-debugging-data-for-support
+  - Name: Troubleshooting issues in GitOps
+    File: troubleshooting-issues-in-GitOps
 - Name: Jenkins
   Dir: jenkins
   Distros: openshift-enterprise

cicd/gitops/about-redhat-openshift-gitops.adoc

@@ -0,0 +1,12 @@
+:_content-type: ASSEMBLY
+[id="about-sizing-requirements-gitops"]
+= Sizing requirements for GitOps Operator
+include::_attributes/common-attributes.adoc[]
+:context: about-sizing-requirements-gitops
+
+toc::[]
+
+[role="_abstract"]
+The sizing requirements page displays the sizing requirements for installing {gitops-title} on {product-title}. It also provides the sizing details for the default ArgoCD instance that is instantiated by the GitOps Operator.
+
+include::modules/sizing-requirements-for-gitops.adoc[leveloffset=+1]

cicd/gitops/about-sizing-requirements-gitops.adoc

@@ -0,0 +1,15 @@
+:_content-type: ASSEMBLY
+[id="argo-cd-custom-resource-properties"]
+= Argo CD Operator
+include::_attributes/common-attributes.adoc[]
+:context: argo-cd-custom-resource-properties
+
+toc::[]
+
+[role="_abstract"]
+The `ArgoCD` custom resource is a Kubernetes Custom Resource (CRD) that describes the desired state for a given Argo CD cluster that allows you to configure the components which make up an Argo CD cluster.
+
+include::modules/argo-cd-command-line.adoc[leveloffset=+1]
+include::modules/gitops-argo-cd-properties.adoc[leveloffset=+1]
+include::modules/gitops-repo-server-properties.adoc[leveloffset=+1]
+include::modules/gitops-argo-cd-notification.adoc[leveloffset=+1]

cicd/gitops/argo-cd-custom-resource-properties.adoc

@@ -0,0 +1,17 @@
+:_content-type: ASSEMBLY
+[id="collecting-debugging-data-for-support"]
+= Collecting debugging data for a support case
+include::_attributes/common-attributes.adoc[]
+:context: collecting-debugging-data-for-support
+
+toc::[]
+
+When you open a support case, you must provide debugging information about your cluster to the Red Hat Support team. You can use the `must-gather` tool to collect diagnostic information for project-level resources, cluster-level resources, and {gitops-title} components. 
+
+[NOTE]
+====
+For prompt support, provide diagnostic information for both {product-title} and {gitops-title}.
+====
+
+include::modules/about-must-gather.adoc[leveloffset=+1]
+include::modules/collecting-gitops-debugging-data.adoc[leveloffset=+1]

cicd/gitops/collecting-debugging-data-for-support.adoc

@@ -0,0 +1,38 @@
+:_content-type: ASSEMBLY
+[id="configuring-an-openshift-cluster-by-deploying-an-application-with-cluster-configurations"]
+= Configuring an OpenShift cluster by deploying an application with cluster configurations
+include::_attributes/common-attributes.adoc[]
+:context: configuring-an-openshift-cluster-by-deploying-an-application-with-cluster-configurations
+
+toc::[]
+
+With {gitops-title}, you can configure Argo CD to recursively sync the content of a Git directory with an application that contains custom configurations for your cluster.
+
+.Prerequisites
+
+* You have logged in to the {product-title} cluster as an administrator.
+* You have installed the {gitops-title} Operator in your cluster.
+* You have logged into Argo CD instance.
+
+include::modules/gitops-using-argo-cd-instance-to-manage-cluster-scoped-resources.adoc[leveloffset=+1]
+
+include::modules/gitops-default-permissions-of-an-argocd-instance.adoc[leveloffset=+1]
+
+include::modules/go-run-argo-cd-instance-on-infrastructure-nodes.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+* To learn more about taints and tolerations, see xref:../../nodes/scheduling/nodes-scheduler-taints-tolerations.adoc#nodes-scheduler-taints-tolerations[Controlling pod placement using node taints].
+* For more information on infrastructure machine sets, see xref:../../machine_management/creating-infrastructure-machinesets.adoc#creating-infrastructure-machinesets[Creating infrastructure machine sets].
+
+include::modules/gitops-creating-an-application-by-using-the-argo-cd-dashboard.adoc[leveloffset=+1]
+
+include::modules/gitops-creating-an-application-by-using-the-oc-tool.adoc[leveloffset=+1]
+
+include::modules/gitops-synchronizing-your-application-application-with-your-git-repository.adoc[leveloffset=+1]
+
+include::modules/gitops-inbuilt-permissions-for-cluster-config.adoc[leveloffset=+1]
+
+include::modules/gitops-additional-permissions-for-cluster-config.adoc[leveloffset=+1]
+
+include::modules/gitops-installing-olm-operators-using-gitops.adoc[leveloffset=+1]

cicd/gitops/configuring-an-openshift-cluster-by-deploying-an-application-with-cluster-configurations.adoc

@@ -0,0 +1,13 @@
+:_content-type: ASSEMBLY
+[id="configuring-argo-cd-rbac"]
+= Configuring Argo CD RBAC
+include::_attributes/common-attributes.adoc[]
+:context: configuring-argo-cd-rbac
+
+toc::[]
+
+[role="_abstract"]
+By default, if you are logged into Argo CD using RHSSO, you are a read-only user. You can change and manage the user level access.
+
+include::modules/configuring-user-level-access.adoc[leveloffset=+1]
+include::modules/modify-rhsso-requests-limits.adoc[leveloffset=+1]

cicd/gitops/configuring-argo-cd-rbac.adoc

@@ -0,0 +1,14 @@
+:_content-type: ASSEMBLY
+[id="configuring-resource-quota"]
+= Configuring resource quota or requests
+include::_attributes/common-attributes.adoc[]
+:context: configuring-resource-quota
+
+toc::[]
+
+[role="_abstract"]
+With the Argo CD Custom Resource, you can create, update, and delete resource requests and limits for Argo CD workloads. 
+
+include::modules/configure-workloads.adoc[leveloffset=+1]
+include::modules/patch-argocd-instance.adoc[leveloffset=+1]
+include::modules/remove-resource-requirements.adoc[leveloffset=+1]

cicd/gitops/configuring-resource-quota.adoc

@@ -0,0 +1,27 @@
+:_content-type: ASSEMBLY
+[id="configuring-secure-communication-with-redis"]
+= Configuring secure communication with Redis
+include::_attributes/common-attributes.adoc[]
+:context: configuring-secure-communication-with-redis
+
+toc::[]
+
+Using the Transport Layer Security (TLS) encryption with {gitops-title}, you can secure the communication between the Argo CD components and Redis cache and protect the possibly sensitive data in transit.
+
+You can secure communication with Redis by using one of the following configurations:
+
+* Enable the `autotls` setting to issue an appropriate certificate for TLS encryption.
+* Manually configure the TLS encryption by creating the `argocd-operator-redis-tls` secret with a key and certificate pair.
+
+Both configurations are possible with or without the High Availability (HA) enabled.
+
+.Prerequisites
+* You have access to the cluster with `cluster-admin` privileges.
+* You have access to the {product-title} web console.
+* {gitops-title} Operator is installed on your cluster.
+
+include::modules/gitops-configuring-tls-for-redis-with-autotls-enabled.adoc[leveloffset=+1]
+
+include::modules/gitops-configuring-tls-for-redis-with-autotls-disabled.adoc[leveloffset=+1]
+
+

cicd/gitops/configuring-secure-communication-with-redis.adoc

@@ -0,0 +1,35 @@
+:_content-type: ASSEMBLY
+[id="configuring-sso-for-argo-cd-on-openshift"]
+= Configuring SSO for Argo CD on OpenShift
+include::_attributes/common-attributes.adoc[]
+:context: configuring-sso-for-argo-cd-on-openshift
+
+toc::[]
+
+After the {gitops-title} Operator is installed, Argo CD automatically creates a user with `admin` permissions. To manage multiple users, Argo CD allows cluster administrators to configure SSO.
+
+.Prerequisites
+* Red Hat SSO is installed on the cluster.
+
+include::modules/gitops-creating-a-new-client-in-keycloak.adoc[leveloffset=+1]
+
+include::modules/gitops-configuring-the-groups-claim.adoc[leveloffset=+1]
+
+include::modules/gitops-configuring-argo-cd-oidc.adoc[leveloffset=+1]
+
+include::modules/gitops-keycloak-identity-brokering-with-openshift-oauthclient.adoc[leveloffset=+1]
+
+include::modules/gitops-registering-an-additional-oauth-client.adoc[leveloffset=+1]
+
+include::modules/gitops-configuring-groups-and-argocd-rbac.adoc[leveloffset=+1]
+
+//include::modules/gitops-enabling-dex.adoc[leveloffset=+1]
+
+include::modules/gitops-in-built-permissions.adoc[leveloffset=+1]
+
+////
+[role="_additional-resources"]
+.Additional resources
+* link:https://stedolan.github.io/jq/[`jq` command-line JSON processor documentation.]
+* link:https://argoproj.github.io/argo-cd/operator-manual/rbac/[Argo CD upstream documentation, RBAC Configuration section].
+////