Contribuisci a migliorare questa pagina

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Per contribuire a questa guida per l'utente, scegli il GitHub link Modifica questa pagina su che si trova nel riquadro destro di ogni pagina.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una classe di archiviazione

Una StorageClass in Amazon EKS Auto Mode definisce come i volumi Amazon EBS vengono forniti automaticamente quando le applicazioni richiedono uno storage persistente. In questa pagina viene spiegato come creare e configurare una StorageClass che funzioni con Amazon EKS Auto Mode per il provisioning dei volumi EBS.

Configurando una StorageClass, è possibile specificare le impostazioni predefinite per i volumi EBS, inclusi il tipo di volume, la crittografia, gli IOPS e altri parametri di storage. È inoltre possibile configurare l'StorageClassuso delle chiavi AWS KMS per la gestione della crittografia.

EKS Auto Mode non crea una StorageClass per te. Devi creare una StorageClass che faccia riferimento a ebs.csi.eks.amazonaws.com per usare la funzionalità di storage di EKS Auto Mode.

Per prima cosa, crea un file denominato 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"

Poi applica la classe di archiviazione al cluster.

kubectl apply -f storage-class.yaml

Componenti chiave:

Usa la chiave KMS autogestita per crittografare i volumi EBS

Per usare una chiave KMS autogestita per crittografare i volumi EBS automatizzati da EKS Auto Mode, bisogna:

Esempio di policy IAM KMS autogestita

Aggiorna i valori seguenti nella policy riportata di seguito:

{
  "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"
            }
        }
    }
  ]
}

Esempio di StorageClass KMS gestita dal cliente

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

Guida di riferimento per i parametri StorageClass

Per informazioni generali sulle risorse StorageClass di Kubernetes, consulta Storage Classes nella documentazione di Kubernetes.

La parameters sezione della StorageClass risorsa è specifica per AWS. Utilizza la tabella seguente per esaminare le opzioni disponibili.

Per ulteriori informazioni, consultate il driver AWS EBS CSI su. GitHub

Considerazioni

La funzionalità di storage a blocchi di EKS Auto Mode è diversa da quella del driver CSI EBS.

Esegui la migrazione da volume-modifier-for-k8s a VolumeAttributesClass

Per i cluster EKS Auto Mode che eseguono Kubernetes 1.34 o versioni successive, utilizza un (VAC) per modificare il tipo, gli IOPS o il throughput di un VolumeAttributesClass volume EBS.

I PVC esistenti possono essere migrati sul posto creando un VAC e impostandolo sul PVC esistente. spec.volumeAttributesClassName Il PVC e il fotovoltaico non vengono ricreati e non ci sono interruzioni dei carichi di lavoro durante questo processo.

Facoltativo: rimuovere le annotazioni VMK

La rimozione delle vecchie annotazioni non è necessaria per il funzionamento di VAC. Una volta che un PVC o PV fa riferimento a un VAC, VMK rifiuta le modifiche basate sulle annotazioni e VAC è il percorso autorevole.

Le annotazioni possono essere rimosse in un secondo momento durante la pulizia della configurazione. Se vengono rimosse, aggiorna anche qualsiasi Helm o altra automazione che le aggiungerebbe nuovamente. GitOps Le annotazioni di stato VMK lasciate sul PV sono innocue e non devono essere rimosse.

Modifica o ripristino delle impostazioni

I parametri VAC sono immutabili. Per modificare la configurazione EBS, create un altro VAC e assegnatene il nome al PVC.

Per annullare una modifica non completata, ripristina il VAC assegnato in precedenza. Se il PVC non ne ha usato uno in precedenza, cancella il campo:

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

La cancellazione del campo non annulla una modifica EBS già completata. Per ripristinare le impostazioni di volume precedenti, create un VAC contenente tali impostazioni e assegnatelo al PVC. Si applicano i normali vincoli dei parametri EBS e i tempi di recupero delle modifiche.

Installa il componente aggiuntivo CSI Snapshot Controller

EKS Auto Mode è compatibile con il componente aggiuntivo CSI Snapshot Controller di Amazon EKS.

AWS suggerisce di configurare questo componente aggiuntivo per l'esecuzione sul pool di nodi integrato. system

Per ulteriori informazioni, consulta:

Per installare il controller di snapshot nel pool di nodi di sistema