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 で編集する場合などです。
• ポッドを削除する
• Kerberos 認証を更新する
• トラブルシューティング
• Orchestrator のカスタム構成を管理する。たとえば、「テナントごとに暗号化キーを設定する」の場合などです。
• データベースの接続文字列を更新する。
• Prometheus メトリックを外部システムにエクスポートする: 「監視スタックを使用する」
• 復元後に Insights の Looker pod を起動できない場合: 「クラスターをバックアップおよび復元する」
• アプリケーションを同期する
  注: 高度な構成を UI 上で削除または変更する前に、必ず UiPath® の適切なドキュメントを確認してください。

ArgoCD にアクセスする

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

• ユーザー名とパスワード – 既定の認証方法です。
• SSO – 推奨される認証方法です。インストール後に SSO 認証を有効化できます。手順については、「ArgoCD の SSO を有効化する」をご覧ください。

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

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. 会社のドメイン資格情報を入力します。