ストレージ

Automation Suite クラスターには、Microsoft SQL Server 以外に、ファイルを保存するストレージ コンポーネントも必要です。 Automation Suite では、選択するサービスの種類に応じて ObjectStore とブロック/ファイル ストレージが必要です。

各 Automation Suite コンポーネントのストレージの推定値

UiPath® Platform サービス

以下のサービスにはストレージ コンポーネントが必要です。これらは、各サービスを Automation Suite のインストール時または後から有効化した場合にのみ必要です。

サービス	ストレージの種類	目的	estimate
Orchestrator	Object Store	デプロイされるオートメーションの NuGet オートメーション パッケージ キューとそのデータ	通常、パッケージは 5 MB であり、バケット (ある場合) は 1 MB 未満です。成熟した大企業では、約 10 GB のパッケージと 12 GB のキューをデプロイしています。
Action Center	Object Store	ユーザーがドキュメント タスクに保存するドキュメント	通常、ドキュメントには 0.15 MB、入力フォームには追加で 0.15 KB が必要です。 成熟した大企業では、これは合計 4 GB になる可能性があります。
Test Manager	Object Store	ユーザーが保存する添付ファイルとスクリーンショット	通常、すべてのファイルと添付ファイルの合計は最大で約 5 GB です。
Insights	Blockstore	パブリッシュされたダッシュボードとそのメタデータ	有効化に 2 GB が必要で、ストレージ フットプリントはこの数字に応じて増加します。大手企業規模のデプロイでは、すべてのダッシュボード用にさらに数 GB が必要です。約 10 GB のストレージで十分です。
Integration Service	Object Store	コネクタのメタデータ イベント トリガー	コネクタのサイズはさまざまですが、利用可能なすべてのコネクタをインストールした場合の消費額は 100 MB 未満です。 トリガー イベントの数は使用状況によって異なりますが、5 GB で十分です。
Studio Web	ファイル ストア	指定したフィード (UiPath のオフィシャル フィード、api.nuget.org) からダウンロードされた NuGet パッケージ Studio Web で作成またはインポートしたプロジェクト	NuGet パッケージ: 220 GB ユーザー プロジェクト: 50 GB
Apps (アプリ)	Object Store	Apps にアップロードされる添付ファイル	通常、データベースには約 5 GB が必要で、一般的な複雑なアプリは約 15 MB を消費します。
AI Center	オブジェクト ストア/ファイル ストア	ML パッケージ 分析対象のデータセット トレーニング パイプライン	代表的な実証済みのインストールでは、5 つのパッケージに 8 GB、データセットに追加で 1 GB を消費します。 パイプラインが追加で 50 GB のブロック ストレージを消費することがありますが、アクティブに実行されている場合だけです。
Document Understanding	Object Store	ML モデル OCR モデル 保存されるドキュメント	成熟したデプロイでは、12 GB が ML モデルに、17 GB が OCR に、50 GB がすべての保存済みドキュメントに使用されます。
Task Mining	Object Store	分析および自動化パターンの提案にはユーザー アクティビティ データが必要です	意味のある自動化を提案するには、約 200 GB のアクティビティ ログ データを分析する必要があります。ただし、反復的な作業では、必要なデータは大幅に少なくなる場合があります。
Automation Suite ロボット	ファイル ストア	オートメーションの実行に必要なパッケージのキャッシュ	通常、成熟した企業では約 10 GB のパッケージをデプロイします。
Process Mining	Object Store	SQL ウェアハウスでクエリを実行するために必要な SQL ファイル	最小フットプリントは SQL ファイルの保存にのみ使用します。当初は約 1 GB のストレージで十分です。

共有されるスイート サービス

以下の共有スイート サービスにはストレージ コンポーネントが必要です。これらは、Automation Suite の一部として各サービスのインストールを有効化した場合にのみ必要です。

サービス	ストレージの種類	目的	estimate
監視	ブロック ストレージ	Kubernetes およびインフラストラクチャ関連のメトリック データ	過去 10 日間の監視データを保存する場合、約 100 GB
ログ	ブロック ストレージ	アプリケーション実行ログ	過去数日間のログを保持する場合、約 20 GB

Object Store

Automation Suite では、次の ObjectStore がサポートされています。

Kubernetes	Object Store	サポートされている認証
EKS	Amazon S3	AWS インスタンス プロファイル アクセス キーとシークレット キー
AKS	Azure ストレージ (BLOB)	アカウント キー ワークロード ID *

^*Insights と Task Mining は現在、認証にワークロード ID をサポートしていません。

CORS ポリシーの設定

また、Automation Suite クラスターの使用中に S3 接続で CORS 関連のエラーが発生する場合は、ストレージ アカウント/バケット レベルで次の CORS ポリシーを有効化しなければならない場合があります。

次の CORS ポリシーの {{fqdn}} は、Automation Suite クラスターの FQDN に置き換えてください。

次のサンプルは、JSON 形式の CORS ポリシーを示しています。

JSON

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "GET",
            "HEAD",
            "DELETE",
            "PUT"
        ],
        "AllowedOrigins": [
            "https://{{fqdn}}"
        ],
        "ExposeHeaders": [
            "etag",
            "x-amz-server-side-encryption",
            "x-amz-request-id",
            "x-amz-id-2"
        ],
        "MaxAgeSeconds": 3000
    }
]

次のサンプルは、XML 形式の CORS ポリシーを示しています。

XML

<CORSConfiguration>
 <CORSRule>
   <AllowedOrigin>{{fqdn}}</AllowedOrigin>
   <AllowedMethod>HEAD</AllowedMethod>
   <AllowedMethod>GET</AllowedMethod>
   <AllowedMethod>PUT</AllowedMethod>
   <AllowedMethod>POST</AllowedMethod>
   <AllowedMethod>DELETE</AllowedMethod>
   <AllowedHeader>*</AllowedHeader>
  <MaxAgeSeconds>3000</MaxAgeSeconds>
  <ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
  <ExposeHeader>x-amz-request-id</ExposeHeader>
  <ExposeHeader>x-amz-id-2</ExposeHeader>
  <ExposeHeader>etag</ExposeHeader>
 </CORSRule>
</CORSConfiguration>

構成

ObjectStore を構成するには、「 外部 ObjectStore の構成」をご覧ください。

注:

コンテナーは Azure Storage アカウントのスコープ内に作成されるため、サービスごとに別々のコンテナーを使用することをお勧めします。

同様に AWS では、Automation Suite にインストールしたサービスごとに専用のバケットを使用することを強くお勧めします。ただし、バケットをグローバルに作成すると、サービスごとに専用のバケットを提供する際に制限が生じる可能性があります。この場合は、単一のバケットを構成し、それをすべての目的に使用できます。

make 権限を付与すれば、Automation Suite インストーラーでコンテナー/バケットを作成できます。または、インストール前に必要なコンテナー/バケットをプロビジョニングし、その情報をインストーラーに指定できます。

Integration Service に必要なバケット

AKS のインストールでは、Azure Storage に複数の BLOB ストレージ バケットを作成する必要があります。 この手順は、単一のバケットを使用する EKS インストールでは不要です。

インストール前に、次のバケットを手動で作成する必要があります。

• gallupx-poller-data
• gallupx-job-engine-state
• gallupx-notification-objects
• gallupx-webhook
• gallupx-execution-trace

ストレージ要件

ストレージ	要件
Object Store	500 GB

ObjectStore のサイズは、デプロイ済みおよび実行中のオートメーションのサイズによって異なります。したがって、インストール開始時点で ObjectStore の正確な推定値を提供するのは困難な場合があります。ObjectStore のサイズは 350 GB から 500 GB から開始できます。ObjectStore の使用量を理解するには、 Automation Suite の各コンポーネントのストレージの推定値をご覧ください。

注:

• オートメーションがスケールするのに応じて、ObjectStore のサイズの増加の検討が必要になる可能性があります。

ブロック ストレージ

ブロック ストレージには、Kubernetes ストレージ クラスを設定した CSI ドライバーが必要です。

次の表に、ブロック ストレージ、ストレージ クラス、プロビジョナーの詳細を示します。

クラウド / Kubernetes	ストレージ	ストレージ クラス	プロビジョナー
AWS	EBS ボリューム	ebs-sc	ebs.csi.aws.com
Azure	Azure Manage Disk	managed-premium Premium LRS ディスク	disk.csi.azure.com

構成

AWS および Azure の公式ガイドに従って、EKS および AKS のクラスターにストレージ クラスを作成できます。

クラスター用に作成したストレージ クラスの名前を input.json ファイルの storage_class パラメーターに渡す必要があります。

注:

• 場合によっては、EKS または AKS クラスターによって CSI ドライバーがインストールされ、ストレージ クラスが提供されることがあります。 そのストレージ クラスが構成されていない場合は、Automation Suite のインストール前に構成する必要があります。
• 次の例に示すように、ブロック ストレージのストレージ クラスを既定のクラスにする必要があります。

例

次の例は、ストレージ クラスを設定する方法と、インストール時にそれを ファイルに指定する方法 input.json 示しています。

構成	input.json	ストレージ クラス
Azure	{ "storage_class": "managed_premium" }	allowVolumeExpansion: true apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: creationTimestamp: "2023-06-15T09:34:17Z" labels: addonmanager.kubernetes.io/mode: EnsureExists kubernetes.io/cluster-service: "true" storageclass.kubernetes.io/is-default-class: "true" name: managed-premium parameters: cachingmode: ReadOnly kind: Managed storageaccounttype: Premium_LRS provisioner: disk.csi.azure.com reclaimPolicy: Delete volumeBindingMode: WaitForFirstConsumer
AWS	{ "storage_class": "ebs-sc" }	allowVolumeExpansion: true apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: ebs-sc annotations: storageclass.kubernetes.io/is-default-class: "true" provisioner: ebs.csi.aws.com reclaimPolicy: Delete volumeBindingMode: WaitForFirstConsumer

ストレージ要件

構成	要件
ブロック ストレージ	50 GB

ブロック ストアのサイズは、デプロイ済みおよび実行中のオートメーションのサイズによって異なります。したがって、インストール開始時点で正確な推定値を提供するのは困難な場合があります。50 GB のブロック ストレージのサイズから開始できます。ブロック ストアの使用量を理解するには、 Automation Suite の各コンポーネントのストレージの推定値をご覧ください。

注:

オートメーションがスケールするのに応じて、ブロック ストレージのサイズの増加の検討が必要になる可能性があります。

ファイル ストレージ

ファイル ストレージには、Kubernetes ストレージ クラスを設定した CSI ドライバーが必要です。

クラウド / Kubernetes	ストレージ	ストレージ クラス	プロビジョナー
AWS	EFS	efs-sc	efs.csi.aws.com
Azure	Azure Files	azurefile-csi-premium*	file.csi.azure.com

• AKS の Studio Web には azurefile-csi-premium ストレージ クラスを使用します。
• 高可用性を確保するために、Studio Web ストレージの ZRS (またはレプリケーション) を構成することをお勧めします。

構成

AWS および Azure の公式ガイドに従って、EKS および AKS のクラスターにストレージ クラスを作成できます。

クラスター用に作成したストレージ クラスの名前を input.json ファイルの storage_class_single_replica パラメーターに渡す必要があります。

注:

場合によっては、EKS または AKS クラスターによって CSI ドライバーがインストールされ、ストレージ クラスが提供されることがあります。 このストレージ クラスが構成されていない場合は、Automation Suite のインストール前に構成する必要があります。

例

次の例は、ストレージ クラスを設定する方法と、インストール時にそれを input.json に指定する方法を示しています。

構成	input.json	StorageClass
Azure	{ "storage_class_single_replica": "azurefile-csi-premium" }	allowVolumeExpansion: true apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: labels: addonmanager.kubernetes.io/mode: EnsureExists kubernetes.io/cluster-service: "true" name: azurefile-csi mountOptions: - mfsymlinks - actimeo=30 - nosharesock - dir_mode=0700 - file_mode=0700 - uid=1000 - gid=1000 - nobrl - cache=none parameters: skuName: Standard_LRS provisioner: file.csi.azure.com reclaimPolicy: Delete volumeBindingMode: Immediate
AWS	{ "storage_class_single_replica": "efs-sc" }	allowVolumeExpansion: true apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: efs-sc parameters: basePath: /dynamic_provisioning directoryPerms: "700" fileSystemId: $(EFS_ID) gidRangeEnd: "2000" gidRangeStart: "1000" provisioningMode: efs-ap provisioner: efs.csi.aws.com reclaimPolicy: Delete volumeBindingMode: Immediate $(EFS_ID) は、インフラストラクチャのプロビジョニング時に作成した実際のファイル共有 ID に置き換えます。

注:

ファイル共有のストレージ クラスでは、ディレクトリとファイルに対して必要な権限を 700 に設定する必要があります。

さらに、Azure の場合は UID と GID を 1000 に設定し、AWS の場合は gidRangeStart と gidRangeEnd をそれぞれ 1000 と 2000 に設定する必要があります。

ストレージ要件

ストレージ	要件
ファイル ストレージ	510 GB

ファイル ストアのサイズは、デプロイ済みおよび実行中のオートメーションのサイズによって異なります。したがって、インストール開始時点で実際の推定値を提供するのは困難な場合があります。ただし、トレーニング パイプラインを同時に 10 個実行し、Automation Suite ロボットを使用するには、約 510 GB のストレージ サイズを予想しておけば良いでしょう。ファイル ストアの使用量を理解するには、 Automation Suite の各コンポーネントのストレージの推定値をご覧ください。

注:

オートメーションがスケールするのに応じて、ファイル ストレージのサイズの増加の検討が必要になる可能性があります。

キュー

インストール前に、クラウド プロバイダーに以下のキューを手動で作成する必要があります。 これらのキューは、イベントと Webhook をサポートするために必要です。

• gallupx-debug-engine-tasks
• gallupx-engine-tasks
• gallupx-cron-tasks
• gallupx-tick-tasks
• gallupx-event-tasks
• gallupx-notification-tasks
• gallupx-webhook-engine-tasks
• gallupx-fps-engine-tasks

EKS の Automation Suite の場合は、次の例に示すように、特定のプレフィックスをキューに手動で追加する必要があります。

• <queuePrefix>-gallupx-debug-engine-tasks
• <queuePrefix>-gallupx-engine-tasks
• <queuePrefix>-gallupx-cron-tasks
• <queuePrefix>-gallupx-tick-tasks
• <queuePrefix>-gallupx-event-tasks
• <queuePrefix>-gallupx-notification-tasks
• <queuePrefix>-gallupx-webhook-engine-tasks
• <queuePrefix>-gallupx-fps-engine-tasks

queuePrefix値は、EKS input.jsonで使用される必須の queue_prefix パラメーターの値と一致する必要があります。

Amazon Simple Queue Service (SQS) を使用する場合は、8 つのデッドレターキュー (DLQ) を追加で作成する必要があります。各 DLQ を対応するプライマリ キューに関連付ける必要があります。

gallupx-engine-tasksを除く各キューを以下の設定で設定する必要があります。

• メッセージ保持期間: 14 日
• 最大メッセージ サイズ: 256 KB
• 配信不能キュー: 有効
• 既定の可視性タイムアウト: 30 秒

以下を除き、 gallupx-engine-tasks キューを同じ設定で構成する必要があります。

• デフォルトの可視性タイムアウト:15分

次の例に示すように、合計 18 のキュー、9 つのプライマリ キュー、および 9 つの関連する配信不能キューが必要です。

prefix-gallupx-core  
prefix-gallupx-core-deadletter  
prefix-gallupx-cron-tasks  
prefix-gallupx-cron-tasks-deadletter  
prefix-gallupx-debug-engine-tasks  
prefix-gallupx-debug-engine-tasks-deadletter  
prefix-gallupx-engine-tasks  
prefix-gallupx-engine-tasks-deadletter  
prefix-gallupx-event-tasks  
prefix-gallupx-event-tasks-deadletter  
prefix-gallupx-fps-engine-tasks  
prefix-gallupx-fps-engine-tasks-deadletter  
prefix-gallupx-notification-tasks  
prefix-gallupx-notification-tasks-deadletter  
prefix-gallupx-tick-tasks  
prefix-gallupx-tick-tasks-deadletter  
prefix-gallupx-webhook-engine-tasks  
prefix-gallupx-webhook-engine-tasks-deadletter

バックアップと復元

Automation Suite クラスターをバックアップするには、クラスター構成とユーザー データをバックアップするための ObjectStore が追加で必要です。

次の表で、バックアップでサポートされるストレージについて説明します。

Kubernetes	Object Store
EKS	AWS S3
AKS	Azure Storage アカウント

注:

バックアップを保存するには、独立した ObjectStore を使用することをお勧めします。

ストレージの認証

AKS からストレージ アカウントへのワークロード ID ベースのアクセス

ワークロード ID の一般的な情報については、「 ワークロード ID の構成」を参照してください。

ワークロード ID を使用するようにストレージ アカウントを設定するには、次のコマンドを実行します。

az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Account Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Blob Data Owner" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"
az role assignment create --assignee $userAssignedManagedIdentityObjectId --role "Storage Queue Data Contributor" --scope "/subscriptions/$($infraJson.subscription_id)/resourceGroups/$(TARGET_RG)/providers/Microsoft.Storage/storageAccounts/$(STORAGE_ACCOUNT_NAME)"

以下のサンプルは、Azure Storage アカウントの有効な input.json 設定を示しています。

"external_object_storage": {
  "enabled": true,
  "storage_type": "azure",
  "account_name": "storaccid5730469",
  "azure_fqdn_suffix": "core.windows.net",
  "use_managed_identity": false,
  "use_workload_identity": true
},