Installing the GitOps CLI

Installing the Red Hat OpenShift GitOps CLI on Linux using an RPM
Additional resources

The Red Hat OpenShift GitOps argocd CLI tool is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.

Use the GitOps argocd CLI tool to configure and manage Red Hat OpenShift GitOps and Argo CD resources from the command line. The GitOps argocd CLI is designed to make GitOps computing tasks simple and concise. You can install the CLI tool on different platforms.

Both the compressed archives and the RPMs contain the argocd executable binary file. If you have an active OpenShift Container Platform subscription on your Red Hat account, install the CLI tool as an RPM by using a package manager, such as yum or dnf.

Installing the Red Hat OpenShift GitOps CLI on Linux using an RPM

For Red Hat Enterprise Linux (RHEL) version 8 or later, you can install the GitOps argocd CLI as an RPM by using a package manager, such as yum or dnf. This allows the GitOps argocd CLI version to be automatically managed by the system. For example, using a command such as dnf upgrade upgrades all packages, including argocd, if a new version is available.

Prerequisites

You have an active OpenShift Container Platform subscription on your Red Hat account.
You have root or sudo privileges on your local system.

Procedure

Register with Red Hat Subscription Manager:
```
# subscription-manager register
```
Pull the latest subscription data:
```
# subscription-manager refresh
```

List the available subscriptions:

# subscription-manager list --available --matches '*gitops*'

In the output for the previous command, find the pool ID for your OpenShift Container Platform subscription and attach the subscription to the registered system:
```
# subscription-manager attach --pool=<pool_id>
```

Enable the repositories required by Red Hat OpenShift GitOps:

For RHEL 8

Linux (x86_64, amd64)

# subscription-manager repos --enable="gitops-1.12-for-rhel-8-x86_64-rpms"

Linux on IBM zSystems and IBM® LinuxONE (s390x)

# subscription-manager repos --enable="gitops-1.12-for-rhel-8-s390x-rpms"

Linux on IBM Power (ppc64le)

# subscription-manager repos --enable="gitops-1.12-for-rhel-8-ppc64le-rpms"

Linux on ARM (aarch64, arm64)

# subscription-manager repos --enable="gitops-1.12-for-rhel-8-aarch64-rpms"

For RHEL 9

Linux (x86_64, amd64)

# subscription-manager repos --enable="gitops-1.12-for-rhel-9-x86_64-rpms"

Linux on IBM zSystems and IBM® LinuxONE (s390x)

# subscription-manager repos --enable="gitops-1.12-for-rhel-9-s390x-rpms"

Linux on IBM Power (ppc64le)

# subscription-manager repos --enable="gitops-1.12-for-rhel-9-ppc64le-rpms"

Linux on ARM (aarch64, arm64)

# subscription-manager repos --enable="gitops-1.12-for-rhel-9-aarch64-rpms"

Install the openshift-gitops-argocd-cli package:
```
# yum install openshift-gitops-argocd-cli
```

After you install the GitOps argocd CLI, verify that it is available by running the following command:

$ argocd version --client

Example output

argocd: v2.9.5+f943664
  BuildDate: 2024-02-15T05:19:27Z
  GitCommit: f9436641a616d277ab1f98694e5ce4c986d4ea05
  GitTreeState: clean
  GoVersion: go1.20.10
  Compiler: gc
  Platform: linux/amd64
  ExtraBuildInfo: openshift-gitops-version: 1.12.0, release: 0015022024 (1)

1	The build information of Red Hat OpenShift GitOps built by Red Hat.

Installing the Red Hat OpenShift GitOps CLI on Linux using an RPM

Additional resources