Skip to main content
Version: v0.12

Kusion stack file reference

Every Kusion project's stack has a stack file, stack.yaml, which specifies metadata about your stack, such as the stack name and stack description. The stack file must begin with lowercase stack and have an extension of either .yaml or .yml.

Attributes

NameRequiredDescriptionOptions
namerequiredName of the stack containing alphanumeric characters, hyphens, underscores.None
descriptionoptionalA brief description of the stack.None
extensionsoptionalList of extensions on the stack.See blow

Extensions

Extensions allow you to customize how resources are generated or customized as part of release.

kubernetesNamespace

The Kubernetes namespace extension allows you to customize namespace within your application generate Kubernetes resources.

KeyRequiredDescriptionExample
kindyThe kind of extension being used. Must be 'kubernetesNamespace'kubernetesNamespace
namespaceyThe namespace where all application-scoped resources generate Kubernetes objects.default
# Example `stack.yaml` file with customized namespace of `test`. 
name: dev
extensions:
- kind: kubernetesNamespace
kubernetesNamespace:
namespace: test