外部 Docker レジストリを設定する

重要:

現在、Automation Suite は公開証明書 (たとえば、ACR、ECR などのクラウド プロバイダーが提供する公開証明書) によって署名された Docker レジストリにのみ接続できます。引き続き、私的機関のホストによって署名された Docker レジストリのサポートを提供できるよう取り組んでいます。

外部 Docker レジストリは、Automation Suite の新しいインストールでのみ選択できます。現在、内部の Docker レジストリから外部の Docker レジストリに移行することはできません。

用語集

OCI 準拠のレジストリ - Open Container Initiative の仕様を満たすレジストリ実装です。以前は「Docker レジストリ」と呼ばれていました。Azure の Azure コンテナー レジストリや AWS の Elastic Container Registry など、広く使用されている実装があります。さらに、以前のコンテナー レジストリのようなセルフホストのオプションもあり、現在は Distributions リポジトリに含まれています。

アーティファクト - OCI の定義では、OCI 準拠のレジストリでホストされているイメージ マニフェストまたは Helm グラフ マニフェストです。

オフライン インストールの前提条件

• Docker と Helm
• as-images.txt
• as-helm-charts.txt
• mirror-registry.sh

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

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

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

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

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

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

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

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

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

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

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

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

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

# command line flags style
./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

Computer Vision イメージを外部 Docker レジストリにアップロードする

注:

これらの手順は、Computer Vision を使用する場合にのみ必要です。これらの手順は、製品を使用する前の任意の時点で実行できます。

任意の Computer Vision イメージを外部 Docker レジストリにアップロードするには、次の手順を実行します。

1. registry.uipath.com でホストされている UiPath レジストリから目的の Computer Vision イメージをプルします。

   docker pull <uipath_registry_server>/<image_name>

   例: UiPath レジストリ サーバーが registry.uipath.com で、Computer Vision のイメージ名が aicenter/cv2304:23.4.5.6 である場合、以下を実行します。

   docker pull registry.uipath.com/aicenter/cv2304:23.4.5.6

2. イメージ ホストの名前を Docker レジストリの名前に従って変更します。

   docker tag <uipath_registry_server>/<image_name> <your_registry_server>/<image_name>

   例: レジストリ名が registory.mycompany.com である場合、以下を実行します。

   docker tag registry.uipath.com/aicenter/cv2304:23.4.5.6 registory.mycompany.com/aicenter/cv2304:23.4.5.6

3. イメージを外部 Docker レジストリにプッシュします。

   docker push <your_registry_server>/<image_name>

   例:

   docker push registory.mycompany.com/aicenter/cv2304:23.4.5.6

Computer Vision モデルでは、以下のイメージを使用できます。

• aicenter/python36cv:v21.10.0-2
• aicenter/python36cvv3:23.4.0-rc19
• aicenter/cv2304:23.4.5.6

Document Understanding イメージを外部 Docker レジストリにアップロードする

注:

これらの手順は、Document Understanding を使用する場合にのみ必要です。これらの手順は、製品を使用する前の任意の時点で実行できます。

任意の Document Understanding イメージを外部 Docker レジストリにアップロードするには、Document Understanding のドキュメントの手順を実行します。