יצירה וניהול של מאגרי צמתים

בדף הזה מוסבר איך ליצור ולנהל משאבים של מאגרי צמתים ב-Google Distributed Cloud באזור Distributed Cloud.

מידע נוסף על מאגרי צמתים ב-Distributed Cloud זמין במאמר איך Distributed Cloud פועל.

יצירת מאגר צמתים

כדי ליצור מאגר צמתים של Distributed Cloud, צריך לבצע את השלבים שבקטע הזה.

כדי לבצע את המשימה הזו, אתם צריכים את התפקידים הבאים בGoogle Cloud פרויקט:

המסוף

אם משתמשים במסוף Google Cloud , אפשר ליצור מאגר צמתים רק כשיוצרים אשכול. כדי ליצור מאגר צמתים עצמאי, צריך להשתמש ב-Google Cloud CLI או ב-Distributed Cloud Edge Container API.

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters node-pools create:

gcloud edge-cloud container clusters node-pools create POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-location=ZONE_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

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

  • ‫POOL_NAME: שם תיאורי שמזהה באופן ייחודי את מאגר הצמתים הזה. השם צריך להיות תואם ל-RFC 1213 ולהכיל רק תווים אלפאנומריים באותיות קטנות ומקפים (-). הוא צריך להתחיל ולהסתיים בתו אלפאנומרי.
  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: Google Cloud האזור שבו מתארח אשכול היעד של Distributed Cloud עבור מאגר הצמתים הזה.
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫ZONE_NAME: השם של אזור היעד ב-Distributed Cloud. האזור הזה צריך להיות באזור שצוין בREGION.
  • ‫NODE_COUNT: מספר הצמתים במאגר הצמתים הזה.
  • ‫MACHINE_FILTER (אופציונלי): מציין את קריטריוני הסינון לבחירת המכונה. כדי לראות את השדות שניתן לסנן לפיהם, אפשר לעיין במאמר קבלת מידע על מכונה. רק למכונות שתואמות למסנן הזה מותר להצטרף למאגר הצמתים הזה.

  • ‫POOL_KMS_KEY (אופציונלי): הנתיב המלא למפתח Cloud KMS שבו רוצים להשתמש עם מאגר הצמתים הזה. לדוגמה:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    הדגל הזה רלוונטי רק אם שילבתם את Distributed Cloud עם Cloud Key Management Service, כמו שמתואר במאמר הפעלת תמיכה במפתחות הצפנה בניהול הלקוח (CMEK) לאחסון מקומי.

API

שולחים בקשת POST אל ה-method‏ projects.locations.clusters.nodePools.create:

POST /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,   
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: Google Cloud האזור שבו מתארח אשכול היעד של Distributed Cloud עבור מאגר הצמתים הזה.
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫NODEPOOL_ID: מזהה ייחודי שניתן לתכנות ומזהה את משאב מאגר הצמתים הזה.
  • ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
  • ‫POOL_NAME: שם תיאורי שמזהה באופן ייחודי את מאגר הצמתים הזה.
  • ‫LABELS: רשימה של תוויות להחלה על משאב מאגר הצמתים הזה.
  • ‫ZONE_NAME: השם של אזור היעד ב-Distributed Cloud. האזור הזה צריך להיות באזור שצוין בREGION.
  • ‫NODE_COUNT: מספר הצמתים במאגר הצמתים הזה.
  • ‫MACHINE_FILTER (אופציונלי): מציין את קריטריוני הסינון לבחירת המכונה. רק למכונות שתואמות למסנן הזה מותר להצטרף למאגר הצמתים הזה.

  • ‫POOL_KMS_KEY (אופציונלי): הנתיב המלא למפתח Cloud KMS שבו רוצים להשתמש עם מאגר הצמתים הזה. לדוגמה:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    הפרמטר הזה רלוונטי רק אם שילבתם את Distributed Cloud עם Cloud Key Management Service, כמו שמתואר במאמר בנושא הפעלת תמיכה במפתחות הצפנה בניהול הלקוח (CMEK) לאחסון מקומי.

הצגת רשימה של מאגרי צמתים

כדי לראות רשימה של מאגרי הצמתים של Distributed Cloud שזמינים באזור של Distributed Cloud, צריך לבצע את השלבים שבקטע הזה.

כדי להשלים את המשימה הזו, צריך להיות לכם התפקיד 'צפייה במאגר תגים ב-Edge' (roles/edgecontainer.viewer) בפרויקט ב- Google Cloud .

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters node-pools list:

gcloud edge-cloud container clusters node-pools list \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.

API

שולחים בקשת GET אל ה-method‏ projects.locations.clusters.nodePools.list:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור Google Cloud שבו נוצר אשכול היעד של Distributed Cloud.
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫FILTER: ביטוי שמגביל את התוצאות שמוחזרות לערכים ספציפיים.
  • ‫PAGE_SIZE: מספר התוצאות שיוחזרו בכל דף.
  • ‫SORT_BY: רשימה מופרדת בפסיקים של שמות שדות שלפיהם ימוינו התוצאות שיוחזרו. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי להגדיר סדר יורד, מוסיפים את התו ~ לפני השדה הרצוי.
  • ‫PAGE_TOKEN: אסימון שמתקבל בתגובה לבקשת הרשימה האחרונה בשדה nextPageToken בתגובה. שולחים את האסימון הזה כדי לקבל דף תוצאות.

קבלת מידע על מאגר צמתים

כדי לקבל מידע על מאגר צמתים של Distributed Cloud, צריך לבצע את השלבים שבקטע הזה.

כדי להשלים את המשימה הזו, צריך להיות לכם התפקיד 'צפייה במאגר תגים ב-Edge' (roles/edgecontainer.viewer) בפרויקט ב- Google Cloud .

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters node-pools describe:

gcloud edge-cloud container clusters node-pools describe POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

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

  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.
  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.

API

שולחים בקשת GET אל ה-method‏ projects.locations.clusters.nodePools.get:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.

שינוי מאגר צמתים

כדי לשנות מאגר צמתים של Distributed Cloud, צריך לבצע את השלבים שבקטע הזה.

כדי להשלים את המשימה הזו, צריך להיות לכם תפקיד אדמין של Edge Container (roles/edgecontainer.admin) בפרויקט Google Cloud .

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters node-pools update:

gcloud edge-cloud container clusters node-pools update POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER

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

  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.
  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫NODE_COUNT: מספר הצמתים במאגר הצמתים הזה.
  • ‫MACHINE_FILTER (אופציונלי): מציין את קריטריוני הסינון לבחירת המכונה. כדי לראות את השדות שניתן לסנן לפיהם, אפשר לעיין במאמר קבלת מידע על מכונה.

API

שולחים בקשת PATCH אל ה-method‏ projects.locations.clusters.nodePools.patch:

PATCH /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": KMS_KEY,
  }
}

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫NODEPOOL_ID: מזהה ייחודי שניתן לתכנות ומזהה את מאגר הצמתים הזה.
  • ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.
  • ‫POOL_NAME: שם תיאורי שמזהה באופן ייחודי את מאגר הצמתים הזה.
  • ‫LABELS: רשימה של תוויות להחלה על משאב מאגר הצמתים הזה.
  • ‫ZONE_NAME: השם של אזור היעד ב-Distributed Cloud. האזור הזה צריך להיות באזור שצוין בREGION.
  • ‫NODE_COUNT: מספר הצמתים במאגר הצמתים הזה.
  • ‫MACHINE_FILTER (אופציונלי): מציין את קריטריוני הסינון לבחירת המכונה. רק למכונות שתואמות למסנן הזה מותר להצטרף למאגר הצמתים הזה.

  • ‫KMS_KEY (אופציונלי): הנתיב המלא למפתח Cloud KMS שבו רוצים להשתמש עם מאגר הצמתים הזה. לדוגמה:

    /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key

    הפרמטר הזה רלוונטי רק אם שילבתם את Distributed Cloud עם Cloud Key Management Service, כמו שמתואר במאמר בנושא הפעלת תמיכה במפתחות הצפנה בניהול הלקוח (CMEK) לאחסון מקומי.

מחיקת מאגר צמתים

כדי למחוק מאגר צמתים של Distributed Cloud, צריך לבצע את השלבים שבקטע הזה.

כדי להשלים את המשימה הזו, צריך להיות לכם תפקיד אדמין של Edge Container (roles/edgecontainer.admin) בפרויקט Google Cloud .

gcloud

משתמשים בפקודה gcloud edge-cloud container clusters node-pools delete:

gcloud edge-cloud container clusters node-pools delete POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

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

  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.
  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.

API

שולחים בקשת DELETE אל ה-method‏ projects.locations.clusters.nodePools.delete:

DELETE /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME?requestId=REQUEST_ID

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

  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫REGION: האזור שבו מתארח אשכול Distributed Cloud שמשויך למאגר הצמתים הזה. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד ב-Distributed Cloud.
  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.
  • ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.

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