サポートコンソール開発者トライアルの開始お問い合わせ

このコンテンツは選択した言語では利用できません。

Chapter 3. Installing the GitOps CLI

Use the GitOps argocd CLI tool to configure and manage Red Hat OpenShift GitOps and Argo CD resources from the command line. You can install it on Linux, macOS, and Windows.

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

  1. Download the GitOps argocd CLI for your operating system and architecture from one of the following locations:

    • Red Hat Developer content gateway

    • Red Hat OpenShift mirror site

      Operating systemArchitectureTarball

      Linux

      x86_64, amd64

      argocd-linux-amd64.tar.gz

      Linux on IBM zSystems and IBM® 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.

  2. Extract the archive by running the following command: 

    $ tar xvzf <file>

  3. Move the binary to a directory on your PATH environment variable by running the following command: 

    $ sudo mv argocd /usr/local/bin/argocd

  4. Make the file executable by running the following command: 

    $ sudo chmod +x /usr/local/bin/argocd

  5. 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.19.0, release: 0015022024

    where:

    ExtraBuildInfo: openshift-gitops-version
    Specifies 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

  1. Register with Red Hat Subscription Manager by running the following command: 

    # subscription-manager register

  2. Pull the latest subscription data by running the following command: 

    # subscription-manager refresh

  3. List the available subscriptions by running the following command: 

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

  4. 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 by running the following command: 

    # subscription-manager attach --pool=<pool_id>

  5. 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.21-for-rhel-8-x86_64-rpms"

    • Linux on IBM zSystems and IBM® LinuxONE (s390x) 

      # subscription-manager repos --enable="gitops-<gitops_version>-for-rhel-<rhel_version>-s390x-rpms"

      Example command: 

      # subscription-manager repos --enable="gitops-1.21-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.21-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.21-for-rhel-8-aarch64-rpms"

  6. Install the openshift-gitops-argocd-cli package by running the following command: 

    # yum install openshift-gitops-argocd-cli

  7. 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.19.0, release: 0015022024

    where:

    ExtraBuildInfo: openshift-gitops-version
    Specifies 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

  1. Download the GitOps argocd CLI for your operating system and architecture from one of the following locations:

  2. Extract the archive with a ZIP program.

  3. Move the binary to a directory on your PATH environment variable by running the following command: 

    C:\> move argocd.exe <directory>

  4. 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: windows/amd64
  ExtraBuildInfo: openshift-gitops-version: 1.19.0, release: 0015022024

    where:

    ExtraBuildInfo: openshift-gitops-version
    Specifies 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

  1. Download the GitOps argocd CLI for your operating system and architecture from one of the following locations:

    • Red Hat Developer content gateway

    • Red Hat OpenShift mirror site

      Operating systemArchitectureTarball

      macOS on Intel

      x86_64

      argocd-darwin-amd64.tar.gz

      macOS on ARM

      arm64

      argocd-darwin-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.

  2. Extract the archive by running the following command: 

    $ tar xvzf <file>

  3. Move the binary to a directory on your PATH environment variable by running the following command: 

    $ sudo mv argocd /usr/local/bin/argocd

  4. Make the file executable by running the following command: 

    $ sudo chmod +x /usr/local/bin/argocd

  5. 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: darwin/amd64
  ExtraBuildInfo: openshift-gitops-version: 1.19.0, release: 0015022024

    where:

    ExtraBuildInfo: openshift-gitops-version
    Specifies the build information of Red Hat OpenShift GitOps built by Red Hat.
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る