Memasang instance Filestore di Cloud Workstation

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

Untuk mengetahui informasi selengkapnya tentang Filestore, lihat dokumentasi Filestore.

Sebelum memulai

Sebelum memulai, buat project Anda dan siapkan peran IAM yang diperlukan.

Buat project Anda

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

    Aktifkan Filestore dan Cloud Workstations API

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

    gcloud init

Peran yang diperlukan

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

  • Jika Anda adalah Admin Cloud Workstations, minta administrator Anda untuk memberi Anda peran berikut: Admin Cloud Workstations (roles/workstations.admin).
  • Jika Anda adalah Admin Filestore, minta administrator Anda untuk memberi Anda peran berikut: Editor Filestore (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 gcloud CLI filestore instances create berikut. Untuk informasi penamaan, lihat Memberi nama instance Filestore Anda 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 disajikan dari instance Filestore—misalnya, vol1.
  • NETWORK_NAME: nama jaringan VPC tempat instance terhubung. 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 filestore instances describe gcloud:

  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 mencetak alamat IP dalam format berikut:

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

Catat FILESTORE_IP_ADDRESS karena Anda akan memerlukannya pada langkah berikutnya.

Membuat cluster workstation

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

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. Jaringan ini harus cocok dengan jaringan instance Filestore—misalnya, default.
  • LOCATION: nama region untuk cluster workstation Anda. 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 Anda 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 isi instance Filestore di jalur berbagi file.

Untuk mengetahui informasi selengkapnya tentang pemasangan 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 me-mount instance Filestore di Cloud Workstations secara otomatis saat startup.

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 Workstations, lihat Menyesuaikan image container.