Attach a managed cluster (edge) to the management hub

Understanding Red Hat Advanced Cluster Management requirements

By default, Red Hat Advanced Cluster Management (RHACM) manages the clusterGroup applications that are deployed on all clusters. In the value-hub.yaml file, add a managedClusterCgroup for each cluster or group of clusters that you want to manage as one.

  managedClusterGroups:
  - name: region-one
    helmOverrides:
    - name: clusterGroup.isHubCluster
      value: false
    clusterSelector:
      matchLabels:
        clusterGroup: region-one

The above YAML file segment deploys the clusterGroup applications on managed clusters with the label clusterGroup=region-one. Specific subscriptions and Operators, applications and projects for that clusterGroup are then managed in a value-region-one.yaml file. For example:

  namespaces:
    - config-demo

  projects:
    - config-demo

  applications:
    config-demo:
      name: config-demo
      namespace: config-demo
      project: config-demo
      path: charts/all/config-demo

  #Subscriptions can be added too - multicloud-gitops at present does not require subscriptions on its managed clusters
  #subscriptions:
.  #  example-subscription
  #    name: example-operator
  #    namespace: example-namespace
  #    channel: example-channel
  #    csv: example-operator.v1.0.0

  subscriptions:

Ensure that you commit the changes and push them to GitHub so that GitOps can fetch your changes and apply them.

Deploying a managed cluster by using Red Hat Advanced Cluster Management

Prerequistes

An OpenShift cluster
- To create an OpenShift cluster, go to the Red Hat Hybrid Cloud console.
- Select Services → Containers → Create cluster.
Red Hat Advanced Cluster Management (RHACM) web console to join the managed cluster to the management hub
After RHACM is installed, a message regarding a Web console update is available" might be displayed. Follow the instructions and click the Refresh web console link.

Procedure

In the left navigation panel of web console, click local-cluster. Select All Clusters. The RHACM web console is displayed with Cluster* on the left navigation panel.
On the Managed clusters tab, click Import cluster.
On the Import an existing cluster page, enter the cluster name and choose KUBECONFIG as the "import mode". Add the tag clusterGroup=region-one. Click Import.

Now that RHACM is no longer deploying the managed cluster applications everywhere, you must indicate that the new cluster has the managed cluster role.

Optional: Deploying a managed cluster by using `cm-cli` tool

Prerequistes

An OpenShift cluster
- To create an OpenShift cluster, go to the Red Hat Hybrid Cloud console.
- Select Services -> Containers -> Create cluster.
The cm-cli tool

Procedure

Obtain the KUBECONFIG file from the managed cluster.
Open a shell prompt and login into the management hub cluster by using either of the following methods:
```
oc login
```
or
```
export KUBECONFIG=~/<path_to_kubeconfig>
```

Run the following command:

cm attach cluster --cluster <cluster-name> --cluster-kubeconfig <path-to-path_to_kubeconfig>

Next steps

Designate the new cluster as a managed cluster site

Optional: Deploying a managed cluster by using the `clusteradm` tool

Prerequistes

An OpenShift cluster
- To create an OpenShift cluster, go to the Red Hat Hybrid Cloud console.
- Select Services → Containers → Create cluster.
The clusteradm tool

Procedure

To deploy an edge cluster, you must to get the token from the management hub cluster. Run the following command on the existing management hub or datacenter cluster:
```
clusteradm get token
```
The command generates a token and shows you the command to use on the managed cluster.
Login to the managed cluster with either of the following methods:
```
oc login
```
or
```
export KUBECONFIG=~/<path_to_kubeconfig>
```

To request that the managed join the hub cluster, run the following command:

clusteradm join --hub-token <token_from_clusteradm_get_token_command> <managed_cluster_name>

Accept the join request on the hub cluster:

clusteradm accept --clusters <managed_cluster_name>

Next steps

Designate the new cluster as a managed cluster site

Designate the new cluster as a managed cluster site

If you use the command line tools such as clusteradm or cm-cli, you must explicitly indicate that the imported cluster is part of a specific clusterGroup. Some examples of clusterGroup are factory, devel, or prod.

To tag the cluster as clusterGroup=<managed-cluster-group>, complete the following steps.

Procedure

To find the new cluster, run the following command:

oc get managedcluster.cluster.open-cluster-management.io

To apply the label, run the following command:

oc label managedcluster.cluster.open-cluster-management.io/YOURCLUSTER site=managed-cluster

Verification

Go to your managed cluster (edge) OpenShift console and check for the open-cluster-management-agent pod being launched. It might take a while for the RHACM agent and agent-addons to launch. After that, the OpenShift GitOps Operator is installed. On successful installation, launch the OpenShift GitOps (ArgoCD) console from the top right of the OpenShift console.

Attach a managed cluster (edge) to the management hub

Understanding Red Hat Advanced Cluster Management requirements

Deploying a managed cluster by using Red Hat Advanced Cluster Management

Optional: Deploying a managed cluster by using cm-cli tool

Optional: Deploying a managed cluster by using the clusteradm tool

Designate the new cluster as a managed cluster site

Verification

Optional: Deploying a managed cluster by using `cm-cli` tool

Optional: Deploying a managed cluster by using the `clusteradm` tool