Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on tu instancia de GitHub Enterprise Server to the 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 versión 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».

About the 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. For more information, see "Trabajar con el registro de contenedores."

For more information about configuring GitHub Packages for tu instancia de GitHub Enterprise Server, see "Iniciar con GitHub Packages para tu empresa."

About migration from the Docker registry

Container registry reemplaza al registro de Docker de GitHub. If the Docker registry on tu instancia de GitHub Enterprise Server contains images, you must manually migrate the images to the Container registry.

Note: 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. For more information about the impact of migration to the Container registry, see "Migrarse al registro del contenedor desde el registro de Docker."

Migrating organizations to the Container registry

You can start a migration of all your organizations' Docker images to the Container registry. The duration of the migration operation depends on the total number of images to migrate, and the overall load on your instance. After a successful migration, GitHub Enterprise Server will display a summary, and all future uploads of Docker images will use the Container registry.

If a site administrator has configured email notifications for tu instancia de GitHub Enterprise Server, you will receive an email after the migration is complete. For more information, see "Configurar el correo electrónico para notificaciones."

Notes:

  • During the migration, the CPU and memory usage for your instance will increase. To ensure the performance of the instance for your users, GitHub recommends that you begin a migration during a period of reduced activity.
  • During the migration, do not modify settings for your enterprise or run ghe-config-apply from an administrative SSH session. These actions will trigger a configuration run, which can restart services and may interrupt the migration.
  • After the migration, storage pressure on your instance will increase due to the duplication of image files in the Docker registry and the Container registry. A future release of GitHub Enterprise Server will remove the duplicated files when all migrations are complete.

For more information about monitoring the performance and storage of tu instancia de GitHub Enterprise Server, see "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. In the left sidebar, click Packages.

  4. To the right of the number of packages to migrate, click Start migration. During the migration, GitHub Enterprise Server will display progress on this page.

After the migration completes, the page will display the results. If a migration fails, the page will show the organizations that own the package that caused the failure.

Re-running a failed organization migration

Prior to migration, if a user has created a package in the Container registry that has an identical name to an existing package in the Docker registry, the migration will fail.

  1. Delete the affected container in the Container registry. For more information, see "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. To the right of the number of packages to migrate, click Re-run migration. During the migration, GitHub Enterprise Server will display progress on this page.

  6. If the migration fails again, start from step 1 and re-run the migration.