Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions _topic_map.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1289,8 +1289,8 @@ Topics:
Topics:
- Name: Understanding OpenShift GitOps
File: understanding-openshift-gitops
# - Name: Getting started with OpenShift GitOps
# File: getting-started-with-openshift-gitops
- Name: Getting started with OpenShift GitOps
File: getting-started-with-openshift-gitops
---
Name: Images
Dir: openshift_images
Expand Down
15 changes: 15 additions & 0 deletions cicd/gitops/getting-started-with-openshift-gitops.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
[id="getting-started-with-openshift-gitops"]
= Getting started with OpenShift GitOps
include::modules/common-attributes.adoc[]
:context: getting-started-with-openshift-gitops
toc::[]

Red Hat OpenShift GitOps uses Argo CD as the core declarative tool and adds other tooling to enable teams to implement GitOps workflows across clusters.
This section walks you through the process of launching Argo CD using the web console and logging into it.

== Prerequisites

* You must install the xref:../../operators/admin/olm-adding-operators-to-cluster.adoc#olm-adding-operators-to-a-cluster[Red Hat OpenShift GitOps Operator] listed in the OpenShift OperatorHub by using the default installation options.

//Procedure Module
include::modules/launching-the-operator-provided-argocd-instance.adoc[leveloffset=+1]
28 changes: 28 additions & 0 deletions modules/launching-the-operator-provided-argocd-instance.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
// Module is included in the following assemblies:
//
// * openshift-docs/cicd/gitops/getting-started--with-openshift-gitops.adoc

[id="launching-the-operator-provided-argocd-instance_{context}"]
= Launching the Operator provided Argo CD instance

Red Hat OpenShift GitOps uses Argo CD to manage specific cluster-scoped resources, including: platform operators, optional Operator Lifecycle Manager (OLM) operators, and user management.

To launch the Argo CD instance for your cluster configuration, ensure that the Red Hat OpenShift GitOps Operator is installed on your cluster. After the Operator is installed, it is applicable to all namespaces on the entire cluster. When you install the Red Hat OpenShift GitOps Operator, it automatically sets up a ready-to-use Argo CD instance that is available in the `openshift-gitops` namespace, and an Argo CD icon is displayed in the console toolbar.

After you install the Red Hat OpenShift GitOps Operator, launch into the Argo CD instance from the *Console Application Launcher* to use Argo CD.

.Prerequisites

* You have installed the Red Hat OpenShift GitOps Operator.

.Procedure

. In the *Administrator* perspective of the web console, navigate to *Operators* -> *Installed Operators*.
. Navigate to *Red Hat applications* -> *Application Stages* -> *Argo CD*. The login page of the Argo CD UI is displayed in a new window.
. Obtain the password for the Argo CD instance:
.. Navigate to the *Developer* perspective of the web console. A list of available projects is displayed.
.. Navigate to the `openshift-gitops` project.
.. Select the *Secrets* tab.
.. Select the *argocd-cluster-cluster* instance to display the password.
.. Copy the password.
. Use this password to log into the Argo CD UI in the new window.