Skip to content

Configure Argo CD

Configure your Argo CD instance for team access and Git repositories after installation.

Prerequisites

  • Argo CD installed using the Install Argo CD guide
  • Access to your OpenShift cluster

Configure User Access

You will need to configure RBAC policies to give yourself and your team access to the default Argo CD instance.

Update RBAC Policy

  1. Open Argo CD configuration - Go to OperatorsInstalled Operators

  2. Click Red Hat OpenShift GitOps

  3. Click the Argo CD tab

  4. Click on the openshift-gitops instance

  5. Click the YAML tab

  6. Find your team groups - Navigate to User ManagementGroups and look for groups that match your team structure (groups are automatically synchronized from Developer Platform)

  7. Update RBAC permissions - Find the rbac section and modify it to add your teams:

    rbac:
      defaultPolicy: 'role:readonly'
      policy: |
        g, system:cluster-admins, role:admin
        g, cluster-admins, role:admin
        g, your-team-name, role:admin  # Add your team here
    

  8. Save the changes - Click Save at the bottom of the YAML editor

Configure Git Repositories

To connect Argo CD to your Git repositories and configure authentication for private repositories, use credential templates which allow you to define repository credentials once and reuse them across multiple repositories:

Credential Templates - Argo CD Documentation

Access Argo CD

Now that user access is configured, you can access the Argo CD instance:

  1. Click the Application Launcher (9-dot grid icon) in the top-right corner of the OpenShift Console
  2. Click on Cluster Argo CD
  3. On the Argo CD login page, click Login via OpenShift

Next Steps

With Argo CD configured, you can now: