Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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 your GitHub Enterprise Server instance para o Container registry.

Quem pode usar esse recurso

Enterprise owners can migrate Docker images to the Container registry.

O

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 "Como trabalhar com o Registro de 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 obter mais informações, confira "Como trabalhar com Container registry."

Para obter mais informações de como configurar o GitHub Packages para your GitHub Enterprise Server instance, confira "Introdução ao GitHub Packages para a empresa".

Sobre a migração do Registro do Docker

Container registry substitui o Registro do Docker de GitHub. Se o registro do Docker em your GitHub Enterprise Server instance contiver imagens, você precisará migrá-las manualmente para o Container registry.

Observação: 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 obter mais informações sobre o impacto da migração para Container registry, confira "Fazer migração para Container registry do Registro do 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 na sua 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 do site tiver configurado notificações por email para your GitHub Enterprise Server instance, você receberá um email após a conclusão da migração. Para obter mais informações, confira "Como configurar o email para notificações".

Observações :

  • 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. – Durante a migração, não modifique as configurações da sua empresa nem execute ghe-config-apply de 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, 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 obter mais informações sobre o monitoramento do desempenho e do armazenamento para your GitHub Enterprise Server instance, confira "Como acessar o painel do monitor".

  1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas
  2. Na barra lateral esquerda, clique em Pacotes.
  3. À 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 obter mais informações, confira "Como excluir e restaurar um pacote".
  2. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da conta corporativa, clique em Configurações. Guia Configurações na barra lateral das contas corporativas 1. Na barra lateral esquerda, clique em Pacotes.
  3. À 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.
  4. Se a migração falhar novamente, comece da etapa 1 e execute novamente a migração.