שימוש בכלי gcloud לבדיקת אפליקציות ולניהול אינדקסים

אתם יכולים להשתמש ב-Google Cloud CLI כדי לבדוק את האפליקציה באופן מקומי וכדי לנהל אינדקסים במופע של Firestore במצב Datastore בסביבת הייצור. בדף הזה מתואר תהליך העבודה האופייני לפעילויות האלה.

ב-CLI של gcloud יש תמיכה בתהליך העבודה הבא:

  1. יצירת תמיכה מקומית במופע Datastore, כולל ספרייה, קבצים נדרשים ומזהה פרויקט.
  2. מפעילים את האמולטור של Datastore, שמספק אמולציה מקומית של סביבת הייצור של Datastore.
  3. יצירת הגדרות אינדקס מהשאילתות של האפליקציה לאמולטור.
  4. מעלים הגדרות אינדקס שנוצרו או נוצרו באופן ידני למופע של מסד הנתונים שלכם בסביבת הייצור.
  5. מוחקים אינדקסים שלא בשימוש ממופע מסד הנתונים של הייצור.

תהליך העבודה בפיתוח באמצעות כלי שורת הפקודה

זהו תהליך העבודה הטיפוסי באמצעות ה-CLI של gcloud:

  1. מפעילים את אמולטור Datastore.

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

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

  4. מעלים את האינדקסים שנוצרו באמצעות הפקודה indexes create, ומעבירים את הנתיב לקובץ index.yaml המקומי, כמו בדוגמה הבאה:

    gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    נתיב הדוגמה מניח שלא הגדרתם ספרייה ספציפית לאפשרות data-dir. אם הגדרתם ספרייה ספציפית, צריך לשנות את הנתיב כך שישתמש בנתיב לקובץ index.yaml.

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

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

  7. עם הזמן, יכול להיות שלא תשתמשו יותר בחלק מהאינדקסים. אפשר למחוק אינדקסים שלא נמצאים בשימוש ממופע מסד הנתונים של הייצור. לשם כך, צריך להסיר אותם מקובץ index.yaml המקומי ואז להפעיל את הפקודה indexes cleanup:

    gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    אם הגדרתם ספרייה ספציפית לאפשרות data-dir, צריך לשנות את הנתיב בדוגמה כדי להשתמש בנתיב לקובץ index.yaml.

המאמרים הבאים