View a markdown version of this page

Créez des nœuds avec des AMI Windows optimisées - Amazon EKS
Calendrier des versionsParamètres de configuration du script d'amorçageImages de conteneur en cacheInstantané CIMFSEn savoir plus

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez des nœuds avec des AMI Windows optimisées

Les AMI optimisées pour Windows Amazon EKS sont basées sur Windows Server 2019, Windows Server 2022 et Windows Server 2025. Elles sont configurées pour servir d'image de base pour les nœuds Amazon EKS. Par défaut, les AMI incluent les composants suivants :

Note

Vous pouvez suivre les événements de sécurité ou de confidentialité pour Windows Server à l'aide du Guide de mise à jour de sécurité Microsoft.

Amazon EKS propose des AMI qui sont optimisées pour les conteneurs Windows dans les variantes suivantes :

  • AMI principale Amazon EKS-optimized Windows Server 2019

  • AMI complète d'Amazon EKS-optimized Windows Server 2019

  • AMI principale Amazon EKS-optimized Windows Server 2022

  • AMI complète Amazon EKS-optimized Windows Server 2022

  • AMI principale Amazon EKS-optimized Windows Server 2025

  • AMI complète Amazon EKS-optimized Windows Server 2025

Important

  • L'AMI Amazon EKS-optimized Windows Server 20H2 Core est obsolète. Aucune nouvelle version de cette AMI ne sera publiée.

  • Pour vous garantir les dernières mises à jour de sécurité par défaut, Amazon EKS conserve des images AMI Windows optimisées pendant les quatre derniers mois. Chaque nouvelle AMI sera disponible pendant 4 mois à compter de la date de publication initiale. Après cette période, les anciennes AMI deviennent privées et ne sont plus accessibles. Nous vous encourageons à utiliser les dernières AMI afin d’éviter les failles de sécurité et de ne pas perdre l’accès aux anciennes AMI qui ont atteint la fin de leur durée de vie prise en charge. Bien que nous ne puissions pas garantir l'accès aux AMI qui ont été rendues privées, vous pouvez demander l'accès en déposant un ticket auprès du AWS support.

Calendrier des versions

Le tableau suivant répertorie les dates de publication et de fin de support pour les versions Windows sur Amazon EKS. Si une date de fin est vide, c’est parce que la version est toujours prise en charge.

Version Windows Version d'Amazon EKS Fin de support pour Amazon EKS

Windows Server 2025 Core

01/27/2026

Windows Server 2025 complet

01/27/2026

Windows Server 2022 Core

10/17/2022

Windows Server 2022 Full

10/17/2022

Windows Server 20H2 Core

8/12/2021

8/9/2022

Windows Server 2004 Core

8/19/2020

12/14/2021

Windows Server 2019 Core

10/7/2019

Windows Server 2019 Full

10/7/2019

Windows Server 1909 Core

10/7/2019

12/8/2020

Paramètres de configuration du script d'amorçage

Lorsque vous créez un nœud Windows, un script sur le nœud permet la configuration de différents paramètres. En fonction de votre configuration, ce script peut être trouvé sur le nœud à un emplacement similaire à :C:\Program Files\Amazon\EKS\Start-EKSBootstrap.ps1. Vous pouvez indiquer des valeurs de paramètres personnalisées en les spécifiant comme arguments dans le script d'amorçage. Par exemple, vous pouvez mettre à jour les données utilisateur dans le modèle de lancement. Pour plus d’informations, consultez Données utilisateur Amazon EC2.

Le script comprend les paramètres de ligne de commande suivants :

  • -EKSClusterName : spécifie le nom du cluster Amazon EKS que ce composant master doit rejoindre.

  • -KubeletExtraArgs : spécifie des arguments supplémentaires pour kubelet (facultatif).

  • -KubeProxyExtraArgs : spécifie des arguments supplémentaires pour kube-proxy (facultatif).

  • -APIServerEndpoint : spécifie le point de terminaison du serveur d'API de cluster Amazon EKS (facultatif). Uniquement valable lorsqu'il est utilisé avec -Base64ClusterCA. Évite d'appeler Get-EKSCluster.

  • -Base64ClusterCA : spécifie le contenu de l'autorité de certification du cluster codée en base64 (facultatif). Uniquement valable lorsqu'il est utilisé avec -APIServerEndpoint. Évite d'appeler Get-EKSCluster.

  • -DNSClusterIP : remplace l'adresse IP à utiliser pour les requêtes DNS au sein du cluster (facultatif). La valeur par défaut est 10.100.0.10 ou 172.20.0.10 en fonction de l'adresse IP de l'interface principale.

  • -ServiceCIDR : remplace la plage d’adresses IP du service Kubernetes à partir de laquelle les services du cluster sont adressés. La valeur par défaut est 172.20.0.0/16 ou 10.100.0.0/16 en fonction de l'adresse IP de l'interface principale.

  • -ExcludedSnatCIDRs : liste des CIDR IPv4 à exclure de la traduction d'adresses réseau source (SNAT, Source Network Address Translation). Cela signifie que l’adresse IP privée du pod, qui est adressable par VPC, ne serait pas traduite en adresse IP de l’adresse principale IPv4 de l’ENI de l’instance pour le trafic sortant. Par défaut, le CIDR IPv4 du VPC pour le nœud Amazon EKS Windows est ajouté. La spécification des CIDR à ce paramètre exclut également les CIDR spécifiés. Pour plus d’informations, consultez Activer l’accès Internet sortant pour les Pods.

  • -EnableCimFS— (Facultatif) Active le snapshotter du système de fichiers d'images composites (CIMFS). containerd Il s'agit d'une fonctionnalité optionnelle uniquement disponible sur les AMI Amazon EKS-optimized Windows Server 2025 pour les versions Kubernetes et ultérieures. 1.35 Pour plus d’informations, consultez Instantané CIMFS.

En plus des paramètres de la ligne de commande, vous pouvez également spécifier certains paramètres de la variable d'environnement. Lorsqu'un paramètre de ligne de commande est spécifié, il est prioritaire sur la variable d'environnement correspondante. La ou les variables d'environnement doivent être définies au niveau de la machine (ou du système), car le script d'amorçage ne lira que les variables au niveau de la machine.

Le script prend en compte les variables d'environnement suivantes :

  • SERVICE_IPV4_CIDR— Reportez-vous au paramètre de la ligne de commande ServiceCIDR pour la définition.

  • EXCLUDED_SNAT_CIDRS— Il doit s'agir d'une chaîne de caractères séparée par des virgules. Reportez-vous au paramètre de la ligne de commande ExcludedSnatCIDRs pour la définition.

  • EKS_ENABLE_CIMFS— Réglez sur true ou 1 pour activer le snapshotter CIMFScontainerd. Reportez-vous au paramètre de la ligne de commande -EnableCimFS pour la définition.

Prise en charge de l’authentification gMSA

Les pods Windows Amazon EKS autorisent différents types d’authentification de compte de service géré de groupe (gMSA).

  • Amazon EKS prend en charge les identités de domaine Active Directory à des fins d’authentification. Pour plus d'informations sur les gMSA joints à un domaine, consultez la section Authentification Windows sur Amazon EKS Windowspods sur le blog. AWS

  • Amazon EKS propose un plug-in qui permet aux nœuds Windows non joints à un domaine de récupérer les informations d’identification gMSA avec une identité utilisateur portable. Pour plus d'informations sur le GMSA sans domaine, consultez Authentification Windows sans domaine pour Amazon EKS Windowspods sur le blog. AWS

Images de conteneur en cache

Les AMI optimisées pour Amazon EKS Windows ont certaines images de conteneur mises en cache pour l’exécution containerd. Les images de conteneurs sont mises en cache lors de la création d'AMI personnalisées à l'aide de composants de Amazon-managed génération. Pour plus d’informations, consultez Utilisation du composant de génération géré par Amazon.

Les images de conteneur mises en cache suivantes sont destinées à l'exécution containerd :

  • amazonaws.com/eks/pause-windows

  • mcr.microsoft.com/windows/nanoserver

  • mcr.microsoft.com/windows/servercore

Instantané CIMFS

Les AMI Amazon EKS-optimized Windows Server 2025 prennent en charge le containerd snapshotter CimFS (Composite Image File System), comme décrit sur le site Web Microsoft Learn. CIMFS stocke les couches d'images de conteneur sous forme d'.cimarchives, ce qui peut réduire les temps d'extraction des images à froid pour les grandes images de conteneur Windows.

CIMFS est une fonctionnalité optionnelle. Il est disponible uniquement sur les AMI Amazon EKS-optimized Windows Server 2025 (Core et Full) pour les versions 1.35 Kubernetes et ultérieures. CIMFS est désactivé par défaut.

Version requise pour Windows Server

CIMFS est uniquement pris en charge sur Windows Server 2025 (build 26100) et versions ultérieures. Son activation n'a aucun effet sur les versions antérieures de Windows Server car la containerd configuration CIMFS n'est pas présente dans ces AMI.

L'AMI fournit une configuration CIMFS prédéfinie (config-cimfs.toml) en plus de la containerd configuration par défaut. Lorsque vous activez CIMFS, le script d'amorçage permute la configuration CIMFS, redémarre et met à nouveau en cache les images de pause et de conteneur de containerd base à l'aide du snapshotter CIMFS.

Pour activer CIMF pour un nœud, utilisez l'une des méthodes suivantes (voirParamètres de configuration du script d'amorçage) :

  • Passez le -EnableCimFS commutateur au script Start-EKSBootstrap.ps1 bootstrap.

  • Définissez la variable d'environnement définie EKS_ENABLE_CIMFS par la machine sur true ou 1 avant l'exécution du script d'amorçage.

L'exemple suivant montre comment activer les CIMF à partir des données utilisateur du modèle de lancement :

<powershell>
[string]$EKSBootstrapScriptFile = "$env:ProgramFiles\Amazon\EKS\Start-EKSBootstrap.ps1"
& $EKSBootstrapScriptFile -EKSClusterName "my-cluster" -EnableCimFS 3>&1 4>&1 5>&1 6>&1
</powershell>

La redirection de flux (3>&1 4>&1 5>&1 6>&1) vous permet de voir l'avertissement, la description, le débogage et les informations du script d'amorçage dans le journal des données utilisateur de l'instance à des fins de dépannage.

En savoir plus

Pour plus d’informations sur l’utilisation des AMI Windows optimisées pour Amazon EKS, consultez les sections suivantes :