5.7. クラスター設定を使用したアプリケーションのデプロイによる OpenShift クラスターの設定

手順

1. Web コンソールの Administrator パースペクティブで、Operators Installed Operators Red Hat OpenShift GitOps Subscription に移動します。
2. Actions ドロップダウンメニューをクリックし、Edit Subscription をクリックします。

3. openshift-gitops-operator サブスクリプションの詳細ページの YAML タブで、Argo CD インスタンスの namespace を仕様セクションの ARGOCD_CLUSTER_CONFIG_NAMESPACES 環境変数に追加して、spec セクションの Subscription YAML ファイルを編集します。

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
     namespace: openshift-operators
   ...
   spec:
     config:
       env:
       - name: ARGOCD_CLUSTER_CONFIG_NAMESPACES
         value: openshift-gitops, <list of namespaces of cluster-scoped Argo CD instances>
   ...

4. Argo インスタンスがクラスタースコープのリソースを管理するクラスターロールで設定されていることを確認するには、次の手順を実行します。

   1. User Management Roles に移動し、Filter ドロップダウンメニューから Cluster-wide Roles を選択します。

   2. Search by name フィールドを使用して、argocd-application-controller を検索します。

      Roles ページには、作成されたクラスターロールが表示されます。

      ヒント

      あるいは、OpenShift CLI で次のコマンドを実行します。

      oc auth can-i create oauth -n openshift-gitops --as system:serviceaccount:openshift-gitops:openshift-gitops-argocd-application-controller

      出力 yes は、Argo インスタンスがクラスタースコープのリソースを管理するクラスターロールで設定されていることを確認します。それ以外の場合は、設定を確認し、必要に応じて必要な手順を実行します。

手順

1. 既存のノードにラベルを付けます。

   $ oc label node <node-name> node-role.kubernetes.io/infra=""

2. オプション: 必要な場合は、テイントを適用し、インフラストラクチャーノードでワークロードを分離し、他のワークロードがそれらのノードでスケジュールされないようにすることもできます。

   $ oc adm taint nodes -l node-role.kubernetes.io/infra \
   infra=reserved:NoSchedule infra=reserved:NoExecute

3. GitOpsService カスタムリソースに runOnInfra トグルを追加します。

   apiVersion: pipelines.openshift.io/v1alpha1
   kind: GitopsService
   metadata:
     name: cluster
   spec:
     runOnInfra: true

4. オプション: テイントがノードに追加された場合は、tolerations を GitOpsService カスタムリソースに追加します。以下に例を示します。

     spec:
       runOnInfra: true
       tolerations:
       - effect: NoSchedule
         key: infra
         value: reserved
       - effect: NoExecute
         key: infra
         value: reserved

5. コンソール UI の Pod を Pods Pod details で表示して、openshift-gitops namespace のワークロードがインフラストラクチャーノードでスケジュールされていることを確認します。

手順

1. Argo CD ダッシュボードで、New App をクリックして新規の Argo CD アプリケーションを追加します。

2. このワークフローでは、以下の設定で cluster-configs アプリケーションを作成します。

   アプリケーション名

   cluster-configs

   プロジェクト

   default

   同期ポリシー

   Manual

   リポジトリー URL

   https://github.com/redhat-developer/openshift-gitops-getting-started

   リビジョン

   HEAD

   パス

   cluster

   宛先

   https://kubernetes.default.svc

   Namespace

   spring-petclinic

   ディレクトリーの再帰処理

   checked

3. Create をクリックしてアプリケーションを作成します。
4. Web コンソールの Administrator パースペクティブで、左側のメニューにある Administration Namespaces に移動します。
5. namespace を検索、選択してから Label フィールドに argocd.argoproj.io/managed-by=openshift-gitops を入力し、openshift-gitops namespace にある Argo CD インスタンスが namespace を管理できるようにします。

手順

1. サンプルアプリケーション をダウンロードします。

   $ git clone git@github.com:redhat-developer/openshift-gitops-getting-started.git

2. アプリケーションを作成します。

   $ oc create -f openshift-gitops-getting-started/argo/app.yaml

3. oc get コマンドを実行して、作成されたアプリケーションを確認します。

   $ oc get application -n openshift-gitops

4. アプリケーションがデプロイされている namespace にラベルを追加し、openshift-gitops namespace の Argo CD インスタンスが管理できるようにします。

   $ oc label namespace spring-petclinic argocd.argoproj.io/managed-by=openshift-gitops

手順

1. Argo CD ダッシュボードでは、cluster-configs Argo CD アプリケーションに Missing および OutOfSync のステータスがあることに注意してください。アプリケーションは手動の同期ポリシーで設定されているため、Argo CD はこれを自動的に同期しません。
2. cluster-configs タイルの 同期 をクリックし、変更を確認してから、Synchronize をクリックします。Argo CD は Git リポジトリーの変更を自動的に検出します。設定が変更されると、Argo CD は cluster-configs のステータスを OutOfSync に変更します。Argo CD の同期ポリシーを変更し、Git リポジトリーからクラスターに変更を自動的に適用できるようにします。
3. cluster-configs Argo CD アプリケーションに Healthy および Synced のステータスがあることに注意してください。cluster-configs タイルをクリックし、クラスター上で同期されたリソースおよびそれらのステータスの詳細を確認します。
4. OpenShift Container Platform Web コンソールに移動し、 をクリックして Red Hat Developer Blog - Kubernetes へのリンクが表示されることを確認します。

5. Project ページに移動し、spring-petclinic namespace を検索し、これがクラスターに追加されていることを確認します。

   クラスター設定がクラスターに正常に同期されます。

手順

1. 管理者として OpenShift Container Platform Web コンソールにログインします。

2. Web コンソールで、User Management Roles Create Role を選択します。以下の ClusterRole YAML テンプレートを使用してルールを追加し、追加のパーミッションを指定します。

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRole
   metadata:
     name: secrets-cluster-role
   rules:
   - apiGroups: [""]
     resources: ["secrets"]
     verbs: ["*"]

3. Create をクリックしてクラスターロールを追加します。
4. ここで、クラスターのロールバインディングを作成します。Web コンソールで、User Management Role Bindings Create Binding を選択します。
5. プロジェクト ドロップダウンから すべてのプロジェクト を選択します。
6. Create binding をクリックします。
7. Binding type を Cluster-wide role binding (ClusterRoleBinding) として選択します。
8. RoleBinding name の一意の値を入力します。
9. ドロップダウンリストから、新しく作成したクラスターロールまたは既存のクラスターロールを選択します。

10. Subject を ServiceAccount として選択し、サブジェクトの namespace と 名前 を指定します。

    1. Subject namespace: openshift-gitops
    2. Subject name: openshift-gitops-argocd-application-controller

11. Create をクリックします。ClusterRoleBinding オブジェクトの YAML ファイルは以下のとおりです。

    kind: ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
      name: cluster-role-binding
    subjects:
      - kind: ServiceAccount
        name: openshift-gitops-argocd-application-controller
        namespace: openshift-gitops
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: admin