Utilizzare i dischi permanenti con più lettori

Questa pagina spiega come aggiungere un disco permanente al tuo cluster utilizzando la modalità di accesso ReadOnlyMany. Questa modalità consente a più pod su diversi nodes di montare il disco per la lettura.

Per ulteriori informazioni su questa modalità, consulta le modalità di accesso ai volumi permanenti.

Requisiti

Formatta e compila un disco permanente di origine

Per utilizzare un disco permanente in modalità di sola lettura, devi compilare un disco permanente di origine con i dati, quindi clonare il volume o utilizzare uno snapshot del volume per spostare i dati in un nuovo volume permanente ReadOnlyMany.

  1. Crea un PersistentVolume utilizzando un disco permanente esistente o utilizzando il provisioning dinamico.

  2. Formatta il disco e compilalo con i dati. Per formattare il disco, fai riferimento al disco come PersistentVolume ReadWriteOnce in un pod. GKE formatta automaticamente il disco sottostante e consente al pod di scrivere dati sul disco. All'avvio del pod, assicurati che scriva i dati che vuoi sul disco.

Crea un ReadOnlyMany PersistentVolume

Puoi creare un ReadOnlyMany PersistentVolume utilizzando uno dei seguenti metodi:

  • Uno snapshot del volume di un PersistentVolume di origine che completi con i dati.
  • Un clone del volume di un PersistentVolume di origine che viene compilato con i dati.

  • Un disco permanente preesistente già compilato con dati.

Istantanea del volume

  1. Crea uno snapshot del volume del PersistentVolume di origine.

  2. Salva il seguente manifest PersistentVolumeClaim come snapshot-pvc.yaml:

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  namespace: PVC_NAMESPACE
  name: PVC_NAME
spec:
  dataSource:
    apiGroup: snapshot.storage.k8s.io
    kind: VolumeSnapshot
    name: SNAPSHOT_NAME
  accessModes:
    - ReadOnlyMany
  storageClassName: premium-rwo
  resources:
    requests:
      storage: STORAGE_SIZE

    Sostituisci quanto segue:

    • PVC_NAMESPACE: lo spazio dei nomi del nuovo PersistentVolumeClaim.
    • PVC_NAME: il nome del nuovo PersistentVolumeClaim.
    • SNAPSHOT_NAME:il nome dell'oggetto VolumeSnapshot.
    • STORAGE_SIZE: la quantità di spazio di archiviazione da richiedere. Deve corrispondere alla quantità richiesta nell'attributo PersistentVolumeClaim di origine.

  3. Applica il manifest al cluster:

    kubectl apply -f snapshot-pvc.yaml

Viene creato un nuovo PersistentVolumeClaim denominato PVC_NAME nel cluster, che GKE utilizza per eseguire il provisioning dinamico di un nuovo PersistentVolume che contiene i dati dello snapshot del disco permanente di origine.

Clonazione dei volumi

Prima di utilizzare la clonazione dei volumi, assicurati di conoscere i limiti di questo approccio.

  1. Salva il seguente manifest come cloning-pvc.yaml:

    kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  namespace: PVC_NAMESPACE
  name: PVC_NAME
spec:
  dataSource:
    name: SOURCE_PVC
    kind: PersistentVolumeClaim
  accessModes:
    - ReadOnlyMany
  storageClassName: STORAGE_CLASS_NAME
  resources:
    requests:
      storage: STORAGE_SIZE

    Sostituisci quanto segue:

    • PVC_NAMESPACE: lo spazio dei nomi del nuovo PersistentVolumeClaim.
    • PVC_NAME: il nome del nuovo PersistentVolumeClaim.
    • SOURCE_PVC: il nome del PersistentVolumeClaim di origine compilato con i dati.
    • STORAGE_CLASS_NAME: la classe di archiviazione per il nuovo PersistentVolumeClaim. Deve essere uguale alla classe di archiviazione del PersistentVolumeClaim di origine.
    • STORAGE_SIZE: la quantità di spazio di archiviazione per il nuovo PersistentVolumeClaim. Deve essere lo stesso importo richiesto dal claim volume persistente di origine.

  2. Applica il manifest al cluster:

    kubectl apply -f cloning-pvc.yaml

Viene creato un PersistentVolumeClaim denominato PVC_NAME che GKE utilizza per creare un nuovo PersistentVolume in modalità ReadOnlyMany con i dati nel PersistentVolume di origine.

Per informazioni più dettagliate sulla clonazione dei volumi, consulta Creare cloni di volumi permanenti.

Disco permanente preesistente

  1. Salva il seguente manifest come preexisting-disk-pv-pvc.yaml:

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: PV_NAME
spec:
  storageClassName: "STORAGE_CLASS_NAME"
  capacity:
    storage: DISK_SIZE
  accessModes:
    - ReadOnlyMany
  claimRef:
    namespace: PVC_NAMESPACE
    name: PVC_NAME
  csi:
    driver: pd.csi.storage.gke.io
    volumeHandle: DISK_ID
    fsType: FS_TYPE
    readOnly: true
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  namespace: PVC_NAMESPACE
  name: PVC_NAME
spec:
  storageClassName: "STORAGE_CLASS_NAME"
  volumeName: PV_NAME
  accessModes:
    - ReadOnlyMany
  resources:
    requests:
      storage: DISK_SIZE

    Sostituisci quanto segue:

    • PV_NAME: il nome del nuovo PersistentVolume.
    • STORAGE_CLASS_NAME: il nome del nuovo StorageClass.
    • DISK_SIZE: le dimensioni del disco preesistente permanente. Ad esempio, 500G.
    • PVC_NAMESPACE: lo spazio dei nomi del nuovo PersistentVolumeClaim.
    • PVC_NAME: il nome del nuovo PersistentVolumeClaim.
    • DISK_ID: l'identificatore del disco preesistente permanente. Il formato è projects/{project_id}/zones/{zone_name}/disks/{disk_name} per dischi permanenti a livello di zona o projects/{project_id}/regions/{region_name}/disks/{disk_name} per dischi permanenti a livello di regione.
    • FS_TYPE: il tipo di file system. Puoi lasciare il valore predefinito (ext4) o utilizzare xfs. Se i tuoi cluster utilizzano un pool di nodi Windows Server, devi impostare questo valore su NTFS.

  2. Applica il manifest al cluster:

    kubectl apply -f preexisting-disk-pv-pvc.yaml

Viene creato un PersistentVolumeClaim denominato PVC_NAME e un PersistentVolume denominato PV_NAME in modalità ReadOnlyMany.

Per informazioni più dettagliate sull'utilizzo di un disco permanente preesistente, consulta disco permanente esistente.

Utilizzare PersistentVolumeClaim in un pod

Ora puoi fare riferimento al nuovo PersistentVolumeClaim in modalità di sola lettura in più pod su più nodi contemporaneamente. Non puoi collegare dischi permanenti in modalità ReadWriteOnce a più nodi contemporaneamente. Per ulteriori informazioni, consulta Deployment e StatefulSet.

Nella specifica del pod, devi specificare readOnly: true nella sezione volumeMounts e nella sezione volumes, come nell'esempio seguente:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: multi-read
  labels:
    app: web-server
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web-server
  template:
    metadata:
      labels:
        app: web-server
    spec:
      containers:
      - name: web-server
        image: nginx
        volumeMounts:
        - mountPath: /test-mnt
          name: my-volume
          readOnly: true
      volumes:
      - name: my-volume
        persistentVolumeClaim:
          claimName: PVC_NAME
          readOnly: true

Passaggi successivi