オフライン インストール用に OCI 準拠レジストリを設定する

オフライン インストールでは、コンテナー イメージとデプロイ Helm チャートを格納するために、OCI (Open Container Initiative) に準拠したレジストリが必要です。 オンライン インストールを実行する場合は、この手順をスキップしてください。

注:

独自のレジストリを利用することを強くお勧めします。使用可能なレジストリがない場合は、いずれかのサーバー・マシンに OCI 準拠のレジストリを一時的にインストールできます。

Automation Suite の成果物を外部 OCI 準拠レジストリにアップロードする

Automation Suite の成果物を外部 OCI 準拠レジストリにアップロードするには、次の 2 つの方法があります。

• オプション A: OCI 準拠のレジストリを UiPath® レジストリにミラーリングする
• オプション B: オフライン バンドルを使用して OCI 準拠のレジストリをハイドレートする

次の表では、成果物をレジストリにアップロードする 2 つのオプションを比較しています。ニーズに合うほうのオプションを選択してください。

オプション A: レジストリをミラーリングする	オプション B: レジストリをハイドレートする
成果物を UiPath® レジストリから任意のターゲット レジストリにコピーします。	オフラインの tarball を使用して成果物を解凍し、ターゲット レジストリにアップロードします。
Docker ツールと Helm ツールが必要です。	Podman ツールと Helm ツールが必要です。
成果物を UiPath® レジストリからターゲット レジストリにコピーする際に、インターネットへのアクセスが必要です。	オフラインの tarball をジャンプ サーバーにダウンロードするためにのみインターネットへのアクセスが必要です。 tarball のアップロードには、インターネットへのアクセスは必要ありません。
コピー中にイメージをキャッシュするための一時的な領域が必要です。 この領域は通常、Docker のインストール中に構成されます。 既定の場所は /var/lib/docker です。	tarball を抽出するための一時的な領域と、Podman がイメージを読み込むための一時的な領域が必要です。 tarball の抽出場所は、ハイドレート手順中に指定する必要があります。 Podman の場所は /var/tmp にすることができ、ストレージに十分な空き容量が必要になります。
/var/lib/docker に必要なストレージ容量は約 128 GiB です	抽出に必要なストレージ容量は約 200 GiB で、/var/tmp には 256 GiB が必要です。

注: ミラーリングまたはハイドレート操作は、サーバー ノードを使用せずに管理マシンまたはジャンプ ボックスから実行することをお勧めします。

オプション A: UiPath® レジストリをレジストリにミラーリングする

この方法では、OCI 準拠のレジストリに Automation Suite のアーティファクトをアップロードするジャンプ マシンでインターネットにアクセスできる必要があります。

UiPath® レジストリをミラーリングするための前提条件

UiPath® レジストリをミラーリングするには、以下が必要です。

• Linux ディストリビューションを実行している VM (推奨) またはノート PC (非推奨)

• プライベート レジストリで認証された Docker クライアント

• プライベート レジストリで認証された 3.8 以降の Helm。

• as-images.txt;
• as-helm-charts.txt;
• mirror-registry.sh;
• registry.uipath.com へのアウトバウンド接続。
• コンテナー イメージとグラフをアップロードするマシンの /var/lib/docker パーティション下に Docker 用の 128 GiB の空きディスク領域。

Docker と Helm をインストールする

Automation Suite のコンテナー イメージとグラフをレジストリにアップロードする予定のマシンに Docker と Helm がインストールされ、認証されている必要があります。

• Docker バイナリをダウンロードするには、公式ドキュメントをご覧ください。

• Docker レジストリに対する認証を行うには、公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  docker login my.registry.io:443 --username "admin" --password "secret"

• Helm バイナリをダウンロードするには、公式ドキュメントをご覧ください。

• Helm レジストリに対する認証を行うには、公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  helm registry login my.registry.io:443 --username "admin" --password "secret"

as-images.txt をダウンロードする

as-images.txt をダウンロードするには、「インストール バンドルをダウンロードする」をご覧ください。

as-helm-charts.txt をダウンロードする

as-helm-charts.txt をダウンロードするには、「インストール バンドルをダウンロードする」をご覧ください。

任意の Document Understanding バンドルをダウンロードする

任意の Document Understanding バンドルをダウンロードするには、Document Understanding のドキュメントをご覧ください。

mirror-registry.sh をダウンロードする

mirror-registry.sh スクリプトをダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。

Automation Suite イメージをレジストリにアップロードする

mirror-registry.sh スクリプトを使用するには、ソース (既定の registry.uipath.com) レジストリとターゲット レジストリへのアウトバウンド接続が必要です。

注:

mirror-registry.sh スクリプトは、レジストリに対する認証を実行しません。レジストリに対して既に認証済みであることを前提としています。

フラグ	Environment Variable (環境変数)	説明
--images-manifest	IMAGES_MANIFEST	必須です。イメージのマニフェスト ファイルへのパスです。
--helm-charts-manifest	HELM_CHARTS_MANIFEST	必須です。Helm グラフのマニフェスト ファイルへのパスです。
--target-registry-url	TARGET_REGISTRY_URL	必須です。ターゲット レジストリの URL を渡します。
--source-registry-url	SOURCE_REGISTRY_URL	任意です。ソース レジストリの URL を渡します。既定値は registry.uipath.com です。

Automation Suite イメージをレジストリにアップロードするには以下を実行します。

1. 次のコマンドを実行して、シェルスクリプトを実行するために必要な権限があることを確認します。

   chmod +x mirror-registry.sh

2. Automation Suite イメージをレジストリにアップロードするには、次のコマンドを実行します。

   ./mirror-registry.sh --target-registry-url my.registry.io:443 --source-registry-url registry.uipath.com --images-manifest /home/myuser/as-images.txt --helm-charts-manifest /home/myuser/as-helm-charts.txt

オプション B: オフライン バンドルでレジストリをハイドレートする

この方法で必要なものは、ジャンプ マシンでオフライン バンドルをダウンロードするためのインターネット アクセスだけです。バンドルが使用可能になると、インターネットに接続せずに OCI 準拠のレジストリにアップロードできます。

注:

この方法では、tar を解凍してレジストリにアップロードするために、マシンに追加の空き領域が必要になる場合もあります。それ以外にも、この方法はミラーリング アプローチよりも時間がかかる場合があります。

レジストリをハイドレートするための前提条件

レジストリをハイドレートするには以下が必要です。

• スクリプトをノート PC で実行するより VM で Linux ディストリビューションを実行する方法が望ましい
• オフライン バンドルを VM にダウンロードしてコピーする、または何らかの方法で反映することができる
• プライベート レジストリで認証された 3.8 以降の Helm。
• Podman がプライベート レジストリでインストール、構成、認証されている
• コンテナーをリモート レジストリにプッシュする前にローカルに読み込むため、/var/lib/containers の下に Podman 用に 150 GiB の空きディスク領域が必要です。既定のパスを変更するには、podman-info コマンドの出力内の graphRoot パスの場所を更新します。
• Podman の公式ドキュメントの説明に従って、TMP_DIR 環境変数を設定します。
• as.tar.gz

Podman と Helm をインストールする

Automation Suite のコンテナー イメージとグラフをレジストリにアップロードする予定の元のマシンに、Podman と Helm がインストールされ、認証されていることを確認する必要があります。

• Podman バイナリをダウンロードするには、公式ドキュメントをご覧ください。
• Podman レジストリに対する認証を行うには、公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  podman login my.registry.io:443 --username "admin" --password "secret"

• Helm バイナリをダウンロードするには、公式ドキュメントをご覧ください。
• Helm レジストリに対する認証を行うには、公式ドキュメントをご覧ください。または、次のコマンドを使用して、資格情報のサンプルを実際のレジストリ資格情報に置き換えることもできます。

  helm registry login my.registry.io:443 --username "admin" --password "secret"

as.tar.gz をダウンロードする

as.tar.gz をダウンロードするには、「インストール バンドルをダウンロードする」をご覧ください。

任意の Document Understanding バンドルをダウンロードする

任意の Document Understanding バンドルをダウンロードするには、Document Understanding のドキュメントをご覧ください。

hydrate-registry.sh をダウンロードする

hydrate-registry.sh スクリプトをダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。

Automation Suite イメージをレジストリにアップロードする

Automation Suite のイメージをレジストリにアップロードするには、hydrate-registry.sh スクリプトを使用します。

hydrate-registry.sh スクリプトは、ターゲット・レジストリー以外のアウトバウンド接続を必要としません。

注:

hydrate-registry.sh スクリプトは、レジストリに対する認証を実行しません。レジストリに対して既に認証済みであることを前提としています。

フラグ	説明
--offline-bundle-path	必須です。オフライン バンドルへのパスです。
--target-registry-url	必須です。ターゲット レジストリの URL を渡します。
--extract-path	オフライン バンドルを解凍するために使用する場所です。 /var/lib/containers またはカスタムの場所を指定できます。100 GiB 以上のストレージがあることを確認します。 ストレージは 256 GiB をお勧めします。

Automation Suite のイメージをレジストリにアップロードするには、次のコマンドを実行します。

./hydrate-registry.sh --target-registry-url registry.azurecr.io --offline-bundle-path ./as.tar.gz --extract-path /extract/to/path

外部 OCI 準拠レジストリの証明書を設定する

外部 OCI 準拠のレジストリを適切に構成するには、Automation Suite をインストールする予定のすべてのマシンの信頼ストアを更新する必要があります。 インストール後にこの手順を実行する方法については、「証明書を管理する」をご覧ください。

そのためには、以下の手順に従ってください。

1. CA ファイルを /etc/pki/ca-trust/source/anchors/ の場所に追加します。
2. update-ca-trust を実行して、オペレーティング システムの信頼ストアを更新します。信頼ストアが更新されると、抽出された証明書ファイルは /etc/pki/ca-trust/extracted/ca-bundle.trust.crt に結合されます。

注:

Automation Suite のインストール時に CA 証明書を指定する必要があります。 cluster_config.json ファイルの registry_ca_cert パラメーターで証明書を指定する必要があります。詳細は、 外部OCI準拠のレジストリ構成を参照してください。

一時的な Docker レジストリを設定する

注:

この手順は、クラスター内のレジストリを使用するオフライン インストールでのみ必要です。 外部 OCI 準拠レジストリを使用するオフライン インストール、またはオンライン インストールを実行する場合は、この手順をスキップできます。

この手順は、いずれかのサーバー ノードでのみ実行する必要があります。ノードには、レジストリのバックエンドとして使用する 512 GiB の追加容量があることを確認する必要があります。これは通常、/uipath マウント ポイントに配置することをお勧めします。

一時的な Docker レジストリは、インストール時またはアップグレード時にのみ必要です。インストールまたはアップグレードが成功すると、一時レジストリは不要になるため、アンインストールする必要があります。

一時レジストリを設定するための前提条件

一時レジストリをセットアップするには、以下が必要です。

• as-fs.tar.gz - ダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。

一時レジストリをインストールする

ノードの 1 つに一時的な Docker レジストリをインストールするには、次のコマンドを実行します。

./configureUiPathAS.sh registry install-temp-registry -i cluster_config.json

フラグ	説明
-i|--input	任意です。cluster_config.json へのパスを受け入れます。既定のレジストリ ポートとファイル パスを変更する場合にのみ必要です。

既定では一時レジストリは、ポート 30070 でマシンにインストールされ、/uipath/data/registry ファイル パスを使用します。ロード バランサーと、一時的な Docker レジストリをインストールするノードでポート 30070 を開く必要があります。

注:

ロード バランサーのバックエンド プールは、一時的な Docker レジストリをホストしているノードを排他的にターゲットにする必要があります。

既定の一時レジストリ ポートとファイル パスを変更する場合は、次のサンプルに示すように cluster_config.json ファイルを更新する必要があります。

{
  "infra": {
    "tmp_docker_registry": {
      "node_port": "<new port number>",
      "file_path": "/uipath/data/registry"
    }
  }
}

一時レジストリをハイドレートする

一時レジストリのインストール後、次の手順を実行します。

1. 次のコマンドを実行して、コンテナー イメージと Helm グラフのある一時レジストリをハイドレートします。

   ./configureUiPathAS.sh registry hydrate-temp-registry --offline-bundle /uipath/tmp/as-fs.tar.gz -i cluster_config.json

2. 次のコマンドを実行して、一時レジストリから内部レジストリをシーディングします。

   ./configureUiPathAS.sh registry seed-internal-registry -i cluster_config.json

フラグ	説明
--offline-bundle	サーバー ノード上の as-fs.tar.gz の場所を含むファイル パスです。
-i|--input	任意です。cluster_config.json ファイルへのパスを受け入れます。既定の Docker レジストリ ポートとファイル パスを変更する場合にのみ必要です。