Memasang instance Filestore di Cloud Workstation

Cloud Workstation dapat memasang instance Network File System (NFS) Filestore yang berada di jaringan VPC yang sama. Instance Filestore dapat diakses oleh beberapa instance Cloud Workstation secara bersamaan.

Untuk mengetahui informasi selengkapnya tentang Filestore, lihat dokumentasi Filestore.

Sebelum memulai

Buat project Anda

  1. Di project workstation, pastikan Anda telah mengaktifkan Filestore API dan Cloud Workstations API.

    Mengaktifkan Filestore dan Cloud Workstations API

  2. Pastikan Anda menginstal dan melakukan inisialisasi gcloud CLI. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

    gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat dan memperbarui workstation, minta administrator untuk memberi Anda peran IAM berikut di project workstation Anda:

  • Jika Anda adalah Cloud Workstations Admin, minta administrator untuk memberi Anda peran berikut: Cloud Workstations Admin (roles/workstations.admin).
  • Jika Anda adalah Filestore Admin, minta administrator untuk memberi Anda peran berikut: Filestore Editor (roles/file.editor).

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat instance Filestore

Jika Anda belum membuat instance Filestore, buat instance menggunakan perintah filestore instances create CLI gcloud berikut. Untuk informasi penamaan, lihat Memberi nama instance Filestore dan Memberi nama file yang dibagikan.

  gcloud filestore instances create INSTANCE_ID \
    --file-share=name=FILE_SHARE_NAME,capacity=1TiB \
    --tier=ENTERPRISE \
    --network=name=NETWORK_NAME \
    --region=LOCATION \
    --project WORKSTATIONS_PROJECT_ID

Ganti kode berikut:

  • INSTANCE_ID: ID untuk mengidentifikasi instance Filestore Anda secara unik.
  • FILE_SHARE_NAME: nama direktori yang ditayangkan dari instance Filestore—misalnya, vol1.
  • NETWORK_NAME: nama jaringan VPC tempat instance terhubung. Nama ini harus cocok dengan jaringan cluster Cloud Workstations—misalnya, default.
  • LOCATION: region instance Filestore Anda. Region ini harus cocok dengan region cluster workstation.
  • WORKSTATIONS_PROJECT_ID: ID project workstation Anda.

Mendapatkan alamat IP instance Filestore

Setelah instance Filestore dibuat, dapatkan alamat IP-nya menggunakan perintah CLI gcloud filestore instances describe:

  gcloud filestore instances describe INSTANCE_ID \
    --region=LOCATION \
    --project WORKSTATIONS_PROJECT_ID

Ganti kode berikut:

  • INSTANCE_ID: ID untuk mengidentifikasi instance Filestore Anda secara unik.
  • LOCATION: region instance Filestore Anda. Region ini harus cocok dengan region cluster workstation.
  • WORKSTATIONS_PROJECT_ID: ID project workstation Anda.

Perintah ini akan mencetak alamat IP dalam format berikut:

...
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - FILESTORE_IP_ADDRESS
...

Catat FILESTORE_IP_ADDRESS karena Anda memerlukannya pada langkah berikutnya.

Membuat cluster workstation

Jika Anda belum membuat cluster workstation, buat cluster menggunakan perintah clusters create CLI gcloud:

gcloud workstations clusters create \
    WORKSTATIONS_CLUSTER_NAME \
    --network=NETWORK_NAME \
    --region=LOCATION \
    --project=WORKSTATIONS_PROJECT_ID

Ganti kode berikut:

  • WORKSTATIONS_CLUSTER_NAME: nama cluster workstation.
  • NETWORK_NAME: nama jaringan VPC tempat instance Cloud Workstations terhubung. Nama ini harus cocok dengan jaringan instance Filestore—misalnya, default.
  • LOCATION: nama region untuk cluster workstation Anda. Zona ini harus cocok dengan region instance Filestore.
  • WORKSTATIONS_PROJECT_ID: ID project workstation Anda.

Membuat konfigurasi workstation dan workstation

Jika Anda belum membuat konfigurasi Cloud Workstations dan instance workstation, lihat Membuat konfigurasi workstation dan Membuat workstation.

Memasang instance Filestore di workstation

Setelah meluncurkan instance Cloud Workstations, buka jendela terminal dan jalankan perintah berikut untuk memasang instance Filestore:

sudo rpcbind
mkdir -p FILE_SHARE_NAME
sudo mount -o rw,intr FILESTORE_IP_ADDRESS:/FILE_SHARE_NAME FILE_SHARE_NAME

Ganti kode berikut:

  • FILE_SHARE_NAME: nama direktori yang ditayangkan dari instance Filestore—misalnya, vol1.
  • FILESTORE_IP_ADDRESS: alamat IP instance Filestore Anda.

Setelah perintah mount berhasil, Anda akan melihat konten instance Filestore di jalur berbagi file.

Untuk mengetahui informasi selengkapnya tentang cara memasang instance Filestore, lihat Memasang fitur berbagi file di klien Compute Engine.

Membuat image container kustom untuk pemasangan otomatis Filestore

Anda dapat menggunakan Dockerfile berikut untuk membuat image container kustom yang memasang instance Filestore di Cloud Workstation secara otomatis saat memulai.

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

RUN echo "#!/bin/bash\n\
sudo rpcbind\n\
sudo mkdir -p /home/user/FILE_SHARE_NAME\n\
sudo mount -o rw,intr FILESTORE_IP_ADDRESS:/FILE_SHARE_NAME /home/user/FILE_SHARE_NAME" | sudo tee -a /etc/workstation-startup.d/011_mount-filestore.sh

RUN sudo chmod +x /etc/workstation-startup.d/011_mount-filestore.sh

Ganti kode berikut:

  • FILE_SHARE_NAME: nama direktori yang ditayangkan dari instance Filestore—misalnya, vol1.
  • FILESTORE_IP_ADDRESS: alamat IP instance Filestore Anda.

Untuk mengetahui informasi selengkapnya tentang cara membuat image container kustom untuk Cloud Workstation, lihat Menyesuaikan image container.