LogoLogo
Bonsai (0.13) DocsGitHubDiscord CommunityGarden Enterprise
Bonsai (0.13)
Bonsai (0.13)
  • Welcome to Garden!
  • 🌸Overview
    • How Garden Works
    • Core Concepts
    • Adopting Garden
    • Garden vs Other Tools
  • 🌳Use Cases
    • Isolated On-Demand Preview Environments
    • Fast, Portable CI Pipelines that Run Anywhere
    • Shift Testing Left
    • Local Development With Remote Clusters
    • Jumpstart your Internal Developer Platform
  • 🌻Getting Started
    • Quickstart Guide
    • Installing Garden
    • Next Steps
  • 💐Tutorials
    • Your First Project
      • 1. Create a Garden Project
      • 2. Pick a Kubernetes Plugin
      • 3. Add Actions
      • 4. Add Tests
      • 5. Code Syncing (Hot Reload)
      • 6. Next Steps
  • 🌿Using Garden
    • About
    • Configuration Overview
    • Projects
    • Dashboard
    • Actions
    • Tests
    • Runs
    • Workflows
    • Variables and templating
    • Config Templates
    • Using the CLI
    • Modules
  • Kubernetes Plugins
    • About
    • Remote K8s Plugin Configuration
      • 1. Create a Cluster
        • AWS
        • GCP
        • Azure
      • 2. Configure Container Registry
        • AWS
        • GCP
        • Azure
        • Docker Hub
      • 3. Set Up Ingress, TLS and DNS
      • 4. Configure the Provider
    • Local K8s Plugin Configuration
      • 1. Install Local Kubernetes
      • 2. Configure the Provider
    • Ephemeral K8s Plugin Configuration
      • 1. Configure the Provider
      • 2. Login to the Garden dashboard
      • 3. Configure Ingress (optional)
      • 4. Retrieve Kubeconfig (optional)
    • Actions
      • Build
        • Container
      • Deploy
        • Kubernetes
        • Helm
        • Container
        • PersistentVolumeClaim
        • ConfigMap
      • Run and Test
        • Kubernetes Pod
        • Helm Pod
        • Kubernetes Exec
        • Container
    • Guides
      • In-Cluster Building
      • Minimal RBAC Configuration for Development Clusters
      • Deploying to Production
      • Using a Registry Mirror
  • ☘️Terraform Plugin
    • About
    • Plugin Configuration
    • Actions
  • 🌹Pulumi Plugin
    • About
    • Plugin Configuration
    • Actions
  • 🌼Other Plugins
    • Container
    • Exec (local scripts)
  • 🌷Guides
    • Migrating to Bonsai
    • Migrating from Docker Compose to Garden
    • Deprecations and updating to Cedar
    • Code Synchronization
    • Connecting a local application to a Kubernetes cluster (Local Mode)
    • Environments and namespaces
    • Using Garden in CircleCI
  • 🪷Advanced
    • Using Remote Sources
    • Custom Commands
  • 🎋Reference
    • Providers
      • conftest-container
      • conftest-kubernetes
      • conftest
      • container
      • ephemeral-kubernetes
      • exec
      • hadolint
      • jib
      • kubernetes
      • local-kubernetes
      • octant
      • otel-collector
      • pulumi
      • terraform
    • Action Types
      • Build
        • container Build
        • exec Build
        • jib-container Build
      • Deploy
        • configmap Deploy
        • container Deploy
        • exec Deploy
        • helm Deploy
        • kubernetes Deploy
        • persistentvolumeclaim Deploy
        • pulumi Deploy
        • terraform Deploy
      • Run
        • container Run
        • exec Run
        • helm-pod Run
        • kubernetes-exec Run
        • kubernetes-pod Run
      • Test
        • conftest-helm Test
        • conftest Test
        • container Test
        • exec Test
        • hadolint Test
        • helm-pod Test
        • kubernetes-exec Test
        • kubernetes-pod Test
    • Template Strings
      • Project template context
      • Environment template context
      • Provider template context
      • Action (all fields) template context
      • Action spec template context
      • Module template context
      • Remote Source template context
      • Project Output template context
      • Custom Command template context
      • Workflow template context
      • Template Helper Functions
    • Commands
    • Project Configuration
    • ConfigTemplate Reference
    • RenderTemplate Reference
    • Workflow Configuration
    • Garden Containers on Docker Hub
    • Module Template Configuration
    • Module Types
      • configmap
      • conftest
      • container
      • exec
      • hadolint
      • helm
      • jib-container
      • kubernetes
      • persistentvolumeclaim
      • pulumi
      • templated
      • terraform
  • 🌸Misc
    • FAQ
    • Troubleshooting
    • Telemetry
    • New Garden Cloud Version
  • Contributing to Garden
    • Contributor Covenant Code of Conduct
    • Contributing to the Docs
    • Setting up your developer environment
    • Developing Garden
    • Config resolution
    • Graph execution
Powered by GitBook
On this page
  • Description
  • Complete YAML Schema
  • Configuration Keys
  • providers[]
  • providers[].name
  • providers[].dependencies[]
  • providers[].environments[]
  • providers[].dockerBuildExtraFlags[]
  • providers[].gardenCloudBuilder
  • providers[].gardenCloudBuilder.enabled
  • providers[].gardenContainerBuilder
  • providers[].gardenContainerBuilder.enabled

Was this helpful?

  1. Reference
  2. Providers

container

PreviousconftestNextephemeral-kubernetes

Last updated 14 days ago

Was this helpful?

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 .

The reference is divided into two sections. The contains the complete YAML schema, and the 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[]

Type
Default
Required

array[object]

[]

No

providers[].name

The name of the provider plugin to use.

Type
Required

string

Yes

Example:

providers:
  - name: "local-kubernetes"

providers[].dependencies[]

List other providers that should be resolved before this one.

Type
Default
Required

array[string]

[]

No

Example:

providers:
  - dependencies:
      - exec

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.

Type
Required

array[string]

No

Example:

providers:
  - environments:
      - dev
      - stage

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.

Type
Required

array[string]

No

providers[].gardenCloudBuilder

Deprecated: The gardenCloudBuilder setting in the container provider configuration has been renamed to gardenContainerBuilder. Use the setting gardenContainerBuilder instead of gardenCloudBuilder.

Type
Required

object

No

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).

Type
Default
Required

boolean

false

No

providers[].gardenContainerBuilder

Type
Required

object

No

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).

Type
Default
Required

boolean

false

No

> name

> dependencies

> environments

> dockerBuildExtraFlags

> gardenCloudBuilder

> > enabled

> gardenContainerBuilder

> > enabled

🎋
configuration guide
first section
second section
providers
providers
providers
providers
providers
providers
gardenCloudBuilder
providers
providers
gardenContainerBuilder