Konfigurieren einer externen Docker-Registrierung

Wichtig:

Die Automation Suite kann derzeit nur eine Verbindung mit einer Docker-Registrierung herstellen, die mit einem öffentlichen Zertifikat signiert ist (z. B. ein öffentliches Zertifikat, das von Cloudanbietern wie ACR, ECR usw. bereitgestellt wird). Wir arbeiten noch an der Unterstützung von Docker-Registrierungen, die von einem privaten Autoritätshost signiert werden.

Sie können sich nur bei Neuinstallationen der Automation Suite für eine externe Docker-Registrierung entscheiden. Die Migration von der internen Docker-Registrierung zu einer externen Docker-Registrierung wird derzeit nicht unterstützt.

Glossar

OCI-konforme Registrierung – Eine Registrierungsimplementierung, die die Spezifikationen der Open Container-Initiative erfüllt. Früher bekannt als „Docker-Registrierung“. Es gibt einige weit verbreitete Implementierungen, z. B. Azure Container Registry von Azure und Elastic Container Registry von AWS. Darüber hinaus gibt es selbstgehostete Optionen wie die frühere Containerregistrierung, die sich jetzt im Repository für Verteilungen befindet.

Artefakt – Laut OCI-Definitionen jedes Image-Manifest oder Manifest eines Helm-Diagramms, das in einer OCI-konformen Registratur gehostet wird.

Voraussetzungen für die Offline-Installation

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

Installieren von Docker und Helm

Sie müssen sicherstellen, dass Docker und Helm auf der Maschine installiert sind, von der Sie die Automation Suite Container-Images und Helm-Diagramme in Ihre externe Docker-Registrierung hochladen möchten.

• Informationen zum Herunterladen der Docker-Binärdateien finden Sie in der offiziellen Dokumentation.
• Informationen zum Herunterladen der Helm-Binärdateien finden Sie in der offiziellen Dokumentation.
• Informationen zur Authentifizierung bei der Docker-Registrierung finden Sie in der offiziellen Dokumentation. Alternativ können Sie die folgenden Befehle verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Anmeldeinformationen ersetzen:

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

Herunterladen von as-images.txt

Informationen zum Herunterladen von as-images.txt finden Sie unter Herunterladen von Installationspaketen.

Herunterladen von as-helm-charts.txt

Informationen zum Herunterladen von as-helm-charts.txt finden Sie unter Herunterladen von Installationspaketen.

Herunterladen von mirror-registry.sh

Informationen zum Herunterladen des Skripts mirror-registry.sh finden Sie unter Herunterladen der Installationspakete.

Hochladen der Automation Suite-Images in die Docker-Registrierung

Das mirror-registry.sh-Skript erfordert ausgehende Konnektivität zu den Quell- (Standard: registry.uipath.com) und Ziel-Registern.

Befehlszeilenargumente	Umgebungsvariable	Beschreibung
--images-manifest	IMAGES_MANIFEST	(Optional) Der Pfad zur Manifestdatei der Images.
--helm-charts-manifest	HELM_CHARTS_MANIFEST	(Optional) Der Pfad zur Manifestdatei der Diagramme.
--target-registry-url	TARGET_REGISTRY_URL	(Obligatorisch) Übergeben Sie die URL für die Zielregistrierung.
--source-registry-url	SOURCE_REGISTRY_URL	(Optional) Übergeben Sie die URL für die Quellregistrierung; Standardwert ist 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

Hochladen der Computer Vision-Images in die externe Docker-Registrierung

Hinweis:

Diese Schritte sind nur erforderlich, wenn Sie Computer Vision verwenden. Sie können diese Schritte jederzeit ausführen, bevor Sie das Produkt verwenden.

Um die optionalen Computer Vision-Images in Ihre externe Docker-Registrierung hochzuladen, führen Sie die folgenden Schritte aus:

1. Ziehen Sie das gewünschte Computer Vision-Image aus der UiPath-Registrierung, das auf registry.uipath.com gehostet wird:

   docker pull <uipath_registry_server>/<image_name>

   Beispiel: Der UiPath-Registrierungsserver ist registry.uipath.com. Wenn der Image-Name für Computer Vision aicenter/cv2304:23.4.5.6 ist, führen Sie Folgendes aus:

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

2. Benennen Sie den Image-Host gemäß Ihrem Docker-Registrierungsnamen um.

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

   Beispiel: Wenn Ihr Registrierungsname registory.mycompany.com ist, führen Sie Folgendes aus:

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

3. Pushen Sie das Image in die externe Docker-Registrierung.

   docker push <your_registry_server>/<image_name>

   Beispiel:

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

Die folgenden Images sind für die Computer Vision-Modelle verfügbar:

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

Hochladen der Document Understanding-Images in die externe Docker-Registrierung

Hinweis:

Diese Schritte sind nur erforderlich, wenn Sie Document Understanding verwenden. Sie können diese Schritte jederzeit ausführen, bevor Sie das Produkt verwenden.

Um die optionalen Document Understanding-Images in Ihre externe Docker-Registrierung hochzuladen, führen Sie die Schritte in der Document Understanding-Dokumentation aus.