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

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

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

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

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

כדי ליצור מאגר צמתים של 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 \
    --node-labels=NODE_LABELS \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY \
    --node-storage-schema=WORKER_NODE_STORAGE_SCHEMA

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

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

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

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

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

  • ‫WORKER_NODE_STORAGE_SCHEMA (אופציונלי): מציין את סכימת האחסון המקומי של צמתי העובדים שנכללים במאגר הצמתים הזה. מידע נוסף זמין במאמר בנושא הגדרת סכימות של אחסון מקומי.

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,
 "nodeLabels": NODE_LABELS,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

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

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

  • ‫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: האזור שבו נוצר אשכול היעד של Distributed Cloud במודל מחובר. Google Cloud
  • ‫CLUSTER_NAME: השם של אשכול היעד של Google 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 Distributed Cloud במודל מחובר. Google 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: השם של אשכול היעד של Google 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: השם של אשכול היעד של Google 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 \
    --local-disk-kms-key=POOL_KMS_KEY

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

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

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

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

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

    כדי להחזיר מאגר צמתים לשימוש ב- Google-owned and Google-managed encryption key, משתמשים בדגל --use-google-managed-key.

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

  • ‫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: השם של אשכול היעד של Google 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: השם של אשכול היעד של Google Distributed Cloud במודל מחובר.
  • ‫POOL_NAME: השם של מאגר הצמתים של היעד.
  • ‫REQUEST_ID: מזהה ייחודי שנוצר באופן פרוגרמטי ומזהה את הבקשה הזו.

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