Chapter 3. Managing the application resources in non-control plane namespaces

Procedure

1. In the Administrator perspective of the web console, click Operators Installed Operators.
2. From the Project list, select the project where the user-defined cluster-scoped Argo CD instance is installed.
3. Select Red Hat OpenShift GitOps from the installed Operators list and go to the Argo CD tab.
4. Click your user-defined cluster-scoped Argo CD instance.

5. Configure the ArgoCD CR of your user-defined cluster-scoped Argo CD instance with the target namespaces:

   1. Click the YAML tab and edit the YAML file of the ArgoCD CR.

   2. In the ArgoCD CR, set the value of the sourceNamespaces parameter to include the non-control plane namespaces:

      Example ArgoCD CR

      apiVersion: argoproj.io/v1beta1
      kind: ArgoCD
      metadata:
        name: example 1
        namespace: spring-petclinic 2
      spec:
        sourceNamespaces: 3
          - dev 4
          - app-team-* 5

      1

      The name of the user-defined cluster-scoped Argo CD instance.

      2

      The namespace where you want to run the user-defined cluster-scoped Argo CD instance.

      3

      The list of non-control plane namespaces for creating and managing Application resources.

      4

      The name of the target namespace for the Argo CD server to create and manage Application resources.

      5

      With wildcards (*), specifies the name of the target namespaces matching the pattern app-team-*, such as app-team-1 and app-team-2, for the Argo CD server to create and manage Application resources.

   3. Click Save and Reload.

      Note

      When a target namespace is specified under the sourceNamespaces field, the Operator adds the argocd.argoproj.io/managed-by-cluster-argocd label to the specified namespace.

      Example dev target namespace

      apiVersion: v1
      kind: Namespace
      metadata:
        name: dev
        labels:
          argocd.argoproj.io/managed-by-cluster-argocd: spring-petclinic 1
          kubernetes.io/metadata.name: dev 2

      1

      The namespace of the user-defined cluster-scoped Argo CD instance.

      2

      The target namespace for the Argo CD server to create and manage Application resources.

6. Verify that Operator adds the argocd.argoproj.io/managed-by-cluster-argocd label to the specified namespace:

   1. Go to Administration Namespaces and click Create Namespace.

   2. In the Create Namespace dialog box, provide the Name and click Create.

      For example, to create dev target namespace, enter dev in the Name field. You can repeat the previous steps to create the app-team-1 and app-team-2 target namespaces.

      The Namespaces page displays the created target namespaces.

   3. Click the target namespace and go to the YAML tab to verify the argocd.argoproj.io/managed-by-cluster-argocd label added by the Operator.

7. Verify that your user-defined cluster-scoped Argo CD instance is configured with a cluster role to manage cluster-scoped resources:

   1. Go to User Management Roles and from the Filter list, select Cluster-wide Roles.

   2. Search for the created cluster roles by using the Search by name field. For example, example-spring-petclinic-argocd-application-controller and example-spring-petclinic-argocd-server.

      The Roles page displays the created cluster roles.

   3. Verify that the following role-based access control (RBAC) resources are created by the GitOps Operator:

      Name	Kind	Purpose
      <argocd_name>-<argocd_namespace>-argocd-application-controller	ClusterRole and ClusterRoleBinding	For the Argo CD Application Controller to watch and list Application resources at cluster-level
      <argocd_name>-<argocd_namespace>-argocd-server	ClusterRole and ClusterRoleBinding	For the Argo CD Server to watch and list Application resources at cluster-level
      <argocd_name>-<target_namespace>	Role and RoleBinding	For the Argo CD server to manage Application resources in target namespace through the UI, API, or CLI

Procedure

1. Create and configure a user-defined AppProject instance in the openshift-gitops control plane namespace to specify the target namespaces in the .spec.sourceNamespaces field:

   1. From the Project list, select the openshift-gitops project.
   2. In the Administrator perspective of the web console, click Operators Installed Operators Red Hat OpenShift GitOps and go to the AppProject tab.

   3. Click Create AppProject and enter the following configuration in the YAML view:

      Example user-defined AppProject instance

      kind: AppProject
      apiVersion: argoproj.io/v1alpha1
      metadata:
        name: project-one 1
        namespace: openshift-gitops 2
      spec:
        sourceNamespaces: 3
        - dev 4
        - app-team-* 5
        destinations: 6
          - name: '*'
            namespace: '*'
            server: '*'
         sourceRepos: 7
          - '*'

      1

      The name of the user-defined AppProject instance.

      2

      The control plane namespace where you want to run the user-defined AppProject instance.

      3

      The list of non-control plane namespaces for creating and managing Application resources.

      4

      The name of the target namespace for the Argo CD server to create and manage Application resources.

      5

      With wildcards (*), specifies the name of the target namespaces matching the pattern app-team-*, such as app-team-1 and app-team-2, for the Argo CD server to create and manage Application resources.

      6

      References to the clusters and namespaces into which applications within the user-defined AppProject instance can deploy.

      7

      References to the repositories from which applications within the user-defined AppProject instance can pull manifests.

   4. Click Create.

      The AppProjects page displays the created user-defined AppProject instance.

Procedure

1. Create and configure the Application CR with the parameters for the metadata.namespace and .spec.project fields to reference the target namespace and user-defined AppProject instance:

   1. From the Project list, select the target namespace.
   2. In the Administrator perspective of the web console, click Operators Installed Operators Red Hat OpenShift GitOps and go to the Application tab.

   3. Click Create Application and enter the following configuration in the YAML view:

      Example user-defined AppProject instance

      kind: Application
      apiVersion: argoproj.io/v1alpha1
      metadata:
        name: cluster-configs 1
        namespace: dev 2
      spec:
        project: project-one 3
        # ...

      1

      The name of the application.

      2

      The name of the target namespace for the Argo CD server to create and manage Application resources.

      3

      The name of the user-defined AppProject instance.

   4. Click Create.

      The Applications page displays the created application.

      The cluster-configs Argo CD application now has the statuses Healthy and Synced.