1. Packages
  2. Kubernetes
  3. API Docs
  4. Provider
Kubernetes v4.5.5 published on Wednesday, Nov 15, 2023 by Pulumi

kubernetes.Provider

Explore with Pulumi AI

kubernetes logo
Kubernetes v4.5.5 published on Wednesday, Nov 15, 2023 by Pulumi

    The provider type for the kubernetes package.

    Create Provider Resource

    new Provider(name: string, args?: Provider, opts?: CustomResourceOptions);
    @overload
    def Provider(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 cluster: Optional[str] = None,
                 context: Optional[str] = None,
                 delete_unreachable: Optional[bool] = None,
                 enable_config_map_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)
    @overload
    def Provider(resource_name: str,
                 args: Optional[ProviderArgs] = None,
                 opts: Optional[ResourceOptions] = 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.
    
    
    name 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 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 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 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 String
    The unique name of the resource.
    args 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

    The Provider resource accepts the following input properties:

    Cluster string

    If present, the name of the kubeconfig cluster to use.

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

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

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

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

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

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

    PluginsPath string

    The path to the helm plugins directory.

    RegistryConfigPath string

    The path to the registry config file.

    RepositoryCache string

    The path to the file containing cached repository indexes.

    RepositoryConfigPath string

    The path to the file containing repository names and URLs.

    Driver string

    The backend storage driver for Helm. Values are: configmap, secret, memory, sql.

    PluginsPath string

    The path to the helm plugins directory.

    RegistryConfigPath string

    The path to the registry config file.

    RepositoryCache string

    The path to the file containing cached repository indexes.

    RepositoryConfigPath string

    The path to the file containing repository names and URLs.

    driver String

    The backend storage driver for Helm. Values are: configmap, secret, memory, sql.

    pluginsPath String

    The path to the helm plugins directory.

    registryConfigPath String

    The path to the registry config file.

    repositoryCache String

    The path to the file containing cached repository indexes.

    repositoryConfigPath String

    The path to the file containing repository names and URLs.

    driver string

    The backend storage driver for Helm. Values are: configmap, secret, memory, sql.

    pluginsPath string

    The path to the helm plugins directory.

    registryConfigPath string

    The path to the registry config file.

    repositoryCache string

    The path to the file containing cached repository indexes.

    repositoryConfigPath string

    The path to the file containing repository names and URLs.

    driver str

    The backend storage driver for Helm. Values are: configmap, secret, memory, sql.

    plugins_path str

    The path to the helm plugins directory.

    registry_config_path str

    The path to the registry config file.

    repository_cache str

    The path to the file containing cached repository indexes.

    repository_config_path str

    The path to the file containing repository names and URLs.

    driver String

    The backend storage driver for Helm. Values are: configmap, secret, memory, sql.

    pluginsPath String

    The path to the helm plugins directory.

    registryConfigPath String

    The path to the registry config file.

    repositoryCache String

    The path to the file containing cached repository indexes.

    repositoryConfigPath String

    The path to the file containing repository names and URLs.

    KubeClientSettings, KubeClientSettingsArgs

    Burst int

    Maximum burst for throttle. Default value is 10.

    Qps double

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    Timeout int

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    Burst int

    Maximum burst for throttle. Default value is 10.

    Qps float64

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    Timeout int

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    burst Integer

    Maximum burst for throttle. Default value is 10.

    qps Double

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    timeout Integer

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    burst number

    Maximum burst for throttle. Default value is 10.

    qps number

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    timeout number

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    burst int

    Maximum burst for throttle. Default value is 10.

    qps float

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    timeout int

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    burst Number

    Maximum burst for throttle. Default value is 10.

    qps Number

    Maximum queries per second (QPS) to the API server from this client. Default value is 5.

    timeout Number

    Maximum time in seconds to wait before cancelling a HTTP request to the Kubernetes server. Default value is 32.

    Package Details

    Repository
    Kubernetes pulumi/pulumi-kubernetes
    License
    Apache-2.0
    kubernetes logo
    Kubernetes v4.5.5 published on Wednesday, Nov 15, 2023 by Pulumi