Wenn Sie die Containerregistrierung Ihrer Organisation für ArcGIS Enterprise on Kubernetes verwenden, müssen Sie vor neuen Bereitstellungen, Aktualisierungen oder Upgrades die Esri Container-Images vorbereiten. Dazu können Sie in der Software enthaltene Registrierungswerkzeuge verwenden, um die Docker Hub-Images von Esri in die Containerregistrierung der Organisation zu verschieben.
Hinweis:
Um die unten beschriebenen Methoden zu verwenden, müssen Sie die ArcGIS Enterprise on Kubernetes-Bereitstellungsskripte auf den einzelnen Client-Workstations, die an der Übertragung der Container-Images beteiligt sind, herunterladen und extrahieren.
Registrierungswerkzeuge
Das ArcGIS Enterprise on Kubernetes-Bereitstellungspaket enthält verschiedene Werkzeuge, die für die Übertragung von Bildern in die Containerregistrierung Ihrer Organisation verwendet werden.
Diese Werkzeuge befinden sich unter tools/registry-tools in dem Verzeichnis, in dem Sie das Bereitstellungspaket extrahiert haben. Es sind folgende Werkzeuge enthalten:
- image-download.sh: Damit werden alle ArcGIS Enterprise on Kubernetes-Docker-Images aus einer angegebenen Docker-Registrierung oder aus einem Repository als .tar.gz-Archive in einen lokalen Ordner heruntergeladen. Zum Erstellen der Archive wird der Befehl docker save verwendet.
- image-upload.sh: Damit werden Bilder, die von image-download.sh heruntergeladen wurden, in die angegebene Registrierung hochgeladen. Zum Extrahieren der Archive wird der Befehl docker load verwendet.
- image-transfer.sh: Damit werden Bilder direkt zwischen zwei Registrierungen übertragen. Diese Option ist schneller als die Verwendung von image-download.sh und image-upload.sh, wenn die Client-Workstation Zugriff auf beide Registrierungen hat.
- create-offline-manifest.sh: Damit wird ein Versionsmanifest mithilfe der Admin-API importiert. Dadurch wird die externe Manifest-URL, die in den arcgis-enterprise.properties definiert wurde, außer Kraft gesetzt und Offline-Benutzern der Zugriff auf Aktualisierungen und Upgrades ermöglicht.
Weitere Informationen finden Sie unter Readme.md im Ordner registry-tools.
Hinweis:
Es wird empfohlen, bei der Übertragung von Bildern in die Registrierung Ihrer Organisation die gleiche Version der Bereitstellungsskripte zu verwenden. Laden Sie zur Vorbereitung auf ein Upgrade die neue Version der Bereitstellungsskripte herunter, um die aktuellen Bilder zu erhalten.
Vorbereiten der Registrierung, wenn der Client-Computer Zugriff auf Docker Hub und die Registrierung Ihrer Organisation hat
Wenn der Client-Computer Zugriff auf Docker Hub und die Registrierung Ihrer Organisation hat, können Sie die Registrierung mithilfe des Skripts image-transfer.sh auf eine neue Bereitstellung vorbereiten oder Aktualisierungen bzw. Upgrades durchführen.
Führen Sie die folgenden Schritte aus, um Bilder zu übertragen.
- Rufen Sie von My Esri die ArcGIS Enterprise on Kubernetes-Softwareversion ab, die Sie bereitstellen möchten.
- Laden Sie die Bereitstellungsskripte auf Ihren Client-Computer herunter, und extrahieren Sie sie.
- Wenn Ihre Registrierung verlangt, dass Sie die Image-Repositorys vorab erstellen, z. B. in Amazon Elastic Container Registry (ECR), führen Sie den folgenden Befehl aus, um eine Liste der erforderlichen Image-Repositorys zu erhalten:
/setup/tools/registry-tools/image-transfer.sh -l - Identifizieren Sie das entsprechende Versions-Tag für die Softwareversion, die Sie bereitstellen möchten, mithilfe der Versionshinweise oder durch Ausführen des folgenden Befehls zur Anzeige der verfügbaren Bild-Tags:
/setup/tools/registry-tools/image-transfer.sh -s - Übertragen Sie mit dem Skript image-transfer.sh die Container-Images aus Docker Hub in die Registrierung Ihrer Organisation.
Weitere Informationen finden Sie unter image-transfer.sh -h.
- Führen Sie das Bereitstellungsskript aus, um ArcGIS Enterprise on Kubernetes bereitzustellen.
Vorbereiten der Registrierung, wenn die Registrierung Ihrer Organisation nicht mit dem Internet verbunden ist
Wenn die Registrierung Ihrer Organisation nicht mit dem Internet verbunden ist, können Sie die Registrierung mithilfe der Skripte image-download.sh und image-upload.sh auf eine neue Bereitstellung vorbereiten oder Aktualisierungen bzw. Upgrades durchführen.
Führen Sie dazu die folgenden Schritte aus:
- Rufen Sie von My Esri die ArcGIS Enterprise on Kubernetes-Softwareversion ab, die Sie bereitstellen möchten.
- Laden Sie die Bereitstellungsskripte auf den Client-Computer herunter, auf dem das Download-Skript ausgeführt wird, und auf den Client-Computer, auf dem das Upload-Skript ausgeführt wird, und extrahieren Sie sie.
- Wenn Ihre Registrierung verlangt, dass Sie die Image-Repositorys vorab erstellen, z. B. in Amazon Elastic Container Registry (ECR), führen Sie den folgenden Befehl aus, um eine Liste der erforderlichen Image-Repositorys zu erhalten:
/setup/tools/registry-tools/image-download.sh -l - Identifizieren Sie das entsprechende Versions-Tag für die Softwareversion, die Sie bereitstellen möchten, mithilfe der Versionshinweise oder durch Ausführen des folgenden Befehls zur Anzeige der verfügbaren Bild-Tags:
/setup/tools/registry-tools/image-download.sh -s - Laden Sie die Container-Images mit dem Skript image-download.sh auf den Client-Computer herunter.
Weitere Informationen finden Sie unter image-download.sh -h.
Hinweis:
Nachdem das Werkzeug image-download.sh erfolgreich abgeschlossen wurde, sind die Bilder weiterhin im Cache der Container-Runtime vorhanden. Um im Anschluss Speicherplatz freizugeben, wird empfohlen, den Docker-Cache von nicht benötigten Elementen zu bereinigen. Führen Sie hierfür docker system prune oder docker image rm aus.
- Befolgen Sie die Prozesse Ihrer Organisation zum Verschieben von Bildern auf den nicht verbundenen Client-Computer.
Dieser Computer muss Zugriff auf Ihre private Registrierung haben.
- Laden Sie mit dem Skript image-upload.sh auf Ihrem privaten Client-Computer Container-Images in die Containerregistrierung der Organisation hoch.
Hinweis:
Nachdem das Werkzeug image-upload.sh erfolgreich abgeschlossen wurde, sind die Bilder weiterhin im Cache der Container-Runtime vorhanden. Um im Anschluss Speicherplatz freizugeben, wird empfohlen, den Docker-Cache von nicht benötigten Elementen zu bereinigen. Führen Sie hierfür docker system prune oder docker image rm aus.
- Führen Sie das Bereitstellungsskript aus, um ArcGIS Enterprise on Kubernetes bereitzustellen.