Mengoptimalkan penyimpanan dengan Multishare Filestore untuk GKE

Panduan ini menunjukkan cara menggunakan multishare Filestore untuk Google Kubernetes Engine dengan driver CSI GKE Filestore.

Sebelum memulai

  1. Sebelum memulai, selesaikan langkah-langkah penyiapan yang diperlukan untuk menggunakan Filestore.

  2. Aktifkan driver CSI GKE Filestore, versi 1.23 atau yang lebih baru:

    • Driver versi 1.23 hingga 1.26 mendukung hingga 10 kali berbagi per instance.

    • Driver versi 1.27 atau yang lebih baru mendukung hingga 80 berbagi per instance.

Menggunakan multishare Filestore dengan beberapa aplikasi

Bagian ini menunjukkan cara men-deploy dua aplikasi, satu Deployment dan satu Statefulset, yang masing-masing menggunakan StorageClass multishare Filestore. Anda juga akan melihat bagaimana GKE melakukan bin packing (proses untuk mengemas aplikasi ke dalam node GKE secara efisien) pada semua volume di dalam instance perusahaan Filestore yang sama yang mendasarinya.

  1. Gunakan StorageClass yang disediakan GKE, enterprise-multishare-rwx, untuk membuat instance yang mendukung hingga 10 aktivitas berbagi.

    • Jika ingin membuat instance yang mendukung hingga 80x bersama, Anda harus membuat StorageClass kustom. Untuk tujuan panduan ini, Anda akan menggunakan StorageClass dengan batas sepuluh kali berbagi per instance.

    Setelah driver CSI GKE Filestore diaktifkan, pengguna dapat mengakses StorageClass multishare yang disediakan GKE, yaitu enterprise-multishare-rwx, dengan konfigurasi berikut. Dengan mereferensikan StorageClass ini, driver CSI GKE Filestore menggunakan penyediaan volume dinamis guna membuat Volume Persisten (PV) secara otomatis untuk Klaim Volume Persisten (PVC) baru sesuai dengan permintaan workload GKE:

    kubectl describe sc enterprise-multishare-rwx
    Name:                  enterprise-multishare-rwx
    IsDefaultClass:        No
    Annotations:           components.gke.io/component-name=filestorecsi,components.gke.io/component-version=0.7.2,components.gke.io/layer=addon
    Provisioner:           filestore.csi.storage.gke.io
    Parameters:            instance-storageclass-label=enterprise-multishare-rwx,multishare=true,tier=enterprise
    AllowVolumeExpansion:  True
    MountOptions:          <none>
    ReclaimPolicy:         Delete
    VolumeBindingMode:     WaitForFirstConsumer
    Events:                <none>
    

Membuat StorageClass kustom

Jika Anda ingin memanfaatkan batas kapasitas terbaru hingga 80 kali berbagi per instance Filestore, buat StorageClass kustom berdasarkan template berikut:

  apiVersion: storage.k8s.io/v1
  kind: StorageClass
  metadata:
    name: csi-filestore-multishare-128
  provisioner: filestore.csi.storage.gke.io
  parameters:
    tier: enterprise
    multishare: "true"
    max-volume-size: "128Gi"
    network: default
  allowVolumeExpansion: true

Saat mengganti nama StorageClass, pertimbangkan persyaratan berikut:

  • Nama StorageClass harus berupa nama subdomain DNS yang valid.

  • Nama StorageClass multishare juga digunakan sebagai label instance dan harus mengikuti panduan penamaan label.

  • Jika aplikasi Anda memerlukan penyediaan volume langsung, sertakan mode binding volume Immediate:

    volumeBindingMode: Immediate

    Misalnya, gunakan spesifikasi ini jika Anda tidak ingin penyediaan volume bergantung pada pembuatan pod di cluster GKE.

  • Mulai versi driver 1.27, jika Anda ingin menetapkan lebih dari 10 kali berbagi per instance, sertakan parameter max-volume-size dan tetapkan salah satu nilai yang diterima dari kolom pertama pada parameter tersebut:

    Ukuran volume maksimum (ukuran pembagian) Jumlah maksimum pembagian per instance
    128 GiB 80
    256 GiB 40
    512 GiB 20
    1024 GiB 10

    Jadi, misalnya, menambahkan pasangan nilai kunci max-volume-size: "128Gi" memastikan bahwa StorageClass memetakan hingga 80 kali berbagi—masing-masing berukuran mulai dari 10 GiB hingga 128 GiB—ke dalam satu instance tingkat perusahaan sebesar 10 TiB.

    • Kemampuan ini merupakan kompatibilitas mundur dengan instance Filestore yang dibuat oleh driver CSI GKE Filestore versi 1.23 hingga 1.26.

    • Instance yang sudah ada dapat membuat PVC atau berbagi baru, dengan ukuran berbagi minimum yang diperluas sebesar 10 GiB.

    • Driver CSI GKE Filestore versi 1.27 mengenali instance perusahaan lama dan menetapkan ukuran berbagi maksimum default sebesar 1024 GiB (1 TiB). Akibatnya, instance lama dibatasi jumlah maksimum berbaginya menjadi 10 kali berbagi per instance.

    Untuk mengetahui informasi selengkapnya, silakan melihat Multishare Filestore untuk GKE.

  1. Membuat Deployment dengan beberapa replika pod menggunakan satu PVC.

    Buat file konfigurasi YAML yang mirip dengan berikut ini:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: web-server-multishare
      labels:
        app: nginx
    spec:
      replicas: 5
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: nginx
            volumeMounts:
            - mountPath: /usr/share/nginx/html
              name: mypvc
          volumes:
          - name: mypvc
            persistentVolumeClaim:
              claimName: test-pvc-fs
    ---
    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: test-pvc-fs
    spec:
      accessModes:
        - ReadWriteMany
      storageClassName: enterprise-multishare-rwx
      resources:
        requests:
          storage: 100Gi
    
    EOF
    
  2. Memeriksa replika pod.

    a. Dari command line, jalankan perintah berikut untuk memeriksa status PVC:

    kubectl get pvc
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
    test-pvc-fs   Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx  35m
    

    b. Dari command line, jalankan perintah berikut untuk memeriksa status pod:

    kubectl get pod
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                                     READY   STATUS    RESTARTS   AGE
    web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          35m
    web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          35m
    web-server-multishare-76c9ffb4b5-csdbd   1/1     Running   0          35m
    web-server-multishare-76c9ffb4b5-rgx82   1/1     Running   0          35m
    web-server-multishare-76c9ffb4b5-zjl27   1/1     Running   0          35m
    
  3. Menskalakan replika.

    a. Dari command line, jalankan perintah berikut untuk mengedit Deployment:

    kubectl edit deployment web-server-multishare
    

    b. File akan terbuka di command line. Temukan kolom spec.replicas dan perbarui nilai ke 10.

    c. Dari command line, jalankan perintah berikut untuk melihat perubahan yang diterapkan:

    kubectl get pod
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                                     READY   STATUS    RESTARTS   AGE
    web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          36m
    web-server-multishare-76c9ffb4b5-5ctkf   1/1     Running   0          3s
    web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          36m
    web-server-multishare-76c9ffb4b5-8dwmw   1/1     Running   0          2s
    web-server-multishare-76c9ffb4b5-csdbd   1/1     Running   0          36m
    web-server-multishare-76c9ffb4b5-lndcq   1/1     Running   0          2s
    web-server-multishare-76c9ffb4b5-rgx82   1/1     Running   0          36m
    web-server-multishare-76c9ffb4b5-vtd6p   1/1     Running   0          3s
    web-server-multishare-76c9ffb4b5-xm49s   1/1     Running   0          3s
    web-server-multishare-76c9ffb4b5-zjl27   1/1     Running   0          36m
    

    Perhatikan bahwa ada 10 pod yang sedang berjalan.

    d. Pada command line, jalankan perintah berikut:

    kubectl get deployment
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
    web-server-multishare   10/10   10           10          36m
    

    e. Dari command line, jalankan perintah berikut untuk memeriksa status terikat PVC:

    kubectl get pvc
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
    test-pvc-fs   Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx  37m
    

    f. Dari command line, jalankan perintah berikut untuk mengedit Deployment:

    kubectl edit deployment web-server-multishare
    

    g. File akan terbuka di command line. Temukan kolom spec.replicas dan perbarui nilai ke 2.

    h. Dari command line, jalankan perintah berikut untuk melihat perubahan yang diterapkan:

    kubectl get pod
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                                     READY   STATUS    RESTARTS   AGE
    web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          38m
    web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          38m
    
  4. Men-deploy Statefulset.

    Deploy aplikasi kedua yang menggunakan instance Filestore yang sama sebagai dasarnya.

    Untuk melakukannya, sediakan ruang sebesar 200 GiB dan pastikan bahwa aplikasi tersebut menggunakan instance Filestore yang mendasari yang sama dengan aplikasi pertama.

    Anda kemudian akan menskalakan aplikasi ke sembilan replika dengan total 900 GiB (9 replika masing-masing menggunakan 100 GiB) dan memastikan bahwa GKE menggunakan instance Filestore yang sama dengan membagikan instance tersebut.

    Buat file konfigurasi YAML yang mirip dengan berikut ini:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: apps/v1
    kind: StatefulSet
    metadata:
      name: web
    spec:
      serviceName: "nginx"
      replicas: 2
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: registry.k8s.io/nginx-slim:0.8
            ports:
            - containerPort: 80
              name: web
            volumeMounts:
            - name: test-pvc-multishare
              mountPath: /usr/share/nginx/html
      volumeClaimTemplates:
      - metadata:
          name: test-pvc-multishare
        spec:
          accessModes: [ "ReadWriteMany" ]
          storageClassName: enterprise-multishare-rwx
          resources:
            requests:
              storage: 100Gi
    
    EOF
    
    
  5. Periksa replika dan volume Statefulset.

    Pada command line, jalankan perintah berikut:

    kubectl get pod
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                                     READY   STATUS    RESTARTS   AGE
    web-0                                    1/1     Running   0          4m48s
    web-1                                    1/1     Running   0          3m32s
    web-server-multishare-76c9ffb4b5-2dhml   1/1     Running   0          57m
    web-server-multishare-76c9ffb4b5-7mtcb   1/1     Running   0          57m
    

    Perhatikan bahwa dua pod pertama yang terkait dengan Statefulset. Dua pod terakhir yang terkait dengan Deployment.

    Pada command line, jalankan perintah berikut:

    kubectl get statefulset
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME   READY   AGE
    web    2/2     2m8s
    

    Pada command line, jalankan perintah berikut:

    kubectl get pvc
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
    test-pvc-fs                 Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx   54m
    test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   100Gi      RWX            enterprise-multishare-rwx   114s
    test-pvc-multishare-web-1   Bound    pvc-8b37cd6e-d764-4d38-80d7-d74228536cfe   100Gi      RWX            enterprise-multishare-rwx   38s
    

    PVC test-pvc-fs terkait dengan Deployment web-server-multishare.

    PVC test-pvc-multishare-web-0 dan test-pvc-multishare-web-1 terkait dengan Statefulset.

  6. Menskalakan replika Statefulset.

    Tingkatkan jumlah replika menjadi sembilan. Saat jumlahnya meningkat, PVC yang sesuai akan dibuat.

    a. Pada command line, jalankan perintah berikut:

    kubectl  edit statefulset web
    

    b. File akan terbuka di command line. Temukan kolom spec.replicas dan perbarui nilai ke 9.

    c. Dari command line, jalankan perintah berikut untuk melihat perubahan yang diterapkan:

    kubectl get statefulset
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME   READY   AGE
    web    9/9     13m
    

    d. Pada command line, jalankan perintah berikut:

    kubectl get deployment
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
    web-server-multishare   2/2     2            2           65m
    

    e. Pada command line, jalankan perintah berikut:

    kubectl get pvc
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
    test-pvc-fs                 Bound    pvc-056d769d-a709-4bb2-b6d3-0361871b27a2   100Gi      RWX            enterprise-multishare-rwx   65m
    test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   100Gi      RWX            enterprise-multishare-rwx   13m
    test-pvc-multishare-web-1   Bound    pvc-8b37cd6e-d764-4d38-80d7-d74228536cfe   100Gi      RWX            enterprise-multishare-rwx   12m
    test-pvc-multishare-web-2   Bound    pvc-3fcbd132-939f-4364-807a-7c8ac6a3e64e   100Gi      RWX            enterprise-multishare-rwx   5m12s
    test-pvc-multishare-web-3   Bound    pvc-5894afa5-2502-4ee7-9d5c-b7378cb85479   100Gi      RWX            enterprise-multishare-rwx   4m57s
    test-pvc-multishare-web-4   Bound    pvc-ebbe452b-bc8f-4624-a830-a2094cce0d67   100Gi      RWX            enterprise-multishare-rwx   4m36s
    test-pvc-multishare-web-5   Bound    pvc-5a73a698-d174-44cb-a3a1-e767966c3417   100Gi      RWX            enterprise-multishare-rwx   4m20s
    test-pvc-multishare-web-6   Bound    pvc-102da6a9-2ca6-4f9e-9896-8fe14709db7a   100Gi      RWX            enterprise-multishare-rwx   3m55s
    test-pvc-multishare-web-7   Bound    pvc-160e81cd-c5bf-4ae6-966e-518e8249e02d   100Gi      RWX            enterprise-multishare-rwx   3m38s
    test-pvc-multishare-web-8   Bound    pvc-9b52d773-2e9a-40de-881c-dc06945ba3d7   100Gi      RWX            enterprise-multishare-rwx   118s
    
  7. Memverifikasi status instance Filestore.

    Sekarang Anda memiliki Deployment dengan dua pod replika, serta Statefulset dengan sembilan pod replika, dan total 10 PVC, masing-masing berukuran 100 GiB. Semua volume dikemas ke dalam satu instance multishare Filestore.

    a. Dari command line, jalankan perintah instances list berikut:

    gcloud beta filestore instances list --project=YOUR_PROJECT_ID --region=REGION
    

    dengan:

    • YOUR_PROJECT_ID adalah nama project yang digunakan. Misalnya, my-project.

    • REGION adalah nama region yang digunakan. Misalnya, us-central1.

    Anda akan melihat respons yang mirip dengan berikut ini:

    INSTANCE_NAME                            LOCATION     TIER        CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS   STATE  CREATE_TIME
    fs-a767cef8-738e-4c8e-b70b-09cbb872d016  us-central1  ENTERPRISE  1024         N/A              10.192.53.2  READY  2022-06-21T21:15:30
    

    b. Dari command line, jalankan perintah instances describe berikut:

    gcloud filestore instances describe fs-a767cef8-738e-4c8e-b70b-09cbb872d016 --project=YOUR_PROJECT_ID --region=REGION
    capacityGb: '1024'
    capacityStepSizeGb: '256'
    createTime: '2022-06-21T21:15:30.464237089Z'
    labels:
      storage_gke_io_created-by: filestore_csi_storage_gke_io
      storage_gke_io_storage-class-id: enterprise-multishare-rwx
    maxCapacityGb: '10240'
    maxShareCount: '10'
    multiShareEnabled: true
    name: projects/YOUR_PROJECT_ID/locations/REGION/instances/fs-a767cef8-738e-4c8e-b70b-09cbb872d016
    networks:
    - connectMode: DIRECT_PEERING
      ipAddresses:
      - 10.192.53.2
      modes:
      - MODE_IPV4
      network: csi-filestore-test-network
      reservedIpRange: 10.192.53.0/26
    state: READY
    tier: ENTERPRISE
    
    

    dengan:

    • YOUR_PROJECT_ID adalah nama project yang digunakan. Misalnya, my-project.

    • REGION adalah nama region yang digunakan. Misalnya, us-central1.

Memperluas PVC dan memverifikasi instance Filestore

Bagian ini menunjukkan cara memperluas PVC yang ada dan memverifikasi ukuran instance Filestore.

  1. Memperluas PVC.

    PVC—yang didukung oleh berbagi dalam instance multishare Filestore—dapat diperluas hingga ke ukuran maksimum yang ditentukan dalam parameter max-volume-size. Untuk memverifikasinya, luaskan salah satu volume yang terkait dengan Statefulset saat pod sedang menggunakannya.

    Dari command line, jalankan perintah berikut untuk memeriksa ukuran PVC saat ini dari replika 0:

    kubectl get pvc test-pvc-multishare-web-0 -o json
    {
        "apiVersion": "v1",
        "kind": "PersistentVolumeClaim",
        "metadata": {
            "annotations": {
                "pv.kubernetes.io/bind-completed": "yes",
                "pv.kubernetes.io/bound-by-controller": "yes",
                "volume.beta.kubernetes.io/storage-provisioner": "filestore.csi.storage.gke.io",
                "volume.kubernetes.io/storage-provisioner": "filestore.csi.storage.gke.io"
            },
            "creationTimestamp": "2022-06-21T22:07:42Z",
            "finalizers": [
                "kubernetes.io/pvc-protection"
            ],
            "labels": {
                "app": "nginx"
            },
            "name": "test-pvc-multishare-web-0",
            "namespace": "default",
            "resourceVersion": "48395",
            "uid": "7aa21b5a-5343-4547-b7d7-414c16af15a7"
        },
        "spec": {
            "accessModes": [
                "ReadWriteMany"
            ],
            "resources": {
                "requests": {
                    "storage": "100Gi"
                }
            },
            "storageClassName": "enterprise-multishare-rwx",
            "volumeMode": "Filesystem",
            "volumeName": "pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7"
        },
        "status": {
            "accessModes": [
                "ReadWriteMany"
            ],
            "capacity": {
                "storage": "100Gi"
            },
            "phase": "Bound"
        }
    }
    
    
  2. Dari command line, jalankan perintah berikut untuk meningkatkan ukuran menjadi 500 GiB:

    kubectl edit pvc test-pvc-multishare-web-0
    
  3. File akan terbuka di command line. Cari kolom spec.resources.requests.storage dan perbarui nilainya menjadi 500Gi.

  4. Dari command line, jalankan perintah berikut untuk melihat perubahan yang diterapkan:

    kubectl get pvc test-pvc-multishare-web-0
    

    Anda akan melihat respons yang mirip dengan berikut ini:

    NAME                        STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS               AGE
    test-pvc-multishare-web-0   Bound    pvc-7aa21b5a-5343-4547-b7d7-414c16af15a7   500Gi      RWX            enterprise-multishare-rwx   28m
    

    Driver CSI Filestore menerima permintaan tersebut, pertama-tama memperluas instance Filestore yang mendasarinya, lalu memperluas berbagi yang mendukung PVC.

    Khususnya, driver CSI Filestore secara otomatis memperluas instance menjadi 1536 Gi untuk mengakomodasi ukuran berbagi baru, yakni 500Gi.

  5. Dari command line, jalankan perintah instances describe berikut untuk memverifikasi kapasitas instance Filestore:

    gcloud filestore instances describe fs-a767cef8-738e-4c8e-b70b-09cbb872d016 --project=YOUR_PROJECT_ID --region=REGION
    capacityGb: '1536'
    capacityStepSizeGb: '256'
    createTime: '2022-06-21T21:15:30.464237089Z'
    labels:
      storage_gke_io_created-by: filestore_csi_storage_gke_io
      storage_gke_io_storage-class-id: enterprise-multishare-rwx
    maxCapacityGb: '10240'
    maxShareCount: '10'
    multiShareEnabled: true
    name: projects/YOUR_PROJECT_ID/locations/us-central1/instances/fs-a767cef8-738e-4c8e-b70b-09cbb872d016
    networks:
    - connectMode: DIRECT_PEERING
      ipAddresses:
      - 10.192.53.2
      modes:
      - MODE_IPV4
      network: csi-filestore-test-network
      reservedIpRange: 10.192.53.0/26
    state: READY
    tier: ENTERPRISE
    

    dengan:

    • YOUR_PROJECT_ID adalah nama project yang digunakan. Misalnya, my-project.

    • REGION adalah nama region yang digunakan. Misalnya, us-central1.

Penyediaan dinamis di VPC Bersama

Driver CSI Filestore untuk GKE mendukung penyediaan dinamis volume dalam project layanan di VPC bersama. Bagian berikut menunjukkan cara menggunakan driver CSI Filestore untuk menyediakan volume secara dinamis pada instance multishare Filestore dalam project layanan pada Jaringan VPC bersama.

  1. Menyelesaikan langkah penyiapan untuk Jaringan VPC bersama dan akses layanan pribadi.

  2. Membuat StorageClass untuk menyediakan volume secara dinamis yang didukung oleh instance multishare Filestore di VPC bersama.

    Jalankan perintah berikut untuk men-deploy resource StorageClass:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: csi-filestore-multishare-sharedvpc
    provisioner: filestore.csi.storage.gke.io
    parameters:
      network: "projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME"
      connect-mode: PRIVATE_SERVICE_ACCESS
      tier: enterprise
      multishare: "true"
    allowVolumeExpansion: true
    
    EOF
    

    dengan:

    • HOST_PROJECT_ID adalah ID atau nama project host Jaringan VPC bersama. Misalnya, my-host-project.

    • SHARED_VPC_NAME adalah nama Jaringan VPC bersama. Misalnya, my-shared-vpc.

    Jika Anda ingin men-deploy resource dalam rentang alamat IP yang dicadangkan, tambahkan baris berikut ke parameter yang digunakan dalam perintah:

    reserved-ip-range: RESERVED_NAME
    

    Dengan RESERVED_NAME sebagai nama rentang alamat IP yang dicadangkan, tempat instance Filestore dapat disediakan. Contoh, filestore-reserved-ip-range. Jika ditentukan, rentang IP yang dicadangkan harus berupa rentang alamat IP bernama, bukan nilai CIDR langsung.

    Untuk mengetahui informasi selengkapnya, lihat Mengalokasikan rentang alamat IP atau Mengonfigurasi rentang alamat IP yang dicadangkan. Untuk melihat contoh cara membuat nama yang dicadangkan menggunakan Konsol Google Cloud, lihat Membuat alokasi IP.

  3. Membuat Deployment.

    Jalankan perintah berikut untuk membuat resource Deployment:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: web-server-multishare
      labels:
        app: nginx
    spec:
      replicas: 5
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: nginx
            volumeMounts:
            - mountPath: /usr/share/nginx/html
              name: mypvc
          volumes:
          - name: mypvc
            persistentVolumeClaim:
              claimName: test-pvc-fs-sharedvpc
    ---
    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: test-pvc-fs-sharedvpc
    spec:
      accessModes:
        - ReadWriteMany
      storageClassName: csi-filestore-multishare-sharedvpc
      resources:
        requests:
          storage: 100Gi
    
    EOF
    

Instance Filestore berkemampuan CMEK

Anda dapat membuat volume GKE yang dihosting di instance multishare Filestore yang mendukung CMEK. Di bagian ini, Anda akan melihat cara menyiapkan kunci enkripsi yang dikelola pelanggan (CMEK) untuk instance Filestore.

Detail kunci yang dikelola pelanggan dapat diberikan di StorageClass. Setiap instance yang dibuat secara dinamis oleh driver Filestore CSI, yang mereferensikan StorageClass ini, akan mengaktifkan CMEK.

  1. Membuat StorageClass yang mendukung CMEK.

    a. Jalankan perintah berikut:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: csi-filestore-multishare-cmek
    provisioner: filestore.csi.storage.gke.io
    parameters:
      tier: enterprise
      multishare: "true"
      instance-encryption-kms-key: projects/KEY_PROJECT_ID/locations/REGION/keyRings/RING_NAME/cryptoKeys/KEY_NAME
    
    allowVolumeExpansion: true
    
    EOF
    

    dengan:

    • KEY_PROJECT_ID adalah nama project tempat kunci tersebut berada. Misalnya, my-key-project.

    • REGION adalah nama region yang digunakan. Misalnya, us-central1.

    • RING_NAME adalah nama key ring. Contoh, my-key-ring-name.

    • KEY_NAME adalah nama kunci. Contoh, my-key-name.

  2. Membuat Deployment.

    b. Jalankan perintah berikut untuk membuat resource Deployment:

    cat <<EOF | kubectl apply -f -
    
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: web-server-multishare
      labels:
        app: nginx
    spec:
      replicas: 5
      selector:
        matchLabels:
          app: nginx
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - name: nginx
            image: nginx
            volumeMounts:
            - mountPath: /usr/share/nginx/html
              name: mypvc
          volumes:
          - name: mypvc
            persistentVolumeClaim:
              claimName: test-pvc-fs-cmek
    ---
    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: test-pvc-fs-cmek
    spec:
      accessModes:
        - ReadWriteMany
      storageClassName: csi-filestore-multishare-cmek
      resources:
        requests:
          storage: 100Gi
    
    EOF
    

Memetakan PVC ke instance Filestore

Di bagian ini, Anda akan melihat cara memetakan PVC ke instance Filestore.

Dengan instance multishare Filestore, setiap PVC dihosting di instance Filestore oleh driver CSI Filestore. Detail instance Filestore, yang mendasari yang menghosting volume dan berbagi yang mewakili volume Kubernetes, ditangkap di kolom volumeHandle pada spesifikasi Volume Persisten. Format handle volume adalah sebagai berikut:

modeMultishare/<storageclass-prefix>/<project>/<region>/<filestore-instance-name>/<filestore-share-name>

Perintah kubectl berikut dapat digunakan untuk menentukan pemetaan antara PVC, PV, Instance Filestore, dan berbagi Filestore dengan cepat.

Pada command line, jalankan perintah berikut:

kubectl get pv -o jsonpath='{range .items[*]}{"pv="}{.metadata.name}{",pvc="}{.spec.claimRef.name}{",volumeHandle="}{.spec.csi.volumeHandle}{"\n"}{end}'

Anda akan melihat respons yang mirip dengan berikut ini:

pv=pvc-67ad9abd-f25e-4130-b7ca-64d28bd29525,pvc=test-pvc-multishare,volumeHandle=modeMultishare/csi-filestore-multishare-sharedvpc/YOUR_PROJECT_ID/us-central1/fs-2109f680-3f04-4ada-b4bc-2a1c7fc47b88/pvc_67ad9abd_f25e_4130_b7ca_64d28bd29525

pv=pvc-c80f4de0-9916-4957-b8ae-b21206650ac0,pvc=test-pvc-fs-sharedvpc,volumeHandle=modeMultishare/csi-filestore-multishare-sharedvpc/YOUR_PROJECT_ID/us-central1/fs-2109f680-3f04-4ada-b4bc-2a1c7fc47b88/pvc_c80f4de0_9916_4957_b8ae_b21206650ac0

dengan:

  • YOUR_PROJECT_ID adalah nama project yang digunakan. Misalnya, my-project.

Perhatikan bahwa dua volume persisten dalam cluster dihosting di satu instance Filestore.

Langkah selanjutnya