Skip to main content

Esta versão do GitHub Enterprise será descontinuada em 2022-10-12. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Habilitar o GitHub Actions com MinIO Gateway para armazenamento NAS

Você pode habilitar GitHub Actions no GitHub Enterprise Server e usar o Gateway MinIO para armazenamento NAS para armazenar dados gerados por execuções de fluxo de trabalho.

Who can use this feature

Site administrators can enable GitHub Actions and configure enterprise settings.

Aviso: o MinIO anunciou a remoção de Gateways MinIO. A partir de 1º de junho de 2022, as correções de suporte e bug para a implementação atual do Gateway do MinIO NAS estarão disponíveis somente para clientes pagos por meio de seu contrato de suporte LTS. Se você quiser continuar usando gateways MinIO com GitHub Actions, recomendamos migrar para o suporte do MinIO LTS. Para saber mais, confira a remoção agendada do Gateway do MinIO para GCS, Azure, HDFS no repositório minio/minio.

Pré-requisitos

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 dados de 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)
  • 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 de 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 no your GitHub Enterprise Server instance:

    • Você deve adicionar localhost e 127.0.0.1 à lista de Exclusão de Proxy HTTP.
    • Se o bucket BYOS não for roteável, você também deverá adicionar a URL do bucket à lista de exclusão.

    Para obter mais informações sobre como alterar as configurações de proxy, veja "Configurando um servidor proxy Web de saída".

Habilitar GitHub Actions com MinIO Gateway para armazenamento NAS

  1. Entre com o SSH no your GitHub Enterprise Server instance. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Para obter mais informações sobre o acesso SSH, confira "Como acessar o shell administrativo (SSH)".

    $ ssh -p 122 admin@HOSTNAME
    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 .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Console de Gerenciamento . Guia Console de Gerenciamento na barra lateral esquerda 1. Na barra lateral esquerda, clique em Ações.

    Aba Ações na barra lateral de configurações 1. Selecione Habilitar GitHub Actions. Caixa de seleção para Habilitar o GitHub Actions

  3. 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 o MINIO_SECRET_KEY usado para sua instância do MinIO.

    Botão de opção para selecionar o Amazon S3 Storage e os campos para a configuração do MinIO

  4. Em "Armazenamento de Logs e Artefatos", selecione Forçar estilo de caminho. Caixa de seleção de Forçar estilo de caminho 1. Na barra lateral esquerda, clique em Salvar configurações.

    Captura de tela do botão Salvar configurações no Console de Gerenciamento

    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.

  5. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

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".