Migrating your enterprise to the Container registry from the Docker registry

You can migrate Docker images previously stored in the Docker registry on sua instância do GitHub Enterprise Server to the Container registry.

Quem pode usar esse recurso?

Enterprise owners can migrate Docker images to the Container registry.

Neste artigo

Observação: atualmente, o Container registry está na versão beta do GitHub Enterprise Server e sujeito a alterações.

O GitHub Packages e o isolamento de subdomínio devem ser habilitados para usar o Container registry. Para obter mais informações, confira "Trabalhando com o registro do Contêiner".

About the Container registry

O Container registry armazena imagens de contêiner na sua conta pessoal ou de organização e permite que você associe uma imagem a um repositório. Você pode escolher se deve herdar permissões de um repositório ou definir permissões granulares, independentemente de um repositório. Você também pode acessar imagens de contêiner público anonimamente. For more information, see "Trabalhando com o registro do Contêiner."

For more information about configuring GitHub Packages for sua instância do GitHub Enterprise Server, see "Primeiros passos com o GitHub Packages para a sua empresa."

About migration from the Docker registry

Container registry substitui o Registro do Docker de GitHub. If the Docker registry on sua instância do GitHub Enterprise Server contains images, you must manually migrate the images to the Container registry.

Note: GitHub Enterprise Server 3.6 dá suporte à migração de imagens do Docker armazenadas em organizações. Uma versão futura dará suporte à migração de imagens de propriedade do usuário.

Os scripts ou fluxos de trabalho de GitHub Actions que usam o namespace do Registro do Docker, docker.HOSTNAME, continuarão funcionando após a migração para Container registry em containers.HOSTNAME. For more information about the impact of migration to the Container registry, see "Fazendo a migração para o Registro do Contêiner a partir do Registro 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 sua instância do GitHub Enterprise Server, you will receive an email after the migration is complete. For more information, see "Configurar notificações de e-mail."

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 sua instância do GitHub Enterprise Server, see "Acessar o painel de monitoramento."

  1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

    Captura de tela do menu suspenso que aparece quando você clica na foto de perfil no GitHub Enterprise Server. A opção "Configurações da empresa" está realçada em um contorno laranja escuro.

  2. Na barra lateral da conta corporativa, clique em Configurações.

  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 "Excluir e restaurar um pacote."

  2. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

    Captura de tela do menu suspenso que aparece quando você clica na foto de perfil no GitHub Enterprise Server. A opção "Configurações da empresa" está realçada em um contorno laranja escuro.

  3. Na barra lateral da conta corporativa, clique em Configurações.

  4. Na barra lateral esquerda, clique em Pacotes.

  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.