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

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 MinIO	Otimizado para	Infraestrutura de armazenamento necessária
MinIO independente (em um único host)	Configuração rápida	N/D
MinIO agrupado (também denominado MinIO Distribuído)	Segurança de dados	Servidores 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".