Lorsque vous utilisez le registre de conteneur de votre organisation avec ArcGIS Enterprise on Kubernetes, vous devez le préparer avec les images de conteneur Esri avant tout nouveau déploiement, mise à jour ou mise à niveau. Pour ce faire, vous devez utiliser les outils de registre inclus avec le logiciel pour intégrer les images Docker Hub Esri dans le registre de conteneur de votre organisation.
Remarque :
Pour utiliser les méthodes décrites ci-dessous, il vous faudra télécharger et extraire les scripts de déploiement ArcGIS Enterprise on Kubernetes sur chaque poste de travail client impliqué dans le transfert des images de conteneur.
Comprendre les outils de registre
Le paquet de déploiement ArcGIS Enterprise on Kubernetes comprend un ensemble d’outils permettant de transférer des images vers le registre de conteneur de votre organisation.
Ces outils se trouvent sous tools/registry-tools dans le répertoire où vous avez extrait le paquet de déploiement et incluent les éléments suivants :
- image-download.sh : télécharge toutes les images Docker ArcGIS Enterprise on Kubernetes se trouvant dans un registre ou référentiel Docker spécifique vers un dossier local sous forme d’archives .tar.gz. Utilise la commande docker save pour créer les archives.
- image-upload.sh : charge les images téléchargées par image-download.sh dans le registre spécifié. Utilise la commande docker load pour extraire les archives.
- image-transfer.sh : transfère les images directement entre deux registres. Cette méthode est plus rapide que celle consistant à utiliser image-download.sh et image-upload.sh si le poste de travail client peut accéder aux deux registres.
- create-offline-manifest.sh : importer un manifeste de version en utilisant l’API d’administration. Cette action remplacera l’URL du manifeste externe définie dans arcgis-enterprise.properties et permettra aux utilisateurs hors connexion d’accéder aux mises à jour et mises à niveau.
Pour plus d’informations, reportez-vous à la rubrique Readme.md du dossier registry-tools.
Remarque :
Nous vous recommandons d’utiliser la même version des scripts de déploiement lorsque vous transférez des images vers le registre de votre organisation. Pour préparer une mise à niveau, téléchargez la nouvelle version des scripts de déploiement afin d’obtenir les dernières images.
Préparez votre registre lorsque la machine cliente a accès à Docker Hub et au registre de votre organisation
Si votre machine client a accès à Docker Hub et au registre de votre organisation, vous pouvez préparer votre registre pour un nouveau déploiement, une mise à jour ou une mise à niveau à l’aide du script image-transfer.sh.
Pour transférer des images, procédez comme suit :
- Sur My Esri, obtenez la version logicielle de ArcGIS Enterprise on Kubernetes que vous voulez déployer.
- Téléchargez et extrayez les scripts de déploiement sur votre machine cliente.
- Si votre registre vous oblige à pré-créer les référentiels d’images, par exemple dans Amazon Elastic Container Registry (ECR), exécutez la commande suivante pour obtenir la liste des référentiels d’images requis.
/setup/tools/registry-tools/image-transfer.sh -l - Identifiez la balise de version correspondant à la version du logiciel que vous comptez déployer en vous référant aux notes de version ou en exécutant la commande suivante pour visualiser les balises d’images disponibles :
/setup/tools/registry-tools/image-transfer.sh -s - Utilisez le script image-transfer.sh pour transférer les images de conteneur depuis Docker Hub vers le registre de votre organisation.
Pour plus d’informations, reportez-vous à image-transfer.sh -h.
- Exécutez le script de déploiement pour déployer ArcGIS Enterprise on Kubernetes.
Préparez votre registre lorsque le registre de votre organisation est déconnecté d’Internet
Si le registre de votre organisation est déconnecté d’Internet, vous pouvez préparer votre registre pour un nouveau déploiement, une mise à jour ou une mise à niveau à l’aide des scripts image-download.sh et image-upload.sh.
Pour ce faire, procédez comme suit :
- Sur My Esri, obtenez la version logicielle de ArcGIS Enterprise on Kubernetes que vous voulez déployer.
- Téléchargez et extrayez les scripts de déploiement sur la machine cliente exécutant le script de téléchargement et la machine cliente exécutant le script de chargement.
- Si votre registre vous oblige à pré-créer les référentiels d’images, par exemple dans Amazon Elastic Container Registry (ECR), exécutez la commande suivante pour obtenir la liste des référentiels d’images requis.
/setup/tools/registry-tools/image-download.sh -l - Identifiez la balise de version correspondant à la version du logiciel que vous comptez déployer en vous référant aux notes de version ou en exécutant la commande suivante pour visualiser les balises d’images disponibles :
/setup/tools/registry-tools/image-download.sh -s - Utilisez le script image-download.sh pour télécharger les images de conteneur sur votre machine cliente.
Pour plus d’informations, reportez-vous à image-download.sh -h.
Remarque :
Une fois l’outil image-download.sh exécuté, les images sont conservées dans le cache d’exécution du conteneur. Pour libérer de l’espace une fois l’outil exécuté avec succès, il est recommandé de supprimer les éléments non requis dans le cache Docker. Pour ce faire, exécutez docker system prune ou docker image rm.
- Suivez les processus de votre organisation pour déplacer les images sur votre machine cliente déconnectée.
Cette machine doit avoir accès à votre registre privé.
- Sur votre machine cliente privée, utilisez le script image-upload.sh pour charger les images de conteneur dans le registre de conteneur de votre organisation.
Remarque :
Une fois l’outil image-upload.sh exécuté, les images sont conservées dans le cache d’exécution du conteneur. Pour libérer de l’espace une fois l’outil exécuté avec succès, il est recommandé de supprimer les éléments non requis dans le cache Docker. Pour ce faire, exécutez docker system prune ou docker image rm.
- Exécutez le script de déploiement pour déployer ArcGIS Enterprise on Kubernetes.
Vous avez un commentaire à formuler concernant cette rubrique ?