Mengakses penyimpanan persisten

Penyimpanan persisten di Google Distributed Cloud (GDC) dengan air gap memungkinkan Anda mempertahankan data container secara independen dari siklus proses pod. Anda dapat mengklaim volume dengan resource PersistentVolumeClaim (PVC) dan memperluas kapasitas untuk mempertahankan status di seluruh mulai ulang dan penjadwalan ulang.

Dokumen ini ditujukan bagi developer dalam grup operator aplikasi yang membuat workload untuk organisasi mereka. Untuk mengetahui informasi selengkapnya, lihat Audiens untuk dokumentasi GDC dengan air gap.

Sebelum memulai

Untuk menyelesaikan tugas dalam dokumen ini, Anda harus meminta izin yang diperlukan dan menyiapkan lingkungan Anda.

Meminta peran IAM

Anda harus memiliki peran tertentu untuk mendapatkan izin yang diperlukan untuk mengakses penyimpanan persisten. Peran yang Anda perlukan bergantung pada apakah Anda bekerja dalam cluster bersama yang tercakup dalam organisasi atau cluster standar yang tercakup dalam project. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi cluster Kubernetes.

Peran cluster bersama

Untuk membuat, menghapus, mengedit, atau melihat persistent volume di cluster bersama, minta Admin Project IAM Anda untuk memberi Anda peran Namespace Admin (namespace-admin). Peran ini terikat ke namespace project Anda.

Peran cluster standar

Untuk membuat, menghapus, mengedit, atau melihat persistent volume di cluster standar, minta Admin Project IAM Anda untuk memberi Anda peran Cluster Developer (cluster-developer). Peran ini terikat ke namespace project Anda.

Menyiapkan lingkungan Anda

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

  • Temukan nama cluster Kubernetes, atau tanyakan kepada anggota grup administrator platform apa nama clusternya.

  • Login dan buat file kubeconfig untuk cluster Kubernetes.

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

Membuat volume persisten

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

  1. Buat resource PersistentVolumeClaim (PVC) dan konfigurasikan dengan mode akses ReadWriteOnce dan class 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 tempat membuat PVC. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, namespace-nya bisa apa saja.

    • PVC_NAME: nama objek PersistentVolumeClaim.

  2. Pastikan objek PVC tersedia:

    kubectl get pvc --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE

    Outputnya mirip dengan hal berikut ini:

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
pvc-uuid   10Gi       RWO            Bound       pvc-name  standard-rwo   60s

  3. Konfigurasikan 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: 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 tempat resource PVC berada. Untuk cluster bersama, ini harus berupa namespace project. Untuk cluster standar, namespace-nya dapat berupa namespace apa pun.

    • 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