Configurar o suporte ao ecossistema de pacote para sua empresa

Você pode configurar o GitHub Packages para sua empresa habilitando ou desabilitando globalmente ecossistemas de pacotes individuais na empresa, incluindo Container registry, o Docker e o npm. Conheça outros requisitos de configuração para dar suporte aos ecossistemas de pacote específicos.

Quem pode usar esse recurso?

Site administrators can enable GitHub Packages and configure enterprise settings.

Neste artigo

Sobre o suporte ao ecossistema de pacotes

Você pode escolher quais ecossistemas de pacote você gostaria de habilitar, desabilitar ou definir como somente leitura no sua instância do GitHub Enterprise Server. As opções disponíveis são Container registry, Docker, RubyGems, npm, Apache Maven, Gradle ou NuGet.

Pré-requisitos

Antes de configurar ecossistemas de pacotes individuais, o GitHub Packages deve ser habilitado e configurado para sua instância. Para saber mais, confira Primeiros passos com o GitHub Packages para a sua empresa.

Habilitar ou desabilitar os ecossistemas de cada pacote

Para evitar que novos pacotes sejam carregados, você pode definir um ecossistema que já você habilitou como Somente Leitura, permitindo que os pacotes existentes sejam baixados.

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

  4. Na barra lateral esquerda, clique em Pacotes.

  5. Abaixo de “Alternâncias de ecossistema”, para cada tipo de pacote, selecione Habilitado, Somente leitura ou Desabilitado.

    Note

    O isolamento de subdomínio precisa ser habilitado para ativação e desativação das opções do Container registry.

    Captura de tela da seção “Ecosystem toggles” na página Settings do Console de Gerenciamento.

  6. Na barra lateral "Configurações", clique em Salvar configurações.

    Note

    Se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  7. Aguarde a conclusão da execução de suas configurações.

Conectar ao registro oficial do npm

Se você habilitou os pacotes do npm na sua empresa e deseja permitir acesso ao registro oficial do npm, bem como ao registro npm do GitHub Packages, você deverá executar uma configuração adicional.

O GitHub Packages usa um proxy transparente para o tráfego de rede que se conecta ao registro npm oficial em registry.npmjs.com. O proxy está habilitado por padrão e não pode ser desabilitado.

Para permitir conexões de rede com o registro npm, você precisará configurar ACLs de rede que permitam que o GitHub Enterprise Server envie o tráfego HTTPS para registry.npmjs.com pela porta 443/TCP.

Observe que as conexões com o registry.npmjs.com percorrem a rede do Cloudflare e, em seguida, não se conectam a um único endereço IP estático. Em vez disso, uma conexão é feita com um endereço IP dentro dos intervalos CIDR listados aqui: https://www.cloudflare.com/ips/.

Caso deseje habilitar fontes upstream do npm, selecione Enabled para npm upstreaming.

Próximas etapas

Como a próxima etapa, recomendamos que verifique se precisa atualizar ou carregar um certificado TLS para a URL do seu pacote de host. Para saber mais, confira Primeiros passos com o GitHub Packages para a sua empresa.