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éation d’une classe de stockage

Une StorageClass dans le mode automatique Amazon EKS définit la façon dont les volumes Amazon EBS sont automatiquement provisionnés lorsque les applications demandent du stockage persistant. Cette page explique comment créer et configurer une StorageClass compatible avec le mode automatique Amazon EKS pour le provisionnement de volumes EBS.

En configurant une StorageClass, vous pouvez définir les paramètres par défaut de vos volumes EBS, notamment le type de volume, le chiffrement, le nombre d’IOPS et d’autres paramètres liés au stockage. Vous pouvez également configurer l'utilisation StorageClass des clés AWS KMS pour la gestion du chiffrement.

Le mode automatique EKS ne crée pas de StorageClass pour vous. Vous devez créer une StorageClass faisant référence à ebs.csi.eks.amazonaws.com pour utiliser les fonctionnalités de stockage du mode automatique EKS.

Tout d’abord, créez un fichier nommé storage-class.yaml :

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: auto-ebs-sc
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
allowedTopologies:
- matchLabelExpressions:
  - key: eks.amazonaws.com/compute-type
    values:
    - auto
provisioner: ebs.csi.eks.amazonaws.com
volumeBindingMode: WaitForFirstConsumer
parameters:
  type: gp3
  encrypted: "true"

Ensuite, appliquez la classe de stockage à votre cluster.

kubectl apply -f storage-class.yaml

Composants clés :

Utilisation d’une clé KMS autogérée pour chiffrer les volumes EBS

Pour utiliser une clé KMS autogérée afin de chiffrer des volumes EBS automatisés par le mode automatique EKS, vous devez :

Exemple de politique IAM KMS autogérée

Mettez à jour les valeurs suivantes dans la politique ci-dessous :

{
  "Version":"2012-10-17",
  "Id": "key-auto-policy-3",
  "Statement": [
      {
          "Sid": "Enable IAM User Permissions",
          "Effect": "Allow",
          "Principal": {
              "AWS": "arn:aws:iam::123456789012:root"
          },
          "Action": "kms:*",
          "Resource": "*"
      },
      {
        "Sid": "Allow access through EBS for all principals in the account that are authorized to use EBS",
        "Effect": "Allow",
        "Principal": {
            "AWS": "*"
        },
        "Action": [
            "kms:Encrypt",
            "kms:Decrypt",
            "kms:ReEncrypt*",
            "kms:GenerateDataKey*",
            "kms:CreateGrant",
            "kms:DescribeKey"
        ],
        "Resource": "*",
        "Condition": {
            "StringEquals": {
                "kms:CallerAccount": "123456789012",
                "kms:ViaService": "ec2.us-east-1.amazonaws.com"
            }
        }
    }
  ]
}

Exemple de StorageClass KMS autogérée

parameters:
  type: gp3
  encrypted: "true"
  kmsKeyId: <custom-key-arn>

Référence des paramètres StorageClass

Pour des informations générales sur les ressources StorageClass de Kubernetes, consultez Classes de stockage dans la documentation Kubernetes.

La parameters section de la StorageClass ressource est spécifique à AWS. Utilisez le tableau ci-dessous pour consulter les options disponibles.

Pour plus d'informations, consultez le pilote AWS EBS CSI sur. GitHub

Considérations

La capacité de stockage par blocs du mode automatique EKS est différente de celle du pilote CSI EBS.

Migrer de volume-modifier-for-k8s vers VolumeAttributesClass

Pour les clusters EKS Auto Mode exécutant Kubernetes 1.34 ou version ultérieure, utilisez un VolumeAttributesClass (VAC) pour modifier le type, les IOPS ou le débit d'un volume EBS.

Les PVC existants peuvent être migrés sur place en créant un VAC et en réglant spec.volumeAttributesClassName le PVC existant. Le PVC et le PV ne sont pas recréés et vos charges de travail ne sont pas interrompues au cours de ce processus.

Facultatif : supprimez les annotations VMK

Il n'est pas nécessaire de supprimer les anciennes annotations pour que VAC fonctionne. Une fois qu'un PVC ou un PV fait référence à un VAC, VMK refuse les modifications basées sur des annotations et VAC est la voie faisant autorité.

Les annotations peuvent être supprimées ultérieurement lors du nettoyage de la configuration. S'ils sont supprimés, mettez également à jour tout Helm ou toute autre automatisation qui les ajouterait à nouveau. GitOps Les annotations d'état de la VMK laissées sur le PV sont inoffensives et n'ont pas besoin d'être supprimées.

Modifier ou rétablir les paramètres

Les paramètres VAC sont immuables. Pour modifier la configuration EBS, créez un autre VAC et attribuez son nom au PVC.

Pour annuler une modification qui n'est pas terminée, restaurez le VAC précédemment attribué. Si le PVC n'en utilisait pas auparavant, effacez le champ :

kubectl patch pvc <pvc-name> -n <namespace> --type=merge \
  -p '{"spec":{"volumeAttributesClassName":null}}'

La suppression du champ n'annule pas une modification EBS déjà effectuée. Pour rétablir les paramètres de volume précédents, créez un VAC contenant ces paramètres et attribuez-le au PVC. Les contraintes normales des paramètres EBS et les temps de recharge des modifications s'appliquent.

Installation du module complémentaire CSI Snapshot Controller

Le mode automatique EKS est compatible avec le module complémentaire Amazon EKS CSI Snapshot Controller.

AWS vous suggère de configurer ce module complémentaire pour qu'il s'exécute sur le pool de system nœuds intégré.

Pour plus d’informations, consultez :

Pour installer le contrôleur d’instantané dans le groupe de nœuds système