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:
-
Para evitar contenção de recursos no dispositivo, recomendamos que o MinIO seja hospedado separadamente de your GitHub Enterprise Server instance.
-
Crie seu bucket para armazenar artefatos de fluxo de trabalho. Para configurar seu bucket e chave de acesso, consulte a Documentação do MinIO. 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
(if Key Management Service (KMS) encryption has been enabled)
-
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
e127..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 MinIO Gateway para armazenamento NAS
-
SSH em your GitHub Enterprise Server instance. Para obter mais informações, consulte "Acessar o shell administrativo (SSH)".
$ ssh -p 122 admin@HOSTNAME
-
Run the
ghe-actions-precheck
command to test your blob storage configuration. Para obter mais informações, consulte "Utilitários de linha de comando". -
From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .
-
If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.
-
Na barra lateral esquerda, clique em Console de gerenciamento.
-
Na barra lateral esquerda, clique em Actions (Ações).
-
Selecione Habilitar o GitHub Actions.
-
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 para p serviço do seu MinIO. Por exemplo,
https://my-minio.example:9000
. - Balde S3 AWS: O nome do seu bucket S3.
- Chave de AWS S3 Access e Chave de AWS S3 Secret: A
MINIO_ACCESS_KEY
eMINIO_SECRET_KEY
utilizada para a sua instância do MinIO. Para obter mais informações, consulte a Documentação do MinIO.
- URL de serviço do AWS: A URL para p serviço do seu MinIO. Por exemplo,
-
Em "Armazenamento de artefatos& registro", selecione Forçar o estilo do caminho.
-
Na barra lateral esquerda, clique Save settings (Salvar configurações).
Note: Saving settings in the Console de gerenciamento restarts system services, which could result in user-visible downtime.
-
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 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.