import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Manages a Node Pool within a Kubernetes Cluster * * > **NOTE:** Multiple Node Pools are only supported when the Kubernetes Cluster is using Virtual Machine Scale Sets. * * > **Note:** Changing certain properties is done by cycling the node pool. When cycling it, it doesn’t perform cordon and drain, and it will disrupt rescheduling pods currently running on the previous node pool. `temporaryNameForRotation` must be specified when changing any of the following properties: `fipsEnabled`, `hostEncryptionEnabled`, `kubeletConfig`, `kubeletDiskType`, `linuxOsConfig`, `maxPods`, `nodePublicIpEnabled`, `osDiskSizeGb`, `osDiskType`, `podSubnetId`, `snapshotId`, `ultraSsdEnabled`, `vmSize`, `vnetSubnetId`, `zones`. * * ## Example Usage * * This example provisions a basic Kubernetes Node Pool. * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const exampleKubernetesCluster = new azure.containerservice.KubernetesCluster("example", { * name: "example-aks1", * location: example.location, * resourceGroupName: example.name, * dnsPrefix: "exampleaks1", * defaultNodePool: { * name: "default", * nodeCount: 1, * vmSize: "Standard_D2_v2", * }, * servicePrincipal: { * clientId: "00000000-0000-0000-0000-000000000000", * clientSecret: "00000000000000000000000000000000", * }, * }); * const exampleKubernetesClusterNodePool = new azure.containerservice.KubernetesClusterNodePool("example", { * name: "internal", * kubernetesClusterId: exampleKubernetesCluster.id, * vmSize: "Standard_DS2_v2", * nodeCount: 1, * tags: { * Environment: "Production", * }, * }); * ``` * * ## API Providers * * * This resource uses the following Azure API Providers: * * * `Microsoft.ContainerService` - 2025-10-01 * * ## Import * * Kubernetes Cluster Node Pools can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:containerservice/kubernetesClusterNodePool:KubernetesClusterNodePool pool1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.ContainerService/managedClusters/cluster1/agentPools/pool1 * ``` */ export declare class KubernetesClusterNodePool extends pulumi.CustomResource { /** * Get an existing KubernetesClusterNodePool resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: KubernetesClusterNodePoolState, opts?: pulumi.CustomResourceOptions): KubernetesClusterNodePool; /** * Returns true if the given object is an instance of KubernetesClusterNodePool. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is KubernetesClusterNodePool; /** * Whether to enable [auto-scaler](https://docs.microsoft.com/azure/aks/cluster-autoscaler). */ readonly autoScalingEnabled: pulumi.Output; /** * Specifies the ID of the Capacity Reservation Group where this Node Pool should exist. Changing this forces a new resource to be created. */ readonly capacityReservationGroupId: pulumi.Output; /** * The Eviction Policy which should be used for Virtual Machines within the Virtual Machine Scale Set powering this Node Pool. Possible values are `Deallocate` and `Delete`. Changing this forces a new resource to be created. * * > **Note:** An Eviction Policy can only be configured when `priority` is set to `Spot` and will default to `Delete` unless otherwise specified. */ readonly evictionPolicy: pulumi.Output; /** * Should the nodes in this Node Pool have Federal Information Processing Standard enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **Note:** FIPS support is in Public Preview - more information and details on how to opt into the Preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-multiple-node-pools#add-a-fips-enabled-node-pool-preview). */ readonly fipsEnabled: pulumi.Output; /** * Specifies whether to install the GPU Driver for the nodes. Possible values are `Install` and `None`. Changing this forces a new resource to be created. */ readonly gpuDriver: pulumi.Output; /** * Specifies the GPU MIG instance profile for supported GPU VM SKU. The allowed values are `MIG1g`, `MIG2g`, `MIG3g`, `MIG4g` and `MIG7g`. Changing this forces a new resource to be created. */ readonly gpuInstance: pulumi.Output; /** * Should the nodes in this Node Pool have host encryption enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** Additional fields must be configured depending on the value of this field - see below. */ readonly hostEncryptionEnabled: pulumi.Output; /** * The fully qualified resource ID of the Dedicated Host Group to provision virtual machines from. Changing this forces a new resource to be created. */ readonly hostGroupId: pulumi.Output; /** * A `kubeletConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ readonly kubeletConfig: pulumi.Output; /** * The type of disk used by kubelet. Possible values are `OS` and `Temporary`. Changing this property requires specifying `temporaryNameForRotation`. */ readonly kubeletDiskType: pulumi.Output; /** * The ID of the Kubernetes Cluster where this Node Pool should exist. Changing this forces a new resource to be created. * * > **NOTE:** The type of Default Node Pool for the Kubernetes Cluster must be `VirtualMachineScaleSets` to attach multiple node pools. */ readonly kubernetesClusterId: pulumi.Output; /** * A `linuxOsConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ readonly linuxOsConfig: pulumi.Output; readonly maxCount: pulumi.Output; /** * The maximum number of pods that can run on each agent. Changing this property requires specifying `temporaryNameForRotation`. */ readonly maxPods: pulumi.Output; readonly minCount: pulumi.Output; /** * Should this Node Pool be used for System or User resources? Possible values are `System` and `User`. Defaults to `User`. */ readonly mode: pulumi.Output; /** * The name of the Node Pool which should be created within the Kubernetes Cluster. Changing this forces a new resource to be created. * * > **NOTE:** A Windows Node Pool cannot have a `name` longer than 6 characters. */ readonly name: pulumi.Output; readonly nodeCount: pulumi.Output; /** * The current node image version running on this Node Pool. */ readonly nodeImageVersion: pulumi.Output; /** * A map of Kubernetes labels which should be applied to nodes in this Node Pool. */ readonly nodeLabels: pulumi.Output<{ [key: string]: string; }>; /** * A `nodeNetworkProfile` block as documented below. */ readonly nodeNetworkProfile: pulumi.Output; /** * Should each node have a Public IP Address? Changing this property requires specifying `temporaryNameForRotation`. */ readonly nodePublicIpEnabled: pulumi.Output; /** * Resource ID for the Public IP Addresses Prefix for the nodes in this Node Pool. `nodePublicIpEnabled` should be `true`. Changing this forces a new resource to be created. */ readonly nodePublicIpPrefixId: pulumi.Output; /** * A list of Kubernetes taints which should be applied to nodes in the agent pool (e.g `key=value:NoSchedule`). */ readonly nodeTaints: pulumi.Output; /** * Version of Kubernetes used for the Agents. If not specified, the latest recommended version will be used at provisioning time (but won't auto-upgrade). AKS does not require an exact patch version to be specified, minor version aliases such as `1.22` are also supported. - The minor version's latest GA patch is automatically chosen in that case. More details can be found in [the documentation](https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#alias-minor-version). * * > **Note:** This version must be supported by the Kubernetes Cluster - as such the version of Kubernetes used on the Cluster/Control Plane may need to be upgraded first. */ readonly orchestratorVersion: pulumi.Output; /** * The Agent Operating System disk size in GB. Changing this property requires specifying `temporaryNameForRotation`. */ readonly osDiskSizeGb: pulumi.Output; /** * The type of disk which should be used for the Operating System. Possible values are `Ephemeral` and `Managed`. Defaults to `Managed`. Changing this property requires specifying `temporaryNameForRotation`. */ readonly osDiskType: pulumi.Output; /** * Specifies the OS SKU used by the agent pool. Possible values are `AzureLinux`, `AzureLinux3`, `Ubuntu`, `Ubuntu2204`, `Ubuntu2404`, `Windows2019` and `Windows2022`. If not specified, the default is `Ubuntu` when os_type=Linux or `Windows2019` if os_type=Windows (`Windows2022` Kubernetes ≥1.33). Changing between `AzureLinux` and `Ubuntu` does not replace the resource; any other change forces a new resource to be created. * * > **Note:** `Windows2019` is deprecated and not supported for Kubernetes version ≥1.33. */ readonly osSku: pulumi.Output; /** * The Operating System which should be used for this Node Pool. Changing this forces a new resource to be created. Possible values are `Linux` and `Windows`. Defaults to `Linux`. */ readonly osType: pulumi.Output; /** * The ID of the Subnet where the pods in the Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. */ readonly podSubnetId: pulumi.Output; /** * The Priority for Virtual Machines within the Virtual Machine Scale Set that powers this Node Pool. Possible values are `Regular` and `Spot`. Defaults to `Regular`. Changing this forces a new resource to be created. */ readonly priority: pulumi.Output; /** * The ID of the Proximity Placement Group where the Virtual Machine Scale Set that powers this Node Pool will be placed. Changing this forces a new resource to be created. * * > **Note:** When setting `priority` to Spot - you must configure an `evictionPolicy`, `spotMaxPrice` and add the applicable `nodeLabels` and `nodeTaints` [as per the Azure Documentation](https://docs.microsoft.com/azure/aks/spot-node-pool). */ readonly proximityPlacementGroupId: pulumi.Output; /** * Specifies how the node pool should deal with scaled-down nodes. Allowed values are `Delete` and `Deallocate`. Defaults to `Delete`. */ readonly scaleDownMode: pulumi.Output; /** * The ID of the Snapshot which should be used to create this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ readonly snapshotId: pulumi.Output; /** * The maximum price you're willing to pay in USD per Virtual Machine. Valid values are `-1` (the current on-demand price for a Virtual Machine) or a positive value with up to five decimal places. Changing this forces a new resource to be created. * * > **Note:** This field can only be configured when `priority` is set to `Spot`. */ readonly spotMaxPrice: pulumi.Output; /** * A mapping of tags to assign to the resource. * * > At this time there's a bug in the AKS API where Tags for a Node Pool are not stored in the correct case - you may wish to use [`ignoreChanges`](https://www.pulumi.com/docs/intro/concepts/programming-model/#ignorechanges) functionality to ignore changes to the casing until this is fixed in the AKS API. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Specifies the name of the temporary node pool used to cycle the node pool when one of the relevant properties are updated. */ readonly temporaryNameForRotation: pulumi.Output; /** * Used to specify whether the UltraSSD is enabled in the Node Pool. Defaults to `false`. See [the documentation](https://docs.microsoft.com/azure/aks/use-ultra-disks) for more information. Changing this property requires specifying `temporaryNameForRotation`. */ readonly ultraSsdEnabled: pulumi.Output; /** * A `upgradeSettings` block as documented below. */ readonly upgradeSettings: pulumi.Output; /** * The SKU which should be used for the Virtual Machines used in this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ readonly vmSize: pulumi.Output; /** * The ID of the Subnet where this Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** A route table must be configured on this Subnet. */ readonly vnetSubnetId: pulumi.Output; /** * A `windowsProfile` block as documented below. Changing this forces a new resource to be created. */ readonly windowsProfile: pulumi.Output; /** * Used to specify the workload runtime. Allowed values are `OCIContainer` and `WasmWasi`. * * > **Note:** WebAssembly System Interface node pools are in Public Preview - more information and details on how to opt into the preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-wasi-node-pools) */ readonly workloadRuntime: pulumi.Output; /** * Specifies a list of Availability Zones in which this Kubernetes Cluster Node Pool should be located. Changing this property requires specifying `temporaryNameForRotation`. */ readonly zones: pulumi.Output; /** * Create a KubernetesClusterNodePool resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: KubernetesClusterNodePoolArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering KubernetesClusterNodePool resources. */ export interface KubernetesClusterNodePoolState { /** * Whether to enable [auto-scaler](https://docs.microsoft.com/azure/aks/cluster-autoscaler). */ autoScalingEnabled?: pulumi.Input; /** * Specifies the ID of the Capacity Reservation Group where this Node Pool should exist. Changing this forces a new resource to be created. */ capacityReservationGroupId?: pulumi.Input; /** * The Eviction Policy which should be used for Virtual Machines within the Virtual Machine Scale Set powering this Node Pool. Possible values are `Deallocate` and `Delete`. Changing this forces a new resource to be created. * * > **Note:** An Eviction Policy can only be configured when `priority` is set to `Spot` and will default to `Delete` unless otherwise specified. */ evictionPolicy?: pulumi.Input; /** * Should the nodes in this Node Pool have Federal Information Processing Standard enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **Note:** FIPS support is in Public Preview - more information and details on how to opt into the Preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-multiple-node-pools#add-a-fips-enabled-node-pool-preview). */ fipsEnabled?: pulumi.Input; /** * Specifies whether to install the GPU Driver for the nodes. Possible values are `Install` and `None`. Changing this forces a new resource to be created. */ gpuDriver?: pulumi.Input; /** * Specifies the GPU MIG instance profile for supported GPU VM SKU. The allowed values are `MIG1g`, `MIG2g`, `MIG3g`, `MIG4g` and `MIG7g`. Changing this forces a new resource to be created. */ gpuInstance?: pulumi.Input; /** * Should the nodes in this Node Pool have host encryption enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** Additional fields must be configured depending on the value of this field - see below. */ hostEncryptionEnabled?: pulumi.Input; /** * The fully qualified resource ID of the Dedicated Host Group to provision virtual machines from. Changing this forces a new resource to be created. */ hostGroupId?: pulumi.Input; /** * A `kubeletConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ kubeletConfig?: pulumi.Input; /** * The type of disk used by kubelet. Possible values are `OS` and `Temporary`. Changing this property requires specifying `temporaryNameForRotation`. */ kubeletDiskType?: pulumi.Input; /** * The ID of the Kubernetes Cluster where this Node Pool should exist. Changing this forces a new resource to be created. * * > **NOTE:** The type of Default Node Pool for the Kubernetes Cluster must be `VirtualMachineScaleSets` to attach multiple node pools. */ kubernetesClusterId?: pulumi.Input; /** * A `linuxOsConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ linuxOsConfig?: pulumi.Input; maxCount?: pulumi.Input; /** * The maximum number of pods that can run on each agent. Changing this property requires specifying `temporaryNameForRotation`. */ maxPods?: pulumi.Input; minCount?: pulumi.Input; /** * Should this Node Pool be used for System or User resources? Possible values are `System` and `User`. Defaults to `User`. */ mode?: pulumi.Input; /** * The name of the Node Pool which should be created within the Kubernetes Cluster. Changing this forces a new resource to be created. * * > **NOTE:** A Windows Node Pool cannot have a `name` longer than 6 characters. */ name?: pulumi.Input; nodeCount?: pulumi.Input; /** * The current node image version running on this Node Pool. */ nodeImageVersion?: pulumi.Input; /** * A map of Kubernetes labels which should be applied to nodes in this Node Pool. */ nodeLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * A `nodeNetworkProfile` block as documented below. */ nodeNetworkProfile?: pulumi.Input; /** * Should each node have a Public IP Address? Changing this property requires specifying `temporaryNameForRotation`. */ nodePublicIpEnabled?: pulumi.Input; /** * Resource ID for the Public IP Addresses Prefix for the nodes in this Node Pool. `nodePublicIpEnabled` should be `true`. Changing this forces a new resource to be created. */ nodePublicIpPrefixId?: pulumi.Input; /** * A list of Kubernetes taints which should be applied to nodes in the agent pool (e.g `key=value:NoSchedule`). */ nodeTaints?: pulumi.Input[]>; /** * Version of Kubernetes used for the Agents. If not specified, the latest recommended version will be used at provisioning time (but won't auto-upgrade). AKS does not require an exact patch version to be specified, minor version aliases such as `1.22` are also supported. - The minor version's latest GA patch is automatically chosen in that case. More details can be found in [the documentation](https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#alias-minor-version). * * > **Note:** This version must be supported by the Kubernetes Cluster - as such the version of Kubernetes used on the Cluster/Control Plane may need to be upgraded first. */ orchestratorVersion?: pulumi.Input; /** * The Agent Operating System disk size in GB. Changing this property requires specifying `temporaryNameForRotation`. */ osDiskSizeGb?: pulumi.Input; /** * The type of disk which should be used for the Operating System. Possible values are `Ephemeral` and `Managed`. Defaults to `Managed`. Changing this property requires specifying `temporaryNameForRotation`. */ osDiskType?: pulumi.Input; /** * Specifies the OS SKU used by the agent pool. Possible values are `AzureLinux`, `AzureLinux3`, `Ubuntu`, `Ubuntu2204`, `Ubuntu2404`, `Windows2019` and `Windows2022`. If not specified, the default is `Ubuntu` when os_type=Linux or `Windows2019` if os_type=Windows (`Windows2022` Kubernetes ≥1.33). Changing between `AzureLinux` and `Ubuntu` does not replace the resource; any other change forces a new resource to be created. * * > **Note:** `Windows2019` is deprecated and not supported for Kubernetes version ≥1.33. */ osSku?: pulumi.Input; /** * The Operating System which should be used for this Node Pool. Changing this forces a new resource to be created. Possible values are `Linux` and `Windows`. Defaults to `Linux`. */ osType?: pulumi.Input; /** * The ID of the Subnet where the pods in the Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. */ podSubnetId?: pulumi.Input; /** * The Priority for Virtual Machines within the Virtual Machine Scale Set that powers this Node Pool. Possible values are `Regular` and `Spot`. Defaults to `Regular`. Changing this forces a new resource to be created. */ priority?: pulumi.Input; /** * The ID of the Proximity Placement Group where the Virtual Machine Scale Set that powers this Node Pool will be placed. Changing this forces a new resource to be created. * * > **Note:** When setting `priority` to Spot - you must configure an `evictionPolicy`, `spotMaxPrice` and add the applicable `nodeLabels` and `nodeTaints` [as per the Azure Documentation](https://docs.microsoft.com/azure/aks/spot-node-pool). */ proximityPlacementGroupId?: pulumi.Input; /** * Specifies how the node pool should deal with scaled-down nodes. Allowed values are `Delete` and `Deallocate`. Defaults to `Delete`. */ scaleDownMode?: pulumi.Input; /** * The ID of the Snapshot which should be used to create this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ snapshotId?: pulumi.Input; /** * The maximum price you're willing to pay in USD per Virtual Machine. Valid values are `-1` (the current on-demand price for a Virtual Machine) or a positive value with up to five decimal places. Changing this forces a new resource to be created. * * > **Note:** This field can only be configured when `priority` is set to `Spot`. */ spotMaxPrice?: pulumi.Input; /** * A mapping of tags to assign to the resource. * * > At this time there's a bug in the AKS API where Tags for a Node Pool are not stored in the correct case - you may wish to use [`ignoreChanges`](https://www.pulumi.com/docs/intro/concepts/programming-model/#ignorechanges) functionality to ignore changes to the casing until this is fixed in the AKS API. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Specifies the name of the temporary node pool used to cycle the node pool when one of the relevant properties are updated. */ temporaryNameForRotation?: pulumi.Input; /** * Used to specify whether the UltraSSD is enabled in the Node Pool. Defaults to `false`. See [the documentation](https://docs.microsoft.com/azure/aks/use-ultra-disks) for more information. Changing this property requires specifying `temporaryNameForRotation`. */ ultraSsdEnabled?: pulumi.Input; /** * A `upgradeSettings` block as documented below. */ upgradeSettings?: pulumi.Input; /** * The SKU which should be used for the Virtual Machines used in this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ vmSize?: pulumi.Input; /** * The ID of the Subnet where this Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** A route table must be configured on this Subnet. */ vnetSubnetId?: pulumi.Input; /** * A `windowsProfile` block as documented below. Changing this forces a new resource to be created. */ windowsProfile?: pulumi.Input; /** * Used to specify the workload runtime. Allowed values are `OCIContainer` and `WasmWasi`. * * > **Note:** WebAssembly System Interface node pools are in Public Preview - more information and details on how to opt into the preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-wasi-node-pools) */ workloadRuntime?: pulumi.Input; /** * Specifies a list of Availability Zones in which this Kubernetes Cluster Node Pool should be located. Changing this property requires specifying `temporaryNameForRotation`. */ zones?: pulumi.Input[]>; } /** * The set of arguments for constructing a KubernetesClusterNodePool resource. */ export interface KubernetesClusterNodePoolArgs { /** * Whether to enable [auto-scaler](https://docs.microsoft.com/azure/aks/cluster-autoscaler). */ autoScalingEnabled?: pulumi.Input; /** * Specifies the ID of the Capacity Reservation Group where this Node Pool should exist. Changing this forces a new resource to be created. */ capacityReservationGroupId?: pulumi.Input; /** * The Eviction Policy which should be used for Virtual Machines within the Virtual Machine Scale Set powering this Node Pool. Possible values are `Deallocate` and `Delete`. Changing this forces a new resource to be created. * * > **Note:** An Eviction Policy can only be configured when `priority` is set to `Spot` and will default to `Delete` unless otherwise specified. */ evictionPolicy?: pulumi.Input; /** * Should the nodes in this Node Pool have Federal Information Processing Standard enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **Note:** FIPS support is in Public Preview - more information and details on how to opt into the Preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-multiple-node-pools#add-a-fips-enabled-node-pool-preview). */ fipsEnabled?: pulumi.Input; /** * Specifies whether to install the GPU Driver for the nodes. Possible values are `Install` and `None`. Changing this forces a new resource to be created. */ gpuDriver?: pulumi.Input; /** * Specifies the GPU MIG instance profile for supported GPU VM SKU. The allowed values are `MIG1g`, `MIG2g`, `MIG3g`, `MIG4g` and `MIG7g`. Changing this forces a new resource to be created. */ gpuInstance?: pulumi.Input; /** * Should the nodes in this Node Pool have host encryption enabled? Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** Additional fields must be configured depending on the value of this field - see below. */ hostEncryptionEnabled?: pulumi.Input; /** * The fully qualified resource ID of the Dedicated Host Group to provision virtual machines from. Changing this forces a new resource to be created. */ hostGroupId?: pulumi.Input; /** * A `kubeletConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ kubeletConfig?: pulumi.Input; /** * The type of disk used by kubelet. Possible values are `OS` and `Temporary`. Changing this property requires specifying `temporaryNameForRotation`. */ kubeletDiskType?: pulumi.Input; /** * The ID of the Kubernetes Cluster where this Node Pool should exist. Changing this forces a new resource to be created. * * > **NOTE:** The type of Default Node Pool for the Kubernetes Cluster must be `VirtualMachineScaleSets` to attach multiple node pools. */ kubernetesClusterId: pulumi.Input; /** * A `linuxOsConfig` block as defined below. Changing this requires specifying `temporaryNameForRotation`. */ linuxOsConfig?: pulumi.Input; maxCount?: pulumi.Input; /** * The maximum number of pods that can run on each agent. Changing this property requires specifying `temporaryNameForRotation`. */ maxPods?: pulumi.Input; minCount?: pulumi.Input; /** * Should this Node Pool be used for System or User resources? Possible values are `System` and `User`. Defaults to `User`. */ mode?: pulumi.Input; /** * The name of the Node Pool which should be created within the Kubernetes Cluster. Changing this forces a new resource to be created. * * > **NOTE:** A Windows Node Pool cannot have a `name` longer than 6 characters. */ name?: pulumi.Input; nodeCount?: pulumi.Input; /** * A map of Kubernetes labels which should be applied to nodes in this Node Pool. */ nodeLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * A `nodeNetworkProfile` block as documented below. */ nodeNetworkProfile?: pulumi.Input; /** * Should each node have a Public IP Address? Changing this property requires specifying `temporaryNameForRotation`. */ nodePublicIpEnabled?: pulumi.Input; /** * Resource ID for the Public IP Addresses Prefix for the nodes in this Node Pool. `nodePublicIpEnabled` should be `true`. Changing this forces a new resource to be created. */ nodePublicIpPrefixId?: pulumi.Input; /** * A list of Kubernetes taints which should be applied to nodes in the agent pool (e.g `key=value:NoSchedule`). */ nodeTaints?: pulumi.Input[]>; /** * Version of Kubernetes used for the Agents. If not specified, the latest recommended version will be used at provisioning time (but won't auto-upgrade). AKS does not require an exact patch version to be specified, minor version aliases such as `1.22` are also supported. - The minor version's latest GA patch is automatically chosen in that case. More details can be found in [the documentation](https://docs.microsoft.com/en-us/azure/aks/supported-kubernetes-versions?tabs=azure-cli#alias-minor-version). * * > **Note:** This version must be supported by the Kubernetes Cluster - as such the version of Kubernetes used on the Cluster/Control Plane may need to be upgraded first. */ orchestratorVersion?: pulumi.Input; /** * The Agent Operating System disk size in GB. Changing this property requires specifying `temporaryNameForRotation`. */ osDiskSizeGb?: pulumi.Input; /** * The type of disk which should be used for the Operating System. Possible values are `Ephemeral` and `Managed`. Defaults to `Managed`. Changing this property requires specifying `temporaryNameForRotation`. */ osDiskType?: pulumi.Input; /** * Specifies the OS SKU used by the agent pool. Possible values are `AzureLinux`, `AzureLinux3`, `Ubuntu`, `Ubuntu2204`, `Ubuntu2404`, `Windows2019` and `Windows2022`. If not specified, the default is `Ubuntu` when os_type=Linux or `Windows2019` if os_type=Windows (`Windows2022` Kubernetes ≥1.33). Changing between `AzureLinux` and `Ubuntu` does not replace the resource; any other change forces a new resource to be created. * * > **Note:** `Windows2019` is deprecated and not supported for Kubernetes version ≥1.33. */ osSku?: pulumi.Input; /** * The Operating System which should be used for this Node Pool. Changing this forces a new resource to be created. Possible values are `Linux` and `Windows`. Defaults to `Linux`. */ osType?: pulumi.Input; /** * The ID of the Subnet where the pods in the Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. */ podSubnetId?: pulumi.Input; /** * The Priority for Virtual Machines within the Virtual Machine Scale Set that powers this Node Pool. Possible values are `Regular` and `Spot`. Defaults to `Regular`. Changing this forces a new resource to be created. */ priority?: pulumi.Input; /** * The ID of the Proximity Placement Group where the Virtual Machine Scale Set that powers this Node Pool will be placed. Changing this forces a new resource to be created. * * > **Note:** When setting `priority` to Spot - you must configure an `evictionPolicy`, `spotMaxPrice` and add the applicable `nodeLabels` and `nodeTaints` [as per the Azure Documentation](https://docs.microsoft.com/azure/aks/spot-node-pool). */ proximityPlacementGroupId?: pulumi.Input; /** * Specifies how the node pool should deal with scaled-down nodes. Allowed values are `Delete` and `Deallocate`. Defaults to `Delete`. */ scaleDownMode?: pulumi.Input; /** * The ID of the Snapshot which should be used to create this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ snapshotId?: pulumi.Input; /** * The maximum price you're willing to pay in USD per Virtual Machine. Valid values are `-1` (the current on-demand price for a Virtual Machine) or a positive value with up to five decimal places. Changing this forces a new resource to be created. * * > **Note:** This field can only be configured when `priority` is set to `Spot`. */ spotMaxPrice?: pulumi.Input; /** * A mapping of tags to assign to the resource. * * > At this time there's a bug in the AKS API where Tags for a Node Pool are not stored in the correct case - you may wish to use [`ignoreChanges`](https://www.pulumi.com/docs/intro/concepts/programming-model/#ignorechanges) functionality to ignore changes to the casing until this is fixed in the AKS API. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Specifies the name of the temporary node pool used to cycle the node pool when one of the relevant properties are updated. */ temporaryNameForRotation?: pulumi.Input; /** * Used to specify whether the UltraSSD is enabled in the Node Pool. Defaults to `false`. See [the documentation](https://docs.microsoft.com/azure/aks/use-ultra-disks) for more information. Changing this property requires specifying `temporaryNameForRotation`. */ ultraSsdEnabled?: pulumi.Input; /** * A `upgradeSettings` block as documented below. */ upgradeSettings?: pulumi.Input; /** * The SKU which should be used for the Virtual Machines used in this Node Pool. Changing this property requires specifying `temporaryNameForRotation`. */ vmSize?: pulumi.Input; /** * The ID of the Subnet where this Node Pool should exist. Changing this property requires specifying `temporaryNameForRotation`. * * > **NOTE:** A route table must be configured on this Subnet. */ vnetSubnetId?: pulumi.Input; /** * A `windowsProfile` block as documented below. Changing this forces a new resource to be created. */ windowsProfile?: pulumi.Input; /** * Used to specify the workload runtime. Allowed values are `OCIContainer` and `WasmWasi`. * * > **Note:** WebAssembly System Interface node pools are in Public Preview - more information and details on how to opt into the preview can be found in [this article](https://docs.microsoft.com/azure/aks/use-wasi-node-pools) */ workloadRuntime?: pulumi.Input; /** * Specifies a list of Availability Zones in which this Kubernetes Cluster Node Pool should be located. Changing this property requires specifying `temporaryNameForRotation`. */ zones?: pulumi.Input[]>; }