pulumi-azure-kotlin/com.pulumi.azure.arckubernetes.kotlin/Cluster

Cluster

class Cluster : KotlinCustomResource

Manages an Arc Kubernetes Cluster.

Note: Installing and configuring the Azure Arc Agent on your Kubernetes Cluster to establish connectivity is outside the scope of this document. For more details refer to Deploy agents to your cluster and Connect an existing Kubernetes Cluster. If you encounter issues connecting your Kubernetes Cluster to Azure Arc, we'd recommend opening a ticket with Microsoft Support.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.arckubernetes.Cluster;
import com.pulumi.azure.arckubernetes.ClusterArgs;
import com.pulumi.azure.arckubernetes.inputs.ClusterIdentityArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-resources")
            .location("West Europe")
            .build());
        var exampleCluster = new Cluster("exampleCluster", ClusterArgs.builder()
            .name("example-akcc")
            .resourceGroupName(example.name())
            .location("West Europe")
            .agentPublicKeyCertificate(StdFunctions.filebase64(Filebase64Args.builder()
                .input("testdata/public.cer")
                .build()).result())
            .identity(ClusterIdentityArgs.builder()
                .type("SystemAssigned")
                .build())
            .tags(Map.of("ENV", "Test"))
            .build());
    }
}

Import

Arc Kubernetes Cluster can be imported using the resource id, e.g.

$ pulumi import azure:arckubernetes/cluster:Cluster example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1/providers/Microsoft.Kubernetes/connectedClusters/cluster1

Properties

agentPublicKeyCertificate

val agentPublicKeyCertificate: Output<String>

Specifies the base64-encoded public certificate used by the agent to do the initial handshake to the backend services in Azure. Changing this forces a new Arc Kubernetes Cluster to be created.

agentVersion

val agentVersion: Output<String>

Version of the agent running on the cluster resource.

distribution

val distribution: Output<String>

The distribution running on this Arc Kubernetes Cluster.

val id: Output<String>

identity

val identity: Output<ClusterIdentity>

An identity block as defined below. Changing this forces a new Arc Kubernetes Cluster to be created.

infrastructure

val infrastructure: Output<String>

The infrastructure on which the Arc Kubernetes Cluster is running on.

kubernetesVersion

val kubernetesVersion: Output<String>

The Kubernetes version of the cluster resource.

location

val location: Output<String>

Specifies the Azure Region where the Arc Kubernetes Cluster should exist. Changing this forces a new Arc Kubernetes Cluster to be created.

name

val name: Output<String>

Specifies the name which should be used for this Arc Kubernetes Cluster. Changing this forces a new Arc Kubernetes Cluster to be created.

offering

val offering: Output<String>

The cluster offering.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

resourceGroupName

val resourceGroupName: Output<String>

Specifies the name of the Resource Group where the Arc Kubernetes Cluster should exist. Changing this forces a new Arc Kubernetes Cluster to be created.