Primeiros passos com o GitHub Packages para a sua empresa

Note

Atualmente, o GitHub Packages no GitHub Enterprise Server não tem suporte para clustering.

Passo 1: Verifique se GitHub Packages está disponível para a sua empresa

GitHub Packages está disponível em GitHub Enterprise Server 3.0 ou superior. Se você estiver usando uma versão anterior do GitHub Enterprise Server, você deverá fazer a atualização para usar GitHub Packages. Para obter mais informações sobre como fazer upgrade da sua instância do GitHub Enterprise Server, confira Sobre atualizações para novas versões.

Etapa 2: revisar os requisitos de hardware

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

É 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 Monitorar sua instância.

Para obter mais informações sobre os requisitos mínimos de hardware de sua instância do GitHub Enterprise Server, confira as considerações sobre hardware da plataforma da 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 o GitHub Packages e configurar o armazenamento externo

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

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

Provedores de armazenamento externos compatíveis

Amazon Web Services (AWS) S3
Azure Blob Storage
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 pacote você gostaria de habilitar, desabilitar ou definir como somente leitura no seu 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, confira Configurar o suporte ao ecossistema de pacote 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 o sua instância do GitHub Enterprise Server, você precisará criar e carregar um certificado TLS que permita a URL do host do pacote para 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á usa o Let's Encrypt, solicite um novo certificado TLS depois de habilitar o 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 como carregar certificados TLS no GitHub Enterprise Server, confira Configurar o TLS.

Etapa 6: verificar e renomear nomes reservados

Se você quiser usar o ecossistema do Docker com isolamento de subdomínio desabilitado, primeiro renomeie qualquer usuário ou organização chamada v2 na sua instância do GitHub Enterprise Server, e depois habilite 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 Administrar sua instância por meio da interface do usuário da Web.