Elasticsearch: 5. GitLab CI
Diese Dokumentation ist Teil des GitHub Actions & GitLab CI-Leitfadens. Den vollständigen Leitfaden finden Sie hier: Starten Sie einen echten Elasticsearch-Service direkt aus Ihrer GitHub Actions- oder GitLab CI-Pipeline, führen Sie Ihre Tests dagegen aus und fahren Sie ihn anschließend automatisch wieder herunter.
👋 Willkommen in der Stackhero-Dokumentation
Stackhero bietet einen vollständig verwalteten Elasticsearch Cloud Service, der für professionelle Anwender entwickelt wurde, die zuverlässige Suche, Analysen und Logging in großem Maßstab benötigen.
- Gleichbleibende Performance und hohe Sicherheit durch eine private, dedizierte Infrastruktur.
- Einfache Einrichtung eines individuellen Domainnamens, abgesichert durch HTTPS.
Starten Sie schnell und konzentrieren Sie sich auf Ihr Kerngeschäft: Sie können in etwa 5 Minuten eine produktionsreife Elasticsearch Cloud Hosting Umgebung bereitstellen – Wartung und Sicherheit werden für Sie übernommen.
Speichern Sie diese Konfiguration als .gitlab-ci.yml. Mit diesem Setup wird bei jedem Pipeline-Lauf eine frische, echte Elasticsearch-Instanz für Ihre Tests bereitgestellt.
test:
image: ubuntu:24.04
variables:
STACK_NAME: "ci-elasticsearch-$CI_PIPELINE_ID-$CI_JOB_ID"
INSTANCE: "20G" # Bei Bedarf anpassen (siehe Schritt 3)
REGION: "europe"
SERVICE_STORE: "elasticsearch"
# STACKHERO_TOKEN stammt aus der in Schritt 1 angelegten CI/CD-Variable.
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
- 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')
user=$(echo "$config" | jq -r '.configuration.credentials.login')
password=$(echo "$config" | jq -r '.configuration.credentials.password')
# Call the cluster health endpoint.
- curl -fsS -u "$user:$password" "https://$host:9200/_cluster/health" | grep -q '"status"'
- echo "✅ Elasticsearch ist aus der CI erreichbar."
# Sie können hier Ihre eigene Test-Suite mit den oben extrahierten Zugangsdaten ausführen ...
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
In GitLab erfolgt das Aufräumen im Abschnitt after_script. Dieser wird immer ausgeführt, auch wenn der Job fehlschlägt, sodass Ihre Elasticsearch-Ressourcen entfernt werden und keine unnötigen Kosten entstehen.
In GitLab läuft
after_scriptin einer frischen Shell. Um dies zu berücksichtigen, schreibt das Skript die Service- und Stack-IDs während des Jobs indeploy.envund lädt sie vor dem Aufräumen wieder ein. So wird sichergestellt, dass Ihre Ressourcen auch bei einem Fehler im Job entfernt werden.
Damit ist der komplette CI-Lebenszyklus für Elasticsearch abgedeckt: Stack erstellen, Service hinzufügen, warten, Zugangsdaten abrufen, Smoke-Test, und immer aufräumen. Jeder Pipeline-Lauf erhält einen echten, isolierten Service – nach Abschluss bleibt nichts zurück. Weitere Informationen zu verfügbaren Befehlen und zur nicht-interaktiven Authentifizierung mit STACKHERO_TOKEN finden Sie in der vollständigen CLI-Dokumentation.