Getting started | Validated Patterns

Deploying the Multicloud GitOps pattern

Prerequisites

An OpenShift cluster
- To create an OpenShift cluster, go to the Red Hat Hybrid Cloud console.
- Select Services -> Containers -> Create cluster.
- The cluster must have a dynamic StorageClass to provision PersistentVolumes. See sizing your cluster.
Optional: A second OpenShift cluster for multicloud demonstration.
Install the tooling dependencies.

The use of this pattern depends on having at least one running Red Hat OpenShift cluster. However, consider creating a cluster for deploying the GitOps management hub assets and a separate cluster for the managed cluster.

If you do not have a running Red Hat OpenShift cluster, you can start one on a public or private cloud by using Red Hat Hybrid Cloud Console.

Procedure

Fork the multicloud-gitops repository on GitHub.

Clone the forked copy of this repository.

git clone git@github.com:your-username/multicloud-gitops.git

Create a local copy of the secret values file that can safely include credentials. Run the following commands:

cp values-secret.yaml.template ~/values-secret-multicloud-gitops.yaml

vi ~/values-secret-multicloud-gitops.yaml

Do not commit this file. You do not want to push personal credentials to GitHub. If you do not want to customize the secrets, these steps are not needed. The framework generates a random password for the config-demo application.

Customize the deployment for your cluster. Run the following command:

git checkout -b my-branch

vi values-global.yaml

git add values-global.yaml

git commit values-global.yaml

git push origin my-branch

Deploy the pattern by running ./pattern.sh make install or by using the Validated Patterns Operator.

Deploying the cluster by using the pattern.sh file

To deploy the cluster by using the pattern.sh file, complete the following steps:

Login to your cluster by running the following command:
```
 oc login
```
Optional: Set the KUBECONFIG variable for the kubeconfig file path:
```
 export KUBECONFIG=~/<path_to_kubeconfig>
```
Deploy the pattern to your cluster. Run the following command:
```
 ./pattern.sh make install
```
Verify that the Operators have been installed.
1. To verify, in the OpenShift Container Platform web console, navigate to Operators → Installed Operators page.
2. Check that the Operator is installed in the openshift-operators namespace and its status is Succeeded.
Verify that all applications are synchronized. Under the project multicloud-gitops-hub click the URL for the hub gitops server. The Vault application is not synched.

As part of this pattern, HashiCorp Vault has been installed. Refer to the section on Vault.

Next steps

After the management hub is set up and works correctly, attach one or more managed clusters to the architecture.

For instructions on deploying the edge, refer to Attach a managed cluster (edge) to the management hub.