Skip to main content
Version: v0.13

Kusion project file reference

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

Attributes

NameRequiredDescriptionOptions
namerequiredName of the project containing alphanumeric characters, hyphens, underscores.None
descriptionoptionalA brief description of the project.None
extensionsoptionalList of extensions on the project.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 `project.yaml` file with customized namespace of `test`. 
name: example
extensions:
- kind: kubernetesNamespace
kubernetesNamespace:
namespace: test