Primeiros passos com o GitHub Actions para o GitHub Enterprise Server

Saiba mais sobre como habilitar e configurar GitHub Actions em GitHub Enterprise Server pela primeira vez.

Site administrators can enable GitHub Actions and configure enterprise settings.

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.

Este artigo explica como os administradores do site podem configurar GitHub Enterprise Server para usar GitHub Actions. Ele abrange os requisitos de hardware e software, apresenta as opções de armazenamento e descreve as políticas de gestão de segurança.

Revise as considerações de hardware

Os recursos de CPU e memória disponíveis para sua instância do GitHub Enterprise Server determinam o número de trabalhos que podem ser executados simultaneamente sem perda de desempenho.

O pico de trabalhos simultâneos rodando sem perda de desempenho depende de fatores como duração do trabalho, uso de artefatos, número de repositórios em execução de ações, e quanto outro trabalho sua instância está fazendo não relacionado a ações. Os testes internos no GitHub demonstraram os objetivos de desempenho a seguir para o GitHub Enterprise Server em uma série de configurações de CPU e memória:

vCPUsMemóriaSimultaneidade máxima*
32128 GB1500 trabalhos
64256 GB1900 trabalhos
96384 GB2200 trabalhos

*A simultaneidade máxima foi medida usando vários repositórios, a duração do trabalho de aproximadamente 10 minutos e o upload de artefato de 10 MB. Você pode ter um desempenho diferente dependendo dos níveis gerais de atividade na sua instância.

Se vocêplano para 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 garantir 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 sua instância do GitHub Enterprise Server, 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.

O GitHub Actions usa armazenamento do blob para armazenar artefatos gerados pelas execuções do fluxo de trabalho, como registros de fluxo de trabalho e artefatos de criaçã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.

Considerações de rede

If GitHub Actions is enabled for your enterprise, only HTTP proxies are supported. SOCK5 and HTTPS proxies and Polipo are not supported. 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:

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.

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.