Partager via


Microsoft.ContainerService managedClusters/agentPools 2021-03-01

Définition de ressource Bicep

Le type de ressource managedClusters/agentPools peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/managedClusters/agentPools, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.ContainerService/managedClusters/agentPools@2021-03-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    availabilityZones: [
      'string'
    ]
    count: int
    enableAutoScaling: bool
    enableEncryptionAtHost: bool
    enableFIPS: bool
    enableNodePublicIP: bool
    gpuInstanceProfile: 'string'
    kubeletConfig: {
      allowedUnsafeSysctls: [
        'string'
      ]
      containerLogMaxFiles: int
      containerLogMaxSizeMB: int
      cpuCfsQuota: bool
      cpuCfsQuotaPeriod: 'string'
      cpuManagerPolicy: 'string'
      failSwapOn: bool
      imageGcHighThreshold: int
      imageGcLowThreshold: int
      podMaxPids: int
      topologyManagerPolicy: 'string'
    }
    kubeletDiskType: 'string'
    linuxOSConfig: {
      swapFileSizeMB: int
      sysctls: {
        fsAioMaxNr: int
        fsFileMax: int
        fsInotifyMaxUserWatches: int
        fsNrOpen: int
        kernelThreadsMax: int
        netCoreNetdevMaxBacklog: int
        netCoreOptmemMax: int
        netCoreRmemDefault: int
        netCoreRmemMax: int
        netCoreSomaxconn: int
        netCoreWmemDefault: int
        netCoreWmemMax: int
        netIpv4IpLocalPortRange: 'string'
        netIpv4NeighDefaultGcThresh1: int
        netIpv4NeighDefaultGcThresh2: int
        netIpv4NeighDefaultGcThresh3: int
        netIpv4TcpFinTimeout: int
        netIpv4TcpkeepaliveIntvl: int
        netIpv4TcpKeepaliveProbes: int
        netIpv4TcpKeepaliveTime: int
        netIpv4TcpMaxSynBacklog: int
        netIpv4TcpMaxTwBuckets: int
        netIpv4TcpTwReuse: bool
        netNetfilterNfConntrackBuckets: int
        netNetfilterNfConntrackMax: int
        vmMaxMapCount: int
        vmSwappiness: int
        vmVfsCachePressure: int
      }
      transparentHugePageDefrag: 'string'
      transparentHugePageEnabled: 'string'
    }
    maxCount: int
    maxPods: int
    minCount: int
    mode: 'string'
    nodeLabels: {
      {customized property}: 'string'
    }
    nodePublicIPPrefixID: 'string'
    nodeTaints: [
      'string'
    ]
    orchestratorVersion: 'string'
    osDiskSizeGB: int
    osDiskType: 'string'
    osSKU: 'string'
    osType: 'string'
    podSubnetID: 'string'
    proximityPlacementGroupID: 'string'
    scaleSetEvictionPolicy: 'string'
    scaleSetPriority: 'string'
    spotMaxPrice: int
    tags: {}
    type: 'string'
    upgradeSettings: {
      maxSurge: 'string'
    }
    vmSize: 'string'
    vnetSubnetID: 'string'
  }
}

Valeurs de propriété

managedClusters/agentPools

Nom Description Valeur
nom Nom de la ressource

Découvrez comment définir des noms et des types pour les ressources enfants dans Bicep.
chaîne (obligatoire)

Limite de caractères : 1 à 12 pour Linux
1-6 pour Windows

Caractères valides :
Lettres minuscules et chiffres.

Impossible de commencer par un nombre.
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : managedClusters
Propriétés Propriétés d’un pool d’agents. ManagedClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfileProperties

Nom Description Valeur
availabilityZones Zones de disponibilité pour les nœuds. Doit utiliser VirtualMachineScaleSets AgentPoolType. string[]
compter Nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 100 (inclus) pour les pools d’utilisateurs et dans la plage comprise entre 1 et 100 (inclus) pour les pools système. La valeur par défaut est 1. Int
enableAutoScaling Indique s’il faut activer la mise à l’échelle automatique Bool
enableEncryptionAtHost Indique s’il faut activer EncryptionAtHost Bool
enableFIPS Indique s’il faut utiliser le système d’exploitation activé par FIPS Bool
enableNodePublicIP Activer l’adresse IP publique pour les nœuds Bool
gpuInstanceProfile GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge. Les valeurs prises en charge sont MIG1g, MIG2g, MIG3g, MIG4g et MIG7g. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
kubeletConfig KubeletConfig spécifie la configuration de kubelet sur les nœuds de l’agent. KubeletConfig
kubeletDiskType KubeletDiskType détermine le placement des volumes emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet. Autorise actuellement une valeur, le système d’exploitation, ce qui entraîne Kubelet à l’aide du disque du système d’exploitation pour les données. 'OS'
'Temporaire'
linuxOSConfig LinuxOSConfig spécifie la configuration du système d’exploitation des nœuds d’agent Linux. LinuxOSConfig
maxCount Nombre maximal de nœuds pour la mise à l’échelle automatique Int
maxPods Nombre maximal de pods qui peuvent s’exécuter sur un nœud. Int
minCount Nombre minimal de nœuds pour la mise à l’échelle automatique Int
mode AgentPoolMode représente le mode d’un pool d’agents 'System'
'User'
nodeLabels Étiquettes de nœud de pool d’agents à conserver sur tous les nœuds du pool d’agents. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID ID de préfixe IP public. Les nœuds de machine virtuelle utilisent des adresses IP affectées à partir de ce préfixe IP public. corde
nodeTaints Les teintes ajoutées aux nouveaux nœuds pendant la création et la mise à l’échelle du pool de nœuds. Par exemple, key=value :NoSchedule. string[]
orchestratorVersion Version d’orchestrateur spécifiée lors de la création du cluster managé. corde
osDiskSizeGB Taille du disque du système d’exploitation en Go à utiliser pour spécifier la taille du disque pour chaque ordinateur de ce pool maître/agent. Si vous spécifiez 0, elle applique la taille osDisk par défaut en fonction de vmSize spécifiée. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 2048
osDiskType Type de disque de système d’exploitation à utiliser pour les machines d’un pool d’agents donné. Les valeurs autorisées sont « Éphémères » et « Géré ». S’il n’est pas spécifié, la valeur par défaut est « Éphémère » lorsque la machine virtuelle prend en charge le système d’exploitation éphémère et a un disque de cache supérieur au système d’exploitation OSDiskSizeGB demandé. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. 'Éphémère'
'Managed'
osSKU OsSKU à utiliser pour spécifier la référence sKU du système d’exploitation. Choisissez ubuntu(par défaut) et CBLMarinr pour Linux OSType. Non applicable à Windows OSType. 'CBLMarinr'
'Ubuntu'
osType OsType à utiliser pour spécifier le type de système d’exploitation. Choisissez dans Linux et Windows. Valeur par défaut pour Linux. 'Linux'
'Windows'
podSubnetID Pod SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les pods. corde
proximityPlacementGroupID ID du groupe de placement de proximité. corde
scaleSetEvictionPolicy ScaleSetEvictionPolicy à utiliser pour spécifier la stratégie d’éviction pour le groupe de machines virtuelles identiques Spot. Valeur par défaut : Supprimer. 'Libérer'
'Supprimer'
scaleSetPriority ScaleSetPriority à utiliser pour spécifier la priorité du groupe de machines virtuelles identiques. Valeur par défaut normale. 'Normal'
'Spot'
spotMaxPrice SpotMaxPrice à utiliser pour spécifier le prix maximal que vous êtes prêt à payer en dollars US. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Int
étiquettes Balises de pool d’agents à conserver sur le groupe de machines virtuelles identiques du pool d’agents. objet
type AgentPoolType représente les types d’un pool d’agents 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings Paramètres de mise à niveau du pool d’agents AgentPoolUpgradeSettings
vmSize Taille des machines virtuelles de l’agent. corde
vnetSubnetID VNet SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les nœuds et peut-être les pods corde

KubeletConfig

Nom Description Valeur
allowedUnsafeSysctls Liste verte de sysctls non sécurisés ou de modèles sysctl non sécurisés (se terminant par *). string[]
containerLogMaxFiles Nombre maximal de fichiers journaux de conteneur pouvant être présents pour un conteneur. Le nombre doit être ≥ 2. Int

Contraintes:
Valeur minimale = 2
containerLogMaxSizeMB Taille maximale (par exemple, 10Mi) du fichier journal conteneur avant sa rotation. Int
cpuCfsQuota Activez l’application du quota CFS processeur pour les conteneurs qui spécifient des limites d’UC. Bool
cpuCfsQuotaPeriod Définit la valeur de la période de quota CFS du processeur. corde
cpuManagerPolicy Stratégie du Gestionnaire d’UC à utiliser. corde
failSwapOn Si la valeur est true, kubelet ne démarre pas si l’échange est activé sur le nœud. Bool
imageGcHighThreshold Pourcentage d’utilisation du disque après laquelle le garbage collection d’images est toujours exécuté. Int
imageGcLowThreshold Pourcentage d’utilisation du disque avant laquelle le garbage collection d’images n’est jamais exécuté. Int
podMaxPids Nombre maximal de processus par pod. Int
topologyManagerPolicy Stratégie du Gestionnaire de topologie à utiliser. corde

LinuxOSConfig

Nom Description Valeur
swapFileSizeMB SwapFileSizeMB spécifie la taille en Mo d’un fichier d’échange sur chaque nœud. Int
sysctls Paramètres Sysctl pour les nœuds d’agent Linux. SysctlConfig
transparentHugePageDefrag Configuration transparente de la défragmentation de page énorme. corde
transparentHugePageEnabled Configuration transparente d’une page énorme activée. corde

SysctlConfig

Nom Description Valeur
fsAioMaxNr Paramètre Sysctl fs.aio-max-nr. Int
fsFileMax Paramètre Sysctl fs.file-max. Int
fsInotifyMaxUserWatches Paramètre Sysctl fs.inotify.max_user_watch. Int
fsNrOpen Paramètre Sysctl fs.nr_open. Int
kernelThreadsMax Sysctl définissant kernel.threads-max. Int
netCoreNetdevMaxBacklog Paramètre Sysctl net.core.netdev_max_backlog. Int
netCoreOptmemMax Paramètre Sysctl net.core.optmem_max. Int
netCoreRmemDefault Paramètre Sysctl net.core.rmem_default. Int
netCoreRmemMax Paramètre Sysctl net.core.rmem_max. Int
netCoreSomaxconn Sysctl définissant net.core.somaxconn. Int
netCoreWmemDefault Paramètre Sysctl net.core.wmem_default. Int
netCoreWmemMax Paramètre Sysctl net.core.wmem_max. Int
netIpv4IpLocalPortRange Paramètre Sysctl net.ipv4.ip_local_port_range. corde
netIpv4NeighDefaultGcThresh1 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Paramètre Sysctl net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Paramètre Sysctl net.ipv4.tcp_keepalive_intvl. Int
netIpv4TcpKeepaliveProbes Paramètre Sysctl net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Paramètre Sysctl net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Paramètre Sysctl net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Paramètre Sysctl net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Paramètre Sysctl net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Paramètre Sysctl net.netfilter.nf_conntrack_buckets. Int
netNetfilterNfConntrackMax Paramètre Sysctl net.netfilter.nf_conntrack_max. Int
vmMaxMapCount Paramètre Sysctl vm.max_map_count. Int
vmSwappiness Sysctl définissant vm.swappiness. Int
vmVfsCachePressure Paramètre Sysctl vm.vfs_cache_pressure. Int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nom Description Valeur
{propriété personnalisée} corde

AgentPoolUpgradeSettings

Nom Description Valeur
maxSurge Nombre ou pourcentage de nœuds supplémentaires à ajouter pendant la mise à niveau. Si vide utilise AKS par défaut corde

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Déployer un cluster AKS pour Azure ML

Déployer sur Azure
Ce modèle vous permet de déployer un cluster AKS conforme à l’entreprise qui peut être attaché à Azure ML

Définition de ressource de modèle ARM

Le type de ressource managedClusters/agentPools peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/managedClusters/agentPools, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "apiVersion": "2021-03-01",
  "name": "string",
  "properties": {
    "availabilityZones": [ "string" ],
    "count": "int",
    "enableAutoScaling": "bool",
    "enableEncryptionAtHost": "bool",
    "enableFIPS": "bool",
    "enableNodePublicIP": "bool",
    "gpuInstanceProfile": "string",
    "kubeletConfig": {
      "allowedUnsafeSysctls": [ "string" ],
      "containerLogMaxFiles": "int",
      "containerLogMaxSizeMB": "int",
      "cpuCfsQuota": "bool",
      "cpuCfsQuotaPeriod": "string",
      "cpuManagerPolicy": "string",
      "failSwapOn": "bool",
      "imageGcHighThreshold": "int",
      "imageGcLowThreshold": "int",
      "podMaxPids": "int",
      "topologyManagerPolicy": "string"
    },
    "kubeletDiskType": "string",
    "linuxOSConfig": {
      "swapFileSizeMB": "int",
      "sysctls": {
        "fsAioMaxNr": "int",
        "fsFileMax": "int",
        "fsInotifyMaxUserWatches": "int",
        "fsNrOpen": "int",
        "kernelThreadsMax": "int",
        "netCoreNetdevMaxBacklog": "int",
        "netCoreOptmemMax": "int",
        "netCoreRmemDefault": "int",
        "netCoreRmemMax": "int",
        "netCoreSomaxconn": "int",
        "netCoreWmemDefault": "int",
        "netCoreWmemMax": "int",
        "netIpv4IpLocalPortRange": "string",
        "netIpv4NeighDefaultGcThresh1": "int",
        "netIpv4NeighDefaultGcThresh2": "int",
        "netIpv4NeighDefaultGcThresh3": "int",
        "netIpv4TcpFinTimeout": "int",
        "netIpv4TcpkeepaliveIntvl": "int",
        "netIpv4TcpKeepaliveProbes": "int",
        "netIpv4TcpKeepaliveTime": "int",
        "netIpv4TcpMaxSynBacklog": "int",
        "netIpv4TcpMaxTwBuckets": "int",
        "netIpv4TcpTwReuse": "bool",
        "netNetfilterNfConntrackBuckets": "int",
        "netNetfilterNfConntrackMax": "int",
        "vmMaxMapCount": "int",
        "vmSwappiness": "int",
        "vmVfsCachePressure": "int"
      },
      "transparentHugePageDefrag": "string",
      "transparentHugePageEnabled": "string"
    },
    "maxCount": "int",
    "maxPods": "int",
    "minCount": "int",
    "mode": "string",
    "nodeLabels": {
      "{customized property}": "string"
    },
    "nodePublicIPPrefixID": "string",
    "nodeTaints": [ "string" ],
    "orchestratorVersion": "string",
    "osDiskSizeGB": "int",
    "osDiskType": "string",
    "osSKU": "string",
    "osType": "string",
    "podSubnetID": "string",
    "proximityPlacementGroupID": "string",
    "scaleSetEvictionPolicy": "string",
    "scaleSetPriority": "string",
    "spotMaxPrice": "int",
    "tags": {},
    "type": "string",
    "upgradeSettings": {
      "maxSurge": "string"
    },
    "vmSize": "string",
    "vnetSubnetID": "string"
  }
}

Valeurs de propriété

managedClusters/agentPools

Nom Description Valeur
type Type de ressource 'Microsoft.ContainerService/managedClusters/agentPools'
apiVersion Version de l’API de ressource '2021-03-01'
nom Nom de la ressource

Découvrez comment définir des noms et des types pour les ressources enfants dans modèles ARM JSON.
chaîne (obligatoire)

Limite de caractères : 1 à 12 pour Linux
1-6 pour Windows

Caractères valides :
Lettres minuscules et chiffres.

Impossible de commencer par un nombre.
Propriétés Propriétés d’un pool d’agents. ManagedClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfileProperties

Nom Description Valeur
availabilityZones Zones de disponibilité pour les nœuds. Doit utiliser VirtualMachineScaleSets AgentPoolType. string[]
compter Nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 100 (inclus) pour les pools d’utilisateurs et dans la plage comprise entre 1 et 100 (inclus) pour les pools système. La valeur par défaut est 1. Int
enableAutoScaling Indique s’il faut activer la mise à l’échelle automatique Bool
enableEncryptionAtHost Indique s’il faut activer EncryptionAtHost Bool
enableFIPS Indique s’il faut utiliser le système d’exploitation activé par FIPS Bool
enableNodePublicIP Activer l’adresse IP publique pour les nœuds Bool
gpuInstanceProfile GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge. Les valeurs prises en charge sont MIG1g, MIG2g, MIG3g, MIG4g et MIG7g. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
kubeletConfig KubeletConfig spécifie la configuration de kubelet sur les nœuds de l’agent. KubeletConfig
kubeletDiskType KubeletDiskType détermine le placement des volumes emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet. Autorise actuellement une valeur, le système d’exploitation, ce qui entraîne Kubelet à l’aide du disque du système d’exploitation pour les données. 'OS'
'Temporaire'
linuxOSConfig LinuxOSConfig spécifie la configuration du système d’exploitation des nœuds d’agent Linux. LinuxOSConfig
maxCount Nombre maximal de nœuds pour la mise à l’échelle automatique Int
maxPods Nombre maximal de pods qui peuvent s’exécuter sur un nœud. Int
minCount Nombre minimal de nœuds pour la mise à l’échelle automatique Int
mode AgentPoolMode représente le mode d’un pool d’agents 'System'
'User'
nodeLabels Étiquettes de nœud de pool d’agents à conserver sur tous les nœuds du pool d’agents. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID ID de préfixe IP public. Les nœuds de machine virtuelle utilisent des adresses IP affectées à partir de ce préfixe IP public. corde
nodeTaints Les teintes ajoutées aux nouveaux nœuds pendant la création et la mise à l’échelle du pool de nœuds. Par exemple, key=value :NoSchedule. string[]
orchestratorVersion Version d’orchestrateur spécifiée lors de la création du cluster managé. corde
osDiskSizeGB Taille du disque du système d’exploitation en Go à utiliser pour spécifier la taille du disque pour chaque ordinateur de ce pool maître/agent. Si vous spécifiez 0, elle applique la taille osDisk par défaut en fonction de vmSize spécifiée. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 2048
osDiskType Type de disque de système d’exploitation à utiliser pour les machines d’un pool d’agents donné. Les valeurs autorisées sont « Éphémères » et « Géré ». S’il n’est pas spécifié, la valeur par défaut est « Éphémère » lorsque la machine virtuelle prend en charge le système d’exploitation éphémère et a un disque de cache supérieur au système d’exploitation OSDiskSizeGB demandé. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. 'Éphémère'
'Managed'
osSKU OsSKU à utiliser pour spécifier la référence sKU du système d’exploitation. Choisissez ubuntu(par défaut) et CBLMarinr pour Linux OSType. Non applicable à Windows OSType. 'CBLMarinr'
'Ubuntu'
osType OsType à utiliser pour spécifier le type de système d’exploitation. Choisissez dans Linux et Windows. Valeur par défaut pour Linux. 'Linux'
'Windows'
podSubnetID Pod SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les pods. corde
proximityPlacementGroupID ID du groupe de placement de proximité. corde
scaleSetEvictionPolicy ScaleSetEvictionPolicy à utiliser pour spécifier la stratégie d’éviction pour le groupe de machines virtuelles identiques Spot. Valeur par défaut : Supprimer. 'Libérer'
'Supprimer'
scaleSetPriority ScaleSetPriority à utiliser pour spécifier la priorité du groupe de machines virtuelles identiques. Valeur par défaut normale. 'Normal'
'Spot'
spotMaxPrice SpotMaxPrice à utiliser pour spécifier le prix maximal que vous êtes prêt à payer en dollars US. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Int
étiquettes Balises de pool d’agents à conserver sur le groupe de machines virtuelles identiques du pool d’agents. objet
type AgentPoolType représente les types d’un pool d’agents 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings Paramètres de mise à niveau du pool d’agents AgentPoolUpgradeSettings
vmSize Taille des machines virtuelles de l’agent. corde
vnetSubnetID VNet SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les nœuds et peut-être les pods corde

KubeletConfig

Nom Description Valeur
allowedUnsafeSysctls Liste verte de sysctls non sécurisés ou de modèles sysctl non sécurisés (se terminant par *). string[]
containerLogMaxFiles Nombre maximal de fichiers journaux de conteneur pouvant être présents pour un conteneur. Le nombre doit être ≥ 2. Int

Contraintes:
Valeur minimale = 2
containerLogMaxSizeMB Taille maximale (par exemple, 10Mi) du fichier journal conteneur avant sa rotation. Int
cpuCfsQuota Activez l’application du quota CFS processeur pour les conteneurs qui spécifient des limites d’UC. Bool
cpuCfsQuotaPeriod Définit la valeur de la période de quota CFS du processeur. corde
cpuManagerPolicy Stratégie du Gestionnaire d’UC à utiliser. corde
failSwapOn Si la valeur est true, kubelet ne démarre pas si l’échange est activé sur le nœud. Bool
imageGcHighThreshold Pourcentage d’utilisation du disque après laquelle le garbage collection d’images est toujours exécuté. Int
imageGcLowThreshold Pourcentage d’utilisation du disque avant laquelle le garbage collection d’images n’est jamais exécuté. Int
podMaxPids Nombre maximal de processus par pod. Int
topologyManagerPolicy Stratégie du Gestionnaire de topologie à utiliser. corde

LinuxOSConfig

Nom Description Valeur
swapFileSizeMB SwapFileSizeMB spécifie la taille en Mo d’un fichier d’échange sur chaque nœud. Int
sysctls Paramètres Sysctl pour les nœuds d’agent Linux. SysctlConfig
transparentHugePageDefrag Configuration transparente de la défragmentation de page énorme. corde
transparentHugePageEnabled Configuration transparente d’une page énorme activée. corde

SysctlConfig

Nom Description Valeur
fsAioMaxNr Paramètre Sysctl fs.aio-max-nr. Int
fsFileMax Paramètre Sysctl fs.file-max. Int
fsInotifyMaxUserWatches Paramètre Sysctl fs.inotify.max_user_watch. Int
fsNrOpen Paramètre Sysctl fs.nr_open. Int
kernelThreadsMax Sysctl définissant kernel.threads-max. Int
netCoreNetdevMaxBacklog Paramètre Sysctl net.core.netdev_max_backlog. Int
netCoreOptmemMax Paramètre Sysctl net.core.optmem_max. Int
netCoreRmemDefault Paramètre Sysctl net.core.rmem_default. Int
netCoreRmemMax Paramètre Sysctl net.core.rmem_max. Int
netCoreSomaxconn Sysctl définissant net.core.somaxconn. Int
netCoreWmemDefault Paramètre Sysctl net.core.wmem_default. Int
netCoreWmemMax Paramètre Sysctl net.core.wmem_max. Int
netIpv4IpLocalPortRange Paramètre Sysctl net.ipv4.ip_local_port_range. corde
netIpv4NeighDefaultGcThresh1 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Paramètre Sysctl net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Paramètre Sysctl net.ipv4.tcp_keepalive_intvl. Int
netIpv4TcpKeepaliveProbes Paramètre Sysctl net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Paramètre Sysctl net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Paramètre Sysctl net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Paramètre Sysctl net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Paramètre Sysctl net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Paramètre Sysctl net.netfilter.nf_conntrack_buckets. Int
netNetfilterNfConntrackMax Paramètre Sysctl net.netfilter.nf_conntrack_max. Int
vmMaxMapCount Paramètre Sysctl vm.max_map_count. Int
vmSwappiness Sysctl définissant vm.swappiness. Int
vmVfsCachePressure Paramètre Sysctl vm.vfs_cache_pressure. Int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nom Description Valeur
{propriété personnalisée} corde

AgentPoolUpgradeSettings

Nom Description Valeur
maxSurge Nombre ou pourcentage de nœuds supplémentaires à ajouter pendant la mise à niveau. Si vide utilise AKS par défaut corde

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Déployer un cluster AKS pour Azure ML

Déployer sur Azure
Ce modèle vous permet de déployer un cluster AKS conforme à l’entreprise qui peut être attaché à Azure ML

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource managedClusters/agentPools peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.ContainerService/managedClusters/agentPools, ajoutez la terraform suivante à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/agentPools@2021-03-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      availabilityZones = [
        "string"
      ]
      count = int
      enableAutoScaling = bool
      enableEncryptionAtHost = bool
      enableFIPS = bool
      enableNodePublicIP = bool
      gpuInstanceProfile = "string"
      kubeletConfig = {
        allowedUnsafeSysctls = [
          "string"
        ]
        containerLogMaxFiles = int
        containerLogMaxSizeMB = int
        cpuCfsQuota = bool
        cpuCfsQuotaPeriod = "string"
        cpuManagerPolicy = "string"
        failSwapOn = bool
        imageGcHighThreshold = int
        imageGcLowThreshold = int
        podMaxPids = int
        topologyManagerPolicy = "string"
      }
      kubeletDiskType = "string"
      linuxOSConfig = {
        swapFileSizeMB = int
        sysctls = {
          fsAioMaxNr = int
          fsFileMax = int
          fsInotifyMaxUserWatches = int
          fsNrOpen = int
          kernelThreadsMax = int
          netCoreNetdevMaxBacklog = int
          netCoreOptmemMax = int
          netCoreRmemDefault = int
          netCoreRmemMax = int
          netCoreSomaxconn = int
          netCoreWmemDefault = int
          netCoreWmemMax = int
          netIpv4IpLocalPortRange = "string"
          netIpv4NeighDefaultGcThresh1 = int
          netIpv4NeighDefaultGcThresh2 = int
          netIpv4NeighDefaultGcThresh3 = int
          netIpv4TcpFinTimeout = int
          netIpv4TcpkeepaliveIntvl = int
          netIpv4TcpKeepaliveProbes = int
          netIpv4TcpKeepaliveTime = int
          netIpv4TcpMaxSynBacklog = int
          netIpv4TcpMaxTwBuckets = int
          netIpv4TcpTwReuse = bool
          netNetfilterNfConntrackBuckets = int
          netNetfilterNfConntrackMax = int
          vmMaxMapCount = int
          vmSwappiness = int
          vmVfsCachePressure = int
        }
        transparentHugePageDefrag = "string"
        transparentHugePageEnabled = "string"
      }
      maxCount = int
      maxPods = int
      minCount = int
      mode = "string"
      nodeLabels = {
        {customized property} = "string"
      }
      nodePublicIPPrefixID = "string"
      nodeTaints = [
        "string"
      ]
      orchestratorVersion = "string"
      osDiskSizeGB = int
      osDiskType = "string"
      osSKU = "string"
      osType = "string"
      podSubnetID = "string"
      proximityPlacementGroupID = "string"
      scaleSetEvictionPolicy = "string"
      scaleSetPriority = "string"
      spotMaxPrice = int
      tags = {}
      type = "string"
      upgradeSettings = {
        maxSurge = "string"
      }
      vmSize = "string"
      vnetSubnetID = "string"
    }
  })
}

Valeurs de propriété

managedClusters/agentPools

Nom Description Valeur
type Type de ressource « Microsoft.ContainerService/managedClusters/agentPools@2021-03-01 »
nom Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1 à 12 pour Linux
1-6 pour Windows

Caractères valides :
Lettres minuscules et chiffres.

Impossible de commencer par un nombre.
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : managedClusters
Propriétés Propriétés d’un pool d’agents. ManagedClusterAgentPoolProfileProperties

ManagedClusterAgentPoolProfileProperties

Nom Description Valeur
availabilityZones Zones de disponibilité pour les nœuds. Doit utiliser VirtualMachineScaleSets AgentPoolType. string[]
compter Nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 100 (inclus) pour les pools d’utilisateurs et dans la plage comprise entre 1 et 100 (inclus) pour les pools système. La valeur par défaut est 1. Int
enableAutoScaling Indique s’il faut activer la mise à l’échelle automatique Bool
enableEncryptionAtHost Indique s’il faut activer EncryptionAtHost Bool
enableFIPS Indique s’il faut utiliser le système d’exploitation activé par FIPS Bool
enableNodePublicIP Activer l’adresse IP publique pour les nœuds Bool
gpuInstanceProfile GPUInstanceProfile à utiliser pour spécifier le profil d’instance GPU MIG pour la référence SKU de machine virtuelle GPU prise en charge. Les valeurs prises en charge sont MIG1g, MIG2g, MIG3g, MIG4g et MIG7g. « MIG1g »
« MIG2g »
« MIG3g »
« MIG4g »
« MIG7g »
kubeletConfig KubeletConfig spécifie la configuration de kubelet sur les nœuds de l’agent. KubeletConfig
kubeletDiskType KubeletDiskType détermine le placement des volumes emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet. Autorise actuellement une valeur, le système d’exploitation, ce qui entraîne Kubelet à l’aide du disque du système d’exploitation pour les données. « Système d’exploitation »
« Temporaire »
linuxOSConfig LinuxOSConfig spécifie la configuration du système d’exploitation des nœuds d’agent Linux. LinuxOSConfig
maxCount Nombre maximal de nœuds pour la mise à l’échelle automatique Int
maxPods Nombre maximal de pods qui peuvent s’exécuter sur un nœud. Int
minCount Nombre minimal de nœuds pour la mise à l’échelle automatique Int
mode AgentPoolMode représente le mode d’un pool d’agents « Système »
« Utilisateur »
nodeLabels Étiquettes de nœud de pool d’agents à conserver sur tous les nœuds du pool d’agents. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID ID de préfixe IP public. Les nœuds de machine virtuelle utilisent des adresses IP affectées à partir de ce préfixe IP public. corde
nodeTaints Les teintes ajoutées aux nouveaux nœuds pendant la création et la mise à l’échelle du pool de nœuds. Par exemple, key=value :NoSchedule. string[]
orchestratorVersion Version d’orchestrateur spécifiée lors de la création du cluster managé. corde
osDiskSizeGB Taille du disque du système d’exploitation en Go à utiliser pour spécifier la taille du disque pour chaque ordinateur de ce pool maître/agent. Si vous spécifiez 0, elle applique la taille osDisk par défaut en fonction de vmSize spécifiée. Int

Contraintes:
Valeur minimale = 0
Valeur maximale = 2048
osDiskType Type de disque de système d’exploitation à utiliser pour les machines d’un pool d’agents donné. Les valeurs autorisées sont « Éphémères » et « Géré ». S’il n’est pas spécifié, la valeur par défaut est « Éphémère » lorsque la machine virtuelle prend en charge le système d’exploitation éphémère et a un disque de cache supérieur au système d’exploitation OSDiskSizeGB demandé. Sinon, la valeur par défaut est « Gérée ». Peut ne pas être modifié après la création. « Éphémère »
« Géré »
osSKU OsSKU à utiliser pour spécifier la référence sKU du système d’exploitation. Choisissez ubuntu(par défaut) et CBLMarinr pour Linux OSType. Non applicable à Windows OSType. « CBLMarinr »
« Ubuntu »
osType OsType à utiliser pour spécifier le type de système d’exploitation. Choisissez dans Linux et Windows. Valeur par défaut pour Linux. « Linux »
« Windows »
podSubnetID Pod SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les pods. corde
proximityPlacementGroupID ID du groupe de placement de proximité. corde
scaleSetEvictionPolicy ScaleSetEvictionPolicy à utiliser pour spécifier la stratégie d’éviction pour le groupe de machines virtuelles identiques Spot. Valeur par défaut : Supprimer. « Libérer »
« Supprimer »
scaleSetPriority ScaleSetPriority à utiliser pour spécifier la priorité du groupe de machines virtuelles identiques. Valeur par défaut normale. « Normal »
« Spot »
spotMaxPrice SpotMaxPrice à utiliser pour spécifier le prix maximal que vous êtes prêt à payer en dollars US. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Int
étiquettes Balises de pool d’agents à conserver sur le groupe de machines virtuelles identiques du pool d’agents. objet
type AgentPoolType représente les types d’un pool d’agents « AvailabilitySet »
« VirtualMachineScaleSets »
upgradeSettings Paramètres de mise à niveau du pool d’agents AgentPoolUpgradeSettings
vmSize Taille des machines virtuelles de l’agent. corde
vnetSubnetID VNet SubnetID spécifie l’identificateur de sous-réseau du réseau virtuel pour les nœuds et peut-être les pods corde

KubeletConfig

Nom Description Valeur
allowedUnsafeSysctls Liste verte de sysctls non sécurisés ou de modèles sysctl non sécurisés (se terminant par *). string[]
containerLogMaxFiles Nombre maximal de fichiers journaux de conteneur pouvant être présents pour un conteneur. Le nombre doit être ≥ 2. Int

Contraintes:
Valeur minimale = 2
containerLogMaxSizeMB Taille maximale (par exemple, 10Mi) du fichier journal conteneur avant sa rotation. Int
cpuCfsQuota Activez l’application du quota CFS processeur pour les conteneurs qui spécifient des limites d’UC. Bool
cpuCfsQuotaPeriod Définit la valeur de la période de quota CFS du processeur. corde
cpuManagerPolicy Stratégie du Gestionnaire d’UC à utiliser. corde
failSwapOn Si la valeur est true, kubelet ne démarre pas si l’échange est activé sur le nœud. Bool
imageGcHighThreshold Pourcentage d’utilisation du disque après laquelle le garbage collection d’images est toujours exécuté. Int
imageGcLowThreshold Pourcentage d’utilisation du disque avant laquelle le garbage collection d’images n’est jamais exécuté. Int
podMaxPids Nombre maximal de processus par pod. Int
topologyManagerPolicy Stratégie du Gestionnaire de topologie à utiliser. corde

LinuxOSConfig

Nom Description Valeur
swapFileSizeMB SwapFileSizeMB spécifie la taille en Mo d’un fichier d’échange sur chaque nœud. Int
sysctls Paramètres Sysctl pour les nœuds d’agent Linux. SysctlConfig
transparentHugePageDefrag Configuration transparente de la défragmentation de page énorme. corde
transparentHugePageEnabled Configuration transparente d’une page énorme activée. corde

SysctlConfig

Nom Description Valeur
fsAioMaxNr Paramètre Sysctl fs.aio-max-nr. Int
fsFileMax Paramètre Sysctl fs.file-max. Int
fsInotifyMaxUserWatches Paramètre Sysctl fs.inotify.max_user_watch. Int
fsNrOpen Paramètre Sysctl fs.nr_open. Int
kernelThreadsMax Sysctl définissant kernel.threads-max. Int
netCoreNetdevMaxBacklog Paramètre Sysctl net.core.netdev_max_backlog. Int
netCoreOptmemMax Paramètre Sysctl net.core.optmem_max. Int
netCoreRmemDefault Paramètre Sysctl net.core.rmem_default. Int
netCoreRmemMax Paramètre Sysctl net.core.rmem_max. Int
netCoreSomaxconn Sysctl définissant net.core.somaxconn. Int
netCoreWmemDefault Paramètre Sysctl net.core.wmem_default. Int
netCoreWmemMax Paramètre Sysctl net.core.wmem_max. Int
netIpv4IpLocalPortRange Paramètre Sysctl net.ipv4.ip_local_port_range. corde
netIpv4NeighDefaultGcThresh1 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Paramètre Sysctl net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Paramètre Sysctl net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Paramètre Sysctl net.ipv4.tcp_keepalive_intvl. Int
netIpv4TcpKeepaliveProbes Paramètre Sysctl net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Paramètre Sysctl net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Paramètre Sysctl net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Paramètre Sysctl net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Paramètre Sysctl net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Paramètre Sysctl net.netfilter.nf_conntrack_buckets. Int
netNetfilterNfConntrackMax Paramètre Sysctl net.netfilter.nf_conntrack_max. Int
vmMaxMapCount Paramètre Sysctl vm.max_map_count. Int
vmSwappiness Sysctl définissant vm.swappiness. Int
vmVfsCachePressure Paramètre Sysctl vm.vfs_cache_pressure. Int

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Nom Description Valeur
{propriété personnalisée} corde

AgentPoolUpgradeSettings

Nom Description Valeur
maxSurge Nombre ou pourcentage de nœuds supplémentaires à ajouter pendant la mise à niveau. Si vide utilise AKS par défaut corde