Utilizzare i dischi permanenti con più lettori

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

Per saperne di più su questa modalità, consulta Modalità di accesso ai volumi permanenti.

Requisiti

Formatta e popola 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 PersistentVolume 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. Quando il pod viene avviato, assicurati che scriva i dati che vuoi sul disco.

Crea un PersistentVolume ReadOnlyMany

Puoi creare un PersistentVolume ReadOnlyMany utilizzando uno dei seguenti metodi:

  • Uno snapshot del volume di un PersistentVolume di origine che viene compilato 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 i dati.

Snapshot 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 all'importo richiesto in PersistentVolumeClaim di origine.

  3. Applica il manifest al cluster:

    kubectl apply -f snapshot-pvc.yaml

Viene creata una nuova PersistentVolumeClaim denominata 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 del volume

Prima di utilizzare la clonazione del volume, assicurati di acquisire familiarità con 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 di PersistentVolumeClaim di origine compilato con i dati.
    • STORAGE_CLASS_NAME: la classe di archiviazione per il nuovo PersistentVolumeClaim. Deve corrispondere 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 da PersistentVolumeClaim di origine.

  2. Applica il manifest al cluster:

    kubectl apply -f cloning-pvc.yaml

In questo modo 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, vedi 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 della nuova StorageClass.
    • DISK_SIZE: le dimensioni del disco permanente preesistente. Ad esempio, 500G.
    • PVC_NAMESPACE: lo spazio dei nomi del nuovo PersistentVolumeClaim
    • PVC_NAME: il nome della nuova PersistentVolumeClaim.
    • DISK_ID: l'identificatore del disco permanente preesistente. Il formato è projects/{project_id}/zones/{zone_name}/disks/{disk_name} per i dischi permanenti a livello di zona o projects/{project_id}/regions/{region_name}/disks/{disk_name} per i 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 modificarlo in NTFS.

  2. Applica il manifest al cluster:

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

Vengono creati 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.

Utilizza 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 nelle sezioni volumeMounts e volumes, come nel seguente esempio:

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