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 atualizadas, acesse a documentação em inglês.

Como habilitar o GitHub Actions com o Google Cloud Storage

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

Quem pode usar esse recurso

Site administrators can enable GitHub Actions and configure enterprise settings.

Observação: o suporte do GitHub Actions para o Google Cloud Storage está em versão beta e sujeito a alterações no momento.

Sobre o armazenamento externo para GitHub Actions

O GitHub Actions usa armazenamento de blob externo para armazenar dados gerados por execuções de fluxo de trabalho, como logs de fluxo de trabalho, caches e artefatos de compilação carregados pelo usuário. Para obter mais informações, confira "Introdução ao GitHub Actions para GitHub Enterprise Server".

Pré-requisitos

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

  • Crie um bucket do Google Cloud Storage para armazenar dados gerados pelas execuções de fluxo de trabalho.

  • Crie uma conta de serviço do Google Cloud que possa acessar o bucket e crie uma chave HMAC (Hash-based Message Authentication Code) para a conta de serviço. Para obter mais informações, confira "Como criar e gerenciar chaves HMAC para contas de serviço" na documentação do Google Cloud.

    A conta de serviço precisa ter as seguintes permissões de IAM (Gerenciamento de Identidades e Acesso) para o bucket:

    • storage.objects.create
    • storage.objects.get
    • storage.objects.list
    • storage.objects.update
    • storage.objects.delete
    • storage.multipartUploads.create
    • storage.multipartUploads.abort
    • storage.multipartUploads.listParts
    • storage.multipartUploads.list * Revisar os requisitos de hardware para GitHub Actions. Para obter mais informações, confira "Introdução ao GitHub Actions para GitHub Enterprise Server".
  • O TLS deve ser configurado para o domínio do your GitHub Enterprise Server instance. Para obter mais informações, confira "Como configurar o 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ê deve adicionar localhost e 127.0.0.1 à lista de Exclusão de Proxy HTTP.
    • Se o local de armazenamento externo não for encaminhável, você também precisará adicionar a URL de armazenamento externo à lista de exclusões.

    Para obter mais informações sobre como alterar as configurações de proxy, veja "Configurando um servidor proxy Web de saída".

Como habilitar o GitHub Actions com o Google Cloud Storage

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

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

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

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda 1. Na barra lateral esquerda, clique em Ações.

    Aba Ações na barra lateral de configurações 1. Selecione Habilitar GitHub Actions. Caixa de seleção para Habilitar o GitHub Actions

  3. Em "Armazenamento de Artefatos e Logs", selecione Google Cloud Storage e insira os detalhes do bucket de armazenamento:

    • URL de Serviço: a URL de serviço do bucket. Geralmente, é https://storage.googleapis.com.
    • Nome do bucket: o nome do bucket.
    • ID de acesso HMAC e Segredo HMAC: a ID de acesso do Google Cloud e o segredo da conta de armazenamento. Para obter mais informações, confira "Como criar e gerenciar chaves HMAC para contas de serviço" na documentação do Google Cloud.

    Botão de opção para selecionar o Google Cloud Storage e campos para configuração 1. Clique no botão Testar configurações de armazenamento para validar as configurações de armazenamento.

    Se houver erros ao validar as configurações de armazenamento, verifique as configurações no provedor de armazenamento e tente novamente. 1. Na barra lateral esquerda, clique em Salvar configurações.

    Captura de tela do botão Salvar configurações no Management Console

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

  4. 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 as próximas etapas, como o gerenciamento das permissões de acesso do GitHub Actions e a adição de executores auto-hospedados, volte a "Introdução ao GitHub Actions para GitHub Enterprise Server".