צירוף מכונות Filestore ב-Cloud Workstations

ב-Cloud Workstations אפשר לטעון מכונות של Filestore Network File System‏ (NFS) שנמצאות באותה רשת VPC. אפשר לגשת למופע Filestore מכמה מופעים של Cloud Workstations בו-זמנית.

מידע נוסף על Filestore זמין במאמרי העזרה בנושא Filestore.

לפני שמתחילים

לפני שמתחילים, צריך ליצור פרויקט ולהגדיר את תפקידי ה-IAM הנדרשים.

יצירת הפרויקט

  1. בפרויקט תחנות העבודה, מוודאים שהפעלתם את Filestore API ואת Cloud Workstations APIs.

    הפעלת ממשקי Filestore ו-Cloud Workstations API

  2. חשוב להתקין ולהפעיל את gcloud CLI. כדי לאתחל את gcloud CLI, מריצים את הפקודה הבאה:

    gcloud init

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות ליצירה ולעדכון של תחנות עבודה, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט של תחנות העבודה:

  • אם אתם אדמינים של Cloud Workstations, בקשו מהאדמין להקצות לכם את התפקיד הבא: אדמין של Cloud Workstations‏ (roles/workstations.admin).
  • אם יש לכם את התפקיד Filestore Admin, בקשו מהאדמין להקצות לכם את התפקיד הבא: Filestore Editor (roles/file.editor).

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

יצירת מופע Filestore

אם עדיין לא יצרתם מופע Filestore, אתם יכולים ליצור אותו באמצעות הפקודה gcloud ב-CLI filestore instances create שמופיעה בהמשך. מידע על מתן שמות מופיע במאמרים בנושא מתן שם למופע Filestore ומתן שם לשיתוף קבצים.

  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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_ID: המזהה שמזהה באופן ייחודי את מופע Filestore.
  • ‫FILE_SHARE_NAME: השם של הספרייה שמוגשת ממופע Filestore, לדוגמה, vol1.
  • ‫NETWORK_NAME: השם של רשת ה-VPC שאליה המכונה מחוברת. היא צריכה להיות זהה לרשת של אשכול Cloud Workstations – לדוגמה, default.
  • ‫LOCATION: האזור של מכונת Filestore. הוא צריך להיות זהה לאזור של אשכול תחנות העבודה.
  • ‫WORKSTATIONS_PROJECT_ID: המזהה של פרויקט תחנות העבודה.

איך מקבלים את כתובת ה-IP של מכונת Filestore

אחרי שיוצרים את מופע Filestore, מקבלים את כתובת ה-IP שלו באמצעות הפקודה filestore instances describe gcloud ב-CLI:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_ID: המזהה שמזהה באופן ייחודי את מופע Filestore.
  • ‫LOCATION: האזור של מכונת Filestore. הוא צריך להיות זהה לאזור של אשכול תחנות העבודה.
  • ‫WORKSTATIONS_PROJECT_ID: המזהה של פרויקט תחנות העבודה.

הפקודה מדפיסה את כתובת ה-IP בפורמט הבא:

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

חשוב לשים לב לFILESTORE_IP_ADDRESS כי תצטרכו אותו בשלבים הבאים.

יצירת אשכול של תחנות עבודה

אם עדיין לא יצרתם אשכול תחנות עבודה, אתם יכולים ליצור אותו באמצעות הפקודה gcloud CLI clusters create:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫WORKSTATIONS_CLUSTER_NAME: השם של אשכול תחנות העבודה.
  • ‫NETWORK_NAME: השם של רשת ה-VPC שאליה מחוברים מופעי Cloud Workstations. הוא צריך להיות זהה לרשת של מופע Filestore, למשל default.
  • ‫LOCATION: שם האזור של אשכול תחנות העבודה. הוא צריך להיות זהה לאזור של מופע Filestore.
  • ‫WORKSTATIONS_PROJECT_ID: המזהה של פרויקט תחנות העבודה.

יצירת הגדרה של תחנת עבודה ותחנת עבודה

אם עדיין לא יצרתם הגדרה של Cloud Workstations ומופע של תחנת עבודה, כדאי לעיין במאמרים בנושא יצירת הגדרה של תחנת עבודה ויצירת תחנת עבודה.

התקנת מופע Filestore בתחנת עבודה

אחרי שמפעילים את מכונת Cloud Workstations, עוברים לחלון טרמינל ומריצים את הפקודות הבאות כדי לטעון מכונת Filestore:

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫FILE_SHARE_NAME: השם של הספרייה שמוגשת ממופע Filestore, לדוגמה, vol1.
  • ‫FILESTORE_IP_ADDRESS: כתובת ה-IP של מופע Filestore.

אחרי שהפקודה mount תפעל בהצלחה, תוכלו לראות את התוכן של מופע Filestore בנתיב של שיתוף הקבצים.

מידע נוסף על טעינת מופעי Filestore זמין במאמר בנושא טעינת שיתופי קבצים בלקוחות Compute Engine.

יצירת קובץ אימג' של קונטיינר מותאם אישית של Filestore להרכבה אוטומטית

אפשר להשתמש בקובץ Dockerfile הבא כדי ליצור קובץ אימג' של קונטיינר בהתאמה אישית, שמטמיע באופן אוטומטי מופע של Filestore ב-Cloud Workstations בזמן ההפעלה.

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

מחליפים את מה שכתוב בשדות הבאים:

  • ‫FILE_SHARE_NAME: השם של הספרייה שמוגשת ממופע Filestore, לדוגמה, vol1.
  • ‫FILESTORE_IP_ADDRESS: כתובת ה-IP של מופע Filestore.

מידע נוסף על יצירת קובץ אימג' של קונטיינר בהתאמה אישית ל-Cloud Workstations זמין במאמר התאמה אישית של קובצי אימג' של קונטיינרים.