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

GitOps ベースの継続的デリバリー用に ArgoCD を使用して Automation Suite の Kubernetes クラスターを管理します。

概要

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 の管理者アカウント

重要:

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

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

• デバッグ目的でのみパラメーターを変更する (たとえば、自己修復の無効化や Rancher での YAML の編集など)
• ポッドを削除する
• Kerberos 認証を更新する
• トラブルシューティング
• Orchestrator のカスタム構成を管理する (例: テナントごとに暗号化キーを設定する)
• データベースの接続文字列を更新する
• Prometheus メトリックを外部システムにエクスポートする
• 復元後に Insights の Looker ポッドが起動しない場合: クラスターをバックアップおよび復元する
• アプリケーションを同期する
  注:

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

ArgoCD にアクセスする

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

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

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

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

読み取り専用権限を持つユーザーは、ArgoCD ポータルから作成できます。ただし、これらのユーザーはアップグレード時に保持されないため、再作成する必要があります。

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

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

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

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

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

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

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

   重要:

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

SSO 認証

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

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