Habilitando pacotes de GitHub com a AWS

Configure GitHub Packages com o AWS como seu armazenamento externo.

Neste artigo

Aviso

  • É fundamental que você configure as políticas de acesso restritivas necessárias para o bucket de armazenamento, pois GitHub não aplica permissões de objeto específicas ou ACLs (listas de controle de acesso) adicionais à configuração do bucket de armazenamento. Por exemplo, se o seu bucket for público, os dados do bucket poderão ser acessados por meio da internet pública. Para obter mais informações, confira Como configurar permissões de acesso de objeto e bucket na documentação da AWS. Se as restrições por endereço IP tiverem sido configuradas, inclua os endereços IP de sua instância do GitHub Enterprise Server e dos usuários finais que usarão o sua instância do GitHub Enterprise Server.
  • É recomendável usar um bucket dedicado para GitHub Packages, separado do bucket que você usa para GitHub Actions armazenamento.
  • Certifique-se de configurar o bucket que você vai querer usar no futuro. Não recomendamos alterar o armazenamento depois que você começar a usar GitHub Packages. Se você precisar mover GitHub Packages o armazenamento para um novo bucket no AWS, planeje uma única janela de manutenção e atualize as duas configurações juntas se você também estiver migrando GitHub Actions o armazenamento. Consulte "GitHub Packages considerações" em Migração do armazenamento externo do GitHub Actions. Para migrações entre provedores, entre em contato com Suporte do GitHub Enterprise.

Pré-requisitos

Antes de habilitar e configurar GitHub Packages em sua instância do GitHub Enterprise Server, você precisa preparar seu bucket de armazenamento da AWS. Para preparar o bucket de armazenamento da AWS, recomendamos consultar a documentação oficial da AWS na documentação da AWS.

Certifique-se de que o seu ID da sua chave e o segredo de acesso do AWS tenham as permissões a seguir:

  • s3:PutObject
  • s3:GetObject
  • s3:ListBucketMultipartUploads
  • s3:ListMultipartUploadParts
  • s3:AbortMultipartUpload
  • s3:DeleteObject
  • s3:ListBucket

Habilitar GitHub Packages com o armazenamento externo do AWS

  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 " Site admin", clique em Console de Gerenciamento.

  4. Na barra lateral esquerda, clique em Pacotes.

  5. Em "Pacotes do GitHub", marque a caixa de seleção Habilitar Pacotes do GitHub.

  6. Em "Armazenamento de Pacotes", selecione Amazon S3 e insira os detalhes do bucket de armazenamento:

    • URL de Serviço da AWS: a URL de serviço para seu bucket. Por exemplo, se o bucket S3 foi criado na us-west-2 region, esse valor deve ser https://s3.us-west-2.amazonaws.com.

      Para obter mais informações, confira Pontos de extremidade de serviço da AWS na documentação da AWS.

    • Bucket do AWS S3: O nome do bucket S3 dedicado a GitHub Packages.

    • Chave de Acesso da AWS S3 e Chave Secreta da AWS S3: a ID da chave de acesso e a chave secreta da AWS para acessar seu bucket.

      Para saber mais sobre como gerenciar chaves de acesso da AWS, confira a Documentação de gerenciamento de identidades e acesso da AWS.

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

    Observação

    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.

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

Próximas etapas

Como a próxima etapa, você pode personalizar os ecossistemas de pacote que você gostaria de disponibilizar para os usuários finais em GitHub. Para saber mais, confira Configuração do suporte ao ecossistema de pacotes para sua empresa.

Para ter uma visão geral de introdução ao GitHub Packages no GitHub, confira Introdução aos pacotes de GitHub para sua empresa.