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 seu bucket do MinIO para armazenar dados gerados pelas execuções do fluxo de trabalho. Para obter mais informações sobre como instalar e configurar o MinIO, confira "Armazenamento de Objetos de Alto Desempenho do MinIO" e "mc mb" na documentação do MinIO.
Para evitar contenção de recursos no dispositivo, recomendamos que o MinIO seja hospedado separadamente de your GitHub Enterprise Server instance.
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 KMS, Serviço de Gerenciamento de Chaves, tiver sido habilitada) * 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
e127.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".
- Você deve adicionar
Habilitar GitHub Actions com armazenamento do MinIO
-
Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
-
Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
1. Na barra lateral à esquerda, clique em Management Console .
1. Na barra lateral esquerda, clique em Ações.
1. Selecione Habilitar GitHub Actions.
-
Em "Armazenamento de Logs e Artefatos", selecione Amazon S3 e insira os detalhes do bucket de armazenamento:
- URL de Serviço da AWS: a URL para o serviço do MinIO. Por exemplo,
https://my-minio.example:9000
. - Bucket da AWS S3: o nome do bucket S3.
- Chave de Acesso da AWS S3 e Chave Secreta da AWS S3: o
MINIO_ACCESS_KEY
e oMINIO_SECRET_KEY
usado para sua instância do MinIO.
- URL de Serviço da AWS: a URL para o serviço do MinIO. Por exemplo,
-
Em "Armazenamento de Logs e Artefatos", selecione Forçar estilo de caminho.
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.
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.
-
Aguarde a conclusão da execução de suas configurações.
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".