Cuando utilice el registro de contenedores de su organización con ArcGIS Enterprise on Kubernetes, debe prepararlo con las imágenes de contenedores de Esri antes de realizar nuevos despliegues, actualizaciones o mejoras. Para ello, debe utilizar las herramientas de registro que se incluyen con el software para insertar las imágenes del hub docker de Esri en el registro de contenedores de su organización.
Nota:
Para utilizar los métodos descritos abajo, necesitará descargar y extraer las secuencias de comando de implementación de ArcGIS Enterprise on Kubernetes en cada estación de trabajo cliente que esté implicada que en la transferencia de imágenes del contenedor.
Comprender las herramientas de registro
El paquete de implementación de ArcGIS Enterprise on Kubernetes incluye un conjunto de herramientas que se utilizan para transferir imágenes al registro de contenedores de su organización.
Estas herramientas se encuentran en tools/registry-tools, en el directorio donde extrajo el paquete de implementación, e incluyen las siguientes:
- image-download.sh: descarga todas las imágenes de Docker de ArcGIS Enterprise on Kubernetes de un registro de Docker concreto o de un repositorio en una carpeta local como archivos .tar.gz. Utiliza el comando docker save para crear los archivos.
- image-upload.sh: carga las imágenes que descargó image-download.sh en un registro concreto. Utiliza el comando docker load para extraer los archivos.
- image-transfer.sh: transfiere imágenes directamente entre dos registros. Esto es más rápido que utilizar image-download.sh y image-upload.sh si la estación de trabajo del cliente puede acceder a ambos registros.
- create-offline-manifest.sh: importe un manifiesto de versión utilizando la API de administración. Esto anulará la URL del manifiesto externo definido en arcgis-enterprise.properties y permite a los usuarios sin conexión acceder a las actualizaciones.
Hay más información disponible en Readme.md, en la carpeta registry-tools.
Nota:
Es recomendable que utilice la misma versión de las secuencias de comandos de implementación al transferir imágenes al registro de su organización. Para preparar una actualización, descargue la nueva versión de las secuencias de comandos de implementación para obtener las imágenes más recientes.
Preparar su registro cuando el equipo cliente tenga acceso al hub Docker y el registro de su organización
Si el equipo cliente tiene acceso al hub Docker y el registro de su organización, puede preparar su registro para una implementación o actualización nueva mediante el uso de la secuencia de comandos image-transfer.sh.
Para transferir imágenes, lleve a cabo los pasos siguientes:
- Desde My Esri, obtenga la versión del software de ArcGIS Enterprise on Kubernetes que desea implantar.
- Descargue y extraiga los scripts de implementación en su equipo cliente.
- Si su registro requiere que cree previamente los repositorios de imágenes, por ejemplo, en Amazon Elastic Container Registry (ECR), ejecute el comando siguiente para obtener una lista de repositorios de imágenes requeridos:
/setup/tools/registry-tools/image-transfer.sh -l - Identifique la etiqueta de versión correspondiente a la versión de software que desea implementar haciendo referencia a las notas de la versión o ejecutando el siguiente comando para ver las etiquetas de las imágenes disponibles:
/setup/tools/registry-tools/image-transfer.sh -s - Utilice la secuencia de comandos image-transfer.sh para transferir las imágenes de contenedores del hub Docker al registro de la organización.
Consulte image-transfer.sh -h para obtener más información.
- Ejecute el script de implementación para implementar ArcGIS Enterprise on Kubernetes.
Preparar su registro cuando el registro de su organización está desconectado de internet
Si el registro de su organización está desconectado de internet, puede preparar su registro para una implementación o actualización nueva mediante el uso de las secuencias de comandos image-download.sh y image-upload.sh.
Para hacerlo, complete los pasos siguientes:
- Desde My Esri, obtenga la versión del software de ArcGIS Enterprise on Kubernetes que desea implantar.
- Descargue y extraiga las secuencias de comandos de implementación en el equipo cliente en el que se ejecuta la secuencia de comandos de descarga y el equipo cliente en el que se ejecuta la secuencia de comandos de carga.
- Si su registro requiere que cree previamente los repositorios de imágenes, por ejemplo, en Amazon Elastic Container Registry (ECR), ejecute el comando siguiente para obtener una lista de repositorios de imágenes requeridos:
/setup/tools/registry-tools/image-download.sh -l - Identifique la etiqueta de versión correspondiente a la versión de software que desea implementar haciendo referencia a las notas de la versión o ejecutando el siguiente comando para ver las etiquetas de las imágenes disponibles:
/setup/tools/registry-tools/image-download.sh -s - Utilice el script image-download.sh para descargar las imágenes del contenedor a su equipo cliente.
Consulte image-download.sh -h para obtener más información.
Nota:
Una vez que la herramienta image-download.sh se ejecute, las imágenes siguen existiendo en la caché de tiempo de ejecución del contenedor. Para liberar espacio después de que se haya completado correctamente, se recomienda limpiar los elementos que no se necesitan en la caché Docker. Puede hacerlo ejecutando docker system prune o docker image rm.
- Siga los procesos de su organización para mover imágenes a su equipo cliente desconectado.
Este equipo debe tener acceso a su registro privado.
- En su equipo cliente privado, utilice la secuencia de comandos image-upload.sh para cargar imágenes de contenedores en el registro de contenedores de su organización.
Nota:
Una vez que la herramienta image-upload.sh se ejecute, las imágenes siguen existiendo en la caché de tiempo de ejecución del contenedor. Para liberar espacio después de que se haya completado correctamente, se recomienda limpiar los elementos que no se necesitan en la caché Docker. Puede hacerlo ejecutando docker system prune o docker image rm.
- Ejecute el script de implementación para implementar ArcGIS Enterprise on Kubernetes.