ionoscloud.k8s.NodePool
Explore with Pulumi AI
Manages a Managed Kubernetes Node Pool, part of a managed Kubernetes cluster on IonosCloud.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";
const example = new ionoscloud.compute.Datacenter("example", {
name: "Datacenter Example",
location: "us/las",
description: "datacenter description",
secAuthProtection: false,
});
const exampleLan = new ionoscloud.compute.Lan("example", {
datacenterId: example.id,
"public": false,
name: "Lan Example",
});
const exampleIPBlock = new ionoscloud.compute.IPBlock("example", {
location: "us/las",
size: 3,
name: "IP Block Example",
});
const exampleCluster = new ionoscloud.k8s.Cluster("example", {
name: "k8sClusterExample",
k8sVersion: "1.31.2",
maintenanceWindow: {
dayOfTheWeek: "Sunday",
time: "09:00:00Z",
},
apiSubnetAllowLists: ["1.2.3.4/32"],
s3Buckets: [{
name: "globally_unique_s3_bucket_name",
}],
});
const exampleNodePool = new ionoscloud.k8s.NodePool("example", {
datacenterId: example.id,
k8sClusterId: exampleCluster.id,
name: "k8sNodePoolExample",
k8sVersion: exampleCluster.k8sVersion,
maintenanceWindow: {
dayOfTheWeek: "Monday",
time: "09:00:00Z",
},
autoScaling: {
minNodeCount: 1,
maxNodeCount: 2,
},
cpuFamily: "INTEL_XEON",
availabilityZone: "AUTO",
storageType: "SSD",
nodeCount: 1,
coresCount: 2,
ramSize: 2048,
storageSize: 40,
publicIps: [
exampleIPBlock.ips[0],
exampleIPBlock.ips[1],
exampleIPBlock.ips[2],
],
lans: [{
id: exampleLan.id,
dhcp: true,
routes: [{
network: "1.2.3.5/24",
gatewayIp: "10.1.5.17",
}],
}],
labels: {
lab1: "value1",
lab2: "value2",
},
annotations: {
ann1: "value1",
ann2: "value2",
},
});
import pulumi
import pulumi_ionoscloud as ionoscloud
example = ionoscloud.compute.Datacenter("example",
name="Datacenter Example",
location="us/las",
description="datacenter description",
sec_auth_protection=False)
example_lan = ionoscloud.compute.Lan("example",
datacenter_id=example.id,
public=False,
name="Lan Example")
example_ip_block = ionoscloud.compute.IPBlock("example",
location="us/las",
size=3,
name="IP Block Example")
example_cluster = ionoscloud.k8s.Cluster("example",
name="k8sClusterExample",
k8s_version="1.31.2",
maintenance_window={
"day_of_the_week": "Sunday",
"time": "09:00:00Z",
},
api_subnet_allow_lists=["1.2.3.4/32"],
s3_buckets=[{
"name": "globally_unique_s3_bucket_name",
}])
example_node_pool = ionoscloud.k8s.NodePool("example",
datacenter_id=example.id,
k8s_cluster_id=example_cluster.id,
name="k8sNodePoolExample",
k8s_version=example_cluster.k8s_version,
maintenance_window={
"day_of_the_week": "Monday",
"time": "09:00:00Z",
},
auto_scaling={
"min_node_count": 1,
"max_node_count": 2,
},
cpu_family="INTEL_XEON",
availability_zone="AUTO",
storage_type="SSD",
node_count=1,
cores_count=2,
ram_size=2048,
storage_size=40,
public_ips=[
example_ip_block.ips[0],
example_ip_block.ips[1],
example_ip_block.ips[2],
],
lans=[{
"id": example_lan.id,
"dhcp": True,
"routes": [{
"network": "1.2.3.5/24",
"gateway_ip": "10.1.5.17",
}],
}],
labels={
"lab1": "value1",
"lab2": "value2",
},
annotations={
"ann1": "value1",
"ann2": "value2",
})
package main
import (
"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud/compute"
"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud/k8s"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := compute.NewDatacenter(ctx, "example", &compute.DatacenterArgs{
Name: pulumi.String("Datacenter Example"),
Location: pulumi.String("us/las"),
Description: pulumi.String("datacenter description"),
SecAuthProtection: pulumi.Bool(false),
})
if err != nil {
return err
}
exampleLan, err := compute.NewLan(ctx, "example", &compute.LanArgs{
DatacenterId: example.ID(),
Public: pulumi.Bool(false),
Name: pulumi.String("Lan Example"),
})
if err != nil {
return err
}
exampleIPBlock, err := compute.NewIPBlock(ctx, "example", &compute.IPBlockArgs{
Location: pulumi.String("us/las"),
Size: pulumi.Int(3),
Name: pulumi.String("IP Block Example"),
})
if err != nil {
return err
}
exampleCluster, err := k8s.NewCluster(ctx, "example", &k8s.ClusterArgs{
Name: pulumi.String("k8sClusterExample"),
K8sVersion: pulumi.String("1.31.2"),
MaintenanceWindow: &k8s.ClusterMaintenanceWindowArgs{
DayOfTheWeek: pulumi.String("Sunday"),
Time: pulumi.String("09:00:00Z"),
},
ApiSubnetAllowLists: pulumi.StringArray{
pulumi.String("1.2.3.4/32"),
},
S3Buckets: k8s.ClusterS3BucketArray{
&k8s.ClusterS3BucketArgs{
Name: pulumi.String("globally_unique_s3_bucket_name"),
},
},
})
if err != nil {
return err
}
_, err = k8s.NewNodePool(ctx, "example", &k8s.NodePoolArgs{
DatacenterId: example.ID(),
K8sClusterId: exampleCluster.ID(),
Name: pulumi.String("k8sNodePoolExample"),
K8sVersion: exampleCluster.K8sVersion,
MaintenanceWindow: &k8s.NodePoolMaintenanceWindowArgs{
DayOfTheWeek: pulumi.String("Monday"),
Time: pulumi.String("09:00:00Z"),
},
AutoScaling: &k8s.NodePoolAutoScalingArgs{
MinNodeCount: pulumi.Int(1),
MaxNodeCount: pulumi.Int(2),
},
CpuFamily: pulumi.String("INTEL_XEON"),
AvailabilityZone: pulumi.String("AUTO"),
StorageType: pulumi.String("SSD"),
NodeCount: pulumi.Int(1),
CoresCount: pulumi.Int(2),
RamSize: pulumi.Int(2048),
StorageSize: pulumi.Int(40),
PublicIps: pulumi.StringArray{
exampleIPBlock.Ips.ApplyT(func(ips []string) (string, error) {
return ips[0], nil
}).(pulumi.StringOutput),
exampleIPBlock.Ips.ApplyT(func(ips []string) (string, error) {
return ips[1], nil
}).(pulumi.StringOutput),
exampleIPBlock.Ips.ApplyT(func(ips []string) (string, error) {
return ips[2], nil
}).(pulumi.StringOutput),
},
Lans: k8s.NodePoolLanArray{
&k8s.NodePoolLanArgs{
Id: exampleLan.ID(),
Dhcp: pulumi.Bool(true),
Routes: k8s.NodePoolLanRouteArray{
&k8s.NodePoolLanRouteArgs{
Network: pulumi.String("1.2.3.5/24"),
GatewayIp: pulumi.String("10.1.5.17"),
},
},
},
},
Labels: pulumi.StringMap{
"lab1": pulumi.String("value1"),
"lab2": pulumi.String("value2"),
},
Annotations: pulumi.StringMap{
"ann1": pulumi.String("value1"),
"ann2": pulumi.String("value2"),
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Ionoscloud.Pulumi.Ionoscloud;
return await Deployment.RunAsync(() =>
{
var example = new Ionoscloud.Compute.Datacenter("example", new()
{
Name = "Datacenter Example",
Location = "us/las",
Description = "datacenter description",
SecAuthProtection = false,
});
var exampleLan = new Ionoscloud.Compute.Lan("example", new()
{
DatacenterId = example.Id,
Public = false,
Name = "Lan Example",
});
var exampleIPBlock = new Ionoscloud.Compute.IPBlock("example", new()
{
Location = "us/las",
Size = 3,
Name = "IP Block Example",
});
var exampleCluster = new Ionoscloud.K8s.Cluster("example", new()
{
Name = "k8sClusterExample",
K8sVersion = "1.31.2",
MaintenanceWindow = new Ionoscloud.K8s.Inputs.ClusterMaintenanceWindowArgs
{
DayOfTheWeek = "Sunday",
Time = "09:00:00Z",
},
ApiSubnetAllowLists = new[]
{
"1.2.3.4/32",
},
S3Buckets = new[]
{
new Ionoscloud.K8s.Inputs.ClusterS3BucketArgs
{
Name = "globally_unique_s3_bucket_name",
},
},
});
var exampleNodePool = new Ionoscloud.K8s.NodePool("example", new()
{
DatacenterId = example.Id,
K8sClusterId = exampleCluster.Id,
Name = "k8sNodePoolExample",
K8sVersion = exampleCluster.K8sVersion,
MaintenanceWindow = new Ionoscloud.K8s.Inputs.NodePoolMaintenanceWindowArgs
{
DayOfTheWeek = "Monday",
Time = "09:00:00Z",
},
AutoScaling = new Ionoscloud.K8s.Inputs.NodePoolAutoScalingArgs
{
MinNodeCount = 1,
MaxNodeCount = 2,
},
CpuFamily = "INTEL_XEON",
AvailabilityZone = "AUTO",
StorageType = "SSD",
NodeCount = 1,
CoresCount = 2,
RamSize = 2048,
StorageSize = 40,
PublicIps = new[]
{
exampleIPBlock.Ips.Apply(ips => ips[0]),
exampleIPBlock.Ips.Apply(ips => ips[1]),
exampleIPBlock.Ips.Apply(ips => ips[2]),
},
Lans = new[]
{
new Ionoscloud.K8s.Inputs.NodePoolLanArgs
{
Id = exampleLan.Id,
Dhcp = true,
Routes = new[]
{
new Ionoscloud.K8s.Inputs.NodePoolLanRouteArgs
{
Network = "1.2.3.5/24",
GatewayIp = "10.1.5.17",
},
},
},
},
Labels =
{
{ "lab1", "value1" },
{ "lab2", "value2" },
},
Annotations =
{
{ "ann1", "value1" },
{ "ann2", "value2" },
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.compute.Datacenter;
import com.pulumi.ionoscloud.compute.DatacenterArgs;
import com.pulumi.ionoscloud.compute.Lan;
import com.pulumi.ionoscloud.compute.LanArgs;
import com.pulumi.ionoscloud.compute.IPBlock;
import com.pulumi.ionoscloud.compute.IPBlockArgs;
import com.pulumi.ionoscloud.k8s.Cluster;
import com.pulumi.ionoscloud.k8s.ClusterArgs;
import com.pulumi.ionoscloud.k8s.inputs.ClusterMaintenanceWindowArgs;
import com.pulumi.ionoscloud.k8s.inputs.ClusterS3BucketArgs;
import com.pulumi.ionoscloud.k8s.NodePool;
import com.pulumi.ionoscloud.k8s.NodePoolArgs;
import com.pulumi.ionoscloud.k8s.inputs.NodePoolMaintenanceWindowArgs;
import com.pulumi.ionoscloud.k8s.inputs.NodePoolAutoScalingArgs;
import com.pulumi.ionoscloud.k8s.inputs.NodePoolLanArgs;
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 Datacenter("example", DatacenterArgs.builder()
.name("Datacenter Example")
.location("us/las")
.description("datacenter description")
.secAuthProtection(false)
.build());
var exampleLan = new Lan("exampleLan", LanArgs.builder()
.datacenterId(example.id())
.public_(false)
.name("Lan Example")
.build());
var exampleIPBlock = new IPBlock("exampleIPBlock", IPBlockArgs.builder()
.location("us/las")
.size(3)
.name("IP Block Example")
.build());
var exampleCluster = new Cluster("exampleCluster", ClusterArgs.builder()
.name("k8sClusterExample")
.k8sVersion("1.31.2")
.maintenanceWindow(ClusterMaintenanceWindowArgs.builder()
.dayOfTheWeek("Sunday")
.time("09:00:00Z")
.build())
.apiSubnetAllowLists("1.2.3.4/32")
.s3Buckets(ClusterS3BucketArgs.builder()
.name("globally_unique_s3_bucket_name")
.build())
.build());
var exampleNodePool = new NodePool("exampleNodePool", NodePoolArgs.builder()
.datacenterId(example.id())
.k8sClusterId(exampleCluster.id())
.name("k8sNodePoolExample")
.k8sVersion(exampleCluster.k8sVersion())
.maintenanceWindow(NodePoolMaintenanceWindowArgs.builder()
.dayOfTheWeek("Monday")
.time("09:00:00Z")
.build())
.autoScaling(NodePoolAutoScalingArgs.builder()
.minNodeCount(1)
.maxNodeCount(2)
.build())
.cpuFamily("INTEL_XEON")
.availabilityZone("AUTO")
.storageType("SSD")
.nodeCount(1)
.coresCount(2)
.ramSize(2048)
.storageSize(40)
.publicIps(
exampleIPBlock.ips().applyValue(ips -> ips[0]),
exampleIPBlock.ips().applyValue(ips -> ips[1]),
exampleIPBlock.ips().applyValue(ips -> ips[2]))
.lans(NodePoolLanArgs.builder()
.id(exampleLan.id())
.dhcp(true)
.routes(NodePoolLanRouteArgs.builder()
.network("1.2.3.5/24")
.gatewayIp("10.1.5.17")
.build())
.build())
.labels(Map.ofEntries(
Map.entry("lab1", "value1"),
Map.entry("lab2", "value2")
))
.annotations(Map.ofEntries(
Map.entry("ann1", "value1"),
Map.entry("ann2", "value2")
))
.build());
}
}
resources:
example:
type: ionoscloud:compute:Datacenter
properties:
name: Datacenter Example
location: us/las
description: datacenter description
secAuthProtection: false
exampleLan:
type: ionoscloud:compute:Lan
name: example
properties:
datacenterId: ${example.id}
public: false
name: Lan Example
exampleIPBlock:
type: ionoscloud:compute:IPBlock
name: example
properties:
location: us/las
size: 3
name: IP Block Example
exampleCluster:
type: ionoscloud:k8s:Cluster
name: example
properties:
name: k8sClusterExample
k8sVersion: 1.31.2
maintenanceWindow:
dayOfTheWeek: Sunday
time: 09:00:00Z
apiSubnetAllowLists:
- 1.2.3.4/32
s3Buckets:
- name: globally_unique_s3_bucket_name
exampleNodePool:
type: ionoscloud:k8s:NodePool
name: example
properties:
datacenterId: ${example.id}
k8sClusterId: ${exampleCluster.id}
name: k8sNodePoolExample
k8sVersion: ${exampleCluster.k8sVersion}
maintenanceWindow:
dayOfTheWeek: Monday
time: 09:00:00Z
autoScaling:
minNodeCount: 1
maxNodeCount: 2
cpuFamily: INTEL_XEON
availabilityZone: AUTO
storageType: SSD
nodeCount: 1
coresCount: 2
ramSize: 2048
storageSize: 40
publicIps:
- ${exampleIPBlock.ips[0]}
- ${exampleIPBlock.ips[1]}
- ${exampleIPBlock.ips[2]}
lans:
- id: ${exampleLan.id}
dhcp: true
routes:
- network: 1.2.3.5/24
gatewayIp: 10.1.5.17
labels:
lab1: value1
lab2: value2
annotations:
ann1: value1
ann2: value2
Note: Set create_before_destroy
on the lan resource if you want to remove it from the nodepool during an update. This is to ensure that the nodepool is updated before the lan is destroyed.
Create NodePool Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new NodePool(name: string, args: NodePoolArgs, opts?: CustomResourceOptions);
@overload
def NodePool(resource_name: str,
args: NodePoolArgs,
opts: Optional[ResourceOptions] = None)
@overload
def NodePool(resource_name: str,
opts: Optional[ResourceOptions] = None,
k8s_version: Optional[str] = None,
node_count: Optional[int] = None,
storage_type: Optional[str] = None,
availability_zone: Optional[str] = None,
cores_count: Optional[int] = None,
cpu_family: Optional[str] = None,
datacenter_id: Optional[str] = None,
k8s_cluster_id: Optional[str] = None,
storage_size: Optional[int] = None,
ram_size: Optional[int] = None,
labels: Optional[Mapping[str, str]] = None,
maintenance_window: Optional[NodePoolMaintenanceWindowArgs] = None,
name: Optional[str] = None,
allow_replace: Optional[bool] = None,
public_ips: Optional[Sequence[str]] = None,
lans: Optional[Sequence[NodePoolLanArgs]] = None,
annotations: Optional[Mapping[str, str]] = None,
auto_scaling: Optional[NodePoolAutoScalingArgs] = None)
func NewNodePool(ctx *Context, name string, args NodePoolArgs, opts ...ResourceOption) (*NodePool, error)
public NodePool(string name, NodePoolArgs args, CustomResourceOptions? opts = null)
public NodePool(String name, NodePoolArgs args)
public NodePool(String name, NodePoolArgs args, CustomResourceOptions options)
type: ionoscloud:k8s:NodePool
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args NodePoolArgs
- 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 NodePoolArgs
- 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 NodePoolArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NodePoolArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NodePoolArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var ionoscloudNodePoolResource = new Ionoscloud.K8s.NodePool("ionoscloudNodePoolResource", new()
{
K8sVersion = "string",
NodeCount = 0,
StorageType = "string",
AvailabilityZone = "string",
CoresCount = 0,
CpuFamily = "string",
DatacenterId = "string",
K8sClusterId = "string",
StorageSize = 0,
RamSize = 0,
Labels =
{
{ "string", "string" },
},
MaintenanceWindow = new Ionoscloud.K8s.Inputs.NodePoolMaintenanceWindowArgs
{
DayOfTheWeek = "string",
Time = "string",
},
Name = "string",
AllowReplace = false,
PublicIps = new[]
{
"string",
},
Lans = new[]
{
new Ionoscloud.K8s.Inputs.NodePoolLanArgs
{
Id = 0,
Dhcp = false,
Routes = new[]
{
new Ionoscloud.K8s.Inputs.NodePoolLanRouteArgs
{
GatewayIp = "string",
Network = "string",
},
},
},
},
Annotations =
{
{ "string", "string" },
},
AutoScaling = new Ionoscloud.K8s.Inputs.NodePoolAutoScalingArgs
{
MaxNodeCount = 0,
MinNodeCount = 0,
},
});
example, err := k8s.NewNodePool(ctx, "ionoscloudNodePoolResource", &k8s.NodePoolArgs{
K8sVersion: pulumi.String("string"),
NodeCount: pulumi.Int(0),
StorageType: pulumi.String("string"),
AvailabilityZone: pulumi.String("string"),
CoresCount: pulumi.Int(0),
CpuFamily: pulumi.String("string"),
DatacenterId: pulumi.String("string"),
K8sClusterId: pulumi.String("string"),
StorageSize: pulumi.Int(0),
RamSize: pulumi.Int(0),
Labels: pulumi.StringMap{
"string": pulumi.String("string"),
},
MaintenanceWindow: &k8s.NodePoolMaintenanceWindowArgs{
DayOfTheWeek: pulumi.String("string"),
Time: pulumi.String("string"),
},
Name: pulumi.String("string"),
AllowReplace: pulumi.Bool(false),
PublicIps: pulumi.StringArray{
pulumi.String("string"),
},
Lans: k8s.NodePoolLanArray{
&k8s.NodePoolLanArgs{
Id: pulumi.Int(0),
Dhcp: pulumi.Bool(false),
Routes: k8s.NodePoolLanRouteArray{
&k8s.NodePoolLanRouteArgs{
GatewayIp: pulumi.String("string"),
Network: pulumi.String("string"),
},
},
},
},
Annotations: pulumi.StringMap{
"string": pulumi.String("string"),
},
AutoScaling: &k8s.NodePoolAutoScalingArgs{
MaxNodeCount: pulumi.Int(0),
MinNodeCount: pulumi.Int(0),
},
})
var ionoscloudNodePoolResource = new com.ionoscloud.pulumi.ionoscloud.k8s.NodePool("ionoscloudNodePoolResource", com.ionoscloud.pulumi.ionoscloud.k8s.NodePoolArgs.builder()
.k8sVersion("string")
.nodeCount(0)
.storageType("string")
.availabilityZone("string")
.coresCount(0)
.cpuFamily("string")
.datacenterId("string")
.k8sClusterId("string")
.storageSize(0)
.ramSize(0)
.labels(Map.of("string", "string"))
.maintenanceWindow(NodePoolMaintenanceWindowArgs.builder()
.dayOfTheWeek("string")
.time("string")
.build())
.name("string")
.allowReplace(false)
.publicIps("string")
.lans(NodePoolLanArgs.builder()
.id(0)
.dhcp(false)
.routes(NodePoolLanRouteArgs.builder()
.gatewayIp("string")
.network("string")
.build())
.build())
.annotations(Map.of("string", "string"))
.autoScaling(NodePoolAutoScalingArgs.builder()
.maxNodeCount(0)
.minNodeCount(0)
.build())
.build());
ionoscloud_node_pool_resource = ionoscloud.k8s.NodePool("ionoscloudNodePoolResource",
k8s_version="string",
node_count=0,
storage_type="string",
availability_zone="string",
cores_count=0,
cpu_family="string",
datacenter_id="string",
k8s_cluster_id="string",
storage_size=0,
ram_size=0,
labels={
"string": "string",
},
maintenance_window={
"day_of_the_week": "string",
"time": "string",
},
name="string",
allow_replace=False,
public_ips=["string"],
lans=[{
"id": 0,
"dhcp": False,
"routes": [{
"gateway_ip": "string",
"network": "string",
}],
}],
annotations={
"string": "string",
},
auto_scaling={
"max_node_count": 0,
"min_node_count": 0,
})
const ionoscloudNodePoolResource = new ionoscloud.k8s.NodePool("ionoscloudNodePoolResource", {
k8sVersion: "string",
nodeCount: 0,
storageType: "string",
availabilityZone: "string",
coresCount: 0,
cpuFamily: "string",
datacenterId: "string",
k8sClusterId: "string",
storageSize: 0,
ramSize: 0,
labels: {
string: "string",
},
maintenanceWindow: {
dayOfTheWeek: "string",
time: "string",
},
name: "string",
allowReplace: false,
publicIps: ["string"],
lans: [{
id: 0,
dhcp: false,
routes: [{
gatewayIp: "string",
network: "string",
}],
}],
annotations: {
string: "string",
},
autoScaling: {
maxNodeCount: 0,
minNodeCount: 0,
},
});
type: ionoscloud:k8s:NodePool
properties:
allowReplace: false
annotations:
string: string
autoScaling:
maxNodeCount: 0
minNodeCount: 0
availabilityZone: string
coresCount: 0
cpuFamily: string
datacenterId: string
k8sClusterId: string
k8sVersion: string
labels:
string: string
lans:
- dhcp: false
id: 0
routes:
- gatewayIp: string
network: string
maintenanceWindow:
dayOfTheWeek: string
time: string
name: string
nodeCount: 0
publicIps:
- string
ramSize: 0
storageSize: 0
storageType: string
NodePool Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The NodePool resource accepts the following input properties:
- Availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- Cores
Count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- Cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- Datacenter
Id string - [string] A Datacenter's UUID
- K8s
Cluster stringId - [string] A k8s cluster's UUID
- K8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- Node
Count int - [int] - The desired number of nodes in the node pool
- Ram
Size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- Storage
Size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- Storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- Allow
Replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- Annotations Dictionary<string, string>
- [map] A key/value map of annotations
- Auto
Scaling Ionoscloud.Node Pool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- Labels Dictionary<string, string>
- [map] A key/value map of labels
- Lans
List<Ionoscloud.
Node Pool Lan> - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- Maintenance
Window Ionoscloud.Node Pool Maintenance Window - See the maintenance_window section in the example above
- Name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- Public
Ips List<string> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
- Availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- Cores
Count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- Cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- Datacenter
Id string - [string] A Datacenter's UUID
- K8s
Cluster stringId - [string] A k8s cluster's UUID
- K8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- Node
Count int - [int] - The desired number of nodes in the node pool
- Ram
Size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- Storage
Size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- Storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- Allow
Replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- Annotations map[string]string
- [map] A key/value map of annotations
- Auto
Scaling NodePool Auto Scaling Args - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- Labels map[string]string
- [map] A key/value map of labels
- Lans
[]Node
Pool Lan Args - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- Maintenance
Window NodePool Maintenance Window Args - See the maintenance_window section in the example above
- Name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- Public
Ips []string - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
- availability
Zone String - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count Integer - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family String - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id String - [string] A Datacenter's UUID
- k8s
Cluster StringId - [string] A k8s cluster's UUID
- k8s
Version String - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- node
Count Integer - [int] - The desired number of nodes in the node pool
- ram
Size Integer - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size Integer - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type String - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace Boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Map<String,String>
- [map] A key/value map of annotations
- auto
Scaling NodePool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- labels Map<String,String>
- [map] A key/value map of labels
- lans
List<Node
Pool Lan> - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window NodePool Maintenance Window - See the maintenance_window section in the example above
- name String
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- public
Ips List<String> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
- availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count number - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id string - [string] A Datacenter's UUID
- k8s
Cluster stringId - [string] A k8s cluster's UUID
- k8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- node
Count number - [int] - The desired number of nodes in the node pool
- ram
Size number - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size number - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations {[key: string]: string}
- [map] A key/value map of annotations
- auto
Scaling NodePool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- labels {[key: string]: string}
- [map] A key/value map of labels
- lans
Node
Pool Lan[] - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window NodePool Maintenance Window - See the maintenance_window section in the example above
- name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- public
Ips string[] - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
- availability_
zone str - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores_
count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu_
family str - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter_
id str - [string] A Datacenter's UUID
- k8s_
cluster_ strid - [string] A k8s cluster's UUID
- k8s_
version str - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- node_
count int - [int] - The desired number of nodes in the node pool
- ram_
size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage_
size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage_
type str - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow_
replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Mapping[str, str]
- [map] A key/value map of annotations
- auto_
scaling NodePool Auto Scaling Args - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- labels Mapping[str, str]
- [map] A key/value map of labels
- lans
Sequence[Node
Pool Lan Args] - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance_
window NodePool Maintenance Window Args - See the maintenance_window section in the example above
- name str
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- public_
ips Sequence[str] - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
- availability
Zone String - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count Number - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family String - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id String - [string] A Datacenter's UUID
- k8s
Cluster StringId - [string] A k8s cluster's UUID
- k8s
Version String - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- node
Count Number - [int] - The desired number of nodes in the node pool
- ram
Size Number - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size Number - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type String - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace Boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Map<String>
- [map] A key/value map of annotations
- auto
Scaling Property Map - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- labels Map<String>
- [map] A key/value map of labels
- lans List<Property Map>
- [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window Property Map - See the maintenance_window section in the example above
- name String
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- public
Ips List<String> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements
Outputs
All input properties are implicitly available as output properties. Additionally, the NodePool 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.
Look up Existing NodePool Resource
Get an existing NodePool resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: NodePoolState, opts?: CustomResourceOptions): NodePool
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
allow_replace: Optional[bool] = None,
annotations: Optional[Mapping[str, str]] = None,
auto_scaling: Optional[NodePoolAutoScalingArgs] = None,
availability_zone: Optional[str] = None,
cores_count: Optional[int] = None,
cpu_family: Optional[str] = None,
datacenter_id: Optional[str] = None,
k8s_cluster_id: Optional[str] = None,
k8s_version: Optional[str] = None,
labels: Optional[Mapping[str, str]] = None,
lans: Optional[Sequence[NodePoolLanArgs]] = None,
maintenance_window: Optional[NodePoolMaintenanceWindowArgs] = None,
name: Optional[str] = None,
node_count: Optional[int] = None,
public_ips: Optional[Sequence[str]] = None,
ram_size: Optional[int] = None,
storage_size: Optional[int] = None,
storage_type: Optional[str] = None) -> NodePool
func GetNodePool(ctx *Context, name string, id IDInput, state *NodePoolState, opts ...ResourceOption) (*NodePool, error)
public static NodePool Get(string name, Input<string> id, NodePoolState? state, CustomResourceOptions? opts = null)
public static NodePool get(String name, Output<String> id, NodePoolState state, CustomResourceOptions options)
resources: _: type: ionoscloud:k8s:NodePool get: id: ${id}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Allow
Replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- Annotations Dictionary<string, string>
- [map] A key/value map of annotations
- Auto
Scaling Ionoscloud.Node Pool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- Availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- Cores
Count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- Cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- Datacenter
Id string - [string] A Datacenter's UUID
- K8s
Cluster stringId - [string] A k8s cluster's UUID
- K8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- Labels Dictionary<string, string>
- [map] A key/value map of labels
- Lans
List<Ionoscloud.
Node Pool Lan> - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- Maintenance
Window Ionoscloud.Node Pool Maintenance Window - See the maintenance_window section in the example above
- Name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- Node
Count int - [int] - The desired number of nodes in the node pool
- Public
Ips List<string> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - Ram
Size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- Storage
Size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- Storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- Allow
Replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- Annotations map[string]string
- [map] A key/value map of annotations
- Auto
Scaling NodePool Auto Scaling Args - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- Availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- Cores
Count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- Cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- Datacenter
Id string - [string] A Datacenter's UUID
- K8s
Cluster stringId - [string] A k8s cluster's UUID
- K8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- Labels map[string]string
- [map] A key/value map of labels
- Lans
[]Node
Pool Lan Args - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- Maintenance
Window NodePool Maintenance Window Args - See the maintenance_window section in the example above
- Name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- Node
Count int - [int] - The desired number of nodes in the node pool
- Public
Ips []string - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - Ram
Size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- Storage
Size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- Storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace Boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Map<String,String>
- [map] A key/value map of annotations
- auto
Scaling NodePool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- availability
Zone String - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count Integer - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family String - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id String - [string] A Datacenter's UUID
- k8s
Cluster StringId - [string] A k8s cluster's UUID
- k8s
Version String - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- labels Map<String,String>
- [map] A key/value map of labels
- lans
List<Node
Pool Lan> - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window NodePool Maintenance Window - See the maintenance_window section in the example above
- name String
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- node
Count Integer - [int] - The desired number of nodes in the node pool
- public
Ips List<String> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - ram
Size Integer - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size Integer - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type String - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations {[key: string]: string}
- [map] A key/value map of annotations
- auto
Scaling NodePool Auto Scaling - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- availability
Zone string - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count number - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family string - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id string - [string] A Datacenter's UUID
- k8s
Cluster stringId - [string] A k8s cluster's UUID
- k8s
Version string - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- labels {[key: string]: string}
- [map] A key/value map of labels
- lans
Node
Pool Lan[] - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window NodePool Maintenance Window - See the maintenance_window section in the example above
- name string
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- node
Count number - [int] - The desired number of nodes in the node pool
- public
Ips string[] - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - ram
Size number - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size number - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type string - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow_
replace bool [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Mapping[str, str]
- [map] A key/value map of annotations
- auto_
scaling NodePool Auto Scaling Args - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- availability_
zone str - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores_
count int - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu_
family str - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter_
id str - [string] A Datacenter's UUID
- k8s_
cluster_ strid - [string] A k8s cluster's UUID
- k8s_
version str - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- labels Mapping[str, str]
- [map] A key/value map of labels
- lans
Sequence[Node
Pool Lan Args] - [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance_
window NodePool Maintenance Window Args - See the maintenance_window section in the example above
- name str
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- node_
count int - [int] - The desired number of nodes in the node pool
- public_
ips Sequence[str] - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - ram_
size int - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage_
size int - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage_
type str - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
- allow
Replace Boolean [bool] When set to true, allows the update of immutable fields by first destroying and then re-creating the node pool.
⚠️ Warning:
allow_replace
- lets you update immutable fields, but it first destroys and then re-creates the node pool in order to do it. Set the field to true only if you know what you are doing. This will cause a downtime for all pods on that nodepool. Consider adding multiple nodepools and update one after the other for downtime free nodepool upgrade.Immutable fields list: name, cpu_family, availability_zone, cores_count, ram_size, storage_size, storage_type.
⚠️ Note:
Be careful when using
auto_scaling
since the number of nodes can change. Because of that, when runningpulumi preview
, An update will be considered required (sincenode_count
from thetf
plan will be different from the number of nodes set by the scheduler). To avoid that, you can useignore_changes
. This will also ignore the manual changes fornode_count
made in thetf
plan. You can read more details about theignore_changes
attribute here.- annotations Map<String>
- [map] A key/value map of annotations
- auto
Scaling Property Map - [string] Whether the Node Pool should autoscale. For more details, please check the API documentation
- availability
Zone String - [string] - The desired Compute availability zone - See the API documentation for more information. This attribute is immutable.
- cores
Count Number - [int] - The CPU cores count for each node of the node pool. This attribute is immutable.
- cpu
Family String - [string] The desired CPU Family - See the API documentation for more information. This attribute is immutable.
- datacenter
Id String - [string] A Datacenter's UUID
- k8s
Cluster StringId - [string] A k8s cluster's UUID
- k8s
Version String - [string] The desired Kubernetes Version. For supported values, please check the API documentation. Downgrades are not supported. The provider will ignore downgrades of patch level.
- labels Map<String>
- [map] A key/value map of labels
- lans List<Property Map>
- [list] A list of numeric LAN id's you want this node pool to be part of. For more details, please check the API documentation, as well as the example above
- maintenance
Window Property Map - See the maintenance_window section in the example above
- name String
- [string] The name of the Kubernetes Cluster. This attribute is immutable.
- node
Count Number - [int] - The desired number of nodes in the node pool
- public
Ips List<String> - [list] A list of public IPs associated with the node pool; must have at least
node_count + 1
elements - ram
Size Number - [int] - The desired amount of RAM, in MB. This attribute is immutable.
- storage
Size Number - [int] - The size of the volume in GB. The size should be greater than 10GB. This attribute is immutable.
- storage
Type String - [string] - The desired storage type - SSD/HDD. This attribute is immutable.
Supporting Types
NodePoolAutoScaling, NodePoolAutoScalingArgs
- Max
Node intCount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- Min
Node intCount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
- Max
Node intCount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- Min
Node intCount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
- max
Node IntegerCount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- min
Node IntegerCount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
- max
Node numberCount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- min
Node numberCount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
- max_
node_ intcount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- min_
node_ intcount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
- max
Node NumberCount - [int] The maximum number of worker nodes that the node pool can scale to. Should be greater than min_node_count
- min
Node NumberCount - [int] The minimum number of worker nodes the node pool can scale down to. Should be less than max_node_count
NodePoolLan, NodePoolLanArgs
- Id int
- [int] The LAN ID of an existing LAN at the related datacenter
- Dhcp bool
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- Routes
List<Ionoscloud.
Node Pool Lan Route> - An array of additional LANs attached to worker nodes
- Id int
- [int] The LAN ID of an existing LAN at the related datacenter
- Dhcp bool
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- Routes
[]Node
Pool Lan Route - An array of additional LANs attached to worker nodes
- id Integer
- [int] The LAN ID of an existing LAN at the related datacenter
- dhcp Boolean
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- routes
List<Node
Pool Lan Route> - An array of additional LANs attached to worker nodes
- id number
- [int] The LAN ID of an existing LAN at the related datacenter
- dhcp boolean
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- routes
Node
Pool Lan Route[] - An array of additional LANs attached to worker nodes
- id int
- [int] The LAN ID of an existing LAN at the related datacenter
- dhcp bool
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- routes
Sequence[Node
Pool Lan Route] - An array of additional LANs attached to worker nodes
- id Number
- [int] The LAN ID of an existing LAN at the related datacenter
- dhcp Boolean
- [boolean] Indicates if the Kubernetes Node Pool LAN will reserve an IP using DHCP. Default value is
true
- routes List<Property Map>
- An array of additional LANs attached to worker nodes
NodePoolLanRoute, NodePoolLanRouteArgs
- gateway_
ip str - [string] IPv4 or IPv6 Gateway IP for the route
- network str
- [string] IPv4 or IPv6 CIDR to be routed via the interface
NodePoolMaintenanceWindow, NodePoolMaintenanceWindowArgs
- Day
Of stringThe Week - [string] Day of the week when maintenance is allowed
- Time string
- [string] A clock time in the day when maintenance is allowed
- Day
Of stringThe Week - [string] Day of the week when maintenance is allowed
- Time string
- [string] A clock time in the day when maintenance is allowed
- day
Of StringThe Week - [string] Day of the week when maintenance is allowed
- time String
- [string] A clock time in the day when maintenance is allowed
- day
Of stringThe Week - [string] Day of the week when maintenance is allowed
- time string
- [string] A clock time in the day when maintenance is allowed
- day_
of_ strthe_ week - [string] Day of the week when maintenance is allowed
- time str
- [string] A clock time in the day when maintenance is allowed
- day
Of StringThe Week - [string] Day of the week when maintenance is allowed
- time String
- [string] A clock time in the day when maintenance is allowed
Import
A Kubernetes Node Pool resource can be imported using its Kubernetes cluster’s uuid as well as its own UUID, both of which you can retrieve from the cloud API: resource id
, e.g.:
$ pulumi import ionoscloud:k8s/nodePool:NodePool demo k8s_cluster_uuid/k8s_nodepool_id
This can be helpful when you want to import kubernetes node pools which you have already created manually or using other means, outside of pulumi, towards the goal of managing them via Pulumi
⚠️ **_Warning: **During a maintenance window, k8s can update your k8s_version
if the old one reaches end of life. This upgrade will not be shown in the plan, as we prevent
pulumi from doing a downgrade, as downgrading k8s_version
is not supported._**
⚠️ Warning: If you are upgrading from v5.x.x to v6.x.x: You have to modify you plan for lans to match the new structure, by putting the ids from the old slice in lans.id fields. This is not backwards compatible.
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- ionoscloud ionos-cloud/pulumi-ionoscloud
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ionoscloud
Terraform Provider.