Getting Started
Install the binary, register your first source, and apply a template. Start with the getting started guide.
deckctl scaffolds projects from templates you keep either on your filesystem
or in a GitLab group. It renders them with Jinja2 (via
gonja), lets you change the
delimiters so Helm and Terraform templates survive untouched, and can apply
existing Copier templates as-is.
deckctl source add --name local --type local --path ~/templatesdeckctl template list --source localdeckctl template apply go-service ./my-service --source local --var app_name=billingGetting Started
Install the binary, register your first source, and apply a template. Start with the getting started guide.
Two source types
Templates live in a local directory or in a GitLab group — public or private, gitlab.com or self-hosted. See Configuring sources.
Helm-safe rendering
Override the Jinja2 delimiters per template so charts and Go templates pass through literally. See Custom delimiters.
Copier compatible
Point deckctl at a repo with a copier.yml and it applies it — ordered
questions, computed defaults and when conditions included. See
Copier compatibility.
Cached and pinnable
GitLab templates are cached with ETag and TTL freshness checks, and --tag
pins an exact version. See Caching.
Scriptable
Every command speaks -o json, and every prompt can be skipped with a flag.
See Using deckctl in CI.
| If you want to… | Read |
|---|---|
| Install and run your first apply | Getting Started |
| Understand the moving parts | Core concepts |
| Write your own template | Authoring templates |
| Look up a command or flag | CLI Reference |
| Look up a config file field | Configuration reference |