- 概要
- 要件
- インストール前
- インストール
- インストール後
- 移行とアップグレード
- 監視とアラート機能
- クラスターの管理
- 製品固有の設定
- トラブルシューティング
- 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 で作成されたワークロードのリソース要求と制限を設定する
EKS のバックアップと復元
EKS の Automation Suite の Velero のバックアップと復元手順を設定します。
Amazon EKS は、Kubernetes クラスターリソースと永続ボリュームを保護し、既存または新規の EKS クラスターへのポリシーベースの復元を可能にする AWS Backup によるバックアップと復元をサポートしています。詳しくは、「 Amazon EKS のバックアップ」をご覧ください。
AWS Backup に加えて、 Velero などの Kubernetes ネイティブ ツールを使用して EKS クラスター リソースをバックアップおよび復元できます。特に、ユースケースとコンプライアンス要件に合わせて、より詳細な Kubernetes レベルの制御またはカスタム バックアップ ポリシーを必要とするシナリオで使用します。
詳しくは、以下の AWS リソースをご覧ください。
EKS の Automation Suite では、主に次の 2 種類のストレージが使用されます。
- Amazon EBS (Elastic Block Store) - Kubernetes ワークロードにブロックレベルのストレージを提供します。
- Amazon EFS (Elastic File System) - 同時接続アクセスが必要なワークロード向けに共有ファイル ストレージを提供します。
ストレージの種類とクロスリージョンの障害復旧の両方をサポートするには、UiPath は Velero File System Backup (FSB) を Amazon S3 およびクロスリージョン レプリケーション (CRR) と共に使用することをお勧めします。
この構成では、バックアップは指定された S3 バケットに保存され、CRR は回復性のためにセカンダリ AWS リージョンに自動的にレプリケートします。
前提条件
Velero を設定する前に、次の前提条件が満たされていることを確認してください。
- Velero のインストール: Helm または Velero CLI を使用して、EKS クラスターに Velero をデプロイする必要があります。
- IAM のアクセス許可: Amazon S3 への書き込みに必要なアクセス許可を Velero サービス アカウントに付与する必要があります。
- S3 バケット: バージョニングを有効にした Amazon S3 バケットを作成する必要があります。
セットアップ手順について詳しくは、 公式の「Velero File System Backup セットアップ ガイド」をご覧ください。
Velero ポリシーを設定する
Velero は、バックアップに含めるリソースとボリュームを決定する柔軟なポリシーをサポートしています。Velero のバックアップ ポリシーの設定について詳しくは、 Velero の公式 ドキュメントをご覧ください。
バックアップ ポリシーを定義する際は、次のガイドラインを考慮してください。
- PVC の除外:
velero.io/exclude-from-backup: "true"のラベルが付いたすべてのPersistentVolumeClaim(PVC) を除外する必要があります。Velero は、バックアップ プロセス中にこのラベルが付いた PVC をスキップします。 - ファイル・システム・バックアップの構成: ファイル・システム・バックアップは、サポートされているストレージ・クラスを使用するPVCに適用する必要があります。次のストレージ クラスでは、ファイル システムのバックアップがサポートされています。
- EFS ストレージ クラス (
efs-sc) - EBS ストレージ クラス (
ebs-sc)次のサンプル ポリシーを使用して、これらのストレージ クラスの除外とファイル システムのバックアップを構成します。
policy: | version: v1 volumePolicies: - conditions: pvcLabels: velero.io/exclude-from-backup: "true" action: type: skip - conditions: csi: driver: efs.csi.aws.com storageClass: - efs-sc action: type: fs-backup - conditions: csi: driver: ebs.csi.aws.com storageClass: - ebs-sc action: type: fs-backuppolicy: | version: v1 volumePolicies: - conditions: pvcLabels: velero.io/exclude-from-backup: "true" action: type: skip - conditions: csi: driver: efs.csi.aws.com storageClass: - efs-sc action: type: fs-backup - conditions: csi: driver: ebs.csi.aws.com storageClass: - ebs-sc action: type: fs-backup - EFS ストレージ クラス (
- バックアップ先: ファイルシステムのバックアップでは、すべてのバックアップデータが設定された Amazon S3 バケットにアップロードされます。クロスリージョンレプリケーション (CRR) が有効な場合、バックアップはリージョン間で自動的にレプリケートされ、回復性が向上します。
バックアップと復元を実行する
Velero でバックアップを作成するには、以下の手順を実行します。
- Velero のバックアップ ガイドに従います。
- バックアップ・カスタム・リソース(CR)を構成して、バックアップに含まれるネームスペースおよびリソースを定義します。
Automation Suite の名前空間には、自動的に created-by=uipathのラベルが付けられます。このキーでラベル付けされた名前空間のみを含めることで、UiPath 関連の名前空間のみを選択的にバックアップできます。これにより、UiPath 固有のすべてのリソースが安全にバックアップされます。
詳しくは、「 Velero のリソース フィルター」をご覧ください。
バックアップからワークロードを復元するには:
- Velero の復元ガイドに従います。
- バックアップ・リソースとターゲット・リソースを指定するリストア・カスタム・リソース(CR)を参照します。
Cluster Autoscaler が有効化されているクラスターで復元すると、Velero で部分的な復元の失敗が報告されることがあります。次のようなエラーが表示される場合があります node-agent pod is not running in node: daemonset pod not found in running state in node。
この問題が発生した場合は、 podvolumerestore (PVR) オブジェクトのステータスを確認する必要があります。すべての PVR に Successが表示されている場合は、復元が成功したと見なすことができます。