Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Kubernetes
  3. API Docs
  4. Provider
Kubernetes v4.23.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-kubernetes

kubernetes.Provider

Explore with Pulumi AI

Kubernetes v4.23.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-kubernetes

The provider type for the kubernetes package.

Create Provider Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Provider(name: string, args?: Provider, opts?: CustomResourceOptions);
@overload
def Provider(resource_name: str,
             args: Optional[ProviderArgs] = None,
             opts: Optional[ResourceOptions] = None)

@overload
def Provider(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             cluster: Optional[str] = None,
             cluster_identifier: Optional[str] = None,
             context: Optional[str] = None,
             delete_unreachable: Optional[bool] = None,
             enable_config_map_mutable: Optional[bool] = None,
             enable_secret_mutable: Optional[bool] = None,
             enable_server_side_apply: Optional[bool] = None,
             helm_release_settings: Optional[HelmReleaseSettingsArgs] = None,
             kube_client_settings: Optional[KubeClientSettingsArgs] = None,
             kubeconfig: Optional[str] = None,
             namespace: Optional[str] = None,
             render_yaml_to_directory: Optional[str] = None,
             skip_update_unreachable: Optional[bool] = None,
             suppress_deprecation_warnings: Optional[bool] = None,
             suppress_helm_hook_warnings: Optional[bool] = None)
func NewProvider(ctx *Context, name string, args *ProviderArgs, opts ...ResourceOption) (*Provider, error)
public Provider(string name, ProviderArgs? args = null, CustomResourceOptions? opts = null)
public Provider(String name, ProviderArgs args)
public Provider(String name, ProviderArgs args, CustomResourceOptions options)

type: pulumi:providers:kubernetes
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args Provider
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args ProviderArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args ProviderArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args ProviderArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. ProviderArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Provider Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Provider resource accepts the following input properties:

Cluster string
If present, the name of the kubeconfig cluster to use.
ClusterIdentifier string

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

Context string
If present, the name of the kubeconfig context to use.
DeleteUnreachable bool
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
EnableConfigMapMutable bool

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
EnableSecretMutable bool

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
EnableServerSideApply bool
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
HelmReleaseSettings Pulumi.Kubernetes.Inputs.HelmReleaseSettings
Options to configure the Helm Release resource.
KubeClientSettings Pulumi.Kubernetes.Inputs.KubeClientSettings
Options for tuning the Kubernetes client used by a Provider.
KubeConfig string
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
Namespace string

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
RenderYamlToDirectory string

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

SkipUpdateUnreachable bool
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
SuppressDeprecationWarnings bool
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
SuppressHelmHookWarnings bool
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS
Cluster string
If present, the name of the kubeconfig cluster to use.
ClusterIdentifier string

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

Context string
If present, the name of the kubeconfig context to use.
DeleteUnreachable bool
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
EnableConfigMapMutable bool

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
EnableSecretMutable bool

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
EnableServerSideApply bool
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
HelmReleaseSettings HelmReleaseSettingsArgs
Options to configure the Helm Release resource.
KubeClientSettings KubeClientSettingsArgs
Options for tuning the Kubernetes client used by a Provider.
Kubeconfig string
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
Namespace string

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
RenderYamlToDirectory string

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

SkipUpdateUnreachable bool
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
SuppressDeprecationWarnings bool
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
SuppressHelmHookWarnings bool
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS
cluster String
If present, the name of the kubeconfig cluster to use.
clusterIdentifier String

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

context String
If present, the name of the kubeconfig context to use.
deleteUnreachable Boolean
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
enableConfigMapMutable Boolean

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
enableSecretMutable Boolean

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
enableServerSideApply Boolean
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
helmReleaseSettings HelmReleaseSettings
Options to configure the Helm Release resource.
kubeClientSettings KubeClientSettings
Options for tuning the Kubernetes client used by a Provider.
kubeconfig String
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
namespace String

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
renderYamlToDirectory String

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

skipUpdateUnreachable Boolean
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
suppressDeprecationWarnings Boolean
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
suppressHelmHookWarnings Boolean
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS
cluster string
If present, the name of the kubeconfig cluster to use.
clusterIdentifier string

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

context string
If present, the name of the kubeconfig context to use.
deleteUnreachable boolean
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
enableConfigMapMutable boolean

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
enableSecretMutable boolean

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
enableServerSideApply boolean
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
helmReleaseSettings HelmReleaseSettings
Options to configure the Helm Release resource.
kubeClientSettings KubeClientSettings
Options for tuning the Kubernetes client used by a Provider.
kubeconfig string
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
namespace string

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
renderYamlToDirectory string

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

skipUpdateUnreachable boolean
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
suppressDeprecationWarnings boolean
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
suppressHelmHookWarnings boolean
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS
cluster str
If present, the name of the kubeconfig cluster to use.
cluster_identifier str

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

context str
If present, the name of the kubeconfig context to use.
delete_unreachable bool
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
enable_config_map_mutable bool

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
enable_secret_mutable bool

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
enable_server_side_apply bool
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
helm_release_settings HelmReleaseSettingsArgs
Options to configure the Helm Release resource.
kube_client_settings KubeClientSettingsArgs
Options for tuning the Kubernetes client used by a Provider.
kubeconfig str
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
namespace str

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
render_yaml_to_directory str

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

skip_update_unreachable bool
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
suppress_deprecation_warnings bool
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
suppress_helm_hook_warnings bool
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS
cluster String
If present, the name of the kubeconfig cluster to use.
clusterIdentifier String

If present, this value will control the provider's replacement behavior. In particular, the provider will only be replaced when clusterIdentifier changes; all other changes to provider configuration will be treated as updates.

Kubernetes does not yet offer an API for cluster identification, so Pulumi uses heuristics to decide when a provider resource should be replaced or updated. These heuristics can sometimes lead to destructive replace operations when an update would be more appropriate, or vice versa.

Use clusterIdentifier for more fine-grained control of the provider resource's lifecycle.

context String
If present, the name of the kubeconfig context to use.
deleteUnreachable Boolean
If present and set to true, the provider will delete resources associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_DELETE_UNREACHABLE
enableConfigMapMutable Boolean

BETA FEATURE - If present and set to true, allow ConfigMaps to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableConfigMapMutable parameter.
  2. The PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_CONFIGMAP_MUTABLE
enableSecretMutable Boolean

BETA FEATURE - If present and set to true, allow Secrets to be mutated. This feature is in developer preview, and is disabled by default.

This config can be specified in the following ways using this precedence:

  1. This enableSecretMutable parameter.
  2. The PULUMI_K8S_ENABLE_SECRET_MUTABLE environment variable. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SECRET_MUTABLE
enableServerSideApply Boolean
If present and set to false, disable Server-Side Apply mode. See https://github.com/pulumi/pulumi-kubernetes/issues/2011 for additional details. It can also be sourced from the following environment variable: PULUMI_K8S_ENABLE_SERVER_SIDE_APPLY
helmReleaseSettings Property Map
Options to configure the Helm Release resource.
kubeClientSettings Property Map
Options for tuning the Kubernetes client used by a Provider.
kubeconfig String
The contents of a kubeconfig file or the path to a kubeconfig file. It can also be sourced from the following environment variable: KUBECONFIG
namespace String

If present, the default namespace to use. This flag is ignored for cluster-scoped resources.

A namespace can be specified in multiple places, and the precedence is as follows:

  1. .metadata.namespace set on the resource.
  2. This namespace parameter.
  3. namespace set for the active context in the kubeconfig.
renderYamlToDirectory String

BETA FEATURE - If present, render resource manifests to this directory. In this mode, resources will not be created on a Kubernetes cluster, but the rendered manifests will be kept in sync with changes to the Pulumi program. This feature is in developer preview, and is disabled by default.

Note that some computed Outputs such as status fields will not be populated since the resources are not created on a Kubernetes cluster. These Output values will remain undefined, and may result in an error if they are referenced by other resources. Also note that any secret values used in these resources will be rendered in plaintext to the resulting YAML.

skipUpdateUnreachable Boolean
If present and set to true, the provider will skip resources update associated with an unreachable Kubernetes cluster from Pulumi state It can also be sourced from the following environment variable: PULUMI_K8S_SKIP_UPDATE_UNREACHABLE
suppressDeprecationWarnings Boolean
If present and set to true, suppress apiVersion deprecation warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS
suppressHelmHookWarnings Boolean
If present and set to true, suppress unsupported Helm hook warnings from the CLI. It can also be sourced from the following environment variable: PULUMI_K8S_SUPPRESS_HELM_HOOK_WARNINGS

Outputs

All input properties are implicitly available as output properties. Additionally, the Provider resource produces the following output properties:

Id string
The provider-assigned unique ID for this managed resource.
Id string
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.
id string
The provider-assigned unique ID for this managed resource.
id str
The provider-assigned unique ID for this managed resource.
id String
The provider-assigned unique ID for this managed resource.

Supporting Types

HelmReleaseSettings
, HelmReleaseSettingsArgs

Driver string
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
PluginsPath string
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
RegistryConfigPath string
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
RepositoryCache string
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
RepositoryConfigPath string
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH
Driver string
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
PluginsPath string
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
RegistryConfigPath string
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
RepositoryCache string
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
RepositoryConfigPath string
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH
driver String
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
pluginsPath String
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
registryConfigPath String
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
repositoryCache String
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
repositoryConfigPath String
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH
driver string
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
pluginsPath string
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
registryConfigPath string
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
repositoryCache string
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
repositoryConfigPath string
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH
driver str
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
plugins_path str
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
registry_config_path str
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
repository_cache str
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
repository_config_path str
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH
driver String
The backend storage driver for Helm. Values are: configmap, secret, memory, sql. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_DRIVER
pluginsPath String
The path to the helm plugins directory. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_PLUGINS_PATH
registryConfigPath String
The path to the registry config file. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REGISTRY_CONFIG_PATH
repositoryCache String
The path to the directory containing cached repository indexes. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CACHE
repositoryConfigPath String
The path to the file containing repository names and URLs. It can also be sourced from the following environment variable: PULUMI_K8S_HELM_REPOSITORY_CONFIG_PATH

KubeClientSettings
, KubeClientSettingsArgs

Burst int
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
Qps double
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
Timeout int
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT
Burst int
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
Qps float64
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
Timeout int
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT
burst Integer
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
qps Double
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
timeout Integer
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT
burst number
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
qps number
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
timeout number
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT
burst int
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
qps float
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
timeout int
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT
burst Number
Maximum burst for throttle. Default value is 120. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_BURST
qps Number
Maximum queries per second (QPS) to the API server from this client. Default value is 50. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_QPS
timeout Number
Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32. It can also be sourced from the following environment variable: PULUMI_K8S_CLIENT_TIMEOUT

Package Details

Repository
Kubernetes pulumi/pulumi-kubernetes
License
Apache-2.0
Kubernetes v4.23.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-kubernetes