יצירה וניהול של אשכולות AlloyDB Express

במאמר הזה מוסבר איך ליצור, לערוך, להציג, למחוק ולשדרג אשכולות ומכונות של AlloyDB Express, ואיך להתחבר אליהם.

בסקירה הכללית על AlloyDB Express מוסבר על ההבדלים בין היכולות של AlloyDB Express לבין היכולות של AlloyDB. כדי ליצור אשכול AlloyDB, קראו את המאמר יצירת אשכול והמכונה הראשית שלו.

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

לפני שיוצרים או מנהלים אשכולות של AlloyDB Express, צריך לבצע את הפעולות הבאות:

  • מפעילים את AlloyDB API וממשקי API נדרשים אחרים בפרויקט ב- Google Cloud כדי שתהיה לפרויקט גישה ל-AlloyDB.
  • אם אתם משתמשים בשרת MCP מרוחק של AlloyDB, הגדירו את לקוח ה-MCP כך שיתחבר לנקודת הקצה הגלובלית של שרת ה-MCP ‏(https://alloydb.googleapis.com/mcp) או לנקודת קצה אזורית (https://alloydb.REGION_ID.rep.googleapis.com/mcp). נקודות קצה אזוריות נמצאות כרגע בגרסת טרום-השקה (Preview).

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

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

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

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

יצירת אשכול ומכונה של AlloyDB Express

אפשר ליצור אשכול AlloyDB Express ואת המכונה הראשית שלו באמצעות Google Cloud המסוף, ה-CLI של Google Cloud, ה-API בארכיטקטורת REST של AlloyDB או שרת ה-MCP המרוחק של AlloyDB.

אשכול AlloyDB Express תומך ב-PostgreSQL 18 ומכיל מכונה ראשית אחת באזור, שמתחילה ב-‎1 vCPU‏ (4GB RAM) ומרחיבה את נפח האחסון באופן אוטומטי עד 20GB. אם אתם מתכננים לשדרג מכונה עם vCPU אחד ל-AlloyDB בהמשך בלי לשנות את הגודל ל-2 vCPU, אתם צריכים ליצור את האשכול באזור שתומך גם בסדרת המכונות C4A.

הגדרות ברירת המחדל של הקישוריות תלויות בכלי שבו אתם משתמשים:

  • ‫Google Cloud : כברירת מחדל, מפעיל גם DNS ציבורי במכונה הראשית וגם Private Service Connect באשכול. אפשר להגדיר פרויקטים של צרכני Private Service Connect בשלב מאוחר יותר, על ידי עריכת הגדרות הקישוריות של המכונה.Google Cloud

  • ה-CLI של gcloud, ‏API בארכיטקטורת REST ושרת MCP מרוחק של AlloyDB: כברירת מחדל, מפעילים רק את Private Service Connect באשכול. כשיוצרים את המכונה הראשית, מפעילים את ה-DNS הציבורי אם רוצים להתחבר דרך DNS ציבורי, ומוסיפים לרשימת ההיתרים את הפרויקטים של הצרכנים ב-Google Cloud שבהם רוצים ליצור נקודות קצה של Private Service Connect למכונה.

המסוף

  1. נכנסים לדף Get started במסוף Google Cloud .

    לדף "שנתחיל?"

    אם בפרויקט Google Cloud כבר יש אשכולות ואתם מתחילים מהדף Clusters, לוחצים על Create cluster בסרגל הכלים כדי לפתוח את הדף Select configuration. בשני הדפים מוצגים כרטיסים של הגדרות אשכולות מוגדרות מראש (AlloyDB Express, ‏Production (single zone)‎ ו-Production (multi-zone)‎).

  2. בכרטיס AlloyDB Express, לוחצים על Create cluster כדי לפתוח את החלונית Create an AlloyDB Express cluster.

  3. בחלונית Create an AlloyDB Express cluster, מגדירים את האשכול:

    • בשדה Cluster ID, מזינים מזהה לאשכול או משאירים את מזהה ברירת המחדל.
    • בשדה Password, מזינים סיסמה למשתמש postgres שמוגדר כברירת מחדל, או לוחצים על Generate כדי ליצור סיסמה. אפשר לשנות את הסיסמה מאוחר יותר בדף משתמשים.
    • בשדה Region, בוחרים אזור נתמך לאשכול. אם אתם מתכננים לשדרג מכונה עם vCPU אחד ל-AlloyDB בהמשך בלי לשנות את הגודל ל-2 vCPU, בחרו אזור שתומך בסדרת המכונות C4A.

  4. לוחצים על Create cluster.

    במסוף Google Cloud נוצר אשכול AlloyDB Express והמכונה הראשית שלו עם 1 vCPU, כשגם Private Service Connect וגם DNS ציבורי מופעלים כברירת מחדל. אחר כך נפתח AlloyDB Studio כדי שתוכלו לשלוח שאילתות למסד הנתונים.

    אי אפשר לשנות את הגדרות הקישוריות במהלך יצירת האשכול במסוףGoogle Cloud , אבל אפשר לעדכן את הרשתות החיצוניות המורשות או את ההגדרות של Private Service Connect מאוחר יותר, על ידי עריכת הגדרות הקישוריות של המכונה.

gcloud

כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

  1. כדי ליצור אשכול AlloyDB Express, מריצים את הפקודה gcloud beta alloydb clusters create עם הדגל --enable-express:

    gcloud beta alloydb clusters create CLUSTER_ID \
    --region=REGION_ID \
    --password=PASSWORD \
    --enable-express \
    --project=PROJECT_ID

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

    • ‫CLUSTER_ID: המזהה של האשכול שרוצים ליצור. המזהה צריך להתחיל באות קטנה באנגלית, והוא יכול להכיל אותיות קטנות, מספרים ומקפים.
    • ‫REGION_ID: האזור הנתמך שבו רוצים ליצור את האשכול. אם אתם מתכננים לשדרג מכונה עם vCPU אחד ל-AlloyDB בשלב מאוחר יותר בלי לשנות את הגודל ל-2 vCPUs, בחרו אזור שתומך גם בסדרת המכונות C4A.
    • ‫PASSWORD: הסיסמה הראשונית של משתמש ברירת המחדל במסד הנתונים של postgres.
    • ‫PROJECT_ID: המזהה של הפרויקט ב-Google Cloud שבו רוצים ליצור את האשכול.

  2. כדי ליצור את המכונה הראשית באשכול AlloyDB Express, מריצים את הפקודה gcloud beta alloydb instances create ובוחרים את דגלי הקישוריות:

    • רק DNS ציבורי: מציינים את --enable-public-dns ומשמיטים את --allowed-psc-projects.
    • ‫Private Service Connect בלבד: משמיטים את --enable-public-dns ומציינים את --allowed-psc-projects=ALLOWED_PROJECT_ID כדי לאפשר חיבורים של Private Service Connect מהפרויקט של הצרכן Google Cloud .
    • גם DNS ציבורי וגם Private Service Connect: מציינים גם את --enable-public-dns וגם את --allowed-psc-projects=ALLOWED_PROJECT_ID.
    gcloud beta alloydb instances create INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --instance-type=PRIMARY \
    --cpu-count=1 \
    --enable-public-dns \
    --allowed-psc-projects=ALLOWED_PROJECT_ID \
    --project=PROJECT_ID

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

    • ‫INSTANCE_ID: המזהה של המכונה הראשית שרוצים ליצור.
    • ‫ALLOWED_PROJECT_ID (אופציונלי): רשימה מופרדת בפסיקים של מזהי פרויקטים או מספרי פרויקטים ב- Google Cloud שמותר ליצור בהם נקודות קצה של Private Service Connect למכונה הזו. אם אתם מגדירים רק DNS ציבורי, השמיטו את --allowed-psc-projects.

REST

  1. כדי ליצור אשכול של AlloyDB Express, שולחים בקשת POST לנקודת הקצה projects.locations.clusters.create, ומגדירים את expressConfig.enabled לערך true.

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

    • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
    • ‫REGION_ID: האזור הנתמך שבו רוצים ליצור את האשכול. אם אתם מתכננים לשדרג מכונה עם vCPU אחד ל-AlloyDB בשלב מאוחר יותר בלי לשנות את הגודל ל-2 vCPUs, בחרו אזור שתומך גם בסדרת המכונות C4A.
    • ‫CLUSTER_ID: המזהה של האשכול שרוצים ליצור.
    • ‫INITIAL_USERNAME: שם המשתמש של המשתמש הראשוני במסד הנתונים (לדוגמה, postgres).
    • ‫INITIAL_USER_PASSWORD: הסיסמה של המשתמש הראשוני במסד הנתונים.

    ה-method של ה-HTTP וכתובת ה-URL:

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID

    תוכן בקשת JSON:

    {
  "databaseVersion": "POSTGRES_18",
  "expressConfig": {
    "enabled": true
  },
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  }
}

  2. אחרי שפעולת יצירת האשכול מסתיימת, יוצרים את המכונה הראשית על ידי שליחת בקשת POST לנקודת הקצה projects.locations.clusters.instances.create, כשהערך של machineConfig.cpuCount מוגדר כ-1 (אם מציינים ערך אחר, היצירה נכשלת).1 בוחרים את שדות הקישוריות בגוף הבקשה:

    • רק DNS ציבורי: מגדירים את "networkConfig": {"publicDnsEnabled": true} ומשמיטים את "pscInstanceConfig".
    • ‫Private Service Connect בלבד: משמיטים את "publicDnsEnabled" (שמוגדר כברירת מחדל ל-false) ומגדירים את "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.
    • גם DNS ציבורי וגם Private Service Connect: כוללים גם את "networkConfig": {"publicDnsEnabled": true} וגם את "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.

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

    • ‫INSTANCE_ID: המזהה של המכונה הראשית שרוצים ליצור.
    • ‫ALLOWED_PROJECT_ID (אופציונלי):Google Cloud מזהי הפרויקטים או מספרי הפרויקטים שמורשים ליצור נקודות קצה של Private Service Connect למכונה הזו.

    ה-method של ה-HTTP וכתובת ה-URL:

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances?instanceId=INSTANCE_ID

    תוכן בקשת JSON:

    {
  "instanceType": "PRIMARY",
  "availabilityType": "ZONAL",
  "machineConfig": {
    "cpuCount": 1
  },
  "networkConfig": {
    "publicDnsEnabled": true
  },
  "pscInstanceConfig": {
    "allowedConsumerProjects": [
      "ALLOWED_PROJECT_ID"
    ]
  }
}

MCP

אתם יכולים להשתמש בלקוח MCP או לקרוא ישירות לשרת ה-MCP המרוחק של AlloyDB כדי ליצור אשכול AlloyDB Express ואת המכונה הראשית שלו.

בלקוח MCP, אתם יכולים להשתמש בהנחיה אחת כדי ליצור גם את אשכול AlloyDB Express וגם את המכונה הראשית שלו. לקוח ה-MCP קורא אוטומטית ל-create_cluster, דוגם את get_operation וקורא ל-create_instance:

Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID with a primary instance named INSTANCE_ID.

כדי להריץ כל שלב בנפרד או להפעיל את הכלים של MCP ישירות, פועלים לפי השלבים הבאים:

  1. כדי ליצור אשכול AlloyDB Express, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי create_cluster ב-MCP, ומגדירים את express_config.enabled ל-true.

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

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_cluster",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID",
      "cluster_id": "CLUSTER_ID",
      "express_config": {
        "enabled": true
      }
    }
  }
}

    כדי לאפשר גישה ל-Private Service Connect מרשת VPC, צריך להוסיף לרשימת ההיתרים את הפרויקטים של הצרכנים ב-Google Cloud ב-"psc_instance_config" כשיוצרים או מעדכנים את המכונה הראשית.

  2. הכלי create_cluster מחזיר פעולה ממושכת. דוגמים את סטטוס הפעולה באמצעות הכלי get_operation של MCP עד שהערך של done הוא true והאשכול נמצא במצב READY.

  3. כדי ליצור את המכונה הראשית באשכול AlloyDB Express, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי create_instance ב-MCP. בוחרים את הגדרות הקישוריות:

    • רק DNS ציבורי: מגדירים את "public_dns_enabled": true ומשמיטים את "psc_instance_config".

    • ‫Private Service Connect בלבד: משמיטים את "public_dns_enabled" (שמוגדר כברירת מחדל ל-false) ומגדירים את "psc_instance_config" עם "allowed_consumer_projects" (או את "psc_auto_connections" שמציין את "consumer_project" ואת "consumer_network").

    • גם DNS ציבורי וגם Private Service Connect: מגדירים את "public_dns_enabled": true וגם את "psc_instance_config".

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

    • ‫INSTANCE_ID: המזהה של המכונה הראשית שרוצים ליצור.

    • ‫ALLOWED_PROJECT_ID: אופציונלי:Google Cloud מזהי הפרויקטים או מספרי הפרויקטים שמורשים ליצור נקודות קצה של Private Service Connect למכונה הזו.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please create a primary instance named INSTANCE_ID in my AlloyDB Express cluster CLUSTER_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
      "instance_id": "INSTANCE_ID",
      "type": "PRIMARY",
      "public_dns_enabled": true,
      "psc_instance_config": {
        "allowed_consumer_projects": [
          "ALLOWED_PROJECT_ID"
        ]
      }
    }
  }
}

  4. דוגמים את פעולת יצירת המכונה באמצעות הכלי get_operation של MCP עד שהערך של done הוא true והמכונה במצב READY.

התחברות למכונה של AlloyDB Express

AlloyDB Express תומך באפשרויות הקישוריות הנכנסת הבאות למסד הנתונים:

  • ‫DNS ציבורי (ברירת המחדל): מספק שם DNS שניתן לניתוב באופן ציבורי (networkInfo.publicDnsName) כדי שתוכלו להתחבר מלקוחות מחוץ לרשת VPC.
  • ‫Private Service Connect: מאפשר להתחבר באופן פרטי למכונה מתוך רשת ה-VPC באמצעות נקודות קצה של Private Service Connect, בלי לחשוף את מסד הנתונים לאינטרנט הציבורי.

התחברות באמצעות DNS ציבורי

כשמתחברים דרך DNS ציבורי מחוץ לרשת VPC, אפשר לבצע אחת מהפעולות הבאות:

התחברות ישירה באמצעות לקוח PostgreSQL

כברירת מחדל, נקודת הקצה הציבורית של ה-DNS דוחה את כל כתובות ה-IP הישירות של הלקוחות. לפני שמתחברים ישירות ל-psql, צריך להוסיף לרשימת ההיתרים את בלוקי ה-CIDR של הלקוח.

  1. מגדירים רשתות חיצוניות מורשות במכונה הראשית.

    אי אפשר להוסיף או להסיר רשתות חיצוניות מורשות בנפרד. כל עדכון מחליף את הרשימה הקיימת. צריך לספק רשימה מופרדת בפסיקים של כל בלוקי ה-CIDR שרוצים לאשר.

    המסוף

    1. נכנסים לדף Clusters במסוף Google Cloud .

      כניסה לדף Clusters

    2. בעמודה Resource name, לוחצים על שם האשכול של AlloyDB Express.

    3. בדף Overview, עוברים לקטע Instances in your cluster, מאתרים את המכונה הראשית ולוחצים על Instance actions > Edit (או עוברים לקטע Connectivity בתפריט הניווט ולוחצים על Edit).

    4. בקטע קישוריות, מוודאים שהקישוריות הציבורית מופעלת.

    5. בקטע Authorized external networks, מזינים רשימה מופרדת בפסיקים של טווחי IPv4 CIDR (לדוגמה, 203.0.113.0/24), או לוחצים על Use my IP כדי להוסיף את כתובת ה-IPv4 של המכונה הנוכחית (/32).

    6. לוחצים על Update instance.

    gcloud

    כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

    מריצים את הפקודה gcloud alloydb instances update עם הדגל --authorized-external-networks:

    gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2 \
    --project=PROJECT_ID

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

    • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
    • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
    • ‫REGION_ID: האזור שבו נמצא האשכול.
    • ‫CIDR_RANGE1, CIDR_RANGE2: רשימה מופרדת בפסיקים של טווחי כתובות IPv4 בסימון CIDR (לדוגמה, 203.0.113.0/24).
    • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

    REST

    שולחים בקשת PATCH לנקודת הקצה (endpoint) projects.locations.clusters.instances.patch עם updateMask=networkConfig.authorizedExternalNetworks.

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

    • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
    • ‫REGION_ID: האזור שבו נמצא האשכול.
    • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
    • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
    • ‫CIDR_RANGE1, CIDR_RANGE2: טווחי כתובות IPv4 בסימון CIDR (לדוגמה, 203.0.113.0/24).

    ה-method של ה-HTTP וכתובת ה-URL:

    PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=networkConfig.authorizedExternalNetworks

    תוכן בקשת JSON:

    {
  "networkConfig": {
    "authorizedExternalNetworks": [
      {
        "cidrRange": "CIDR_RANGE1"
      },
      {
        "cidrRange": "CIDR_RANGE2"
      }
    ]
  }
}

    MCP

    מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי update_instance של MCP עם השדה authorized_external_networks.

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

    • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

    • ‫REGION_ID: האזור שבו נמצא האשכול.

    • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

    • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

    • ‫CIDR_RANGE1, CIDR_RANGE2: טווחי כתובות IPv4 בפורמט CIDR, כמו 203.0.113.0/24.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to allow external connections from CIDR_RANGE1.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "authorized_external_networks": [
        "CIDR_RANGE1",
        "CIDR_RANGE2"
      ]
    }
  }
}

  2. מאחזרים את שם ה-DNS הציבורי של המכונה:

    המסוף

    1. במסוף Google Cloud , נכנסים לדף Clusters ולוחצים על שם האשכול של AlloyDB Express.
    2. עוברים אל Connectivity (או צופים בכרטיס המכונה הראשי בדף Overview) ומעתיקים את שם ה-DNS הציבורי של המכונה.

    gcloud

    מריצים את הפקודה gcloud beta alloydb instances describe כדי לאחזר את הערך של networkInfo.publicDnsName:

    gcloud beta alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(networkInfo.publicDnsName)" \
    --project=PROJECT_ID

    הפלט משתמש בפורמט הבא:

    IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.goog

    בפלט הזה, IDENTIFIER הוא מזהה אלפאנומרי שנוצר על ידי המערכת.

    REST

    שולחים בקשת GET לנקודת הקצה (endpoint) projects.locations.clusters.instances.get וקוראים את השדה networkInfo.publicDnsName מהתגובה:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

    MCP

    מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי get_instance של ה-MCP וקוראים את השדה networkInfo.publicDnsName מהתשובה.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please get the public DNS name of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

  3. מתחברים למסד הנתונים באמצעות URI סטנדרטי של חיבור PostgreSQL ושם ה-DNS הציבורי של המכונה:

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

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

    • USERNAME: שם המשתמש במסד הנתונים של PostgreSQL (לדוגמה, postgres).
    • ‫PUBLIC_DNS_NAME: שם ה-DNS הציבורי של מכונת AlloyDB Express (לדוגמה, 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • ‫DATABASE_NAME: שם מסד הנתונים שאליו רוצים להתחבר (מסד הנתונים שמוגדר כברירת מחדל הוא postgres).

  4. כשמוצגת בקשה, מזינים את הסיסמה של המשתמש במסד הנתונים.

התחברות באמצעות ה-CLI של gcloud או שרת ה-Proxy לאימות

כדי להתחבר באמצעות DNS ציבורי בלי להגדיר רשתות חיצוניות מורשות, אפשר להשתמש בפקודה gcloud beta alloydb connect או בלקוח Auth Proxy עצמאי (alloydb-auth-proxy) עם הדגל --public-ip. למרות שב-AlloyDB Express מוצג שם DNS ציבורי במקום כתובת IP ציבורית, מישור הבקרה מקצה חיבור ציבורי בסיסי למכונה, ש-Auth Proxy פותר באופן אוטומטי כשמציינים את --public-ip.

כדי להפעיל מכונה מקומית של שרת proxy לאימות ולפתוח סשן של psql באמצעות ה-CLI של gcloud, מריצים את הפקודה gcloud beta alloydb connect עם הדגל --public-ip:

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip \
    --user=USERNAME \
    --database=DATABASE_NAME \
    --project=PROJECT_ID

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

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • USERNAME: שם המשתמש של מסד הנתונים (ברירת המחדל היא postgres).
  • ‫DATABASE_NAME: שם מסד הנתונים (ברירת המחדל היא postgres).
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

במאמר התחברות באמצעות ה-CLI של gcloud מוסבר איך מתחברים באמצעות ה-CLI של gcloud, כולל אימות של מסד נתונים ב-IAM‏ (--auto-iam-authn).

אפשר גם להוריד ולהריץ את לקוח Auth Proxy העצמאי עם הדגל --public-ip:

./alloydb-auth-proxy \
    "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" \
    --public-ip

במאמר התחברות באמצעות AlloyDB Auth Proxy מוסבר איך מורידים, מגדירים ומתחברים באמצעות לקוח Auth Proxy עצמאי.

חיבור באמצעות Private Service Connect

כדי ליצור קישוריות פרטית מתוך רשת ה-VPC בלי לחשוף את מסד הנתונים לאינטרנט הציבורי, אתם יכולים להגדיר את Private Service Connect במכונה של AlloyDB Express. אתם יכולים להתחבר לנקודת קצה של Private Service Connect ישירות מלקוח ברשת ה-VPC או באמצעות Auth Proxy. מידע נוסף על התחברות ל-Private Service Connect זמין במאמר התחברות למכונה באמצעות Private Service Connect.

כשפועלים לפי ההוראות האלה ל-AlloyDB Express, יוצרים את האשכול ואת המכונה הראשית של אזור עם מעבד וירטואלי אחד, כמו שמתואר בקטע יצירת אשכול ומכונה של AlloyDB Express עם Private Service Connect מופעל. AlloyDB Express תומך בקישוריות נכנסת של Private Service Connect למכונה ראשית של אזור אחד.

עריכת מכונה של AlloyDB Express

אתם יכולים לעדכן את מספר המעבדים (vCPU אחד או 2 מעבדי vCPU) או את הדגלים לניהול מסד הנתונים של מכונה ראשית ב-AlloyDB Express.

המסוף

  1. נכנסים לדף Clusters במסוף Google Cloud .

    כניסה לדף Clusters

  2. בעמודה Resource name, לוחצים על שם האשכול של AlloyDB Express.

  3. בדף Overview, בקטע Instances in your cluster, מאתרים את המכונה הראשית ולוחצים על Edit primary (או על Instance actions > Edit).

  4. בדף Edit primary instance, מעדכנים את הגדרות המכונה:

    • בקטע Machine, ברשימה Machine Type בוחרים באפשרות ‎1 vCPU, 4 GB או ‎2 vCPU, 8 GB.
    • אופציונלי: כדי להגדיר דגלים של מסד נתונים, מרחיבים את Flags (או לוחצים על Show advanced options ומרחיבים את Flags) ולוחצים על Add flag. בוחרים דגל לניהול מסד נתונים מהרשימה New database flag, מזינים ערך ולוחצים על Done.

  5. לוחצים על Update instance.

gcloud

כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

כדי לשנות את קנה המידה של המכונה על ידי שינוי מספר המעבדים (1 או 2) או כדי לעדכן את דגלי ניהול מסד הנתונים, מריצים את הפקודה gcloud alloydb instances update:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --cpu-count=CPU_COUNT \
    --database-flags=FLAGS \
    --project=PROJECT_ID

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

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫CPU_COUNT: מספר ה-vCPUs של המכונה (1 ל-vCPU אחד, 4GB RAM או 2 ל-2 vCPUs, 8GB RAM).
  • ‫FLAGS (אופציונלי): רשימה מופרדת בפסיקים של דגלים לניהול מסד נתונים וערכים בפורמט FLAG_NAME=VALUE. אם אתם מעדכנים רק את מספר המעבדים, השמיטו את הדגל --database-flags. למידע נוסף על דגלים נתמכים, ראו דגלים נתמכים לניהול מסדי נתונים.
  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫--enable-public-dns או --no-enable-public-dns: הפעלה או השבתה של DNS ציבורי למכונה. הדגל הזה זמין רק ב-gcloud beta (gcloud beta alloydb instances update).
  • ‫--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: מעדכן את הרשימה המופרדת בפסיקים של מזהי הפרויקטים או מספרי הפרויקטים של הצרכן Google Cloud שמורשים ליצור נקודות קצה של Private Service Connect למכונה.

REST

כדי לעדכן את מספר המעבדים או את הדגלים לניהול מסד הנתונים של מכונה ראשית ב-AlloyDB Express, שולחים בקשת PATCH לנקודת הקצה (endpoint) projects.locations.clusters.instances.patch ומציינים את השדות שרוצים לעדכן בפרמטר השאילתה updateMask.

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
  • ‫CPU_COUNT: מספר ה-vCPU של המכונה (1 או 2).
  • ‫FLAG_NAME ו-FLAG_VALUE (אופציונלי): השם והערך של הדגל לניהול מסד הנתונים שרוצים להגדיר. אם אתם מעדכנים רק את מספר המעבדים, צריך להגדיר את updateMask=machineConfig.cpuCount ולהשמיט את databaseFlags מגוף הבקשה.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=machineConfig.cpuCount,databaseFlags

תוכן בקשת JSON:

{
  "machineConfig": {
    "cpuCount": CPU_COUNT
  },
  "databaseFlags": {
    "FLAG_NAME": "FLAG_VALUE"
  }
}

MCP

כדי לעדכן את מספר המעבדים או את הדגלים לניהול מסד הנתונים של מכונה ראשית ב-AlloyDB Express, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי update_instance ב-MCP.

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

  • ‫REGION_ID: האזור שבו נמצא האשכול.

  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

  • ‫CPU_COUNT: מספר ה-vCPU של המכונה (1 או 2).

  • ‫FLAG_NAME ו-FLAG_VALUE: אופציונלי: השם והערך של הדגל לניהול מסד הנתונים שרוצים להגדיר. אם אתם מעדכנים רק את מספר המעבדים, השמיטו את database_flags מ-arguments.

ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to CPU_COUNT vCPUs.

פרמטרים של קריאת API לכלי:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "cpu_count": CPU_COUNT,
      "database_flags": {
        "FLAG_NAME": "FLAG_VALUE"
      }
    }
  }
}

הצגת פרטי האשכול והמכונה של AlloyDB Express

אתם יכולים לראות רשימה של אשכולות AlloyDB Express, לראות פרטים על אשכול או מכונה ספציפיים של AlloyDB Express ולבדוק את נפח האחסון הנדרש למחשוב ולאחסון של האשכול.

למידע נוסף, ראו הצגת רשימת האשכולות, הצגת פרטי האשכול והצגת פרטי המכונה.

המסוף

  1. נכנסים לדף Clusters במסוף Google Cloud .

    כניסה לדף Clusters

    בעמודה Resource name, ליד השם של אשכולות AlloyDB Express מופיע התג Express.

  2. כדי לראות מידע מפורט על אשכול ועל המכונה הראשית שלו, לוחצים על שם האשכול בעמודה Resource name.

  3. בדף Overview, בודקים את פרטי האשכול בקטע Cluster details (כולל התג Express לצד Cluster ID ו-Total storage used מתוך המגבלה של 20GB) ואת פרטי המכונה הראשית בקטע Instances in your cluster.

gcloud

כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

  • כדי לראות את רשימת האשכולות בפרויקט, מריצים את הפקודה gcloud alloydb clusters list:

    gcloud alloydb clusters list --project=PROJECT_ID

  • כדי לראות פרטים על אשכול ספציפי, מריצים את הפקודה gcloud alloydb clusters describe:

    gcloud alloydb clusters describe CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • כדי לראות פרטים על מכונה ספציפית, מריצים את הפקודה gcloud alloydb instances describe:

    gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

REST

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

  • כדי לראות רשימה של אשכולות באזור מסוים, שולחים בקשת GET לנקודת הקצה (endpoint) של projects.locations.clusters.list:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters

  • כדי לראות פרטים על אשכול, שולחים בקשת GET לנקודת הקצה (endpoint) projects.locations.clusters.get:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID

  • כדי לראות פרטים על מכונה, שולחים בקשת GET לנקודת הקצה (endpoint) projects.locations.clusters.instances.get:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

MCP

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

  • ‫REGION_ID: האזור שבו נמצא האשכול.

  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

  • כדי לראות רשימה של אשכולות באזור, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי list_clusters ב-MCP.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID"
    }
  }
}

  • כדי לראות פרטים על אשכול, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי get_cluster ב-MCP.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please show the details of the AlloyDB cluster CLUSTER_ID in REGION_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
    }
  }
}

  • כדי לראות פרטים על מכונה, מזינים הנחיה בלקוח ה-MCP או מפעילים את הכלי get_instance ב-MCP.

    ב-MCP client, אתם יכולים להזין הנחיה כמו זו:

    Please show the details of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    פרמטרים של קריאת API לכלי:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

הצגת נתוני השימוש במשאבי מחשוב ובנפח אחסון נדרש

כדי לבדוק את נפח האחסון והמחשוב שבהם משתמשים האשכול והמכונה הראשית של AlloyDB Express, אפשר להשתמש במסוף Google Cloud או ב-Cloud Monitoring:

  • במסוף Google Cloud , פותחים את הדף Overview של האשכול:

    • נפח האחסון שבשימוש: בקטע Cluster details, בודקים את Total storage used כדי לראות כמה נפח אחסון האשכול מנצל מתוך המגבלה של 20GB.
    • חישוב וחיבורים: אפשר להציג את התרשימים CPU utilization ו-Active connections בדף Overview, או ללחוץ על System insights בתפריט הניווט כדי להציג מדדים מפורטים של המעבד, הזיכרון והאחסון.

  • ב-Cloud Monitoring Metrics Explorer, שולחים שאילתה לגבי המדדים הבאים של סוגי המשאבים במעקב alloydb.googleapis.com/Cluster ו-alloydb.googleapis.com/Instance:

    • שטח האחסון המנוצל: alloydb.googleapis.com/cluster/storage/usage
    • ניצול המעבד (CPU): alloydb.googleapis.com/instance/cpu/average_utilization ו-alloydb.googleapis.com/instance/cpu/maximum_utilization
    • חיבורים פעילים: alloydb.googleapis.com/database/postgresql/backends

מחיקת אשכול או מכונה של AlloyDB Express

אם אתם לא צריכים יותר את המכונה הראשית או את האשכול של AlloyDB Express, אתם יכולים למחוק אותם.

מידע נוסף זמין במאמרים מחיקת מכונה ומחיקת אשכול.

המסוף

  1. נכנסים לדף Clusters במסוף Google Cloud .

    כניסה לדף Clusters

  2. בעמודה Resource name, לוחצים על שם האשכול של AlloyDB Express.

  3. בדף Overview, מוחקים את המכונה הראשית או את האשכול:

    • כדי למחוק את המכונה הראשית, עוברים לקטע Instances in your cluster, לוחצים על Instance actions > Delete, מזינים את מזהה המכונה בתיבת הדו-שיח ולוחצים על Delete.
    • כדי למחוק את האשכול, קודם מוחקים את המכונה הראשית באשכול, ואז לוחצים על Delete cluster, מזינים את מזהה האשכול בתיבת הדו-שיח Delete cluster ולוחצים על Delete.

gcloud

כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

  • כדי למחוק מכונה, מריצים את הפקודה gcloud alloydb instances delete:

    gcloud alloydb instances delete INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • כדי למחוק אשכול, מריצים את הפקודה gcloud alloydb clusters delete. אם האשכול עדיין מכיל את המכונה הראשית, צריך לכלול את הדגל --force כדי למחוק את המכונה הראשית ואת האשכול ביחד:

    gcloud alloydb clusters delete CLUSTER_ID \
    --region=REGION_ID \
    --force \
    --project=PROJECT_ID

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

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

REST

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

  • ‫INSTANCE_ID: המזהה של המכונה הראשית של AlloyDB Express.

  • כדי למחוק מכונה, שולחים בקשת DELETE לנקודת הקצה projects.locations.clusters.instances.delete:

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

  • כדי למחוק אשכול (כולל המכונה הראשית שלו כשמציינים את force=true), שולחים בקשת DELETE לנקודת הקצה projects.locations.clusters.delete:

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?force=true

שדרוג אשכול AlloyDB Express ל-AlloyDB

אתם יכולים לשדרג את אשכול AlloyDB Express לאשכול AlloyDB בלי לשנות את המיקום שלו.

השדרוג שומר על נתוני מסד הנתונים, הסכימות, התוספים, פרטי הכניסה של המשתמשים, הגדרות הרשת (כולל שם ה-DNS הציבורי ונקודות הקצה של Private Service Connect) ומספר ה-vCPU של המכונה הראשית.

ברשימה הבאה מתוארים המשאבים וההגדרות שמשתנים במהלך תהליך השדרוג:

  • מספר המעבדים, יחס הזיכרון וקיבולת המחשוב: המכונה שומרת על מספר המעבדים הווירטואליים הנוכחי (vCPU אחד או 2 vCPU) ומשדרגת מיחס ה-vCPU לזיכרון של AlloyDB Express ‏(1:4, זיכרון RAM בנפח 4GB או 8GB) ליחס ה-vCPU לזיכרון של AlloyDB ‏(1:8, זיכרון RAM בנפח 8GB ל-vCPU אחד או זיכרון RAM בנפח 16GB ל-2 vCPU). אחרי השדרוג, אפשר להגדיל את המחשוב עד 288 מעבדי vCPU.
    • כשמשדרגים מכונה עם vCPU אחד, אפשר לבחור רק אזורים שתומכים בסדרת המכונות C4A. אזורים נתמכים עבור C4A
    • אם המכונה של AlloyDB Express לא נמצאת באזור שתומך בסוגי מכונות C4A, צריך קודם לעדכן את המכונה הראשית להגדרה של 2 vCPU לפני השדרוג. אם לוחצים על Upgrade במסוף Google Cloud למכונה עם מעבד וירטואלי אחד באזור שלא נתמך, מופיעה הודעה שבה מתבקשים לשנות את גודל המכונה ל-2 מעבדים וירטואליים.
  • חיוב ועיבוד מוקצה: השדרוג משבית את צמצום הפעולה לאפס, והמכונה פועלת כמכונה שפועלת תמיד ב-AlloyDB ומחויבת לפי התעריפים של AlloyDB.
  • נפח אחסון: השדרוג מסיר את מגבלת האחסון של 20GB. נפח האחסון גדל עד למכסת ברירת מחדל של 16TiB לכל אשכול, ואפשר לבקש להגדיל את מכסת האחסון עד ל-128TiB.
  • תכונות של Enterprise: השדרוג מאפשר זמינות גבוהה (HA) אזורית, שמכוסה על ידי הסכם רמת השירות (SLA) של 99.99% זמן פעולה תקינה. הוא גם מאפשר להשתמש במכונות של מאגר קריאה, ברפליקציה בין אזורים, בגיבוי ובשחזור רציפים ובגיבויים אוטומטיים ולפי דרישה.

כדי לשדרג אשכול AlloyDB Express לאשכול AlloyDB:

המסוף

  1. נכנסים לדף Clusters במסוף Google Cloud .

    כניסה לדף Clusters

  2. בעמודה Resource name, לוחצים על שם האשכול של AlloyDB Express.

  3. בדף Overview, בקטע Cluster details, מאתרים את Cluster ID ולוחצים על Upgrade.

    אם המכונה הראשית היא מכונה עם מעבד וירטואלי אחד באזור שלא תומך בסדרת המכונות C4A, תופיע ההודעה הבאה:

    Upgrading to AlloyDB requires a 2 vCPU instance in the REGION_ID region. Resize your instance to 2 vCPUs first.

    כדי לשנות את גודל המכונה ל-2 vCPUs, לוחצים על Edit instance. אחרי שמשנים את גודל המכונה, לוחצים שוב על Upgrade.

  4. בחלונית Upgrade from AlloyDB Express, מזינים את מזהה האשכול (Cluster ID) כדי לאשר את השדרוג ולוחצים על Confirm.

gcloud

כדי להשתמש ב-CLI של gcloud, אתם יכולים להתקין ולהפעיל את Google Cloud CLI או להשתמש ב-Cloud Shell.

כדי לשדרג את אשכול AlloyDB Express לאשכול AlloyDB, מריצים את הפקודה gcloud beta alloydb clusters update עם הדגל --no-enable-express:

gcloud beta alloydb clusters update CLUSTER_ID \
    --region=REGION_ID \
    --no-enable-express \
    --project=PROJECT_ID

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

  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .

אם המכונה הראשית היא מכונה עם מעבד וירטואלי אחד באזור שלא תומך בסדרת המכונות C4A, הפקודה נכשלת ומופיעה השגיאה הבאה:

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

כדי לפתור את השגיאה, מעדכנים את המכונה הראשית ל-2 מעבדי vCPU‏ (--cpu-count=2) ומריצים שוב את פקודת השדרוג.

REST

כדי לשדרג אשכול של AlloyDB Express לאשכול של AlloyDB, שולחים בקשת PATCH לנקודת הקצה projects.locations.clusters.patch עם updateMask=expressConfig.enabled ומגדירים את expressConfig.enabled כ-false.

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

  • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud .
  • ‫REGION_ID: האזור שבו נמצא האשכול.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB Express.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?updateMask=expressConfig.enabled

תוכן בקשת JSON:

{
  "expressConfig": {
    "enabled": false
  }
}

אם המכונה הראשית היא מכונה עם vCPU אחד באזור שלא תומך בסדרת המכונות C4A, הבקשה תיכשל ותופיע השגיאה הבאה:

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

כדי לפתור את השגיאה, מעדכנים את המכונה הראשית ל-2 מעבדי vCPU‏ ("machineConfig": {"cpuCount": 2}) ושולחים שוב את בקשת השדרוג.

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