ArgoCD でクラスターを管理する

概要

ArgoCD は、Kubernetes 用の宣言的な GitOps 継続的デリバリー ツールです。ArgoCD は Kubernetes コントローラーとして設計されており、UiPath® の実行中のアプリケーションを継続的に監視し、現在のステートを Docker レジストリで指定された目的のターゲット ステートと照合して確認します。詳細については、 ArgoCD のドキュメントをご覧ください。

管理者は、クラスター、構成、アプリケーションのステータス、健全性の概要すべてをシンプルな UI または CLI で確認できます。ArgoCD には、HA と非 HA の両方の設定をサポートする、専用のオープンソース バンドル版の Redis が付属します。

Automation Suite では、ArgoCD を以下のシナリオで使用します。

• ファブリック コンポーネントと UiPath® のコア サービスをインストールおよびアップグレードする。
• 指定したターゲット環境への、目的のアプリケーションのステートのデプロイを自動化する。ArgoCD は、目的とするアプリケーションのステートを定義するための信頼できる情報源として Git/helm リポジトリを使用する GitOps パターンに従います。
• インストールのステートを追跡する。インストールが特定の時点で失敗し、しばらくしてからインストールを再開する場合、ArgoCD は、既に同期済みのステップをすべてスキップし、失敗した時点から再開します。
• アプリケーションを自己回復する。誤っていずれかのオブジェクトを削除した場合、マニフェストが自動的に同期されます。

ArgoCD アカウントの種類

ArgoCD では、次の 2 つのアカウントの種類がサポートされています。

• 読み取り専用アカウント
• 管理者アカウント

ArgoCD の読み取り専用アカウント

ArgoCD の読み取り専用アカウントは、次の基本シナリオで使用できます。

• すべてのアプリ、ポッド、サービスをシンプルなインターフェイスで可視化
• すべてのアプリ、ポッド、サービスの健全性を監視する
• デプロイ内の問題を迅速に特定する
• クラスター内でアプリケーションを再同期する

ArgoCD の管理者アカウント

重要:

このセクションに記載されているもの以外の設定やパラメーターは一切変更しないでください。

ArgoCD の管理者アカウントは、次の高度なシナリオで使用できます。

• デバッグ目的でのみパラメーターを変更する。たとえば、自己回復機能を無効化し、YAML を Rancher で編集する場合などです。

• ポッドを削除する

• Updating Kerberos authentication;

• トラブルシューティング

• Orchestrator のカスタム構成を管理する。たとえば、「テナントごとに暗号化キーを設定する」の場合などです。

• データベースの接続文字列を更新する。

• Exporting Prometheus metrics to an external system: Using the monitoring stack;

• If Insights looker pod fails to start after restore: Backing up and restoring the cluster;

• アプリケーションを同期する

  注:

  高度な構成を UI 上で削除または変更する前に、必ず UiPath® の適切なドキュメントを確認してください。

ArgoCD にアクセスする

ArgoCD では、次の 2 つの認証方法がサポートされています。

• username and password – default authentication method
• SSO– recommended authentication method. You can enable SSO authentication post-installation. For instructions, see Enabling SSO for ArgoCD

ユーザー名とパスワードによる認証

ArgoCD の読み取り専用アカウントにアクセスする

ユーザー名とパスワードを使用して ArgoCD の読み取り専用アカウントにアクセスするには、次の手順に従います。

1. URL: https://alm.${CONFIG_CLUSTER_FQDN} にアクセスします。

2. ユーザー名「argocdro」を入力します。

3. パスワードにアクセスします。

   kubectl get secrets/argocd-initial-admin-secret -n argocd \
   -o "jsonpath={.data['password']}" | base64 --decode
   

4. パスワードを入力します。

   重要:

   読み取り専用アカウントでは、同期強制または同期置換を実行するオプションが既定で提供されているアプリケーションを同期できます。この同期では、名前空間がパージされ、リソースが削除される可能性があります。同期強制または同期置換を使用しないことを強くお勧めします。

   

ArgoCD の管理者アカウントにアクセスする

ユーザー名とパスワードを使用して ArgoCD の管理者アカウントにアクセスするには、次の手順に従います。

1. URL: https://alm.${CONFIG_CLUSTER_FQDN} にアクセスします。

2. ユーザー名「admin」を入力します。

3. パスワードにアクセスします。

   kubectl get secrets/argocd-admin-password -n argocd \
   -o "jsonpath={.data['password']}" | echo $(base64 -d)
   

4. パスワードを入力します。

   重要:

   ArgoCD の管理者アカウントは、高度なシナリオにのみ使用する必要があります。注意して使用しないと、クラスターに対して破壊的な操作が実行される可能性があります。

SSO 認証

SSO を使用して ArgoCD にアクセスするには、次の手順に従います。

1. ArgoCD のログイン ページで [SSO] ボタンを選択します。
2. 会社のドメイン資格情報を入力します。