Chapter 3. Installing the GitOps CLI Important 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. Note 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 . 3.1. Installing the Red Hat OpenShift GitOps CLI on Linux For Linux distributions, you can download the GitOps argocd CLI as a tar.gz archive. Procedure Download the latest version of the CLI tool from the content gateway for your operating system and architecture. Operating system Architecture Tarball Linux x86_64, amd64 argocd-linux-amd64.tar.gz Linux on IBM zSystems and IBM(R) LinuxONE s390x argocd-linux-s390x.tar.gz Linux on IBM Power ppc64le argocd-linux-ppc64le.tar.gz Linux on ARM aarch64, arm64 argocd-linux-arm64.tar.gz Note Newer versions of the CLI tool are compatible with the older versions of Red Hat OpenShift GitOps server, but not vice versa. Extract the archive by running the following command: USD tar xvzf <file> Move the binary to a directory on your PATH environment variable by running the following command: USD sudo mv argocd /usr/local/bin/argocd Make the file executable by running the following command: USD sudo chmod +x /usr/local/bin/argocd After you install the GitOps argocd CLI, verify that it is available by running the following command: USD 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. 3.2. 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 by running the following command: # subscription-manager register Pull the latest subscription data by running the following command: # subscription-manager refresh List the available subscriptions by running the following command: # subscription-manager list --available --matches '*gitops*' In the output for the command, find the pool ID for your OpenShift Container Platform subscription, and attach the subscription to the registered system by running the following command: # subscription-manager attach --pool=<pool_id> Enable the repositories required by Red Hat OpenShift GitOps for RHEL version 8 or later by running the following command: Linux (x86_64, amd64) # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-x86_64-rpms" Example command # subscription-manager repos --enable="gitops-1.12-for-rhel-8-x86_64-rpms" Linux on IBM zSystems and IBM(R) LinuxONE (s390x) # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-s390x-rpms" Example command # subscription-manager repos --enable="gitops-1.12-for-rhel-8-s390x-rpms" Linux on IBM Power (ppc64le) # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-ppc64le-rpms" Example command # subscription-manager repos --enable="gitops-1.12-for-rhel-8-ppc64le-rpms" Linux on ARM (aarch64, arm64) # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-aarch64-rpms" Example command # subscription-manager repos --enable="gitops-1.12-for-rhel-8-aarch64-rpms" Install the openshift-gitops-argocd-cli package by running the following command: # yum install openshift-gitops-argocd-cli After you install the GitOps argocd CLI, verify that it is available by running the following command: USD 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. 3.3. Installing the Red Hat OpenShift GitOps CLI on Windows For Windows, you can download the GitOps argocd CLI as a compressed zip archive. Procedure Download the latest version of the CLI tool from the content gateway for your operating system and architecture. Operating system Architecture Tarball Windows x86_64 argocd-windows-amd64.zip Note Newer versions of the CLI tool are compatible with the older versions of Red Hat OpenShift GitOps server, but not vice versa. Extract the archive with a ZIP program. Move the binary to a directory on your PATH environment variable by running the following command: C:\> move argocd.exe <directory> After you install the GitOps argocd CLI, verify that it is available by running the following command: USD 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. 3.4. Installing the Red Hat OpenShift GitOps CLI on macOS For macOS, you can download the GitOps argocd CLI as a tar.gz archive. Procedure Download the latest version of the CLI tool from the content gateway for your operating system and architecture. Operating system Architecture Tarball macOS on Intel x86_64 argocd-macos-amd64.tar.gz macOS on ARM arm64 argocd-macos-arm64.tar.gz Note Newer versions of the CLI tool are compatible with the older versions of Red Hat OpenShift GitOps server, but not vice versa. Extract the archive by running the following command: USD tar xvzf <file> Move the binary to a directory on your PATH environment variable by running the following command: USD sudo mv argocd /usr/local/bin/argocd Make the file executable by running the following command: USD sudo chmod +x /usr/local/bin/argocd After you install the GitOps argocd CLI, verify that it is available by running the following command: USD 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. 3.5. Additional resources Configuring the GitOps CLI Logging in to the Argo CD server in the default mode Basic GitOps argocd commands Installing Red Hat OpenShift GitOps Setting up a new Argo CD instance

Commands:
tar xvzf <file>
sudo mv argocd /usr/local/bin/argocd
sudo chmod +x /usr/local/bin/argocd
argocd version --client
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
subscription-manager register
subscription-manager refresh
subscription-manager list --available --matches '*gitops*'
subscription-manager attach --pool=<pool_id>
subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-x86_64-rpms"
subscription-manager repos --enable="gitops-1.12-for-rhel-8-x86_64-rpms"
subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-s390x-rpms"
subscription-manager repos --enable="gitops-1.12-for-rhel-8-s390x-rpms"
subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-ppc64le-rpms"
subscription-manager repos --enable="gitops-1.12-for-rhel-8-ppc64le-rpms"
subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-aarch64-rpms"
subscription-manager repos --enable="gitops-1.12-for-rhel-8-aarch64-rpms"
yum install openshift-gitops-argocd-cli
argocd version --client
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
C:\> move argocd.exe <directory>
argocd version --client
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
tar xvzf <file>
sudo mv argocd /usr/local/bin/argocd
sudo chmod +x /usr/local/bin/argocd
argocd version --client
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