Links

pulumi

Description

EXPERIMENTAL
This provider allows you to integrate Pulumi stacks into your Garden project, via pulumi modules.
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:
# The version of pulumi to use. Set to `null` to use whichever version of `pulumi` is on your PATH.
version: 3.48.0
# Overrides the default plan directory path used when deploying with the `deployFromPreview` option for pulumi
# modules.
#
# Must be a relative path to a directory inside the project root.
#
# This option can be useful when you want to provide a folder of pre-approved pulumi plans to a CI pipeline step.
previewDir:
# The name of the pulumi organization to use. This option can also be set on the module level, in which case it
# overrides this provider-level option.
orgName:
# Sets the maximum task concurrency for the tasks generated by the pulumi plugin commands (e.g. when running
# `garden plugins pulumi preview`).
#
# Note: This limit is not applied when running built-in commands (e.g. `garden deploy`).
pluginTaskConcurrencyLimit: 5

Configuration Keys

providers[]

Type
Default
Required
array[object]
[]
No

providers[].name

providers > name
The name of the provider plugin to use.
Type
Required
string
Yes
Example:
providers:
- name: "local-kubernetes"

providers[].dependencies[]

providers > dependencies
List other providers that should be resolved before this one.
Type
Default
Required
array[string]
[]
No
Example:
providers:
- dependencies:
- exec

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.
Type
Required
array[string]
No
Example:
providers:
- environments:
- dev
- stage

providers[].version

providers > version
The version of pulumi to use. Set to null to use whichever version of pulumi is on your PATH.
Type
Allowed Values
Default
Required
string
"3.48.0", "3.40.0", "3.39.4", "3.25.1", null
"3.48.0"
Yes

providers[].previewDir

providers > previewDir
Overrides the default plan directory path used when deploying with the deployFromPreview option for pulumi modules.
Must be a relative path to a directory inside the project root.
This option can be useful when you want to provide a folder of pre-approved pulumi plans to a CI pipeline step.
Type
Required
posixPath
No

providers[].orgName

providers > orgName
The name of the pulumi organization to use. This option can also be set on the module level, in which case it overrides this provider-level option.
Type
Required
string
No

providers[].pluginTaskConcurrencyLimit

providers > pluginTaskConcurrencyLimit
Sets the maximum task concurrency for the tasks generated by the pulumi plugin commands (e.g. when running garden plugins pulumi preview).
Note: This limit is not applied when running built-in commands (e.g. garden deploy).
Type
Default
Required
number
5
No
Last modified 3mo ago