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 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 guna mengakses penyimpanan persisten. Peran yang Anda perlukan bergantung pada apakah Anda bekerja dalam cluster bersama cakupan organisasi atau cluster standar cakupan project. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi cluster Kubernetes.

Peran cluster bersama

Untuk membuat, menghapus, mengedit, atau melihat volume persisten di cluster bersama, minta Admin IAM Project 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 volume persisten di cluster standar, minta Admin IAM Project 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 nama cluster kepada anggota grup administrator platform.

  • 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 standard-rwo StorageClass 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 dapat berupa namespace apa pun.

    • PVC_NAME: nama objek PersistentVolumeClaim.

  2. Konfirmasi bahwa 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. 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: 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