Tous les produits
Search
Centre de documentation

Container Compute Service:Référence des annotations de pod

Dernière mise à jour :Aug 12, 2026

Ajoutez des annotations aux pods Container Compute Service (ACS) pour configurer le réseau, le téléchargement des images, l'ordonnancement et les paramètres du système d'exploitation. Cette référence répertorie toutes les annotations prises en charge, classées par catégorie.

Annotations de configuration des pods

Définissez ces annotations dans metadata.annotations lors de la création d'un pod ou d'un Deployment.

Exemple de configuration de pod

apiVersion: v1
kind: Pod
metadata:
  name: annotation-pod
  annotations:
    # Specify one or more vSwitch IDs to control which zones the pod is created in
    network.alibabacloud.com/vswitch-ids: "vsw-foo"
    # Attach an EIP automatically when the pod starts
    network.alibabacloud.com/pod-with-eip: "true"
spec:
  ...

Exemple de configuration de Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
  name: foo
spec:
  template:
    metadata:
      annotations:
        network.alibabacloud.com/vswitch-ids: "vsw-foo"
    ...

Réseau

Paramètre

Exemple

Description

network.alibabacloud.com/vswitch-ids

"vsw-slw1,vsw-lkjwo"

Identifiants des vSwitch du pod. Spécifiez plusieurs ID pour répartir les pods sur différentes zones. Voir Spécifier les vSwitch et les groupes de sécurité pour les pods.

Important
  • Si des vSwitch et une affinité sont définis simultanément, ACS utilise les vSwitch spécifiés et ignore la configuration d'affinité.

  • Si le pod utilise un PersistentVolumeClaim (PVC) avec le mode de liaison WaitForFirstConsumer, spécifiez également la zone cible dans les paramètres d'affinité du pod. L'ordonnanceur pourra ainsi aligner la zone du PVC sur celle du vSwitch, évitant que le pod ne reste bloqué à l'état Pending. Voir Ordonnancement par affinité de nœud.

network.alibabacloud.com/security-group-ids

"sg-sljwo,sg-lwirp"

Identifiants des groupes de sécurité du pod. Spécifiez plusieurs ID pour associer plusieurs groupes de sécurité.

network.alibabacloud.com/custom-dnsconfig

{"servers":["20.1.xx.xx","30.1.xx.xx"],"searches":["xx.com","yy.com"],"options":["ndots:2","edns0"]}

Configuration DNS personnalisée pour le pod. Voir Configurer un DNS personnalisé à l'aide d'annotations.

alibabacloud.com/enable-network-policy-agent

"true"

Active NetworkPolicy pour le pod. Valeur par défaut : false. Voir Utiliser des politiques réseau dans les clusters ACS.

Configuration EIP

Utilisez les annotations suivantes pour attacher une adresse IP élastique (EIP) à un pod. Voir Attacher une EIP à un pod à l'aide d'annotations.

Paramètre

Exemple

Description

network.alibabacloud.com/pod-with-eip

"true"

Crée et attache automatiquement une EIP au pod. Valeurs valides : true ou false.

network.alibabacloud.com/pod-eip-instanceid

"eip-bp14q***"

Utilise une EIP existante. Saisissez l'ID de l'instance EIP. Voir Demander une EIP.

network.alibabacloud.com/eip-bandwidth

"5"

Bande passante maximale de l'EIP, en Mbit/s.

network.alibabacloud.com/eip-internet-charge-type

"PayByTraffic"

Mode de facturation du transfert de données EIP. Valeurs valides : PayByTraffic (par défaut) | PayByBandwidth. Voir Modes de facturation des EIP.

network.alibabacloud.com/eip-instance-charge-type

"PrePaid"

Mode de facturation de l'instance EIP. Valeurs valides : PrePaid (abonnement) | PostPaid (paiement à l'utilisation). Voir Abonnement et Paiement à l'utilisation.

network.alibabacloud.com/eip-common-bandwidth-package-id

"cbwp-slex***"

Associe l'EIP du pod à une instance Internet Shared Bandwidth existante.

network.alibabacloud.com/eip-isp

"BGP"

Type de ligne de l'EIP. Valeurs valides : BGP (BGP Multi-ISP) | BGP_PRO (BGP Multi-ISP Pro). Voir Demander une EIP.

network.alibabacloud.com/eip-public-ip-address-pool-id

"pippool-dlsw***"

Pool d'adresses EIP source pour l'allocation. Voir Pools d'adresses IP.

network.alibabacloud.com/eip-resource-group-id

N/A

Groupe de ressources de l'EIP. Voir Demander une EIP.

network.alibabacloud.com/eip-name

N/A

Nom de l'EIP.

network.alibabacloud.com/eip-description

N/A

Description de l'EIP.

network.alibabacloud.com/eip-security-protection-types

N/A

Services de sécurité à appliquer à l'EIP. Séparez les valeurs multiples par une virgule (,). Voir Demander une EIP.

network.alibabacloud.com/pod-eip-release-strategy

"Never"

Politique de libération de l'EIP lors de la suppression du pod. Valeurs valides :

  • Follow : par défaut, l'EIP est libérée lors de la suppression du pod.

  • Never : l'EIP est conservée ; supprimez-la manuellement si elle n'est plus nécessaire.

  • Durée de style Go : par exemple, 5m30s supprime l'EIP 5 minutes et 30 secondes après la suppression du pod.

Image

Paramètre

Exemple

Description

registry.alibabacloud.com/plain-http-registry

"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"

Registres utilisant HTTP simple. Configurez ce paramètre pour éviter les échecs de téléchargement lorsqu'un référentiel d'images utilise HTTP au lieu de HTTPS. Séparez les entrées multiples par une virgule. Voir Utiliser un référentiel d'images auto-géré.

registry.alibabacloud.com/insecure-registry

"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"

Registres avec certificats auto-signés. Configurez ce paramètre pour ignorer la validation des certificats et éviter les échecs de téléchargement. Séparez les entrées multiples par une virgule.

Ordonnancement

Fonctionnalité

Paramètre

Exemple

Description

Politique d'ordonnancement multi-zone des pods

scheduling.alibabacloud.com/schedule-strategy

"VSwitchOrdered"

Politique d'ordonnancement multi-zone. Valeurs valides :

  • VSwitchOrdered : ordonnance les pods sur les vSwitch selon l'ordre de la liste.

  • VSwitchRandom : ordonnance les pods sur les vSwitch de manière aléatoire.

Politique de gestion des défaillances de pod

scheduling.alibabacloud.com/fail-strategy

"fail-back"

Politique de gestion des défaillances pour les pods. Valeurs valides :

  • fail-back : récupération automatique après une défaillance. Si la création d'un pod échoue, le système tente automatiquement de le recréer.

  • fail-over : transfert du pod en cas de défaillance. Cet effet est identique à celui de fail-back.

  • fail-fast : signale immédiatement une erreur si la création du pod échoue.

Durée maximale d'attente d'un pod

scheduling.alibabacloud.com/max-pending-minute

"10"

Durée maximale pendant laquelle un pod peut rester à l'état Pending. Le système met automatiquement fin à l'instance si ce délai expire.

La valeur doit être un entier compris entre 10 et 1440 (en minutes). La durée minimale est de 10 minutes et la maximale d'un jour. La valeur par défaut est de 4 heures.

Le compte à rebours démarre au début de la création du bac à sable. Les pods n'ayant pas encore atteint cette étape ne sont pas concernés par ce délai d'expiration.

Système d'exploitation

Paramètre

Valeur d'exemple

Description

alibabacloud.com/os-kernel-config

{"transparentHugepageEnabled": "madvise","transparentHugepageShmemEnabled": "advise"}

Paramètres Transparent Huge Pages pour le système d'exploitation du pod. Classes de calcul prises en charge : GPU et GPU-HPN. Sous-paramètres :

  • transparentHugepageEnabled : correspond à /sys/kernel/mm/transparent_hugepage/enabled ; valeurs valides :

    • always

    • madvise

    • never

  • transparentHugepageShmemEnabled : correspond à /sys/kernel/mm/transparent_hugepage/shmem_enabled ; valeurs valides :

    • always

    • within_size

    • advise

    • never

    • deny

    • force

Annotations ajoutées par ACS

Remarque

ACS ajoute ces annotations au pod après sa création. Elles reflètent les résultats d'allocation d'exécution, notamment les affectations d'interface réseau élastique (ENI) et d'EIP. Ces annotations ne peuvent être ni définies ni modifiées.

Allocation ENI

Paramètre

Valeur d'exemple

Description

network.alibabacloud.com/allocated-eni-id

"eni-esdxs***"

ID de l'ENI allouée.

network.alibabacloud.com/vpc-id

"vpc-sljwo***"

ID du VPC auquel appartient l'ENI.

network.alibabacloud.com/vswitch-id

"vsw-lskdw***"

ID du vSwitch auquel l'ENI a été attribuée. Si vous avez spécifié plusieurs vSwitch, cette valeur indique celui effectivement utilisé.

Allocation EIP

Paramètre

Valeur d'exemple

Description

network.alibabacloud.com/allocated-eip-id

"eip-bp1m***"

ID de l'EIP allouée.

network.alibabacloud.com/allocated-eip-address

"116.62.***"

Adresse IP de l'EIP allouée.

Spécifications des ressources

Paramètre

Valeur d'exemple

Description

alibabacloud.com/pod-use-spec

"2.5-5Gi"

Spécifications normalisées de CPU et de mémoire. Format : {xxvCPU}-{xxGiB}.

alibabacloud.com/pod-gpu-use-spec

"1"

Nombre normalisé de cartes GPU.

alibabacloud.com/pod-ephemeral-storage

"30Gi"

Taille normalisée du stockage éphémère, en GiB.

Résultat de l'ordonnancement

Paramètre

Valeur d'exemple

Description

topology.kubernetes.io/region

"cn-hangzhou"

Région où le pod s'exécute.

topology.kubernetes.io/zone

"cn-hangzhou-i"

Zone où le pod s'exécute.

Autres métadonnées

Paramètre

Valeur d'exemple

Description

alibabacloud.com/instance-id

"acs-sdsf***"

ID d'instance du pod ACS.

alibabacloud.com/request-id

"6925D4B7-***"

ID de la requête API de création de pod.

Compatibilité des anciennes annotations

Les annotations suivantes sont prises en charge pour assurer la compatibilité ascendante. Pour les nouveaux déploiements, utilisez les annotations de remplacement recommandées ci-dessous.

Ancienne annotation

Remplacement recommandé

k8s.aliyun.com/eci-eip-instanceid

network.alibabacloud.com/pod-eip-instanceid

k8s.aliyun.com/eip-charge-type

network.alibabacloud.com/eip-internet-charge-type