Template-Variablen
Bette {{Variablen}} in Job-URLs, Header und Body ein – serverseitig zur Laufzeit aufgelöst, niemals im Git gespeichert.
Template-Variablen ermöglichen es, dynamische Werte in URL, Request-Header oder Body eines Jobs einzubetten – mit der {{doppelte_klammern}}-Syntax. Die Variable wird serverseitig zur Laufzeit aufgelöst. Der tatsächliche Wert wird weder in das Manifest geschrieben, noch im Git committet, noch im CLI-Diff sichtbar.
Syntax
Den Variablennamen in {{ }} einschließen:
jobs:
- id: notify-slack
kind: http
method: POST
url: https://hooks.slack.com/services/{{slack_path}}
headers:
Authorization: "Bearer {{api_token}}"
body: '{"event": "nightly-backup-complete"}'
Variablennamen müssen mit einem Buchstaben beginnen und dürfen Buchstaben, Ziffern und Unterstriche enthalten.
Verwendbare Felder
| Job-Feld | Unterstützt |
|---|---|
url | ✓ |
| Header-Werte | ✓ |
body | ✓ |
schedule | ✗ |
id / name | ✗ |
Variablenwerte definieren
Werte werden im kontoweiten Variablen-Speicher abgelegt, erreichbar im Dashboard unter Einstellungen → Variablen. Werte sind verschlüsselt und werden von der API nie im Klartext zurückgegeben.
Template-Variablen vs. ${ENV}-Platzhalter
{{template}} | ${ENV} | |
|---|---|---|
| Auflösung | Serverseitig zur Laufzeit | CLI-seitig bei apply |
| Im Manifest gespeichert | Nur der Name | Aufgelöster Wert |
| Im CLI-Diff sichtbar | Nur der Name | Aufgelöster Wert |
| Anwendungsfall | Langlebige Secrets (Tokens) | CI-Umgebungsvariablen |