Migración de tu empresa al registro del contenedor desde el registro de Docker

Puedes migrar imágenes de Docker almacenadas anteriormente en el registro de Docker en tu instancia de GitHub Enterprise Server al Container registry.

¿Quién puede utilizar esta característica?

Enterprise owners can migrate Docker images to the Container registry.

En este artículo

Nota: Container registry se encuentra actualmente en beta para GitHub Enterprise Server y está sujeto a cambios.

Tanto GitHub Packages como el aislamiento de subdominio deben estar habilitados para usar Container registry. Para obtener más información, vea «Trabajar con el registro de contenedores».

Acerca del Container registry

El Container registry almacena imágenes de contenedor dentro de tu organización o cuenta personal y te permite asociar una imagen a un repositorio. Puedes elegir si quieres heredar permisos desde un repositorio o si quieres configurar permisos granulares independientemente de un repositorio. También puedes acceder a imágenes de contenedor públicas de forma anónima. Para obtener más información, consulta "Trabajar con el registro de contenedores".

Para más información sobre cómo configurar GitHub Packages para tu instancia de GitHub Enterprise Server, consulta "Iniciar con GitHub Packages para tu empresa".

Acerca de la migración desde el registro de Docker

Container registry reemplaza al registro de Docker de GitHub. Si el registro de Docker en tu instancia de GitHub Enterprise Server contiene imágenes, debes migrar manualmente las imágenes al Container registry.

Nota: GitHub Enterprise Server 3.6 admite la migración de imágenes de Docker almacenadas en organizaciones. Una versión futura admitirá la migración de las imágenes propiedad del usuario.

Cualquier script o flujo de trabajo de GitHub Actions que utilice el espacio de nombres para el registro de Docker, docker.HOSTNAME, seguirá funcionando después de la migración al Container registry en containers.HOSTNAME. Para obtener más información sobre el impacto de la migración al Container registry, consulta "Migrarse al registro del contenedor desde el registro de Docker".

Migración de organizaciones al Container registry

Puedes iniciar una migración de todas las imágenes de Docker de las organizaciones al Container registry. La duración de la operación de migración depende del número total de imágenes que se van a migrar y de la carga total de la instancia. Después de una migración correcta, el GitHub Enterprise Server mostrará un resumen y todas las cargas futuras de imágenes de Docker usarán el Container registry.

Si el administrador de un sitio ha configurado notificaciones por correo electrónico para tu instancia de GitHub Enterprise Server, recibirás un correo electrónico una vez completada la migración. Para obtener más información, vea «Configurar el correo electrónico para notificaciones».

Notas:

  • Durante la migración, aumentará el uso de CPU y memoria de la instancia. Para garantizar el rendimiento de la instancia para tus usuarios, GitHub recomienda iniciar una migración durante un período de actividad reducida.
  • Durante la migración, no modifique la configuración de la empresa ni ejecute ghe-config-apply desde una sesión de SSH administrativa. Estas acciones desencadenarán una ejecución de configuración, que puede reiniciar los servicios y puede interrumpir la migración.
  • Después de la migración, la presión de almacenamiento en la instancia aumentará debido a la duplicación de archivos de imagen en el registro de Docker y el Container registry. En una versión futura de GitHub Enterprise Server se eliminarán los archivos duplicados cuando se completen todas las migraciones.

Para obtener más información sobre cómo supervisar el rendimiento y el almacenamiento de tu instancia de GitHub Enterprise Server, consulta "Acceder al tablero del monitor".

  1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.

    Captura de pantalla del menú desplegable que aparece al hacer clic en la foto de perfil en GitHub Enterprise Server. La opción "Configuración de Enterprise" está resaltada en un contorno naranja oscuro.

  2. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Configuración.

  3. En la barra lateral de la izquierda, haga clic en Packages.

  4. A la derecha del número de paquetes que se van a migrar, haz clic en Start migration (Iniciar migración). Durante la migración, GitHub Enterprise Server mostrará el progreso en esta página.

Una vez completada la migración, la página mostrará los resultados. Si se produce un error en una migración, la página mostrará las organizaciones que poseen el paquete que provocó el error.

Volver a ejecutar una migración de organización con errores

Antes de la migración, si un usuario ha creado un paquete en el Container registry que tiene un nombre idéntico a un paquete existente en el registro de Docker, se producirá un error en la migración.

  1. Elimina el contenedor afectado en el Container registry. Para obtener más información, vea «Borrar y restablecer un paquete».

  2. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.

    Captura de pantalla del menú desplegable que aparece al hacer clic en la foto de perfil en GitHub Enterprise Server. La opción "Configuración de Enterprise" está resaltada en un contorno naranja oscuro.

  3. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Configuración.

  4. En la barra lateral de la izquierda, haga clic en Packages.

  5. A la derecha del número de paquetes que se van a migrar, haz clic en Re-run migration (Volver a ejecutar migración). Durante la migración, GitHub Enterprise Server mostrará el progreso en esta página.

  6. Si de nuevo se produce un error en la migración, comienza en el paso 1 y vuelve a ejecutar la migración.