Halaman ini diterjemahkan oleh Cloud Translation API.

Pemasangan volume Cloud Storage untuk layanan

Halaman ini menunjukkan cara memasang bucket Cloud Storage sebagai volume penyimpanan, menggunakan pemasangan volume Cloud Run.

Memasang bucket sebagai volume di Cloud Run akan menampilkan konten bucket sebagai file dalam sistem file container, yang memungkinkan penggunaan operasi dan library sistem file standar untuk mengakses sistem file tersebut.

Batasan

Cloud Run menggunakan Cloud Storage FUSE untuk pemasangan volume ini. Jadi, ada beberapa hal yang perlu diingat saat memasang bucket Cloud Storage sebagai volume:

Cloud Storage FUSE tidak memberikan kontrol serentak untuk beberapa penulisan (penguncian file) ke file yang sama. Ketika beberapa penulisan mencoba mengganti file, penulisan terakhir akan menang dan semua penulisan sebelumnya hilang.
Cloud Storage FUSE bukan sistem file yang sepenuhnya mematuhi POSIX. Untuk mengetahui detail selengkapnya, baca dokumentasi Cloud Storage FUSE.

Sebelum memulai

Anda memerlukan bucket Cloud Storage agar terpasang sebagai volume.

Kontrol akses IAM untuk bucket Cloud Storage

Identitas layanan layanan Cloud Run Anda mengautentikasi terhadap bucket Cloud Storage yang dilindungi IAM.

Pastikan akun layanan yang dikonfigurasi memiliki izin yang diperlukan untuk akses file.

Memasang volume Cloud Storage

Anda dapat memasang beberapa bucket di jalur pemasangan yang berbeda. Anda juga dapat memasang volume ke lebih dari satu container menggunakan jalur pemasangan yang sama atau berbeda di seluruh container.

Jika Anda menggunakan beberapa container, tentukan volume terlebih dahulu, lalu tentukan pemasangan volume untuk setiap container.

Konsol

Di konsol Google Cloud, buka Cloud Run:

Buka Cloud Run
Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang ada, klik layanan, lalu klik Edit and deploy new revision.
Jika Anda mengonfigurasi layanan baru, isi halaman setelan layanan awal sesuai keinginan, kemudian klik Container, vo;ume, jejaring, sekuritas untuk memperluas halaman konfigurasi layanan.
Klik tab Volume.
- Pada Volume:
  - Klik Tambahkan volume.
  - Di drop-down Volume type, pilih bucket Cloud Storage sebagai jenis volume.
  - Pada kolom Nama volume, masukkan nama yang ingin Anda gunakan untuk volume.
  - Jelajahi dan pilih bucket Cloud Storage yang akan digunakan untuk volume, atau, secara opsional, buat bucket baru.
  - Jika Anda ingin membuat bucket hanya-baca, pilih kotak centang Hanya baca.
  - Klik Done.
  - Klik tab Penampung.
  - Klik tab Volume Mount.
  - Klik Pasang volume.
  - Pilih volume penyimpanan dari menu.
  - Tentukan jalur tempat Anda ingin memasang volume.
  - Klik Done
Klik Buat atau Deploy.

Command line

Catatan: kami menunjukkan perintah gcloud beta run services update, tetapi Anda juga dapat menggunakan perintah gcloud beta run deploy dengan parameter yang sama seperti yang ditunjukkan.

Untuk menambahkan volume dan memasangnya:
```
gcloud beta run services update SERVICE \
--execution-environment gen2 \
--add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH
```
Ganti:
- SERVICE dengan nama layanan Anda.
- MOUNT_PATH dengan jalur relatif tempat Anda memasang volume, misalnya, /cache.
- VOLUME_NAME dengan nama apa pun yang Anda inginkan untuk volume. Nilai VOLUME_NAME digunakan untuk memetakan volume ke pemasangan volume.
- BUCKET_NAME dengan nama bucket Cloud Storage Anda.
Untuk memasang volume sebagai volume hanya baca:

--add-volume=name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,readonly=true

Jika Anda menggunakan beberapa container, tentukan volume terlebih dahulu, lalu tentukan pemasangan volume untuk setiap container:

gcloud beta run services update SERVICE \
--add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
--container CONTAINER_1 \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH \
--container CONTAINER_2 \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

Anda dapat mendownload dan melihat konfigurasi layanan yang ada menggunakan perintah gcloud run services describe --format export, yang memberikan hasil yang telah diolah dalam format YAML. Kemudian, Anda dapat mengubah kolom yang dijelaskan di bawah ini dan mengunggah YAML yang telah dimodifikasi menggunakan perintah gcloud run services replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

Untuk melihat dan mengunduh konfigurasi:

gcloud run services describe SERVICE --format export > service.yaml

Perbarui sesuai kebutuhan.
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/execution-environment: gen2
    spec:
      containers:
      - image: IMAGE_URL
        volumeMounts:
        - name: VOLUME_NAME
          mountPath: MOUNT_PATH
      volumes:
      - name: VOLUME_NAME
        csi:
          driver: gcsfuse.run.googleapis.com
          readOnly: IS_READ_ONLY
          volumeAttributes:
            bucketName: BUCKET_NAME
```
Ganti
- IMAGE_URL dengan referensi ke image container misalnya, us-docker.pkg.dev/cloudrun/container/hello:latest. Jika Anda menggunakan Artifact Registry, repositori REPO_NAME harus sudah dibuat. URL berbentuk LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- MOUNT_PATH dengan jalur relatif tempat Anda memasang volume, misalnya, /cache.
- VOLUME_NAME dengan nama apa pun yang Anda inginkan untuk volume. Nilai VOLUME_NAME digunakan untuk memetakan volume ke pemasangan volume.
- IS_READ_ONLY dengan True untuk membuat volume menjadi hanya baca, atau False untuk mengizinkan penulisan.
- BUCKET_NAME dengan nama bucket Cloud Storage.
Ganti layanan dengan konfigurasinya yang baru menggunakan perintah berikut:
```
gcloud run services replace service.yaml
```

Melihat setelan Pemasangan volume

Untuk melihat setelan Pemasangan Volume saat ini untuk layanan Cloud Run Anda:

Konsol

Di konsol Google Cloud, buka Cloud Run:

Buka Cloud Run
Klik layanan yang Anda minati untuk membuka halaman Detail layanan.
Klik tab Revisi.
Di panel detail di sebelah kanan, setelan Pemasangan volume tercantum di bagian tab Volume.

Command line

Gunakan perintah berikut:
```
gcloud run services describe SERVICE
```
Temukan setelan Pemasangan Volume di konfigurasi yang ditampilkan.