ManagedClusterAgentPoolProfileProperties Classe

Initialise une nouvelle instance de ManagedClusterAgentPoolProfileProperties.

Type de pool d’agents.

Liste des zones de disponibilité à utiliser pour les nœuds. Cela ne peut être spécifié que si la propriété AgentPoolType est « VirtualMachineScaleSets ».

AKS associe le pool d’agents spécifié au groupe de réservations de capacité.

Nombre d’agents (machines virtuelles) pour héberger des conteneurs Docker. Les valeurs autorisées doivent être comprises entre 0 et 1 000 (inclus) pour les pools d’utilisateurs et dans la plage de 1 à 1 000 (inclus) pour les pools système. La valeur par défaut est 1.

Il s’agit de l’ID ARM de l’objet source à utiliser pour créer l’objet cible.

Si orchestratorVersion était une version <entièrement spécifiée major.minor.patch>, ce champ sera exactement égal à celui-ci. Si orchestratorVersion était <major.minor>, ce champ contiendra la version complète <de major.minor.patch> utilisée.

La valeur par défaut est false. Le NAT sortant ne peut être désactivé que si le type de trafic sortant du cluster est une passerelle NAT et si l’adresse IP publique du nœud n’est pas activée dans le pool d’agents Windows.

Indique s’il faut activer la mise à l’échelle automatique.

Lorsqu’il est défini sur true, AKS ajoute une étiquette au nœud indiquant que la fonctionnalité est activée et déploie un démonet avec les services hôtes pour synchroniser les autorités de certification personnalisées à partir de la liste fournie par l’utilisateur de certificats encodés en base64 dans des magasins d’approbation de nœuds. La valeur par défaut est false.

Cela est pris en charge uniquement sur certaines tailles de machine virtuelle et dans certaines régions Azure. Pour plus d’informations, consultez https://docs.microsoft.com/azure/aks/enable-host-encryption.

Pour plus d’informations, consultez Ajouter un pool de nœuds avec FIPS .

Certains scénarios peuvent exiger que les nœuds d’un pool de nœuds reçoivent leurs propres adresses IP publiques dédiées. C’est par exemple le cas pour les charges de travail de gaming, où une console doit être directement connectée à une machine virtuelle du cloud afin de réduire les tronçons. Pour plus d’informations, consultez Affectation d’une adresse IP publique par nœud. La valeur par défaut est false.

Indique s’il faut activer UltraSSD.

GPUInstanceProfile à utiliser pour spécifier le profil d’instance MIG GPU pour la référence SKU de machine virtuelle GPU prise en charge.

Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Pour plus d’informations, consultez Hôtes dédiés Azure.

Configuration Kubelet sur les nœuds du pool d’agents.

Détermine l’emplacement des volumes emptyDir, de la racine des données du runtime de conteneur et du stockage éphémère Kubelet.

Configuration du système d’exploitation des nœuds de l’agent Linux.

Nombre maximal de nœuds pour la mise à l’échelle automatique.

Nombre maximal de pods pouvant s’exécuter sur un nœud.

Chaîne encodée en base64 qui sera écrite dans /etc/motd après le décodage. Cela permet la personnalisation du message du jour pour les nœuds Linux. Il ne doit pas être spécifié pour les nœuds Windows. Il doit s’agir d’une chaîne statique (c’est-à-dire qu’elle sera imprimée brute et non exécutée en tant que script).

Nombre minimal de nœuds pour la mise à l’échelle automatique.

Un cluster doit avoir au moins un pool d’agents « Système » à tout moment. Pour plus d’informations sur les restrictions de pool d’agents et les meilleures pratiques, consultez : https://docs.microsoft.com/azure/aks/use-system-pools.

Paramètres liés au réseau d’un pool d’agents.

Version de l’image de nœud.

Étiquettes de nœud à conserver sur tous les nœuds du pool d’agents.

Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}.

Les teintes ajoutées aux nouveaux nœuds lors de la création et de la mise à l’échelle du pool de nœuds. Par exemple, key=value:NoSchedule.

Les versions <de correctif major.minor.patch> et <major.minor> sont prises en charge. Lorsque <major.minor> est spécifié, la dernière version de correctif prise en charge est choisie automatiquement. La mise à jour du pool d’agents avec le même <fichier major.minor> une fois qu’il a été créé ne déclenche pas de mise à niveau, même si une version de correctif plus récente est disponible. En guise de bonne pratique, vous devez mettre à niveau tous les pools de nœuds dans un cluster AKS vers la même version de Kubernetes. La version du pool de nœuds doit avoir la même version principale que le plan de contrôle. La version secondaire du pool de nœuds doit être située à deux versions secondaires de la version du plan de contrôle. La version du pool de nœuds ne peut pas être supérieure à la version du plan de contrôle. Pour plus d’informations, consultez Mise à niveau d’un pool de nœuds.

Taille du disque du système d’exploitation en Go à utiliser pour spécifier la taille du disque pour chaque ordinateur du pool master/agent. Si vous spécifiez 0, la taille osDisk par défaut est appliquée en fonction de la taille vmSize spécifiée.

La valeur par défaut est « Éphémère » si la machine virtuelle la prend en charge et possède un disque de cache supérieur à l’OSDiskSizeGB demandé. Dans le cas contraire, la valeur par défaut est « Managed ». Peut ne pas être modifié après la création. Pour plus d’informations, consultez Système d’exploitation éphémère.

Spécifie la référence SKU du système d’exploitation utilisée par le pool d’agents. S’il n’est pas spécifié, la valeur par défaut est Ubuntu si OSType=Linux ou Windows2019 si OSType=Windows. Et la référence OSSKU Windows par défaut sera remplacée par Windows2022 une fois Windows2019 dépréciée.

Type de système d’exploitation. La valeur par défaut est Linux.

En cas d’omission, les adresses IP de pod sont affectées de manière statique sur le sous-réseau du nœud (voir vnetSubnetID pour plus d’informations). Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}.

Indique si le cluster est en cours d’exécution ou arrêté.

État actuel du déploiement ou de l’approvisionnement.

ID du groupe de placement de proximité.

Cela affecte également le comportement du générateur de mise à l’échelle automatique du cluster. S’il n’est pas spécifié, la valeur par défaut est Delete.

Cela ne peut pas être spécifié, sauf si le scaleSetPriority est « Spot ». Si elle n’est pas spécifiée, la valeur par défaut est « Delete ».

Priorité groupe de machines virtuelles identiques. S’il n’est pas spécifié, la valeur par défaut est « Regular ».

Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent la volonté de payer n’importe quel prix à la demande. Pour plus d’informations sur la tarification spot, consultez Tarification des machines virtuelles spot.

Balises à conserver sur le groupe de machines virtuelles identiques du pool d’agents.

Cela peut être défini sur un entier (par exemple, « 5 ») ou un pourcentage (par exemple, « 50 % »). Si un pourcentage est spécifié, il s’agit du pourcentage de la taille totale du pool d’agents au moment de la mise à niveau. Pour les pourcentages, les nœuds fractionnaires sont arrondis vers le haut. Si cet argument n'est pas spécifié, la valeur par défaut est 1. Pour plus d’informations, notamment sur les bonnes pratiques, consultez : https://docs.microsoft.com/azure/aks/upgrade-cluster#customize-node-surge-upgrade.

La disponibilité de la taille de machine virtuelle varie selon la région. Si un nœud contient des ressources de calcul insuffisantes (mémoire, processeur, etc.), les pods peuvent ne pas s’exécuter correctement. Pour plus d’informations sur les tailles de machine virtuelle restreintes, consultez : https://docs.microsoft.com/azure/aks/quotas-skus-regions.

Si ce n’est pas spécifié, un réseau virtuel et un sous-réseau seront générés et utilisés. Si aucun podSubnetID n’est spécifié, cela s’applique aux nœuds et aux pods. Sinon, elle s’applique uniquement aux nœuds. Il s’agit de la forme suivante : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}.

Détermine le type de charge de travail qu’un nœud peut exécuter.