GitOps のインストール

手順

1. Web コンソールの Administrator パースペクティブを開き、Operators → OperatorHub に移動します。
2. OpenShift GitOps を検索し、Red Hat OpenShift GitOps タイルをクリックし、Install をクリックします。

3. Install Operator ページで以下を行います。

   1. Update channel を選択します。
   2. インストールする GitOps Version を選択します。

   3. Installed Namespace を選択します。デフォルトのインストール namespace は openshift-gitops-operator です。

      注記

      GitOps バージョン 1.10 以降では、デフォルトの namespace が openshift-operators から openshift-gitops operator に変更されました。

   4. Enable Operator recommended cluster monitoring on this Namespace チェックボックスを選択して、クラスターのモニタリングを有効にします。

      注記

      openshift.io/cluster-monitoring=true ラベルを適用して、任意の namespace でクラスターモニタリングを有効にできます。

      $ oc label namespace <namespace> openshift.io/cluster-monitoring=true

      出力例

      namespace/<namespace> labeled

4. Install をクリックし、GitOps Operator を OpenShift Container Platform クラスターで利用可能にします。

   Red Hat OpenShift GitOps は、クラスターのすべての namespace にインストールされます。

5. Red Hat OpenShift GitOps Operator が、Operators → Installed Operators に一覧表示されていることを確認します。Status は Succeeded に解決されるはずです。

手順

1. openshift-gitops-operator namespace を作成します。

   $ oc create ns openshift-gitops-operator

   出力例

   namespace/openshift-gitops-operator created

   注記

   openshift.io/cluster-monitoring=true ラベルを適用することで、openshift-gitops-operator または任意の namespace でクラスターモニタリングを有効にできます。

   $ oc label namespace <namespace> openshift.io/cluster-monitoring=true

   出力例

   namespace/<namespace> labeled

2. OperatorGroup オブジェクト YAML ファイルを作成します (例: gitops-operator-group.yaml)。

   OperatorGroup の例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-gitops-operator
   spec:
     upgradeStrategy: Default

3. OperatorGroup をクラスターに適用します。

   $ oc apply -f gitops-operator-group.yaml

   出力例

   operatorgroup.operators.coreos.com/openshift-gitops-operator created

4. Subscription オブジェクトの YAML ファイルを作成し、namespace を Red Hat OpenShift GitOps Operator にサブスクライブします (例: openshift-gitops-sub.yaml)。

   Subscription の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-gitops-operator
   spec:
     channel: latest 1
     installPlanApproval: Automatic
     name: openshift-gitops-operator 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   1

   Operator のサブスクライブ元のチャネル名を指定します。

   2

   サブスクライブする Operator の名前を指定します。

   3

   Operator を提供する CatalogSource の名前を指定します。

   4

   CatalogSource の namespace。デフォルトの OperatorHub CatalogSource には openshift-marketplace を使用します。

5. Subscription をクラスターに適用します。

   $ oc apply -f openshift-gitops-sub.yaml

   出力例

   subscription.operators.coreos.com/openshift-gitops-operator created

6. インストールが完了したら、openshift-gitops namespace のすべての Pod が実行されていることを確認します。

   $ oc get pods -n openshift-gitops

   出力例

   NAME                                                      	  READY   STATUS    RESTARTS   AGE
   cluster-b5798d6f9-zr576                                   	  1/1 	  Running   0          65m
   openshift-gitops-application-controller-0                 	  1/1 	  Running   0          53m
   openshift-gitops-applicationset-controller-6447b8dfdd-5ckgh       1/1 	  Running   0          65m
   openshift-gitops-dex-server-569b498bd9-vf6mr                      1/1     Running   0          65m
   openshift-gitops-redis-74bd8d7d96-49bjf                   	  1/1 	  Running   0          65m
   openshift-gitops-repo-server-c999f75d5-l4rsg              	  1/1 	  Running   0          65m
   openshift-gitops-server-5785f7668b-wj57t                  	  1/1 	  Running   0          53m

7. openshift-gitops-operator namespace の Pod が実行されていることを確認します。

   $ oc get pods -n openshift-gitops-operator

   出力例

   NAME                                                            READY   STATUS    RESTARTS   AGE
   openshift-gitops-operator-controller-manager-664966d547-vr4vb   2/2     Running   0          65m

手順

1. Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動し、Red Hat OpenShift GitOps Operator がインストールされていることを確認します。
2. メニュー → OpenShift GitOps → Cluster Argo CD の順に移動します。Argo CD UI のログインページは、新規ウィンドウに表示されます。

3. オプション: OpenShift Container Platform の認証情報でログインするには、cluster-admins グループのユーザーであることを確認してから、Argo CD ユーザーインターフェイスで LOG IN VIA OPENSHIFT オプションを選択します。

   注記

   cluster-admins グループのユーザーになるには、oc adm groups new cluster-admins <user> コマンドを使用します。この場合の <user> は、クラスター全体またはローカルでユーザーおよびグループにバインドできるデフォルトのクラスターロールです。

4. Argo CD インスタンスのパスワードを取得します。

   1. ナビゲーションパネルを使用して、Workloads → Secrets ページに移動します。
   2. Project ドロップダウンリストを使用して、Argo CD インスタンスが作成される namespace を選択します。
   3. パスワードを表示するには、<argo_CD_instance_name>-cluster インスタンスを選択します。
   4. Details タブで、Data → admin.password の下にあるパスワードをコピーします。
5. Username に admin を使用し、Password にはコピーしたパスワードを使用して、新しいウィンドウで Argo CD UI にログインします。

手順

1. ご使用のオペレーティングシステムとアーキテクチャーに応じた最新バージョンの CLI ツールを コンテンツゲートウェイ からダウンロードします。

   オペレーティングシステム	アーキテクチャー	Tarball
   Linux	x86_64、amd64	argocd-linux-amd64.tar.gz
   Linux on IBM zSystems および IBM® LinuxONE	s390x	argocd-linux-s390x.tar.gz
   Linux on IBM Power	ppc64le	argocd-linux-ppc64le.tar.gz
   ARM 上の Linux	aarch64、arm64	argocd-linux-arm64.tar.gz

   注記

   新しいバージョンの CLI ツールは、古いバージョンの Red Hat OpenShift GitOps サーバーと互換性がありますが、その逆は当てはまりません。

2. 次のコマンドを実行してアーカイブを抽出します。

   $ tar xvzf <file>

3. 次のコマンドを実行して、バイナリーを PATH 環境変数のディレクトリーに移動します。

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

4. 次のコマンドを実行して、ファイルを実行可能にします。

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

5. 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

   1

   Red Hat によってビルドされた Red Hat OpenShift GitOps のビルド情報。

手順

1. 次のコマンドを実行して、Red Hat Subscription Manager に登録します。

   # subscription-manager register

2. 次のコマンドを実行して、最新のサブスクリプションデータを取得します。

   # subscription-manager refresh

3. 次のコマンドを実行して、利用可能なサブスクリプションをリスト表示します。

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

4. 前のコマンドの出力で、OpenShift Container Platform サブスクリプションのプール ID を見つけ、次のコマンドを実行して、登録済みのシステムにサブスクリプションをアタッチします。

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

5. 次のコマンドを実行して、Red Hat OpenShift GitOps for RHEL バージョン 8 以降に必要なリポジトリーを有効にします。

   • Linux (x86_64, amd64)

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

     コマンドの例

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

   • Linux on IBM zSystems および IBM® LinuxONE (s390x)

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

     コマンドの例

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

   • Linux on IBM Power (ppc64le)

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

     コマンドの例

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

   • ARM 上の Linux (aarch64、arm64)

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

     コマンドの例

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

6. 次のコマンドを実行して、openshift-gitops-argocd-cli パッケージをインストールします。

   # yum install openshift-gitops-argocd-cli

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

   1

   Red Hat によってビルドされた Red Hat OpenShift GitOps のビルド情報。

手順

1. ご使用のオペレーティングシステムとアーキテクチャーに応じた最新バージョンの CLI ツールを コンテンツゲートウェイ からダウンロードします。

   オペレーティングシステム	アーキテクチャー	Tarball
   Windows	x86_64	argocd-windows-amd64.zip

   注記

   新しいバージョンの CLI ツールは、古いバージョンの Red Hat OpenShift GitOps サーバーと互換性がありますが、その逆は当てはまりません。

2. ZIP プログラムでアーカイブを展開します。

3. 次のコマンドを実行して、バイナリーを PATH 環境変数のディレクトリーに移動します。

   C:\> move argocd.exe <directory>

4. 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

   1

   Red Hat によってビルドされた Red Hat OpenShift GitOps のビルド情報。

手順

1. ご使用のオペレーティングシステムとアーキテクチャーに応じた最新バージョンの CLI ツールを コンテンツゲートウェイ からダウンロードします。

   オペレーティングシステム	アーキテクチャー	Tarball
   Intel 上の macOS	x86_64	argocd-macos-amd64.tar.gz
   ARM 上の macOS	arm64	argocd-macos-arm64.tar.gz

   注記

   新しいバージョンの CLI ツールは、古いバージョンの Red Hat OpenShift GitOps サーバーと互換性がありますが、その逆は当てはまりません。

2. 次のコマンドを実行してアーカイブを抽出します。

   $ tar xvzf <file>

3. 次のコマンドを実行して、バイナリーを PATH 環境変数のディレクトリーに移動します。

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

4. 次のコマンドを実行して、ファイルを実行可能にします。

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

5. 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

   1

   Red Hat によってビルドされた Red Hat OpenShift GitOps のビルド情報。