Skip to main content

Esta versão do GitHub Enterprise Server foi descontinuada em 2024-07-09. 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 Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Guia de início rápido para configurar o seu bucket de armazenamento de MinIO para o GitHub Packages

Configure seu bucket de armazenamento do MinIO personalizado para uso com GitHub Packages.

Platform navigation

Antes de poder habilitar e configurar GitHub Packages em sua instância do GitHub Enterprise Server, você deverá preparar sua solução de armazenamento de terceiros.

O MinIO oferece armazenamento de objetos com suporte para a API S3 e GitHub Packages na sua empresa.

Este início rápido mostra como configurar o MinIO usando o Docker para uso com GitHub Packages. No entanto, você tem outras opções para gerenciar o MinIO além do Docker. Para obter mais informações sobre o MinIO, confira a documentação oficial do MinIO.

1. Escolher um modo do MinIO para suas necessidades

Modo MinIOOtimizado paraInfraestrutura de armazenamento necessária
MinIO independente (em um único host)Configuração rápidaNão aplicável
MinIO agrupado (também denominado MinIO Distribuído)Segurança de dadosServidores de armazenamento em execução em um cluster

Para obter mais informações sobre suas opções, confira a documentação oficial do MinIO.

2. Instalar, executar e entrar no MinIO

  1. Configure suas variáveis de ambiente preferidas para o MinIO.

    Estes exemplos usam MINIO_DIR:

    export MINIO_DIR=$(pwd)/minio
    mkdir -p $MINIO_DIR
    
  2. Instalar MinIO.

    docker pull minio/minio
    

    Para obter mais informações, confira o "Guia de Início Rápido do MinIO" oficial.

  3. Efetue o login no MinIO usando sua chave e segredo de acesso do MinIO.

    $ export MINIO_ACCESS_KEY=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    # this one is actually a secret, so careful
    $ export MINIO_SECRET_KEY=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    
    $ export MINIO_ACCESS_KEY=$(cat /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    # this one is actually a secret, so careful
    $ export MINIO_SECRET_KEY=$(cat /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
    

    Você pode acessar suas chaves do MinIO usando as variáveis de ambiente:

    echo $MINIO_ACCESS_KEY
    echo $MINIO_SECRET_KEY
    
  4. Execute o MinIO no modo escolhido.

    • Execute o MinIO usando Docker em um único host:

      $ docker run -p 9000:9000 \
              -v $MINIO_DIR:/data \
              -e "MINIO_ACCESS_KEY=$MINIO_ACCESS_KEY" \
              -e "MINIO_SECRET_KEY=$MINIO_SECRET_KEY" \
              minio/minio server /data
      

      Para obter mais informações, confira "Guia de Início Rápido do MinIO no Docker".

    • Executar o MinIO usando Docker como um cluster. Esta implantação do MinIO usa vários hosts e a codificação de eliminação do MinIO para uma proteção de dados mais forte. Para executar o MinIO em um modo de cluster, confira o "Guia de início rápido do MinIO distribuído".

3. Criar seu bucket do MinIO para o GitHub Packages

  1. Instalar o cliente do MinIO.

    docker pull minio/mc
    
  2. Criar um bucket com uma URL de host que GitHub Enterprise Server pode acessar.

    • Exemplo de implantação local:

      export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @localhost:9000"
      docker run minio/mc BUCKET-NAME
      

      Este exemplo pode ser usado para o MinIO autônomo.

    • Exemplo de implantações agrupadas:

      export MC_HOST_minio="http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY} @minioclustername.example.com:9000"
      docker run minio/mc mb packages
      

Próximas etapas

Para concluir a configuração de armazenamento para GitHub Packages, você precisará copiar a URL de armazenamento do MinIO:

echo "http://${MINIO_ACCESS_KEY}:${MINIO_SECRET_KEY}@minioclustername.example.com:9000"

Para ver as próximas etapas, confira "Habilitar o GitHub Packeges com o MinIO".