ClusterArgs

data class ClusterArgs(val authorization: Output<ClusterAuthorizationArgs>? = null, val controlPlane: Output<ClusterControlPlaneArgs>? = null, val controlPlaneEncryption: Output<ClusterControlPlaneEncryptionArgs>? = null, val defaultMaxPodsPerNode: Output<Int>? = null, val externalLoadBalancerIpv4AddressPools: Output<List<String>>? = null, val fleet: Output<ClusterFleetArgs>? = null, val labels: Output<Map<String, String>>? = null, val location: Output<String>? = null, val maintenancePolicy: Output<ClusterMaintenancePolicyArgs>? = null, val name: Output<String>? = null, val networking: Output<ClusterNetworkingArgs>? = null, val project: Output<String>? = null, val releaseChannel: Output<String>? = null, val systemAddonsConfig: Output<ClusterSystemAddonsConfigArgs>? = null, val targetVersion: Output<String>? = null) : ConvertibleToJava<ClusterArgs>

Cluster contains information about a Google Distributed Cloud Edge Kubernetes cluster. To get more information about Cluster, see:

Example Usage

Edgecontainer Cluster

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.edgecontainer.Cluster;
import com.pulumi.gcp.edgecontainer.ClusterArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationAdminUsersArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterFleetArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterNetworkingArgs;
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) {
final var project = OrganizationsFunctions.getProject();
var default_ = new Cluster("default", ClusterArgs.builder()
.authorization(ClusterAuthorizationArgs.builder()
.adminUsers(ClusterAuthorizationAdminUsersArgs.builder()
.username("admin@hashicorptest.com")
.build())
.build())
.fleet(ClusterFleetArgs.builder()
.project(String.format("projects/%s", project.applyValue(getProjectResult -> getProjectResult.number())))
.build())
.labels(Map.ofEntries(
Map.entry("my_key", "my_val"),
Map.entry("other_key", "other_val")
))
.location("us-central1")
.networking(ClusterNetworkingArgs.builder()
.clusterIpv4CidrBlocks("10.0.0.0/16")
.servicesIpv4CidrBlocks("10.1.0.0/16")
.build())
.build());
}
}

Edgecontainer Cluster With Maintenance Window

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.edgecontainer.Cluster;
import com.pulumi.gcp.edgecontainer.ClusterArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationAdminUsersArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterFleetArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterMaintenancePolicyArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterMaintenancePolicyWindowArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterMaintenancePolicyWindowRecurringWindowArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterMaintenancePolicyWindowRecurringWindowWindowArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterNetworkingArgs;
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) {
final var project = OrganizationsFunctions.getProject();
var default_ = new Cluster("default", ClusterArgs.builder()
.authorization(ClusterAuthorizationArgs.builder()
.adminUsers(ClusterAuthorizationAdminUsersArgs.builder()
.username("admin@hashicorptest.com")
.build())
.build())
.fleet(ClusterFleetArgs.builder()
.project(String.format("projects/%s", project.applyValue(getProjectResult -> getProjectResult.number())))
.build())
.location("us-central1")
.maintenancePolicy(ClusterMaintenancePolicyArgs.builder()
.window(ClusterMaintenancePolicyWindowArgs.builder()
.recurringWindow(ClusterMaintenancePolicyWindowRecurringWindowArgs.builder()
.recurrence("FREQ=WEEKLY;BYDAY=SA")
.window(ClusterMaintenancePolicyWindowRecurringWindowWindowArgs.builder()
.endTime("2023-01-01T17:00:00Z")
.startTime("2023-01-01T08:00:00Z")
.build())
.build())
.build())
.build())
.networking(ClusterNetworkingArgs.builder()
.clusterIpv4CidrBlocks("10.0.0.0/16")
.servicesIpv4CidrBlocks("10.1.0.0/16")
.build())
.build());
}
}

Edgecontainer Local Control Plane Cluster

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.organizations.OrganizationsFunctions;
import com.pulumi.gcp.organizations.inputs.GetProjectArgs;
import com.pulumi.gcp.edgecontainer.Cluster;
import com.pulumi.gcp.edgecontainer.ClusterArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterAuthorizationAdminUsersArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterControlPlaneArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterControlPlaneLocalArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterFleetArgs;
import com.pulumi.gcp.edgecontainer.inputs.ClusterNetworkingArgs;
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) {
final var project = OrganizationsFunctions.getProject();
var default_ = new Cluster("default", ClusterArgs.builder()
.authorization(ClusterAuthorizationArgs.builder()
.adminUsers(ClusterAuthorizationAdminUsersArgs.builder()
.username("admin@hashicorptest.com")
.build())
.build())
.controlPlane(ClusterControlPlaneArgs.builder()
.local(ClusterControlPlaneLocalArgs.builder()
.machineFilter("machine-name")
.nodeCount(1)
.nodeLocation("us-central1-edge-example-edgesite")
.sharedDeploymentPolicy("ALLOWED")
.build())
.build())
.externalLoadBalancerIpv4AddressPools("10.100.0.0-10.100.0.10")
.fleet(ClusterFleetArgs.builder()
.project(String.format("projects/%s", project.applyValue(getProjectResult -> getProjectResult.number())))
.build())
.location("us-central1")
.networking(ClusterNetworkingArgs.builder()
.clusterIpv4CidrBlocks("10.0.0.0/16")
.servicesIpv4CidrBlocks("10.1.0.0/16")
.build())
.build());
}
}

Import

Cluster can be imported using any of these accepted formats* projects/{{project}}/locations/{{location}}/clusters/{{name}} * {{project}}/{{location}}/{{name}} * {{location}}/{{name}} In Terraform v1.5.0 and later, use an import block to import Cluster using one of the formats above. For exampletf import { id = "projects/{{project}}/locations/{{location}}/clusters/{{name}}" to = google_edgecontainer_cluster.default }

$ pulumi import gcp:edgecontainer/cluster:Cluster When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), Cluster can be imported using one of the formats above. For example
$ pulumi import gcp:edgecontainer/cluster:Cluster default projects/{{project}}/locations/{{location}}/clusters/{{name}}
$ pulumi import gcp:edgecontainer/cluster:Cluster default {{project}}/{{location}}/{{name}}
$ pulumi import gcp:edgecontainer/cluster:Cluster default {{location}}/{{name}}

Constructors

Link copied to clipboard
fun ClusterArgs(authorization: Output<ClusterAuthorizationArgs>? = null, controlPlane: Output<ClusterControlPlaneArgs>? = null, controlPlaneEncryption: Output<ClusterControlPlaneEncryptionArgs>? = null, defaultMaxPodsPerNode: Output<Int>? = null, externalLoadBalancerIpv4AddressPools: Output<List<String>>? = null, fleet: Output<ClusterFleetArgs>? = null, labels: Output<Map<String, String>>? = null, location: Output<String>? = null, maintenancePolicy: Output<ClusterMaintenancePolicyArgs>? = null, name: Output<String>? = null, networking: Output<ClusterNetworkingArgs>? = null, project: Output<String>? = null, releaseChannel: Output<String>? = null, systemAddonsConfig: Output<ClusterSystemAddonsConfigArgs>? = null, targetVersion: Output<String>? = null)

Functions

Link copied to clipboard
open override fun toJava(): ClusterArgs

Properties

Link copied to clipboard

RBAC policy that will be applied and managed by GEC. Structure is documented below.

Link copied to clipboard

The configuration of the cluster control plane. Structure is documented below.

Link copied to clipboard

Remote control plane disk encryption options. This field is only used when enabling CMEK support. Structure is documented below.

Link copied to clipboard
val defaultMaxPodsPerNode: Output<Int>? = null

The default maximum number of pods per node used if a maximum value is not specified explicitly for a node pool in this cluster. If unspecified, the Kubernetes default value will be used.

Link copied to clipboard

Address pools for cluster data plane external load balancing.

Link copied to clipboard
val fleet: Output<ClusterFleetArgs>? = null

Fleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. Structure is documented below.

Link copied to clipboard
val labels: Output<Map<String, String>>? = null

User-defined labels for the edgecloud cluster. Note: This field is non-authoritative, and will only manage the labels present in your configuration. Please refer to the field effective_labels for all of the labels present on the resource.

Link copied to clipboard
val location: Output<String>? = null

The location of the resource.

Link copied to clipboard

Cluster-wide maintenance policy configuration. Structure is documented below.

Link copied to clipboard
val name: Output<String>? = null

The GDCE cluster name.

Link copied to clipboard
val networking: Output<ClusterNetworkingArgs>? = null

Fleet related configuration. Fleets are a Google Cloud concept for logically organizing clusters, letting you use and manage multi-cluster capabilities and apply consistent policies across your systems. Structure is documented below.

Link copied to clipboard
val project: Output<String>? = null

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Link copied to clipboard
val releaseChannel: Output<String>? = null

The release channel a cluster is subscribed to. Possible values are: RELEASE_CHANNEL_UNSPECIFIED, NONE, REGULAR.

Link copied to clipboard

Config that customers are allowed to define for GDCE system add-ons. Structure is documented below.

Link copied to clipboard
val targetVersion: Output<String>? = null

The target cluster version. For example: "1.5.0".