Agent
data class AgentPoolArgs(val administratorConfiguration: Output<AdministratorConfigurationArgs>? = null, val agentOptions: Output<AgentOptionsArgs>? = null, val agentPoolName: Output<String>? = null, val attachedNetworkConfiguration: Output<AttachedNetworkConfigurationArgs>? = null, val availabilityZones: Output<List<String>>? = null, val count: Output<Double>? = null, val extendedLocation: Output<ExtendedLocationArgs>? = null, val kubernetesClusterName: Output<String>? = null, val labels: Output<List<KubernetesLabelArgs>>? = null, val location: Output<String>? = null, val mode: Output<Either<String, AgentPoolMode>>? = null, val resourceGroupName: Output<String>? = null, val tags: Output<Map<String, String>>? = null, val taints: Output<List<KubernetesLabelArgs>>? = null, val upgradeSettings: Output<AgentPoolUpgradeSettingsArgs>? = null, val vmSkuName: Output<String>? = null) : ConvertibleToJava<AgentPoolArgs>
Azure REST API version: 2023-05-01-preview. Other available API versions: 2023-07-01.
Example Usage
Create or update Kubernetes cluster agent pool
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var agentPool = new AzureNative.NetworkCloud.AgentPool("agentPool", new()
{
AdministratorConfiguration = new AzureNative.NetworkCloud.Inputs.AdministratorConfigurationArgs
{
AdminUsername = "azure",
SshPublicKeys = new[]
{
new AzureNative.NetworkCloud.Inputs.SshPublicKeyArgs
{
KeyData = "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm",
},
},
},
AgentOptions = new AzureNative.NetworkCloud.Inputs.AgentOptionsArgs
{
HugepagesCount = 96,
HugepagesSize = "1G",
},
AgentPoolName = "agentPoolName",
AttachedNetworkConfiguration = new AzureNative.NetworkCloud.Inputs.AttachedNetworkConfigurationArgs
{
L2Networks = new[]
{
new AzureNative.NetworkCloud.Inputs.L2NetworkAttachmentConfigurationArgs
{
NetworkId = "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName",
PluginType = "DPDK",
},
},
L3Networks = new[]
{
new AzureNative.NetworkCloud.Inputs.L3NetworkAttachmentConfigurationArgs
{
IpamEnabled = "False",
NetworkId = "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName",
PluginType = "SRIOV",
},
},
TrunkedNetworks = new[]
{
new AzureNative.NetworkCloud.Inputs.TrunkedNetworkAttachmentConfigurationArgs
{
NetworkId = "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName",
PluginType = "MACVLAN",
},
},
},
AvailabilityZones = new[]
{
"1",
"2",
"3",
},
Count = 3,
ExtendedLocation = new AzureNative.NetworkCloud.Inputs.ExtendedLocationArgs
{
Name = "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
Type = "CustomLocation",
},
KubernetesClusterName = "kubernetesClusterName",
Labels = new[]
{
new AzureNative.NetworkCloud.Inputs.KubernetesLabelArgs
{
Key = "kubernetes.label",
Value = "true",
},
},
Location = "location",
Mode = "System",
ResourceGroupName = "resourceGroupName",
Tags =
{
{ "key1", "myvalue1" },
{ "key2", "myvalue2" },
},
Taints = new[]
{
new AzureNative.NetworkCloud.Inputs.KubernetesLabelArgs
{
Key = "kubernetes.taint",
Value = "true",
},
},
UpgradeSettings = new AzureNative.NetworkCloud.Inputs.AgentPoolUpgradeSettingsArgs
{
MaxSurge = "1",
},
VmSkuName = "NC_M16_v1",
});
});Content copied to clipboard
package main
import (
"github.com/pulumi/pulumi-azure-native-sdk/networkcloud/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := networkcloud.NewAgentPool(ctx, "agentPool", &networkcloud.AgentPoolArgs{
AdministratorConfiguration: networkcloud.AdministratorConfigurationResponse{
AdminUsername: pulumi.String("azure"),
SshPublicKeys: networkcloud.SshPublicKeyArray{
&networkcloud.SshPublicKeyArgs{
KeyData: pulumi.String("ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"),
},
},
},
AgentOptions: &networkcloud.AgentOptionsArgs{
HugepagesCount: pulumi.Float64(96),
HugepagesSize: pulumi.String("1G"),
},
AgentPoolName: pulumi.String("agentPoolName"),
AttachedNetworkConfiguration: networkcloud.AttachedNetworkConfigurationResponse{
L2Networks: networkcloud.L2NetworkAttachmentConfigurationArray{
&networkcloud.L2NetworkAttachmentConfigurationArgs{
NetworkId: pulumi.String("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName"),
PluginType: pulumi.String("DPDK"),
},
},
L3Networks: networkcloud.L3NetworkAttachmentConfigurationArray{
&networkcloud.L3NetworkAttachmentConfigurationArgs{
IpamEnabled: pulumi.String("False"),
NetworkId: pulumi.String("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName"),
PluginType: pulumi.String("SRIOV"),
},
},
TrunkedNetworks: networkcloud.TrunkedNetworkAttachmentConfigurationArray{
&networkcloud.TrunkedNetworkAttachmentConfigurationArgs{
NetworkId: pulumi.String("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName"),
PluginType: pulumi.String("MACVLAN"),
},
},
},
AvailabilityZones: pulumi.StringArray{
pulumi.String("1"),
pulumi.String("2"),
pulumi.String("3"),
},
Count: pulumi.Float64(3),
ExtendedLocation: &networkcloud.ExtendedLocationArgs{
Name: pulumi.String("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
Type: pulumi.String("CustomLocation"),
},
KubernetesClusterName: pulumi.String("kubernetesClusterName"),
Labels: []networkcloud.KubernetesLabelArgs{
{
Key: pulumi.String("kubernetes.label"),
Value: pulumi.String("true"),
},
},
Location: pulumi.String("location"),
Mode: pulumi.String("System"),
ResourceGroupName: pulumi.String("resourceGroupName"),
Tags: pulumi.StringMap{
"key1": pulumi.String("myvalue1"),
"key2": pulumi.String("myvalue2"),
},
Taints: []networkcloud.KubernetesLabelArgs{
{
Key: pulumi.String("kubernetes.taint"),
Value: pulumi.String("true"),
},
},
UpgradeSettings: &networkcloud.AgentPoolUpgradeSettingsArgs{
MaxSurge: pulumi.String("1"),
},
VmSkuName: pulumi.String("NC_M16_v1"),
})
if err != nil {
return err
}
return nil
})
}Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.networkcloud.AgentPool;
import com.pulumi.azurenative.networkcloud.AgentPoolArgs;
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 agentPool = new AgentPool("agentPool", AgentPoolArgs.builder()
.administratorConfiguration(Map.ofEntries(
Map.entry("adminUsername", "azure"),
Map.entry("sshPublicKeys", Map.of("keyData", "ssh-rsa AAtsE3njSONzDYRIZv/WLjVuMfrUSByHp+jfaaOLHTIIB4fJvo6dQUZxE20w2iDHV3tEkmnTo84eba97VMueQD6OzJPEyWZMRpz8UYWOd0IXeRqiFu1lawNblZhwNT/ojNZfpB3af/YDzwQCZgTcTRyNNhL4o/blKUmug0daSsSXISTRnIDpcf5qytjs1Xo+yYyJMvzLL59mhAyb3p/cD+Y3/s3WhAx+l0XOKpzXnblrv9d3q4c2tWmm/SyFqthaqd0= admin@vm"))
))
.agentOptions(Map.ofEntries(
Map.entry("hugepagesCount", 96),
Map.entry("hugepagesSize", "1G")
))
.agentPoolName("agentPoolName")
.attachedNetworkConfiguration(Map.ofEntries(
Map.entry("l2Networks", Map.ofEntries(
Map.entry("networkId", "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName"),
Map.entry("pluginType", "DPDK")
)),
Map.entry("l3Networks", Map.ofEntries(
Map.entry("ipamEnabled", "False"),
Map.entry("networkId", "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName"),
Map.entry("pluginType", "SRIOV")
)),
Map.entry("trunkedNetworks", Map.ofEntries(
Map.entry("networkId", "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName"),
Map.entry("pluginType", "MACVLAN")
))
))
.availabilityZones(
"1",
"2",
"3")
.count(3)
.extendedLocation(Map.ofEntries(
Map.entry("name", "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
Map.entry("type", "CustomLocation")
))
.kubernetesClusterName("kubernetesClusterName")
.labels(Map.ofEntries(
Map.entry("key", "kubernetes.label"),
Map.entry("value", "true")
))
.location("location")
.mode("System")
.resourceGroupName("resourceGroupName")
.tags(Map.ofEntries(
Map.entry("key1", "myvalue1"),
Map.entry("key2", "myvalue2")
))
.taints(Map.ofEntries(
Map.entry("key", "kubernetes.taint"),
Map.entry("value", "true")
))
.upgradeSettings(Map.of("maxSurge", "1"))
.vmSkuName("NC_M16_v1")
.build());
}
}Content copied to clipboard
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:networkcloud:AgentPool default /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/kubernetesClusters/{kubernetesClusterName}/agentPools/{agentPoolName}Content copied to clipboard
Constructors
Link copied to clipboard
fun AgentPoolArgs(administratorConfiguration: Output<AdministratorConfigurationArgs>? = null, agentOptions: Output<AgentOptionsArgs>? = null, agentPoolName: Output<String>? = null, attachedNetworkConfiguration: Output<AttachedNetworkConfigurationArgs>? = null, availabilityZones: Output<List<String>>? = null, count: Output<Double>? = null, extendedLocation: Output<ExtendedLocationArgs>? = null, kubernetesClusterName: Output<String>? = null, labels: Output<List<KubernetesLabelArgs>>? = null, location: Output<String>? = null, mode: Output<Either<String, AgentPoolMode>>? = null, resourceGroupName: Output<String>? = null, tags: Output<Map<String, String>>? = null, taints: Output<List<KubernetesLabelArgs>>? = null, upgradeSettings: Output<AgentPoolUpgradeSettingsArgs>? = null, vmSkuName: Output<String>? = null)
Functions
Properties
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
The selection of how this agent pool is utilized, either as a system pool or a user pool. System pools run the features and critical services for the Kubernetes Cluster, while user pools are dedicated to user workloads. Every Kubernetes cluster must contain at least one system node pool with at least one node.