Como migrar sua empresa para o registro de contêiner do Registro do Docker

Você pode migrar as imagens do Docker que estavam armazenadas no registro do Docker em sua instância do GitHub Enterprise Server para o Container registry.

Quem pode usar esse recurso?

Enterprise owners can migrate Docker images to the Container registry.

Neste artigo

Note

Atualmente, o Container registry está em beta no 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".

Sobre o 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. Para saber mais, confira Trabalhando com o registro do Contêiner.

Para saber mais sobre como configurar o GitHub Packages para sua instância do GitHub Enterprise Server, confira Primeiros passos com o GitHub Packages para a sua empresa.

Sobre a migração do Registro do Docker

Container registry substitui o Registro do Docker de GitHub. Se o registro do Docker em sua instância do GitHub Enterprise Server contiver imagens, você precisará migrá-las manualmente para o 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. Para saber mais sobre o impacto da migração para Container registry, confira Fazendo a migração para o Registro do Contêiner a partir do Registro Docker.

Migrar organizações para Container registry

Você pode iniciar uma migração de todas as imagens do Docker de suas organizações para Container registry. A duração da operação de migração depende do número total de imagens a serem migradas e da carga geral da instância. Após uma migração bem-sucedida, GitHub Enterprise Server exibirá um resumo, e todos os uploads futuros de imagens do Docker usarão o Container registry.

Se um administrador de site tiver configurado notificações por email para sua instância do GitHub Enterprise Server, você receberá um email após a conclusão da migração. Para saber mais, confira Configurar notificações de e-mail.

Durante a migração

Durante a migração, o uso de CPU e memória para sua instância aumentará. Para garantir o desempenho da instância dos seus usuários, GitHub recomenda que você inicie uma migração durante um período de atividade reduzida.

Warning

Não modifique as configurações da sua empresa nem execute ghe-config-apply em uma sessão SSH administrativa. Essas ações vão disparar uma execução de configuração, que podem reiniciar serviços e pode interromper a migração.

Após a migração

Após a migração, a pressão de armazenamento em sua instância aumentará devido à duplicação de arquivos de imagem no Registro do Docker e a Container registry. Uma versão futura de GitHub Enterprise Server removerá os arquivos duplicados quando todas as migrações estiverem concluídas.

Para saber mais sobre o monitoramento do desempenho e do armazenamento para sua instância do GitHub Enterprise Server, confira Sobre o painel do monitor.

Início da migração

  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. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Configurações.

  3. Na barra lateral esquerda, clique em Pacotes.

  4. À direita do número de pacotes a serem migrados, clique em Iniciar migração. Durante a migração, GitHub Enterprise Server exibirá o andamento nesta página.

Após a conclusão da migração, a página exibirá os resultados. Se uma migração falhar, a página mostrará as organizações que têm o pacote que causou a falha.

Executar novamente uma migração de organização com falha

Antes da migração, se um usuário tiver criado um pacote no Container registry que tem um nome idêntico a um pacote existente no Registro do Docker, a migração falhará.

  1. Exclua o contêiner afetado no Container registry. Para saber mais, confira 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. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Configurações.

  4. Na barra lateral esquerda, clique em Pacotes.

  5. À direita do número de pacotes a serem migrados, clique em Executar migração novamente. Durante a migração, GitHub Enterprise Server exibirá o andamento nesta página.

  6. Se a migração falhar novamente, comece da etapa 1 e execute novamente a migração.