MinIO: 5. GitLab CI
Esta documentação faz parte do guia GitHub Actions & GitLab CI. Consulte o guia completo aqui: Inicie um serviço real de MinIO a partir do seu pipeline do GitHub Actions ou GitLab CI, execute os seus testes sobre ele e elimine-o automaticamente.
👋 Bem-vindo à documentação da Stackhero!
A Stackhero disponibiliza uma plataforma MinIO Object Storage pronta a usar, concebida para garantir fiabilidade e desempenho. As principais vantagens incluem:
- Transferências ilimitadas sem custos ocultos.
- Preços simples, previsíveis e transparentes.
- Um domínio personalizado protegido por HTTPS (por exemplo, https://object-storage.sua-empresa.com).
- Atualizações automáticas e sem complicações, com apenas um clique e sem necessidade de intervenção manual.
- Elevada performance e segurança numa infraestrutura privada e dedicada.
- Disponível nas regiões 🇪🇺 Europa e 🇺🇸 USA.
Otimize o seu fluxo de trabalho e reduza o tempo de configuração: pode implementar o serviço de alojamento MinIO Object Storage da Stackhero em apenas 5 minutos.
Pode guardar esta configuração como .gitlab-ci.yml. Com esta configuração, cada execução do pipeline cria uma nova instância real de MinIO para os seus testes.
test:
image: ubuntu:24.04
variables:
STACK_NAME: "ci-minio-$CI_PIPELINE_ID-$CI_JOB_ID"
INSTANCE: "100G" # Altere se necessário (ver passo 3)
REGION: "europe"
SERVICE_STORE: "minio"
# STACKHERO_TOKEN vem da variável CI/CD criada no passo 1.
script:
- set -euo pipefail
- curl -fsSL https://www.stackhero.io/install.sh | sh
- apt-get update && apt-get install -y --no-install-recommends jq curl awscli
- STACK_ID=$(stackhero --format=script stack-create --name="$STACK_NAME")
- echo "STACK_ID=$STACK_ID" >> deploy.env
- SERVICE_ID=$(stackhero --format=script service-add --stack="$STACK_ID" --service-store="$SERVICE_STORE" --instance="$INSTANCE" --region="$REGION")
- echo "SERVICE_ID=$SERVICE_ID" >> deploy.env
- stackhero service-wait-for --service="$SERVICE_ID"
- config=$(stackhero service-configuration-get --service="$SERVICE_ID" --format=json)
- host=$(echo "$config" | jq -r '.configuration.domain')
accessKey=$(echo "$config" | jq -r '.configuration.credentials.rootUser')
secretKey=$(echo "$config" | jq -r '.configuration.credentials.rootPassword')
# List the buckets with the AWS CLI (S3-compatible).
- AWS_ACCESS_KEY_ID="$accessKey" AWS_SECRET_ACCESS_KEY="$secretKey" \
aws --endpoint-url "https://$host" s3 ls
- echo "✅ MinIO está acessível a partir do CI."
# Pode executar a sua própria suite de testes aqui usando as credenciais acima ...
after_script:
- test -f deploy.env && . ./deploy.env || true
- >
if [ -n "${SERVICE_ID:-}" ]; then
stackhero service-delete --service="$SERVICE_ID" --confirm
stackhero service-wait-for --service="$SERVICE_ID"
fi
- >
if [ -n "${STACK_ID:-}" ]; then
stackhero stack-delete --stack="$STACK_ID" --confirm
fi
No GitLab, a limpeza é feita na secção after_script. Esta secção é sempre executada, mesmo que o job falhe, garantindo que os recursos de MinIO são eliminados e que não será cobrado por recursos não utilizados.
No GitLab, o
after_scriptcorre numa shell nova. Para lidar com isto, o script grava os IDs do serviço e da stack emdeploy.envdurante o job e volta a carregá-los antes da limpeza. Assim, mesmo que algo falhe a meio do job, os seus recursos são sempre eliminados.
Este é o ciclo CI completo para MinIO: criar uma stack, adicionar o serviço, aguardar, obter credenciais, smoke-test e garantir sempre a limpeza. Cada execução do pipeline recebe um serviço real e isolado, sem nada a correr no final. Para mais informações sobre os comandos disponíveis e autenticação não interativa com STACKHERO_TOKEN, consulte a documentação completa do CLI.