Below is the schema reference for the Project and Module garden.yml configuration files. For an introduction to configuring a Garden project, please look at our configuration guide.

The reference is divided into four sections. The first section lists and describes the available schema keys for the project level configuration, and the second section contains the project level YAML schema.

The third section lists and describes the available schema keys for the module level configuration, and the fourth section contains the module level YAML schema.

Note that individual providers, e.g. kubernetes, add their own project level configuration keys. The provider types are listed on the Providers page.

Likewise, individual module types, e.g. container, add additional configuration keys at the module level. Module types are listed on the Module Types page.

Please refer to those for more details on provider and module configuration.

Project configuration keys

apiVersion

The schema version of this project's config (currently not used).

kind

name

The name of the project.

Example:

name: "my-sweet-project"

defaultEnvironment

The default environment to use when calling commands without the --env parameter.

environmentDefaults

Default environment settings. These are inherited (but can be overridden) by each configured environment.

Example:

environmentDefaults:
  providers: []
  variables: {}

environmentDefaults.providers[]

​environmentDefaults > providers

A list of providers that should be used for this environment, and their configuration. Please refer to individual plugins/providers for details on how to configure them.

environmentDefaults.providers[].name

​environmentDefaults > providers > name

The name of the provider plugin to use.

Example:

environmentDefaults:
  providers: []
  variables: {}
  ...
  providers:
    - name: "local-kubernetes"

environmentDefaults.variables

​environmentDefaults > variables

A key/value map of variables that modules can reference when using this environment.

environments

A list of environments to configure for the project.

Example:

environments:
  - name: local
    providers:
      - name: local-kubernetes
    variables: {}

environments[].providers[]

​environments > providers

A list of providers that should be used for this environment, and their configuration. Please refer to individual plugins/providers for details on how to configure them.

environments[].providers[].name

​environments > providers > name

The name of the provider plugin to use.

Example:

environments:
  - name: local
    providers:
      - name: local-kubernetes
    variables: {}
  - providers:
      - name: "local-kubernetes"

environments[].variables

​environments > variables

A key/value map of variables that modules can reference when using this environment.

environments[].name

​environments > name

Valid RFC1035/RFC1123 (DNS) label (may contain lowercase letters, numbers and dashes, must start with a letter, and cannot end with a dash), cannot contain consecutive dashes or start with garden, or be longer than 63 characters.

sources

A list of remote sources to import into project.

sources[].name

​sources > name

The name of the source to import

sources[].repositoryUrl

​sources > repositoryUrl

A remote repository URL. Currently only supports git servers. Must contain a hash suffix pointing to a specific branch or tag, with the format: #

Example:

sources:
  - repositoryUrl: "git+https://github.com/org/repo.git#v2.0"

Project YAML schema

apiVersion: garden.io/v0
kind: Project
name:
defaultEnvironment: ''
environmentDefaults:
  providers:
    - name:
  variables: {}
environments:
  - providers:
      - name:
    variables: {}
    name:
sources:
  - name:
    repositoryUrl:

Module configuration keys

apiVersion

The schema version of this module's config (currently not used).

kind

type

The type of this module.

Example:

type: "container"

name

The name of this module.

Example:

name: "my-sweet-module"

description

include

Specify a list of POSIX-style paths or globs that should be regarded as the source files for this module. Files that do not match these paths or globs are excluded when computing the version of the module, as well as when responding to filesystem watch events.

Note that you can also exclude files by placing .gardenignore files in your source tree, which use the same format as .gitignore files.

Also note that specifying an empty list here means no sources should be included.

Example:

include:
  - Dockerfile
  - my-app.js

repositoryUrl

A remote repository URL. Currently only supports git servers. Must contain a hash suffix pointing to a specific branch or tag, with the format: #

Garden will import the repository source code into this module, but read the module's config from the local garden.yml file.

Example:

repositoryUrl: "git+https://github.com/org/repo.git#v2.0"

allowPublish

When false, disables pushing this module to remote registries.

build

Specify how to build the module. Note that plugins may define additional keys on this object.

build.dependencies[]

​build > dependencies

A list of modules that must be built before this module is built.

Example:

build:
  ...
  dependencies:
    - name: some-other-module-name

build.dependencies[].name

​build > dependencies > name

Module name to build ahead of this module.

build.dependencies[].copy[]

​build > dependencies > copy

Specify one or more files or directories to copy from the built dependency to this module.

build.dependencies[].copy[].source

​build > dependencies > copy > source

POSIX-style path or filename of the directory or file(s) to copy to the target.

build.dependencies[].copy[].target

​build > dependencies > copy > target

POSIX-style path or filename to copy the directory or file(s) to (defaults to same as source path).

Module YAML schema

apiVersion: garden.io/v0
kind: Module
type:
name:
description:
include:
repositoryUrl:
allowPublish: true
build:
  dependencies:
    - name:
      copy:
        - source:
          target: ''