Configuration d'un registre Docker externe

Important :

Automation Suite ne peut actuellement se connecter qu'à un registre Docker signé par un certificat public (par exemple, un certificat public fourni par des fournisseurs Cloud tels que ACR, ECR, etc.). Nous travaillons toujours à la prise en charge du registre Docker signé par un hôte d'autorité privée.

Vous ne pouvez opter pour un registre Docker externe que dans les nouvelles installations d'Automation Suite. La migration du registre Docker interne vers un registre Docker externe n'est actuellement pas prise en charge.

Glossaire

Registre conforme à l'OCI : Une implémentation de registre qui répond aux spécifications de l'Open Container Initiative. Anciennement connu sous le nom de « registre Docker ». Il existe des implémentations largement utilisées, telles que Azure Container Registry d'Azure et Elastic Container Registry d'AWS. En outre, il existe des options auto-hébergées telles que l'ancien registre de conteneurs, qui se trouve désormais dans le référentiel Distributions.

Artefact : Selon les définitions OCI, tout manifeste d'image ou manifeste de graphique Helm hébergé dans un registre conforme à OCI.

Prérequis à l'installation hors ligne

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

Installation de Docker et Helm

Vous devez vous assurer que Docker et Helm sont installés sur la machine à partir de laquelle vous prévoyez de télécharger les images de conteneur Automation Suite et les graphiques Helm vers votre registre Docker externe.

• Pour télécharger les fichiers binaires Docker, consultez la documentation officielle.
• Pour télécharger les fichiers binaires Helm, consultez la documentation officielle.
• Pour vous authentifier auprès du registre Docker, consultez la documentation officielle. Vous pouvez également utiliser les commandes suivantes en remplaçant les exemples d'informations d'identification par vos informations d'identification de registre réelles :

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

Téléchargement du fichier as-images.txt

Pour télécharger as-images.txt, voir Téléchargement des bundles d'installation.

Téléchargement du fichier as-helm-charts.txt

Pour télécharger as-helm-charts.txt, voir Téléchargement des bundles d'installation.

Téléchargement de miroir-registre.sh

Pour télécharger le script mirror-registry.sh, consultez la section Téléchargement des packages d'installation.

Téléchargement des images Automation Suite dans le registre Docker

Le script mirror-registry.sh nécessite une connectivité sortante vers les registres source (registry.uipath.com par défaut) et cible.

Argument de ligne de commande	Variable d'environnement	Description
--images-manifest	IMAGES_MANIFEST	(Facultatif) Chemin d'accès au fichier manifeste des images.
--helm-charts-manifest	HELM_CHARTS_MANIFEST	(Facultatif) Chemin d'accès au fichier manifeste des graphiques.
--target-registry-url	TARGET_REGISTRY_URL	(Obligatoire) Transmettez l'URL du registre cible.
--source-registry-url	SOURCE_REGISTRY_URL	(Facultatif) transmettez l'URL du registre source ; par défaut 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

Téléchargement des images Computer Vision vers le registre Docker externe

Remarque :

Ces étapes ne sont nécessaires que si vous utilisez Computer Vision. Vous pouvez effectuer ces étapes à tout moment avant d'utiliser le produit.

Pour télécharger les images Computer Vision facultatives dans votre registre Docker externe, procédez comme suit :

1. Extrayez l'image Computer Vision souhaitée du registre UiPath hébergé sur registry.uipath.com :

   docker pull <uipath_registry_server>/<image_name>

   Exemple : le serveur de registre UiPath est registry.uipath.com ; si le nom de l'image pour Computer Vision est aicenter/cv2304:23.4.5.6, exécutez :

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

2. Renommez l'hôte de l'image selon votre nom de registre Docker.

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

   Exemple : si le nom de votre registre est registory.mycompany.com, exécutez :

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

3. Transmettez l'image à votre registre Docker externe.

   docker push <your_registry_server>/<image_name>

   Exemple :

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

Les images suivantes sont disponibles pour les modèles Computer Vision :

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

Téléchargement des images Document Understanding vers le registre Docker externe

Remarque :

Ces étapes ne sont nécessaires que si vous utilisez Document Understanding. Vous pouvez effectuer ces étapes à tout moment avant d'utiliser le produit.

Pour télécharger les images Document Understanding facultatives dans votre registre Docker externe, suivez les étapes décrites dans la documentation Document Understanding.