手順 8: ディスクを構成する

Automation Suite をインストールする前に必要な、ディスクのパーティション設定と LVM の構成のリファレンスです。

Automation Suite のインストール実行前に、LVM を使用してディスクのパーティション設定と構成を行い、データ移行やデータ損失が生じることなく、ディスク サイズを容易に変更できるようにする必要があります。

ディスクのパーティションを設定する

RHEL マシンの既定のパーティション構成は、Kubernetes のインストールには適していません。Kubernetes のインフラストラクチャは、通常 /var パーティション下にインストールされ、このパーティションには既定で 8 GB しか割り当てられていないためです。

注:

• サポート対象のディスク フォーマットは ext4 または xfs です。
• パーティションは、すべて LVM を使用して作成し、クラスターのデータが異なるディスク上にある可能性があっても、一貫性のある表示を保証する必要があります。これは将来、データ移行のリスクやデータ損失なしに、パーティションのサイズを拡張できるようにするためにも役立ちます。
• すべてのポッドとアプリケーション ログは、 /var/log/pods ディレクトリに保存されます。 このディレクトリの容量が 8 GB 以上であることを確認してください。 また、毎日から毎週の間隔でログをローテーションするように logrotate を構成することをお勧めします。
• シングルノード RKE2 セットアップでクラスター内のストレージを使用する場合は、Ceph のデータ バックアップを保存するために、少なくとも 512 GB のディスク領域を追加で用意する必要があります。このディスクはインストール時に必要ですが、このディスクを使用するバックアップ cronJob はクラスターが完全にインストールされた後に構成する必要があります。詳しくは、「 インストール後の操作を実行する」をご覧ください。

オンライン インストールとオフライン インストールのディスク要件は同じですが、オフラインの UiPath® バンドルを解凍するために必要な領域が異なります。

RHEL OS の場合は、マシン上のマウント ポイントの最小サイズが、以下を満たすようにする必要があります。

ディスク ラベル	サーバー	オペレーター	パーティション	Size	目的
クラスター ディスク Document Understanding モダン プロジェクトを有効化する場合、最小サイズは 400 GB です。	✅	✅	/var/lib/rancher	190ギガバイト Document Understanding モダン プロジェクトが有効な場合、最小 334 GB	コンテナーのイメージとレイヤーを格納します。
			/var/lib/kubelet	56ギガバイト	シークレット、構成マップ、emptyDir などのランタイム Kubernetes 構成が格納されます。
			/opt/UiPathAutomationSuite	10 GB	インストーラーのバイナリを格納します。
etcd ディスク	✅	❌	/var/lib/rancher/rke2/server/db	16 GB	Kubernetes 用の分散データベースを格納します。
データ ディスク	✅	❌	/datadisk/insights	15ギガバイト	Insights に必要です。
			/datadisk/monitoring	50 GB	監視ツールに必要です。
			/datadisk/registry 1	200ギガバイト	Docker レジストリに必要です。
			/datadisk/objectstore 2	10 GB	ceph-mon に必要です。
ObjectStore2	✅	❌	N/A	512 GB	クラスター内の ObjectStore に必要です。
AI Center3	✅	✅	N/A	1 つのトレーニング パイプラインにつき最小 51 GB、推奨105 GB	AI Center をインストールする場合にのみ必要です。
UiPath® バンドル ディスク	✅	❌	/uipath	512 GB	オフライン バンドルを保存するためにオフライン インストールでのみ必要です。
Ceph のバックアップ	✅	❌	/backup	512 GB	Ceph データのバックアップを保存するために、クラスター内のストレージを使用するシングルノードの RKE2 設定でのみ必要です。

¹ これはクラスター内の Docker レジストリを指し、外部レジストリを使用する場合は適用されません。

² これはクラスター内の ObjectStore を指し、外部 ObjectStore を使用する場合は適用されません。

³ これは、AI Center のトレーニング パイプラインで必要なストレージを指します。このディスクは、AI Center のトレーニング パイプラインを実行する予定のマシンにのみ必要です。エージェント マシンにこのディスクをアタッチすることをお勧めします。

注:

各プロセスに公平にリソースが配分されるようにするため、前述のどの目的でも OS ディスクを使用しないことをお勧めします。

uipathctl を使用してディスクを構成する

ディスクの構成には uipathctl を使用することをお勧めします。次の例では 、 uipathctlを使用していますが、代わりに独自のツールを使用できます。

uipathctl をダウンロードする

uipathctl は as-installer.zip インストール パッケージの一部です。 uipathctlを使用するには、以下の手順に従います。

1. as-installer.zipをダウンロードし、一時的な場所に保存します。ダウンロード手順については、「 as-installer.zip」をご覧ください。

2. 次のコマンドを実行して内容を抽出します。

   unzip as-installer.zip -d installer
   

uipathctl を使用してディスクを構成する方法の詳細については、次のコマンドを実行してください。

./bin/uipathctl rke2 disk --help

すべてのマシンでクラスター ディスクを構成する

正しいディスクを特定するには、 lsblk を実行してすべてのブロック デバイスとそのサイズを一覧表示し、出力を ハードウェア要件の表のクラスター ディスク サイズと比較します。ディスクは、表に記載されている 3 つのマウントポイントすべてに対応するのに十分な容量である必要があります。

クラスター ディスクを構成するには、すべてのマシンで次のコマンドを実行します。

./bin/uipathctl rke2 disk --cluster-disk-name <name_of_cluster_disk>

すべてのサーバー マシンで etcd ディスクを構成する

etcd ディスクを構成するには、すべてのサーバー マシンで次のコマンドを実行します。

./bin/uipathctl rke2 disk --etcd-disk-name name_of_etcd_disk

重要:

etcd ディスクの構成は、クラスター ディスクの構成が完了した後にのみ実行する必要があります。

etcd ディスクはクラスター ディスク内にマウントされるため、設定の順序を維持する必要があります。

クラスター ディスクを構成する前にこの手順を実行すると、マシンの再起動時にデータが失われる可能性があります。カーネルは、最初にクラスター ディスク、etcd ディスクの順にディスクを自動的にマウントするためです。

すべてのサーバー マシンでデータ ディスクを構成する

データ ディスクを構成するには、使用する特定のディスクを特定する必要があります。lsblkコマンドを実行して、すべてのブロックデバイス、そのサイズ、およびマウントポイントを一覧表示します。ディスク サイズを使用して関連するディスクを特定します ( --volume フラグでは、512 GB のデータ ディスクを使用する必要があります)。

すべてのサーバー マシンで次のコマンドを実行し、要件に基づいて必要なフラグを指定します。

./bin/uipathctl rke2 disk --volume name_of_data_disk

フラグ	値 (Value)
-v|--volume	ディスク名の例: /dev/sde 監視、Insights、ObjectStore、レジストリ用のさまざまなマウントをホストするディスクにパーティションを設定するときに、ディスク名が必要です。 ディスクの初回構成では、ディスク名の指定が必須です。後続の実行時に指定されない場合は、uipathdatavg に関連付けられている既存のディスクを使用して、選択したコンポーネントのパーティションが作成されます。
--docker-registry	任意です。外部レジストリが利用できない場合にのみ必要です。
--monitoring	任意のフラグ。監視パーティション (Prometheus ストレージ) は必須であるため、最初の実行時にフラグが明示的に渡されなくても、自動的に作成されます。 ただしこのフラグは、後続の実行で --size フラグとともに監視用パーティションのサイズ変更時に必要になります。
--objectstore	任意のフラグ。外部の ObjectStore が利用できない場合にのみ必要です。使用すると、ceph-mon に必要な datadisk パーティションも作成されます。詳細については、「 ディスクのパーティションを設定する」をご覧ください。
--insights	省略可能なフラグです。 Insights パーティションは、最初の実行時にフラグが明示的に渡されない場合でも自動的に作成されます。 Insights のインストール後に Insights を有効化するには、インフラストラクチャのインストール時に Insights のストレージ構成が必要です。 ただしこのフラグは、後続の実行で --size フラグとともに Insights パーティションのサイズ変更時に必要になります。
--size <int>	任意です。整数値を指定すると、十分な空き領域がある場合は、選択したコンポーネントのサイズが変更されます。空き領域が不足している場合は、選択したパーティションを拡張するためにディスク全体が使用されます。サイズ変更しなければならないパーティションを 1 つだけ指定する必要があります。 ディスク構成時に --size オプションは必要ありません。 構成後にディスク サイズを拡張するために使用できます。
--robot-package-cache	Automation Suite ロボット ノード上の、キャッシュするパッケージをダウンロードする場所へのパスです。 これは、Automation Suite ロボット ノードでのみ実行する必要があります。

次の例に示すように、このコマンドを使用して、 --size フラグを使用して選択したパーティションのサイズを変更することもできます。

./bin/uipathctl rke2 disk --docker-registry --size 300

すべてのサーバー マシンで ObjectStore ディスクを構成する

この手順は、外部の ObjectStore が利用できない場合にのみ必要です。

次のスクリプトをすべてのサーバー ノードで実行して、クラスター内の ObjectStore のストレージ サイズを追加または拡張できます。

./bin/uipathctl rke2 disk --ceph-raw-disk-name name_ceph_raw_disk

注:

• Azure の既知の問題により、Azure ディスクが非 SSD として誤ってマークされます。Azure がクラウド プロバイダーであり、ObjectStore ディスクを構成したい場合は、「 トラブルシューティング」をご覧ください。
• 既存のディスクの垂直スケーリングはサポートされていません。インストール後にクラスター内のストレージのサイズを増やすには、新しい RAW ディスクを追加してください。

選択したマシンで AI Center ディスクを構成する

AI Center ディスクを構成するには、トレーニング パイプラインを実行する予定のマシンで次のコマンドを実行します。

./bin/uipathctl rke2 disk --aicenter-disk-name name_of_aicenter_disk_to_partition

AI Center のストレージを拡張するには、以下の手順を実行します。

• 新しい AI Center ディスクを追加する場合は、ディスクを追加する予定のマシンで次のコマンドを実行します。

  ./bin/uipathctl rke2 disk --aicenter-storage-extend name_of_new_aicenter_disk_to_attach
  

• 既存の AI Center ディスクを拡張した場合は、基になる AI Center ディスクが拡張されているマシンで次のコマンドを実行します。

  ./bin/uipathctl rke2 disk --aicenter-storage-extend
  

Automation Suite ロボットのパッケージ キャッシュホスティング ディスクを構成する

この手順は、専用の Automation Suite ロボット エージェントを使用しないシングルノード設定の場合に必要です。

サーバー ノードで Automation Suite ロボットのパッケージ キャッシュをホストするには、10 GB 以上のディスクを作成する必要があります。

./bin/uipathctl rke2 disk --volume name_of_data_disk --robot-package-cache

注:

ディスクは LVM でバックアップすることをお勧めします。

最初のサーバー ノードでバンドル ディスクをクラスター内レジストリ用に構成する

この手順は、次のシナリオで必要です。

• オフライン (エアギャップ) インストールを実行する場合。
• 外部レジストリが使用できない場合。

バンドル ディスクを構成するには、最初のサーバー ノードでのみ次のコマンドを実行します。

./bin/uipathctl rke2 disk --bundle-disk-name name_of_bundle_disk

サーバー ノードで Ceph バックアップ ディスクを構成する

この手順は、Automation Suite クラスターをバックアップするためにクラスター内のストレージを使用するシングルノード RKE2 設定でのみ必要です。

サーバー ノードで次のコマンドを実行します。

./bin/uipathctl rke2 disk --backup-disk-name <disk-name>

ディスク マウントを検証する

注:

すべてのマウント ポイントを fstab ファイルに追加し、それらの fstab エントリに nofail オプションを指定して、障害発生時の仮想マシンのブートに影響を及ぼさないようにしてください。

/etc/fstab が正しく構成され、システムの再起動を処理できることを確認するには、以下の手順で次のコマンドを実行します。

mount -afv

以下の出力を取得できます。

# Servers
/datadisk/monitoring              : already mounted
/datadisk/insights                : already mounted
/var/lib/rancher/rke2/server/db   : already mounted

# Servers or agents
/opt/UiPathAutomationSuite        : already mounted
/var/lib/rancher                  : already mounted
/var/lib/kubelet                  : already mounted

# In case of an offline environment, only on the primary server node
/uipath                           : already mounted

# Additional mount point is require if customer is installing offline with internal registry
/datadisk/registry                : already mounted

# Additional mount point is require if customer is using in-cluster objectstore
/datadisk/objectstore             : already mounted