Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
Sobre GitHub Actions em GitHub Enterprise Server
Este artigo explica como os administradores do site podem configurar GitHub Enterprise Server para usar GitHub Actions.
GitHub Actions is available in GitHub Enterprise Server 3.0 or higher. If you're using an earlier version of GitHub Enterprise Server, you'll have to upgrade to use GitHub Actions. Para obter mais informações sobre a atualização da instância de GitHub Enterprise Server, consulte "Sobre as atualizações para novas versões de."
Por padrão, GitHub Actions não está habilitado para GitHub Enterprise Server. Você deberá determinar se a sua instância possui recursos adequados de CPU e memória para lidar com a carga do GitHub Actions sem causar perda de desempenho e possivelmente aumentar esses recursos. Você também precisará decidir qual provedor de armazenamento irá usar para o armazenamento do blob necessário para armazenar os artefatos gerados pela execução do fluxo de trabalho. Em seguida, você irá habilitar GitHub Actions para a sua empresa, gerenciar permissões de acesso e adicionar executores auto-hospedados para executar fluxos de trabalho.
Antes de começar, você deve fazer um plano de como apresentar GitHub Actions para a sua empresa. Para obter mais informações, consulte "Apresentando GitHub Actions � sua empresa".
Se você estiver migrando sua empresa para GitHub Actions de outro provedor, há considerações adicionais. Para obter mais informações, consulte "Migrando sua empresa para GitHub Actions".
Revisar os requisitos de hardware
Os recursos da CPU e memória disponíveis para your GitHub Enterprise Server instance determinam o rendimento máximo do trabalho para GitHub Actions. GitHub recomenda um mínimo de 8 vCPU e 64 GB de memória para executar GitHub Actions.
O teste interno em GitHub demonstrou o rendimento máximo a seguir para instâncias de GitHub Enterprise Server com um intervalo de configurações da CPU e memória. Você pode ver diferentes tipos de transferência, dependendo dos níveis gerais de atividade na sua instância.
| vCPUs | Memória | Rendimento máximo do trabalho |
|---|---|---|
| 4 | 32 GB | Demonstração ou testes rápidos |
| 8 | 64 GB | 25 trabalhos |
| 16 | 160 GB | 35 trabalhos |
| 32 | 256 GB | 100 trabalhos |
Se você planeja habilitar GitHub Actions para os usuários de uma instância existente, revise os níveis de atividade para usuários e automações na instância e garanta que você tenha fornecido CPU e memória adequadas para seus usuários. Para obter mais informações sobre o monitoramento da capacidade e desempenho de GitHub Enterprise Server, consulte "Monitoramento do seu aplicativo".
Para obter mais informações sobre os requisitos mínimos de hardware para your GitHub Enterprise Server instance, consulte as considerações sobre hardware para a plataforma da sua instância.
Para obter mais informações sobre o ajuste de recursos para uma instância existente, consulte "aumentar a capacidade de armazenamento" e "aumentar recursos de CPU ou memória".
Requisitos de armazenamento externo
Para habilitar o GitHub Actions em GitHub Enterprise Server, você deve ter acesso ao armazenamento externo do blob.
GitHub Actions usa armazenamento do blob para armazenar dados gerados pela execução de fluxo de trabalho, tais como logs de fluxo de trabalho e artefatos de compilação enviados pelo usuário. A quantidade de armazenamento necessária depende do seu uso de GitHub Actions. Somente uma única configuração de armazenamento externo é compatível, e você não pode usar vários provedores de armazenamento ao mesmo tempo.
GitHub Actions é compatível com estes provedores de armazenamento:
- Armazenamento do Azure Blob
- Amazon S3
- MinIO Gateway compatível com S3 para NAS
Observação: Estes são os únicos provedores de armazenamento com os quais GitHub é compatível e podem fornecer ajuda. Outros provedores de armazenamento compatíveis com a API do S3 provavelmente não funcionarão devido a diferenças em relação � API do S3. Entre em contato conosco para pedir suporte para provedores de armazenamento adicionais.
Aviso: O MinIO anunciou a remoção dos Gateways do MinIO. A partir de 1 de junho, 2022, o suporte e correções de erros para a implementação atual do MinIO NAS Gateway só estará disponível para clientes pagos por meio do contrato de suporte do LTS. Se você deseja continuar usando MinIO Gateways com GitHub Actions, nós recomendamos a transferência para o suporte do MinIO LTS. Para obter mais informações, consulte Remoção agendada do MinIO Gateway para o GCS, Azure, HDFS no repositório minio/minio.
Antes de habilitar o GitHub Actions, você pode testar a sua configuração de armazenamento a partir do shell administrativo com o utilitário ghe-actions-precheck. Para obter mais informações, consulte "Utilitários de linha de comando" e "Acessando o shell administrativo (SSH)".
Considerações de rede
Se GitHub Actions estiver habilitado para sua empresa, apenas os proxies HTTP são compatíveis. Os proxies SOCK5 e HTTPS e Polipo não são compatíveis. Para obter mais informações sobre o uso de um proxy com GitHub Enterprise Server, consulte "Configurando um servidor de proxy web de saída".
Habilitar GitHub Actions com o seu provedor de armazenamento
Siga um dos procedimentos abaixo para habilitar GitHub Actions com o seu provedor de armazenamento escolhido:
- Habilitar o o GitHub Actions com armazenamento do Azure Blob
- Habilitar o GitHub Actions com armazenamento do Amazon S3
- Habilitar o GitHub Actions com MinIO Gateway para armazenamento NAS
Gerenciar as permissões de acesso para GitHub Actions na sua empres
Você pode usar políticas para gerenciar o acesso a GitHub Actions. Para obter mais informações, consulte "Aplicando as políticas do GitHub Actions para sua empresa".
Adicionar executores auto-hospedados
Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
Para executar fluxos de trabalho de GitHub Actions, você deve adicionar executores auto-hospedados. Você pode adicionar executores auto-hospedados nos níveis da empresa, organização ou repositório. Para obter mais informações, consulte "Adicionando executores auto-hospedados".
Gerenciar quais ações podem ser usadas na sua empresa
Você pode controlar quais ações os usuários têm permissão para usar na sua empresa. Isso inclui a configuração de GitHub Connect para acesso automático � s ações de GitHub.com, ou a sincronização manual das ações de GitHub.com.
Para obter mais informações, consulte "Sobre o uso de ações na sua empresa".
Fortalecimento geral de segurança para GitHub Actions
Se você quiser saber mais sobre as práticas de segurança para GitHub Actions, consulte "Fortalecimento da segurança para GitHub Actions".
Nomes reservados
Ao habilitar GitHub Actions para a sua empresa, serão criadas duas organizações: github e actions. Se sua empresa já usa o nome da organização github, github-org (ou github-github-org se github-org também estiver em uso) será usado. Se sua empresa já usa o nome da organização actions, github-actions (ou github-actions-org se github-actions também estiver em uso) será usado. Uma vez que as ações são habilitadas, você não poderá usar mais esses nomes.