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

      Copy to Clipboard Toggle word wrap

      出力例

      namespace/<namespace> labeled

      Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   出力例

   namespace/openshift-gitops-operator created

   Copy to Clipboard Toggle word wrap

   注記

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

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

   Copy to Clipboard Toggle word wrap

   出力例

   namespace/<namespace> labeled

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   3

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

   4

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

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

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

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get pods -n openshift-gitops

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                                      	  READY   STATUS    RESTARTS   AGE
   cluster-785cfc5f75-669wq                                      1/1     Running   0          76s
   gitops-plugin-6664c749dd-dx64s                                1/1     Running   0          76s
   openshift-gitops-application-controller-0                     1/1     Running   0          74s
   openshift-gitops-applicationset-controller-549d7f6686-wzckt   1/1     Running   0          74s
   openshift-gitops-dex-server-5d4ffdb9b9-lb7b7                  1/1     Running   0          74s
   openshift-gitops-redis-6d65c94d4b-k9l8k                       1/1     Running   0          75s
   openshift-gitops-repo-server-79db854c58-279jr                 1/1     Running   0          75s
   openshift-gitops-server-f488b848-xntbc                        1/1     Running   0          75s

   Copy to Clipboard Toggle word wrap

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

   $ oc get pods -n openshift-gitops-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                                            READY   STATUS    RESTARTS   AGE
   openshift-gitops-operator-controller-manager-6fdc5cd9dc-jr9mn   2/2     Running   0          41s

   Copy to Clipboard Toggle word wrap

手順

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 ツールを コンテンツゲートウェイ からダウンロードします。

   Expand

   オペレーティングシステム	アーキテクチャー	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

   Show more
   注記

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

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

   $ tar xvzf <file>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

5. GitOps argocd CLI をインストールしたら、次のコマンドを実行して、使用可能であることを確認します。

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   出力例

   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

   Copy to Clipboard Toggle word wrap

   1

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

手順

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

   # subscription-manager register

   Copy to Clipboard Toggle word wrap

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

   # subscription-manager refresh

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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"

     Copy to Clipboard Toggle word wrap

     コマンドの例

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

     コマンドの例

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

     Copy to Clipboard Toggle word wrap

   • Linux on IBM Power (ppc64le)

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

     Copy to Clipboard Toggle word wrap

     コマンドの例

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

     Copy to Clipboard Toggle word wrap

   • ARM 上の Linux (aarch64、arm64)

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

     Copy to Clipboard Toggle word wrap

     コマンドの例

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

     Copy to Clipboard Toggle word wrap

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

   # yum install openshift-gitops-argocd-cli

   Copy to Clipboard Toggle word wrap

7. GitOps argocd CLI をインストールしたら、次のコマンドを実行して、使用可能であることを確認します。

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   出力例

   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

   Copy to Clipboard Toggle word wrap

   1

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

手順

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

   Expand

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

   Show more
   注記

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

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

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

   C:\> move argocd.exe <directory>

   Copy to Clipboard Toggle word wrap

4. GitOps argocd CLI をインストールしたら、次のコマンドを実行して、使用可能であることを確認します。

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   出力例

   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

   Copy to Clipboard Toggle word wrap

   1

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

手順

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

   Expand

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

   Show more
   注記

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

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

   $ tar xvzf <file>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

5. GitOps argocd CLI をインストールしたら、次のコマンドを実行して、使用可能であることを確認します。

   $ argocd version --client

   Copy to Clipboard Toggle word wrap

   出力例

   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

   Copy to Clipboard Toggle word wrap

   1

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