- 概要
- 要件
- インストール前
- インストール
- インストール後
- 移行とアップグレード
- 監視とアラート機能
- クラスターの管理
- 製品固有の設定
- トラブルシューティング
- Azure Government への接続に失敗したため、バックアップのセットアップが機能しない
- カスタム ノード taint を有効化すると uipath 名前空間のポッドがスタックする
- プロキシ設定がある場合に Automation Hub と Apps を起動できない
- Velero のバックアップが FailedValidation エラーで失敗する
- 外部シークレットのトラブルシューティング
- Temporal as a Service のトラブルシューティング
- TLS 証明書の検証が有効化されていると、AI Center と Document Understanding ポッドの起動に失敗する
- TLS 証明書の検証エラー
- Fluentd では、IPv6 環境ではログはエクスポートされません
- デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- uipathctl で作成されたワークロードのリソース要求と制限を設定する
GitOps ツールのインストールと構成
EKS/AKS の Automation Suite 用の ArgoCD GitOps ツールをインストールして構成します。
ArgoCD のインストールと構成に進む前に、Istio をインストールし、必要なすべての権限を uipathadmin サービス アカウントに付与する必要があります。
For the service mesh installation and configuration instructions, refer to Installing and configuring the service mesh.
For the installation permissions, refer to Granting installation permissions.
If you cannot grant admin privileges to the Automation Suite installer, you must bring your own ArgoCD for the Automation Suite deployment. For details, refer to Provisioning ArgoCD.
ArgoCD をプロビジョニングする
Automation Suite インストーラーに管理者権限を付与できない場合は、独自の ArgoCD を使用して、次の構成手順を実行する必要があります。
input.jsonファイルのargocdセクションでapplication_namespaceパラメーターに正しい値を指定します。これはアプリケーションが作成される名前空間であり、理想的には ArgoCD をインストールする名前空間である必要があります。- If you install Automation Suite on a shared cluster, we recommend creating a new ArgoCD project dedicated to Automation Suite rather than using the default project. For details on how to create a project in ArgoCD, refer to Creating a project in ArgoCD.
- Configure the Helm repository in ArgoCD. For details, refer to Configuring the Helm repository in ArgoCD.
- Grant the necessary permissions on the ArgoCD namespace. For details, refer to Granting the necessary permissions on the ArgoCD namespace.
ArgoCD でプロジェクトを作成する
ArgoCD UI で新しいプロジェクトを作成するには、次の手順に従います。
- ArgoCD にログインします。
- [設定] > [プロジェクト] > + [新しいプロジェクト] に移動します。
- プロジェクトの名前と説明を入力します。
- 次の宛先を追加します。
- 名前空間として「
<uipath>」と入力し、サーバーとして「https://kubernetes.default.svc」と入力します。 - 名前空間として「
<istio-system>」と入力し、サーバーとして「https://kubernetes.default.svc」と入力します。
- 名前空間として「
<argocd>名前空間をsourceNamespacesに追加します。注:以前の ArgoCD リリースでは、
sourceNamespacesは UI に表示されません。
宣言によって ArgoCD プロジェクトを作成することもできます。
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
name: <project-name>
namespace: <argocd-namespace>
spec:
description: App project to manage and deploy uipath applications
clusterResourceWhitelist:
- group: '*'
kind: '*'
destinations:
- namespace: <uipath>
server: https://kubernetes.default.svc
- namespace: <istio-system>
server: https://kubernetes.default.svc
sourceNamespaces:
- <argocd-namespace>
sourceRepos:
- '*'
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
name: <project-name>
namespace: <argocd-namespace>
spec:
description: App project to manage and deploy uipath applications
clusterResourceWhitelist:
- group: '*'
kind: '*'
destinations:
- namespace: <uipath>
server: https://kubernetes.default.svc
- namespace: <istio-system>
server: https://kubernetes.default.svc
sourceNamespaces:
- <argocd-namespace>
sourceRepos:
- '*'
ArgoCD で Helm リポジトリを設定する
ArgoCD に Helm リポジトリを構成するには、次の手順に従います。
- ArgoCD にログインします。
- [設定] > [リポジトリ] > +[CONNECT REPO] に移動します。
- 接続方法には VIA HTTPS を使用します。
- タイプとして [ Helm ] を選択します。
- 名前を入力します。
- プロジェクトとして [ UiPath ] を選択します。uipath は、UiPath® アプリケーション用に作成した ArgoCD プロジェクトの名前です。
- リポジトリの URL、ユーザー名、パスワード、証明書の情報を入力します。
- 「OCI」チェック・ボックスを選択します。
- [接続] を選択します。
- 接続ステータスが [成功] であることを確認します。
ArgoCD 名前空間で必要な権限を付与する
ArgoCD 名前空間で必要な権限を付与するには、次の手順に従います。
-
<argocd>名前空間でシークレットを作成および編集するロールを作成します。apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: argo-secret-role namespace: <argocd> rules: - apiGroups: ["rbac.authorization.k8s.io"] resources: ["roles", "rolebindings"] verbs: ["*"] - apiGroups: ["*"] resources: ["secrets"] verbs: ["get", "watch", "list", "patch", "update", "create"]apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: argo-secret-role namespace: <argocd> rules: - apiGroups: ["rbac.authorization.k8s.io"] resources: ["roles", "rolebindings"] verbs: ["*"] - apiGroups: ["*"] resources: ["secrets"] verbs: ["get", "watch", "list", "patch", "update", "create"] -
argo-secret-roleロールをuipathadminサービス アカウントにバインドします。kubectl -n <argocd> create rolebinding secret-binding \ --role=argo-secret-role --serviceaccount=<uipath>:uipathadminkubectl -n <argocd> create rolebinding secret-binding \ --role=argo-secret-role --serviceaccount=<uipath>:uipathadmin -
<argocd>名前空間でアプリケーションを管理するロールを作成します。apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: uipath-application-manager namespace: <argocd> rules: - apiGroups: - argoproj.io resources: - applications verbs: - "*"apiVersion: rbac.authorization.k8s.io/v1 kind: Role metadata: name: uipath-application-manager namespace: <argocd> rules: - apiGroups: - argoproj.io resources: - applications verbs: - "*" -
uipath-application-managerロールをuipathadminサービス アカウントにバインドします。kubectl create rolebinding uipath-application-manager-rolebinding --role=uipath-application-manager --serviceaccount=<uipath>:uipathadmin -n <argocd>kubectl create rolebinding uipath-application-manager-rolebinding --role=uipath-application-manager --serviceaccount=<uipath>:uipathadmin -n <argocd> -
<argocd>名前空間の名前空間閲覧者ロールをuipathadminサービス アカウントにバインドします。kubectl -n <argocd> create rolebinding namespace-reader-rolebinding \ --clusterrole=namespace-reader-clusterrole --serviceaccount=<uipath>:uipathadminkubectl -n <argocd> create rolebinding namespace-reader-rolebinding \ --clusterrole=namespace-reader-clusterrole --serviceaccount=<uipath>:uipathadmin