pulumi-azure-native-kotlin/com.pulumi.azurenative.kubernetesconfiguration.kotlin/Extension

Extension

class Extension : KotlinCustomResource

The Extension object. Uses Azure REST API version 2023-05-01. In version 1.x of the Azure Native provider, it used API version 2020-07-01-preview. Other available API versions: 2020-07-01-preview, 2022-04-02-preview, 2022-07-01, 2024-11-01.

Example Usage

Create Extension

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var extension = new AzureNative.KubernetesConfiguration.Extension("extension", new()
    {
        AutoUpgradeMinorVersion = true,
        ClusterName = "clusterName1",
        ClusterResourceName = "connectedClusters",
        ClusterRp = "Microsoft.Kubernetes",
        ConfigurationProtectedSettings =
        {
            { "omsagent.secret.key", "secretKeyValue01" },
        },
        ConfigurationSettings =
        {
            { "omsagent.env.clusterName", "clusterName1" },
            { "omsagent.secret.wsid", "fakeTokenPlaceholder" },
        },
        ExtensionName = "ClusterMonitor",
        ExtensionType = "azuremonitor-containers",
        ReleaseTrain = "Preview",
        ResourceGroupName = "rg1",
        Scope = new AzureNative.KubernetesConfiguration.Inputs.ScopeArgs
        {
            Cluster = new AzureNative.KubernetesConfiguration.Inputs.ScopeClusterArgs
            {
                ReleaseNamespace = "kube-system",
            },
        },
    });
});
Content copied to clipboard
package main
import (
	kubernetesconfiguration "github.com/pulumi/pulumi-azure-native-sdk/kubernetesconfiguration/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := kubernetesconfiguration.NewExtension(ctx, "extension", &kubernetesconfiguration.ExtensionArgs{
			AutoUpgradeMinorVersion: pulumi.Bool(true),
			ClusterName:             pulumi.String("clusterName1"),
			ClusterResourceName:     pulumi.String("connectedClusters"),
			ClusterRp:               pulumi.String("Microsoft.Kubernetes"),
			ConfigurationProtectedSettings: pulumi.StringMap{
				"omsagent.secret.key": pulumi.String("secretKeyValue01"),
			},
			ConfigurationSettings: pulumi.StringMap{
				"omsagent.env.clusterName": pulumi.String("clusterName1"),
				"omsagent.secret.wsid":     pulumi.String("fakeTokenPlaceholder"),
			},
			ExtensionName:     pulumi.String("ClusterMonitor"),
			ExtensionType:     pulumi.String("azuremonitor-containers"),
			ReleaseTrain:      pulumi.String("Preview"),
			ResourceGroupName: pulumi.String("rg1"),
			Scope: &kubernetesconfiguration.ScopeArgs{
				Cluster: &kubernetesconfiguration.ScopeClusterArgs{
					ReleaseNamespace: pulumi.String("kube-system"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.kubernetesconfiguration.Extension;
import com.pulumi.azurenative.kubernetesconfiguration.ExtensionArgs;
import com.pulumi.azurenative.kubernetesconfiguration.inputs.ScopeArgs;
import com.pulumi.azurenative.kubernetesconfiguration.inputs.ScopeClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var extension = new Extension("extension", ExtensionArgs.builder()
            .autoUpgradeMinorVersion(true)
            .clusterName("clusterName1")
            .clusterResourceName("connectedClusters")
            .clusterRp("Microsoft.Kubernetes")
            .configurationProtectedSettings(Map.of("omsagent.secret.key", "secretKeyValue01"))
            .configurationSettings(Map.ofEntries(
                Map.entry("omsagent.env.clusterName", "clusterName1"),
                Map.entry("omsagent.secret.wsid", "fakeTokenPlaceholder")
            ))
            .extensionName("ClusterMonitor")
            .extensionType("azuremonitor-containers")
            .releaseTrain("Preview")
            .resourceGroupName("rg1")
            .scope(ScopeArgs.builder()
                .cluster(ScopeClusterArgs.builder()
                    .releaseNamespace("kube-system")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Create Extension with Plan

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var extension = new AzureNative.KubernetesConfiguration.Extension("extension", new()
    {
        AutoUpgradeMinorVersion = true,
        ClusterName = "clusterName1",
        ClusterResourceName = "connectedClusters",
        ClusterRp = "Microsoft.Kubernetes",
        ExtensionName = "azureVote",
        ExtensionType = "azure-vote",
        Plan = new AzureNative.KubernetesConfiguration.Inputs.PlanArgs
        {
            Name = "azure-vote-standard",
            Product = "azure-vote-standard-offer-id",
            Publisher = "Microsoft",
        },
        ReleaseTrain = "Preview",
        ResourceGroupName = "rg1",
    });
});
Content copied to clipboard
package main
import (
	kubernetesconfiguration "github.com/pulumi/pulumi-azure-native-sdk/kubernetesconfiguration/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := kubernetesconfiguration.NewExtension(ctx, "extension", &kubernetesconfiguration.ExtensionArgs{
			AutoUpgradeMinorVersion: pulumi.Bool(true),
			ClusterName:             pulumi.String("clusterName1"),
			ClusterResourceName:     pulumi.String("connectedClusters"),
			ClusterRp:               pulumi.String("Microsoft.Kubernetes"),
			ExtensionName:           pulumi.String("azureVote"),
			ExtensionType:           pulumi.String("azure-vote"),
			Plan: &kubernetesconfiguration.PlanArgs{
				Name:      pulumi.String("azure-vote-standard"),
				Product:   pulumi.String("azure-vote-standard-offer-id"),
				Publisher: pulumi.String("Microsoft"),
			},
			ReleaseTrain:      pulumi.String("Preview"),
			ResourceGroupName: pulumi.String("rg1"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.kubernetesconfiguration.Extension;
import com.pulumi.azurenative.kubernetesconfiguration.ExtensionArgs;
import com.pulumi.azurenative.kubernetesconfiguration.inputs.PlanArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var extension = new Extension("extension", ExtensionArgs.builder()
            .autoUpgradeMinorVersion(true)
            .clusterName("clusterName1")
            .clusterResourceName("connectedClusters")
            .clusterRp("Microsoft.Kubernetes")
            .extensionName("azureVote")
            .extensionType("azure-vote")
            .plan(PlanArgs.builder()
                .name("azure-vote-standard")
                .product("azure-vote-standard-offer-id")
                .publisher("Microsoft")
                .build())
            .releaseTrain("Preview")
            .resourceGroupName("rg1")
            .build());
    }
}
Content copied to clipboard

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:kubernetesconfiguration:Extension azureVote /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{clusterRp}/{clusterResourceName}/{clusterName}/providers/Microsoft.KubernetesConfiguration/extensions/{extensionName}
Content copied to clipboard

Properties

Link copied to clipboard
val aksAssignedIdentity: Output<ExtensionResponseAksAssignedIdentity>?

Identity of the Extension resource in an AKS cluster

Link copied to clipboard
val autoUpgradeMinorVersion: Output<Boolean>?

Flag to note if this extension participates in auto upgrade of minor version, or not.

Link copied to clipboard
val configurationProtectedSettings: Output<Map<String, String>>?

Configuration settings that are sensitive, as name-value pairs for configuring this extension.

Link copied to clipboard
val configurationSettings: Output<Map<String, String>>?

Configuration settings, as name-value pairs for configuring this extension.

Link copied to clipboard
val currentVersion: Output<String>

Currently installed version of the extension.

Link copied to clipboard
val customLocationSettings: Output<Map<String, String>>

Custom Location settings properties.

Link copied to clipboard
val errorInfo: Output<ErrorDetailResponse>

Error information from the Agent - e.g. errors during installation.

Link copied to clipboard
val extensionType: Output<String>?

Type of the Extension, of which this resource is an instance of. It must be one of the Extension Types registered with Microsoft.KubernetesConfiguration by the Extension publisher.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val identity: Output<IdentityResponse>?

Identity of the Extension resource

Link copied to clipboard
val isSystemExtension: Output<Boolean>

Flag to note if this extension is a system extension

Link copied to clipboard
val name: Output<String>

The name of the resource

Link copied to clipboard
val packageUri: Output<String>

Uri of the Helm package

Link copied to clipboard
val plan: Output<PlanResponse>?

The plan information.

Link copied to clipboard
val provisioningState: Output<String>

Status of installation of this extension.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val releaseTrain: Output<String>?

ReleaseTrain this extension participates in for auto-upgrade (e.g. Stable, Preview, etc.) - only if autoUpgradeMinorVersion is 'true'.

Link copied to clipboard
val scope: Output<ScopeResponse>?

Scope at which the extension is installed.

Link copied to clipboard
val statuses: Output<List<ExtensionStatusResponse>>?

Status from this extension.

Link copied to clipboard
val systemData: Output<SystemDataResponse>

Top level metadata https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/common-api-contracts.md#system-metadata-for-all-azure-resources

Link copied to clipboard
val type: Output<String>

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val version: Output<String>?

User-specified version of the extension for this extension to 'pin'. To use 'version', autoUpgradeMinorVersion must be 'false'.