Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Habilitar o GitHub Actions com MinIO Gateway para armazenamento NAS

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

Site administrators can enable GitHub Actions and configure enterprise settings.

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.

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. 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 (se a criptografia de serviço de gerenciamento de chaves (KMS) foi habilitada)
  • 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 e 127..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

  1. SSH em your GitHub Enterprise Server instance. Para obter mais informações, consulte "Acessar o shell administrativo (SSH)".

    $ ssh -p 122 admin@HOSTNAME
  2. Execute o comando ghe-actions-precheck para testar a sua configuração de armazenamento do blob. Para obter mais informações, consulte "Utilitários de linha de comando".

  3. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  4. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  5. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  6. Na barra lateral esquerda, clique em Actions (Ações).

    Aba Ações na barra lateral de configurações

  7. Selecione Habilitar o GitHub Actions. Caixa de seleção para habilitar o GitHub Actions

  8. 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 e MINIO_SECRET_KEY utilizada para a sua instância do MinIO. Para obter mais informações, consulte a Documentação do MinIO.

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

  9. Em "Armazenamento de artefatos& registro", selecione Forçar o estilo do caminho. Caixa de seleção para forçar estilo de caminho

  10. Na barra lateral esquerda, clique Save settings (Salvar configurações).

    Screenshot of the save settings button in the Console de gerenciamento

    Note: Saving settings in the Console de gerenciamento restarts system services, which could result in user-visible downtime.

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