Come join Pulumi for the industry's first Cloud Engineering Summit! October 7–8. Save Your Spot

This page documents the language specification for the kubernetes package. If you're looking for help working with the inputs, outputs, or functions of kubernetes resources in a Pulumi program, please see the resource documentation for examples and API reference.

provider

class pulumi_kubernetes.provider.Provider(resource_name, opts=None, cluster=None, context=None, enable_dry_run=None, kubeconfig=None, namespace=None, suppress_deprecation_warnings=None, render_yaml_to_directory=None, __name__=None, __opts__=None)

The provider type for the kubernetes package.

Create a Provider resource with the given unique name, arguments, and options.

Parameters
  • resource_name (str) – The unique name of the resource.

  • opts (pulumi.ResourceOptions) – An optional bag of options that controls this resource’s behavior.

  • cluster (pulumi.Input[str]) – If present, the name of the kubeconfig cluster to use.

  • context (pulumi.Input[str]) – If present, the name of the kubeconfig context to use.

  • enable_dry_run (pulumi.Input[bool]) – BETA FEATURE - If present and set to True, enable server-side diff calculations. 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 `enableDryRun` parameter.
2. The `PULUMI_K8S_ENABLE_DRY_RUN` environment variable.
Parameters
  • kubeconfig (pulumi.Input[str]) – The contents of a kubeconfig file. If this is set, this config will be used instead of $KUBECONFIG.

  • namespace (pulumi.Input[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.
Parameters

suppress_deprecation_warnings (pulumi.Input[bool]) – If present and set to True, suppress apiVersion deprecation warnings from the CLI. This config can be specified in the following ways, using this precedence:

1. This `suppressDeprecationWarnings` parameter.
2. The `PULUMI_K8S_SUPPRESS_DEPRECATION_WARNINGS` environment variable.
Parameters

render_yaml_to_directory (pulumi.Input[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.