בדף הזה מפורטות הפקודות של ה-CLI של gcloud שנדרשות כדי להגדיר את הדרישות המוקדמות, להקצות מופע בפרויקט שירות, לתאר מופע ולמחוק מופע. כדי לבצע את המשימות האלה, צריך לפעול לפי ההוראות בכל קטע בדף הזה.
הוראות מפורטות יותר לביצוע המשימות האלה מופיעות בדפים הבאים:
הפעלת ממשקי ה-API
מפעילים את ממשקי ה-API הבאים שנדרשים להגדרת מדיניות חיבור שירות, להגדרת VPC משותף וליצירת מופע של Memorystore for Valkey.
gcloud
מפעילים את ממשקי ה-API הבאים בפרויקט השירות:
gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com
מחליפים את SERVICE_PROJECT_ID במזהה פרויקט השירות.
מפעילים את ממשקי ה-API הבאים בפרויקט המארח:
gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com
מחליפים את HOST_PROJECT_ID במזהה של פרויקט המארח.
יצירת מדיניות לחיבור שירות
לאחר מכן, צריך ליצור מדיניות חיבור לשירות עבור הפרויקט המארח של ה-VPC המשותף שבו מוגדרת המדיניות, הרשת, האזור ותת-הרשתות שבהן רוצים להקצות את מופע Memorystore for Valkey. בדרך כלל, האדמין של הרשת מבצע את הפעולה הזו, אבל יכול להיות שיש לכם את ההרשאה הנדרשת להפעלת הפקודה אם יש לכם את התפקיד הנדרש.
במדריך הזה למתחילים נעשה שימוש ברשת default וברשת המשנה default. כתובות ה-IP של המכונה הווירטואלית מוקצות ברשת המשנה הזו שמוגדרת כברירת מחדל באזור.
gcloud
כדי ליצור את מדיניות חיבור השירות, מריצים את הפקודה
create:gcloud network-connectivity service-connection-policies create POLICY_NAME \ --network=default \ --project=HOST_PROJECT_ID \ --region=REGION \ --service-class=gcp-memorystore \ --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default
מחליפים את מה שכתוב בשדות הבאים:
- POLICY_NAME הוא שם המדיניות הרצוי.
- HOST_PROJECT_ID הוא מזהה פרויקט המארח.
- REGION הוא אותו אזור שבו רוצים להקצות את מופע Memorystore for Valkey.
כדי לוודא שהמדיניות נוצרה בהצלחה, מריצים את הפקודה
list:gcloud network-connectivity service-connection-policies list \ --region=REGION \ --project=HOST_PROJECT_ID
מחליפים את מה שכתוב בשדות הבאים:
- HOST_PROJECT_ID הוא מזהה פרויקט המארח.
- REGION הוא האזור שבו מוגדרת מדיניות חיבור השירות.
יצירת מופע
כדי ליצור מכונה וירטואלית בפרויקט השירות שמצורף ל-VPC המשותף, מריצים את הפקודה הבאה:
gcloud
gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/HOST_PROJECT_ID/global/networks/default", "projectId": "SERVICE_PROJECT_ID"}}]}]'
מחליפים את מה שכתוב בשדות הבאים:
- INSTANCE הוא מזהה המופע.
- SERVICE_PROJECT_ID הוא מזהה פרויקט השירות.
REGION הוא האזור שבו רוצים להקצות את המופע.
NODE_TYPE הוא סוג הצומת שבו רוצים להשתמש עבור המופע.
SHARD_COUNT קובע את מספר הרסיסים במופע. מספר הרסיסים קובע את קיבולת הזיכרון הכוללת לאחסון נתוני המופע. פרטים נוספים על מפרט המופע זמינים במאמר מפרט המופע והצומת.
REPLICA_COUNT הוא מספר העותקים לקריאה (לכל שבר). הערכים הקבילים הם
0עד5.HOST_PROJECT_ID הוא מזהה פרויקט המארח.
תיאור המופע
כדי לראות את פרטי המופע, מריצים את הפקודה הבאה:
gcloud
gcloud memorystore instances describe INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
מחליפים את מה שכתוב בשדות הבאים:
- INSTANCE הוא מזהה המופע.
- SERVICE_PROJECT_ID הוא מזהה פרויקט השירות.
- REGION הוא האזור שבו נמצאת המכונה.
מחיקת המכונה
כדי למחוק מופע, מריצים את הפקודה הבאה:
gcloud
gcloud memorystore instances delete INSTANCE \ --project=SERVICE_PROJECT_ID \ --location=REGION
מחליפים את מה שכתוב בשדות הבאים:
- INSTANCE הוא מזהה המופע.
- SERVICE_PROJECT_ID הוא מזהה פרויקט השירות.
- REGION הוא האזור שבו נמצאת המכונה.