Mengakses penyimpanan persisten

Halaman ini menjelaskan cara membuat dan mengelola penyimpanan persisten untuk workload kontainer di sovereign universe air-gapped Google Distributed Cloud (GDC) Anda. Penyimpanan persisten memberikan identitas yang konsisten dan nama host yang stabil untuk aplikasi Anda, terlepas dari tempat workload-nya dijadwalkan.

Halaman ini ditujukan bagi developer dalam grup operator aplikasi, yang bertanggung jawab membuat workload aplikasi untuk organisasi mereka. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Audiens untuk GDC yang terisolasi dari internet.

Sebelum memulai

Untuk menjalankan perintah terhadap cluster Kubernetes, pastikan Anda memiliki resource berikut:

  1. Temukan nama cluster Kubernetes, atau tanyakan kepada Administrator Platform Anda nama cluster tersebut.

  2. Login dan buat file kubeconfig untuk cluster Kubernetes jika Anda belum memilikinya.

  3. Gunakan jalur kubeconfig cluster Kubernetes untuk mengganti KUBERNETES_CLUSTER_KUBECONFIG dalam petunjuk ini.

Untuk mendapatkan izin yang diperlukan guna membuat volume persisten, minta Admin IAM Organisasi Anda untuk memberi Anda peran Namespace Admin (namespace-admin) di namespace project Anda.

Membuat volume persisten

Petunjuk berikut menunjukkan cara membuat volume menggunakan GDC standard-rwo StorageClass. Untuk mengetahui informasi selengkapnya tentang resource StorageClass yang tersedia di GDC, lihat Penyimpanan persisten untuk container.

  1. Buat PersistentVolumeClaim dan konfigurasikan dengan mode akses ReadWriteOnce dan kelas penyimpanan standard-rwo:

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: PVC_NAME
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: 10Gi
      storageClassName: standard-rwo
    EOF
    

    Ganti kode berikut:

    • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster.

    • NAMESPACE: namespace project tempat PVC akan dibuat.

    • PVC_NAME: nama objek PersistentVolumeClaim.

  2. Objek PersistentVolume (PV) disediakan secara dinamis. Periksa status PV baru di cluster Kubernetes Anda:

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG
    

    Outputnya mirip dengan hal berikut ini:

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
    pvc-uuidd  10Gi       RWO            Bound       pvc-name  standard-rwo   60s
    
  3. Konfigurasi workload container Anda untuk menggunakan PVC. Berikut adalah contoh pod nginx yang menggunakan PVC standard-rwo:

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: apps/v1
    kind: Pod
    metadata:
      name: web-server-deployment
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: PVC_NAME
    EOF
    

    Ganti PVC_NAME dengan PVC yang Anda buat.

Memperluas kapasitas volume

Untuk meningkatkan kapasitas objek PersistentVolumeClaim, perbarui kolom spec.resources.storage ke kapasitas baru. Ukuran volume maksimum yang didukung adalah 14,5 Ti.

  1. Perbarui volume ke ukuran yang lebih besar dalam file manifes objek PersistentVolumeClaim:

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: PVC_NAME
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: VOLUME_STORAGE_SIZE
    EOF
    

    Ganti kode berikut:

    • KUBERNETES_CLUSTER_KUBECONFIG: file kubeconfig untuk cluster.

    • NAMESPACE: namespace project tempat resource PVC berada.

    • PVC_NAME: nama PVC yang ukuran penyimpanannya akan Anda tingkatkan.

    • VOLUME_SNAPSHOT_SIZE: jumlah ukuran penyimpanan yang akan ditingkatkan, seperti 50Gi.

  2. Periksa status PV yang diupdate di cluster Anda:

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG
    

Langkah berikutnya