Getting started

Deploying the RHOSO GitOps pattern

Deploy the RHOSO GitOps pattern on a single Red Hat OpenShift Container Platform cluster. Complete the prerequisites, prepare your fork of the pattern repository, install with ./pattern.sh, and verify that Argo CD Applications are healthy.

Prerequisites

Before you deploy the pattern, verify that you have the following:

A Red Hat OpenShift Container Platform cluster meeting the RHOSO software requirements with enough compute and storage. For sizing guidance, see Cluster sizing.
Cluster administrator privileges and a working kubeconfig.
Podman 4.3 or later for ./pattern.sh.
Red Hat OpenShift GitOps available on the cluster (installed by the pattern framework or pre-installed).
The required tool dependencies.

Preparing for deployment

Procedure

Fork the rhoso-gitops repository on GitHub.

Clone your fork:

$ git clone git@github.com:<your_organization>/rhoso-gitops.git

Change to the repository directory:
```
$ cd rhoso-gitops
```
Configure your overrides. See RHOSO GitOps pattern configuration for the values file layers and override options.
Configure your secrets file before installing. See Secret management for the RHOSO GitOps pattern for instructions on both the Vault + External Secrets Operator and direct injection approaches.

Installing the pattern

Procedure

Validate prerequisites without applying changes:
```
$ ./pattern.sh make validate-prereq
```
Preview the rendered manifests:
```
$ ./pattern.sh make show
```
Install the pattern:
```
$ ./pattern.sh make install
```

Verifying the deployment

Procedure

List Argo CD applications in vp-gitops:
```
$ oc get applications -n vp-gitops
```
After installation, run the pattern health check:
```
$ ./pattern.sh make argo-healthcheck
```
Validate the pattern schema:
```
$ ./pattern.sh make validate-schema
```

Edit this page Open a documentation issue