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-FeldUnterstü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ösungServerseitig zur LaufzeitCLI-seitig bei apply
Im Manifest gespeichertNur der NameAufgelöster Wert
Im CLI-Diff sichtbarNur der NameAufgelöster Wert
AnwendungsfallLanglebige Secrets (Tokens)CI-Umgebungsvariablen

Verwandte Seiten