Argo CD アプリケーション

手順

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

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

   アプリケーション名

   spring-petclinic

   プロジェクト

   default

   同期ポリシー

   Automatic

   リポジトリー URL

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

   リビジョン

   HEAD

   パス

   app

   宛先

   https://kubernetes.default.svc

   namespace

   spring-petclinic

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   $ oc get application -n openshift-gitops

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

手順

1. Argo CD ダッシュボードで、アプリケーションに Synced ステータスがあることを確認します。
2. Argo CD ダッシュボードの app-spring-petclinic タイルをクリックし、クラスターにデプロイされたアプリケーションのリソースを表示します。
3. OpenShift Container Platform Web コンソールで、Developer パースペクティブに移動します。

4. Spring PetClinic デプロイメントを変更し、Git リポジトリーの app/ ディレクトリーに変更をコミットします。Argo CD は変更をクラスターに自動的にデプロイします。

   1. OpenShift GitOps 開始のリポジトリー をフォークします。
   2. deployment.yaml ファイルで failureThreshold の値を 5 に変更します。

   3. デプロイメントクラスターで、以下のコマンドを実行し、failureThreshold フィールドの値を確認します。

      $ oc edit deployment spring-petclinic -n spring-petclinic

      Copy to Clipboard Toggle word wrap

5. OpenShift Container Platform Web コンソールでアプリケーションを監視している間に、クラスターでデプロイメントを変更し、これを 2 つの Pod にスケールアップして自己修復動作をテストします。

   1. 以下のコマンドを実行してデプロイメントを変更します。

      $ oc scale deployment spring-petclinic --replicas 2  -n spring-petclinic

      Copy to Clipboard Toggle word wrap
   2. OpenShift Container Platform Web コンソールでは、デプロイメントは 2 つの Pod にスケールアップし、すぐに再び 1 つの Pod にスケールダウンすることに注意してください。Argo CD は Git リポジトリーとの差異を検知し、OpenShift Container Platform クラスターでアプリケーションを自動的に修復しました。
6. Argo CD ダッシュボードで、app-spring-petclinic タイル → APP DETAILS → EVENTS をクリックします。EVENTS タブには、以下のイベントが表示されます。Argo CD がクラスターのデプロイメントリソースが同期されていないことを検知し、Git リポジトリーを再同期してこれを修正します。

手順

1. Argo CD サーバーの admin アカウントのパスワードを取得します。

   $ ADMIN_PASSWD=$(oc get secret openshift-gitops-cluster -n openshift-gitops -o jsonpath='{.data.admin\.password}' | base64 -d)

   Copy to Clipboard Toggle word wrap

2. Argo CD サーバーの URL を取得します。

   $ SERVER_URL=$(oc get routes openshift-gitops-server -n openshift-gitops -o jsonpath='{.status.ingress[0].host}')

   Copy to Clipboard Toggle word wrap

3. admin アカウントのパスワードを使用して Argo CD サーバーにログインし、一重引用符で囲みます。

   重要

   パスワードを一重引用符で囲むと、$ などの特殊文字がシェルによって誤って解釈されなくなります。パスワードのリテラル値を囲むには常に一重引用符を使用してください。

   $ argocd login --username admin --password ${ADMIN_PASSWD} ${SERVER_URL}

   Copy to Clipboard Toggle word wrap

   例

   $ argocd login --username admin --password '<password>' openshift-gitops.openshift-gitops.apps-crc.testing

   Copy to Clipboard Toggle word wrap

4. すべてのアプリケーションを表示して、argocd コマンドをデフォルトモードで実行できることを確認します。

   $ argocd app list

   Copy to Clipboard Toggle word wrap

   設定が正しい場合は、既存のアプリケーションが次のヘッダーとともにリストされます。

   出力例

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

   Copy to Clipboard Toggle word wrap

5. デフォルトモードでアプリケーションを作成します。

   $ argocd app create app-spring-petclinic \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path app \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy automated \
       --self-heal \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

   Copy to Clipboard Toggle word wrap

6. openshif-gitops Argo CD インスタンスによって管理される spring-petclinic 宛先 namespace にラベルを付けます。

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

   Copy to Clipboard Toggle word wrap

7. 使用可能なアプリケーションをリストして、アプリケーションが正常に作成されたことを確認し、アプリケーションのステータスが Healthy および Synced になるまでコマンドを繰り返します。

   $ argocd app list

   Copy to Clipboard Toggle word wrap

手順

1. oc CLI ツールを使用して OpenShift Container Platform クラスターにログインします。

   $ oc login -u <username> -p <password> <server_url>

   Copy to Clipboard Toggle word wrap

   例

   $ oc login -u kubeadmin -p '<password>' https://api.crc.testing:6443

   Copy to Clipboard Toggle word wrap

2. コンテキストが kubeconfig ファイルで正しく設定されているかどうかを確認します。

   $ oc config current-context

   Copy to Clipboard Toggle word wrap

3. 現在のコンテキストのデフォルトの namespace を openshift-gitops に設定します。

   $ oc config set-context --current --namespace openshift-gitops

   Copy to Clipboard Toggle word wrap

4. 次の環境変数を設定して、Argo CD コンポーネント名をオーバーライドします。

   $ export ARGOCD_REPO_SERVER_NAME=openshift-gitops-repo-server

   Copy to Clipboard Toggle word wrap

5. すべてのアプリケーションを一覧表示して、core モードで argocd コマンドを実行できることを確認します。

   $ argocd app list --core

   Copy to Clipboard Toggle word wrap

   設定が正しい場合は、既存のアプリケーションが次のヘッダーとともにリストされます。

   出力例

   NAME CLUSTER NAMESPACE  PROJECT  STATUS  HEALTH   SYNCPOLICY  CONDITIONS  REPO PATH TARGET

   Copy to Clipboard Toggle word wrap

6. core モードでアプリケーションを作成します。

   $ argocd app create app-spring-petclinic --core \
       --repo https://github.com/redhat-developer/openshift-gitops-getting-started.git \
       --path app \
       --revision main \
       --dest-server  https://kubernetes.default.svc \
       --dest-namespace spring-petclinic \
       --directory-recurse \
       --sync-policy automated \
       --self-heal \
       --sync-option Prune=true \
       --sync-option CreateNamespace=true

   Copy to Clipboard Toggle word wrap

7. openshif-gitops Argo CD インスタンスによって管理される spring-petclinic 宛先 namespace にラベルを付けます。

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

   Copy to Clipboard Toggle word wrap

8. 使用可能なアプリケーションをリストして、アプリケーションが正常に作成されたことを確認し、アプリケーションのステータスが Healthy および Synced になるまでコマンドを繰り返します。

   $ argocd app list --core

   Copy to Clipboard Toggle word wrap