Introdução aos pacotes de GitHub para sua empresa

Observação

Atualmente, o GitHub Packages no GitHub Enterprise Server não dá suporte a clustering.

Etapa 1: verificar se GitHub Packages está disponível para sua empresa

GitHub Packages está disponível na GitHub Enterprise Server versão 3.0 ou superior. Se você estiver usando uma versão anterior do GitHub Enterprise Server, precisará atualizar para usar GitHub Packages. Para obter mais informações sobre como atualizar sua GitHub Enterprise Server instância, consulte Sobre atualizações para novas versões.

Etapa 2: revisar os requisitos de hardware

Se você planeja habilitar Container registry para os usuários de sua instância, pelo menos 10% mais recursos de CPU serão necessários.

É recomendável revisar os níveis de atividade para usuários e automações na instância a fim de garantir que você tenha provisionado recursos suficientes de CPU para seus usuários. Para saber mais, confira Monitore o seu instance.

Para obter mais informações sobre os requisitos mínimos de hardware para sua instância do GitHub Enterprise Server, consulte as considerações de hardware para a plataforma da sua instância.

Para obter mais informações sobre como ajustar recursos para uma instância existente, confira Aprimorar os recursos de CPU ou memória.

Etapa 3: Habilitar GitHub Packages e configurar o armazenamento externo

GitHub Packages em GitHub Enterprise Server usa o armazenamento de blobs externo para armazenar seus pacotes.

Depois de habilitar GitHub Packages para sua instância do GitHub Enterprise Server, você precisará preparar seu bucket de armazenamento de terceiros. A quantidade de armazenamento necessária depende do seu uso e as diretrizes de GitHub Packagesinstalação podem variar de acordo com o provedor de armazenamento.

Provedores de armazenamento externos compatíveis

AWS (Amazon Web Services) S3
Armazenamento de Blobs do Azure
MinIO

Para habilitar GitHub Packages e configurar o armazenamento de terceiros, consulte:

Etapa 4: especificar os ecossistemas de pacotes que serão compatíveis com a sua instância

Escolha quais ecossistemas de pacotes você deseja habilitar, desabilitar ou definir como somente leitura em sua instância do GitHub Enterprise Server. As opções disponíveis são Container registry, Docker, RubyGems, npm, Apache Maven, Gradle ou NuGet. Para obter mais informações, consulte Configuração do suporte ao ecossistema de pacotes para sua empresa.

Etapa 5: verificar se você tem um certificado TLS para a URL do host do pacote, se necessário

Se o isolamento de subdomínio estiver habilitado para sua instância do GitHub Enterprise Server, você precisará criar e enviar um certificado TLS que seja válido para a URL de host do pacote de cada ecossistema que deseja usar, como containers.HOSTNAME. Verifique se cada URL do host do pacote inclui https://.

Você pode criar o certificado manualmente ou usar Let's Encrypt. Se você já usar o Let's Encrypt, deverá solicitar um novo certificado TLS depois de habilitar GitHub Packages. Para obter mais informações sobre as URL do host de pacote, confira Habilitar isolamento de subdomínio. Para obter mais informações sobre o upload de certificados TLS para GitHub Enterprise Server, consulte Configurando o TLS.

Etapa 6: verificar e renomear nomes reservados

Se você quiser usar o ecossistema do Docker com o isolamento de subdomínio desabilitado, primeiro você deve renomear qualquer usuário ou organização chamado v2 em sua instância do GitHub Enterprise Server, antes de habilitar o suporte ao ecossistema do Docker no Console de Gerenciamento. O Docker usa o nome de conta v2 para gerenciar conflitos de caminho com a API do Docker. Depois que o suporte ao registro do Docker estiver habilitado, você não poderá mais usar esse nome.

Você pode ver uma lista completa de logons reservados para uso interno acessando a página "Logons reservados" no painel do administrador do site. Para saber mais, confira Sobre nomes de usuário reservados para GitHub Enterprise Server.

Quem pode usar esse recurso?

Neste artigo