container
Description
Provides the container
actions and module type.Note that this provider is currently automatically included, and you do not need to configure it in your project configuration.
Below is the full schema reference for the provider configuration. For an introduction to configuring a Garden project with providers, please look at our configuration guide.
The reference is divided into two sections. The first section contains the complete YAML schema, and the second section describes each schema key.
Complete YAML Schema
The values in the schema below are the default values.
providers:
- # The name of the provider plugin to use.
name:
# List other providers that should be resolved before this one.
dependencies: []
# If specified, this provider will only be used in the listed environments. Note that an empty array effectively
# disables the provider. To use a provider in all environments, omit this field.
environments:
# **Stability: Experimental**. Subject to breaking changes within minor releases.
#
# Extra flags to pass to the `docker build` command. Will extend the `spec.extraFlags` specified in each container
# Build action.
dockerBuildExtraFlags:
gardenCloudBuilder:
# Enable Garden Container Builder, which can speed up builds significantly using fast machines and extremely
# fast caching.
#
# By running `GARDEN_CONTAINER_BUILDER=1 garden build` you can try Garden Container Builder temporarily without
# any changes to your Garden configuration.
# The environment variable `GARDEN_CONTAINER_BUILDER` can also be used to override this setting, if enabled in
# the configuration. Set it to `false` or `0` to temporarily disable Garden Container Builder.
#
# Under the hood, enabling this option means that Garden will install a remote buildx driver on your local
# Docker daemon, and use that for builds. See also https://docs.docker.com/build/drivers/remote/
#
# If service limits are reached, or Garden Container Builder is not available, Garden will fall back to building
# images locally, or it falls back to building in your Kubernetes cluster in case in-cluster building is
# configured in the Kubernetes provider configuration.
#
# Please note that when enabling Container Builder together with in-cluster building, you need to authenticate
# to your `deploymentRegistry` from the local machine (e.g. by running `docker login`).
enabled: false
gardenContainerBuilder:
# Enable Garden Container Builder, which can speed up builds significantly using fast machines and extremely
# fast caching.
#
# By running `GARDEN_CONTAINER_BUILDER=1 garden build` you can try Garden Container Builder temporarily without
# any changes to your Garden configuration.
# The environment variable `GARDEN_CONTAINER_BUILDER` can also be used to override this setting, if enabled in
# the configuration. Set it to `false` or `0` to temporarily disable Garden Container Builder.
#
# Under the hood, enabling this option means that Garden will install a remote buildx driver on your local
# Docker daemon, and use that for builds. See also https://docs.docker.com/build/drivers/remote/
#
# If service limits are reached, or Garden Container Builder is not available, Garden will fall back to building
# images locally, or it falls back to building in your Kubernetes cluster in case in-cluster building is
# configured in the Kubernetes provider configuration.
#
# Please note that when enabling Container Builder together with in-cluster building, you need to authenticate
# to your `deploymentRegistry` from the local machine (e.g. by running `docker login`).
enabled: false
Configuration Keys
providers[]
providers[]
array[object]
[]
No
providers[].name
providers[].name
providers > name
The name of the provider plugin to use.
string
Yes
Example:
providers:
- name: "local-kubernetes"
providers[].dependencies[]
providers[].dependencies[]
providers > dependencies
List other providers that should be resolved before this one.
array[string]
[]
No
Example:
providers:
- dependencies:
- exec
providers[].environments[]
providers[].environments[]
providers > environments
If specified, this provider will only be used in the listed environments. Note that an empty array effectively disables the provider. To use a provider in all environments, omit this field.
array[string]
No
Example:
providers:
- environments:
- dev
- stage
providers[].dockerBuildExtraFlags[]
providers[].dockerBuildExtraFlags[]
providers > dockerBuildExtraFlags
Stability: Experimental. Subject to breaking changes within minor releases.
Extra flags to pass to the docker build
command. Will extend the spec.extraFlags
specified in each container Build action.
array[string]
No
providers[].gardenCloudBuilder
providers[].gardenCloudBuilder
providers > gardenCloudBuilder
Deprecated: The gardenCloudBuilder
setting in the container
provider configuration has been renamed to gardenContainerBuilder
. Use the setting gardenContainerBuilder
instead of gardenCloudBuilder
.
object
No
providers[].gardenCloudBuilder.enabled
providers[].gardenCloudBuilder.enabled
providers > gardenCloudBuilder > enabled
Deprecated: This field will be removed in a future release.
Enable Garden Container Builder, which can speed up builds significantly using fast machines and extremely fast caching.
By running GARDEN_CONTAINER_BUILDER=1 garden build
you can try Garden Container Builder temporarily without any changes to your Garden configuration.
The environment variable GARDEN_CONTAINER_BUILDER
can also be used to override this setting, if enabled in the configuration. Set it to false
or 0
to temporarily disable Garden Container Builder.
Under the hood, enabling this option means that Garden will install a remote buildx driver on your local Docker daemon, and use that for builds. See also https://docs.docker.com/build/drivers/remote/
If service limits are reached, or Garden Container Builder is not available, Garden will fall back to building images locally, or it falls back to building in your Kubernetes cluster in case in-cluster building is configured in the Kubernetes provider configuration.
Please note that when enabling Container Builder together with in-cluster building, you need to authenticate to your deploymentRegistry
from the local machine (e.g. by running docker login
).
boolean
false
No
providers[].gardenContainerBuilder
providers[].gardenContainerBuilder
providers > gardenContainerBuilder
object
No
providers[].gardenContainerBuilder.enabled
providers[].gardenContainerBuilder.enabled
providers > gardenContainerBuilder > enabled
Enable Garden Container Builder, which can speed up builds significantly using fast machines and extremely fast caching.
By running GARDEN_CONTAINER_BUILDER=1 garden build
you can try Garden Container Builder temporarily without any changes to your Garden configuration.
The environment variable GARDEN_CONTAINER_BUILDER
can also be used to override this setting, if enabled in the configuration. Set it to false
or 0
to temporarily disable Garden Container Builder.
Under the hood, enabling this option means that Garden will install a remote buildx driver on your local Docker daemon, and use that for builds. See also https://docs.docker.com/build/drivers/remote/
If service limits are reached, or Garden Container Builder is not available, Garden will fall back to building images locally, or it falls back to building in your Kubernetes cluster in case in-cluster building is configured in the Kubernetes provider configuration.
Please note that when enabling Container Builder together with in-cluster building, you need to authenticate to your deploymentRegistry
from the local machine (e.g. by running docker login
).
boolean
false
No
Last updated
Was this helpful?