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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Habilitar o GitHub Actions com armazenamento do Amazon S3

Você pode habilitar GitHub Actions em GitHub Enterprise Server e usar o armazenamento Amazon S3 para armazenar dados gerados por execuções de fluxo de trabalho.

Site administrators can enable GitHub Actions and configure enterprise settings.

Pré-requisitos

Aviso: Os únicos provedores de armazenamento S3 compatíveis são Amazon S3 e MinIO Gateway para NAS. Os outros provedores de armazenamento compatíveis com a API do S3 não são compatíveis. Para obter mais informações sobre provedores de armazenamento compatíveis, consulte "Primeiros passos com GitHub Actions para o GitHub Enterprise Server".

Antes de habilitar GitHub Actions, certifique-se de que você realizou os seguintes passos:

  • Crie seu bucket do Amazon S3 para armazenar dados gerados pelas execuções do fluxo de trabalho. GitHub Actions exige as seguintes permissões para a chave de acesso que terá acesso ao bucket:

    • s3:PutObject
    • s3:GetObject
    • s3:ListBucketMultipartUploads
    • s3:ListMultipartUploadParts
    • s3:AbortMultipartUpload
    • s3:DeleteObject
    • s3:ListBucket
    • kms:GenerateDataKey (se a criptografia de serviço de gerenciamento de chaves (KMS) foi habilitada)
  • Revisar os requisitos de hardware para GitHub Actions. Para obter mais informações, consulte "Primeiros passos com GitHub Actions for GitHub Enterprise Server".

  • O TLS deve ser configurado para o domínio de your GitHub Enterprise Server instance. Para obter mais informações, consulte "Configurar TLS".

    Observação: É altamente recomendável que você configure a TLS em GitHub Enterprise Server com um certificado assinado por uma autoridade confiável. Embora um certificado autoassinado possa funcionar, é necessária uma configuração extra para os seus executores auto-hospedados, e não é recomendado para ambientes de produção.

  • Se você tiver um Servidor Proxy HTTP configurado em your GitHub Enterprise Server instance, você deverá adicionar localhost e 127..0.1 à lista HTTP Proxy Exclusion. Para obter mais informações sobre como alterar as configurações de proxy, consulte "Configurar um servidor de proxy web de saída".

Habilitar GitHub Actions com armazenamento do Amazon S3

  1. SSH em your GitHub Enterprise Server instance. Para obter mais informações, consulte "Acessar o shell administrativo (SSH)".

    $ ssh -p 122 admin@HOSTNAME
  2. Execute o comando ghe-actions-precheck para testar a sua configuração de armazenamento do blob. Para obter mais informações, consulte "Utilitários de linha de comando".

  3. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  4. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  5. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  6. Na barra lateral esquerda, clique em Actions (Ações).

    Aba Ações na barra lateral de configurações

  7. Selecione Habilitar o GitHub Actions. Caixa de seleção para habilitar o GitHub Actions

  8. Em "Artefato & Registro de Armazenamento", selecione Amazon S3, e insira as informações do seu grupo de armazenamento:

    • URL de serviço do AWS: A URL do serviço para seu bucket. Por exemplo, se o seu bucket S3 foi criado na região us-west-2, esse valor deverá ser https://s3.us-west-2.amazonaws.com.

      Para obter mais informações, consulte "pontos de extremidade do serviço AWS" na documentação do AWS.

    • Balde S3 AWS: O nome do seu bucket S3.

    • Chave de acesso do AWS S3 e Chave de segredo do AWS S3: A chave de acesso AWS e chave do segredo para o seu bucket. Para mais informações sobre como gerenciar as chaves de acesso do AWS, consulte a "Documentação de identidade do AWS e gerenciamento de acesso".

    Botão de opção para selecionar o armazenamento do Amazon S3 e campos para configuração S3

  9. Na barra lateral esquerda, clique Save settings (Salvar configurações).

    Screenshot of the save settings button in the Console de gerenciamento

    Note: Saving settings in the Console de gerenciamento restarts system services, which could result in user-visible downtime.

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

    Configurar a instância

Próximas etapas

Depois que a execução da configuração tiver sido concluída com sucesso, GitHub Actions será habilitado em your GitHub Enterprise Server instance. Para os seus próximos passos, como gerenciar as permissões de acesso GitHub Actions e adicionar executores auto-hospedados, retorne para "Primeiros passos com GitHub Actions para GitHub Enterprise Server.