Pré-requisitos
Aviso: os únicos provedores de armazenamento S3 com suporte são o Amazon S3 e o Gateway do MinIO 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 os provedores de armazenamento com suporte, confira "Introdução ao GitHub Actions para 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 KMS, Serviço de Gerenciamento de Chaves, tiver sido habilitada)
-
Review the hardware requirements for GitHub Actions. For more information, see "Getting started with GitHub Actions for GitHub Enterprise Server."
-
TLS must be configured for your GitHub Enterprise Server instance's domain. For more information, see "Configuring TLS."
Note: É 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.
-
If you have an HTTP Proxy Server configured on your GitHub Enterprise Server instance:
- You must add
localhost
and127.0.0.1
to the HTTP Proxy Exclusion list. - If the BYOS bucket is not routable, then you must also add the bucket's URL to the exclusion list.
For more information on changing your proxy settings, see "Configuring an outbound web proxy server."
- You must add
Habilitar GitHub Actions com armazenamento do Amazon S3
-
SSH into your GitHub Enterprise Server instance. If your instance comprises multiple nodes, for example if high availability or geo-replication are configured, SSH into the primary node. If you use a cluster, you can SSH into any node. For more information about SSH access, see "Accessing the administrative shell (SSH)."
1. Execute o comando `ghe-actions-precheck` para testar a sua configuração de armazenamento do blob. Para obter mais informações, confira "[Utilitários de linha de comando](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-actions-precheck)". 1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .$ ssh -p 122 admin@HOSTNAME
-
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 Console de Gerenciamento . 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 de serviço do bucket. Por exemplo, se o bucket S3 foi criado na região
us-west-2
, esse valor deve serhttps://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 da AWS S3: o nome do bucket S3.
-
Chave de Acesso da AWS S3 e Chave Secreta da AWS S3: a ID da chave de acesso da AWS e a chave secreta do bucket. Para obter mais informações sobre como gerenciar chaves de acesso da AWS, confira a "Documentação de gerenciamento de identidades e acesso da AWS".
1. Na barra lateral esquerda, 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.
-
-
Aguarde a conclusão da execução de suas configurações.
Next steps
After the configuration run has successfully completed, GitHub Actions will be enabled on your GitHub Enterprise Server instance. For your next steps, such as managing GitHub Actions access permissions and adding self-hosted runners, return to "Getting started with GitHub Actions for GitHub Enterprise Server."