Zum Inhalt springen
diggn.de
← alle Beiträge Projekte · · 3 Minuten

Drei Fehler, die erst der echte Deploy gezeigt hat

Diese Seite läuft als Docker-Stack hinter Traefik. Die Konfiguration sah dreimal richtig aus und war es dreimal nicht, und keiner der Fehler war lokal zu sehen.

Die Preview liegt auf einem Portainer-Host mit Swarm, davor ein Traefik, das die Zertifikate per HTTP-01 holt. Das Muster habe ich von einem Stack übernommen, der dort schon läuft. Beim ersten Deploy ging trotzdem nichts, und zwar aus drei unabhängigen Gründen.

Das Label, das Traefik nie gesehen hat

Traefik antwortete mit 404 und seinem eigenen Default-Zertifikat. Die Labels waren da, die Regeln stimmten, der Container lief.

Sie standen nur unter deploy.labels:

diggn-de.preview.docker-compose.ymlYAML
deploy:
  replicas: 1
  restart_policy:
    condition: any
  labels:
    - 'traefik.enable=true'

Falsch ist das nicht, es ist nur für einen anderen Traefik gedacht. deploy.labels landen am Swarm-Service-Objekt. Traefik läuft auf diesem Host aber als gewöhnlicher Container und nutzt deshalb den Docker-Provider, und der sieht Container-Labels. Das Service-Objekt schaut er sich nie an. Beide Schreibweisen sind gültiges Compose, beide werden ohne Murren angenommen, und genau eine wird gelesen.

Der Stack, von dem ich abgeschrieben hatte, macht es richtig. Ich hatte den Unterschied überlesen, weil er wie Einrückung aussieht.

Eine Fehlermeldung als Passwort

Die n8n-Oberfläche im selben Stack soll hinter Basic Auth liegen, und der Stack soll gar nicht erst starten, wenn die Zugangsdaten fehlen. Dafür gibt es die Fragezeichen-Form:

compose.preview.ymlYAML
- 'traefik.http.middlewares.diggn-n8n-auth.basicauth.users=${N8N_UI_BASICAUTH:?set N8N_UI_BASICAUTH}'

Meine erste Fassung hatte dort eine ausführliche deutsche Erklärung stehen, mitsamt einem Geviertstrich. Die hat die Substitution nicht überlebt. Statt den Start abzubrechen, landete ihr Rest als vermeintlicher htpasswd-Wert im Label, Traefik nahm ihn an, und die Oberfläche stand offen.

Die Sicherung, die den Start anhalten sollte, hat das Loch aufgemacht, das sie bewachen sollte.

Jetzt steht dort ein kurzer ASCII-Text. Nebenbei kam dabei heraus, dass Portainer den Variablenwert wörtlich durchreicht und $$ nicht auflöst: Der bcrypt-Hash gehört dort mit einfachem $ hinein, verdoppelt scheitert die Anmeldung.

Der Deploy, der Erfolg meldete, ohne nachzusehen

Der dritte Fehler war der bequemste. Der CI-Job rief git/redeploy in der Portainer-API auf und meldete danach Erfolg. Nur ist das hier ein File-Stack: Der Inhalt kommt aus diesem Repo, nicht aus einem Git-Remote, das Portainer selbst kennt. Der Aufruf lief durch und tat nichts.

Richtig ist PUT /api/stacks/:id mit stackFileContent, dazu registries mit der ID des hinterlegten Zugangs. Fehlt die, zieht Swarm das private Image nicht und lehnt die Tasks mit „No such image“ ab.

Was ich seitdem am wichtigsten finde, ist der letzte Schritt des Jobs. Statt sich darauf zu verlassen, dass die API den Redeploy angenommen hat, fragt er die echte URL ab, bis sie 200 liefert:

.gitlab-ci.ymlShell
for i in $(seq 1 20); do
  code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 10 https://www.diggn.preview.diggn.de/ || echo 000)
  [ "$code" = "200" ] && { echo "Preview antwortet mit 200."; exit 0; }
  sleep 15
done

Alle drei Fehler haben eines gemeinsam: Lokal gab es nichts, was sie hätte zeigen können. Es gab kein Traefik, das die Labels liest, keine Portainer-Substitution und keine API, die einen Aufruf freundlich ignoriert. Ob eine Konfiguration stimmt, zeigt sich erst, wenn am anderen Ende etwas Echtes antwortet. Genau das prüft der Job jetzt.

#docker#traefik#ci

Ähnliche Beiträge