שדרוג מכונה לארכיטקטורת הרשת החדשה

MySQL   |  PostgreSQL   |  SQL Server

בדף הזה מוסבר איך לשדרג את המכונות של Cloud SQL מארכיטקטורת הרשת הישנה לארכיטקטורת הרשת החדשה.

הדף הזה, שעוסק בשדרוג של ארכיטקטורת הרשת ב-Cloud SQL, רלוונטי רק לחלק מהמכונות של Cloud SQL. אם במכונות של Cloud SQL נעשה שימוש בפרויקט של רשת בענן וירטואלי פרטי (VPC) שנוצר לפני אוגוסט 2021, צריך לשדרג את ארכיטקטורת הרשת של Cloud SQL במכונות.

סקירה כללית

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

יכולת	ארכיטקטורת רשת ישנה	ארכיטקטורת רשת חדשה
העברה מ-Cloud SQL ל-AlloyDB ל-PostgreSQL באמצעות Database Migration Service	צריך להגדיר כתובת IP פרטית להעברה	אין צורך בהגדרות רשת נוספות. לדוגמה, העברה מ-Cloud SQL ל-AlloyDB ל-PostgreSQL.
חיבור מכונת Cloud SQL באמצעות כתובת IP פרטית לשירותים פרטיים כמו Cloud Build או Vertex AI	אין תמיכה בגלל חוסר טרנזיטיביות של קישור בין רשתות שכנות (peering)	נתמך
מכונות שתואמות ל-Assured Workloads	לא נתמך	נתמך
Knowledge Catalog	לא נתמך	נתמך
AD בניהול הלקוח	לא נתמך	נתמך
שירות מנוהל ל-Microsoft AD	לא נתמך	נתמך
Private Service Connect	לא נתמך	נתמך
מכסת ברירת המחדל של מכונות Cloud SQL לכל פרויקט	100	1000

תכנון השדרוג

לפני שמשדרגים את ארכיטקטורת הרשת של מכונות Cloud SQL, צריך לתכנן את השדרוג בהתאם למגבלות הבאות:

• אם תשדרגו את ארכיטקטורת הרשת, המכונה תושבת ל-4 דקות בממוצע.

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

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

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

• אי אפשר לשדרג את ארכיטקטורת הרשת של מכונות ברשת עם יותר מ-300 מכונות של Cloud SQL.

תוכנית לשדרוג כל המכונות של Cloud SQL בפרויקט רשת

המכונות של Cloud SQL יכולות להיות באותו פרויקט של רשת ה-VPC או בפרויקט נפרד. הפרויקט שמארח את רשת ה-VPC הוא פרויקט הרשת.

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

כדי לשלוח שאילתה על ארכיטקטורת הרשת של כל המכונות בפרויקט, אתם יכולים להשתמש ב-ה-CLI של gcloud או ב-API.

שיקולים לגבי פרויקטים עם מחסנית כפולה

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

• שדרוג מכונה באופן משתמע: כשמשנים את הרשת הפרטית של מכונה או מפעילים את כתובת ה-IP הפרטית בפרויקט עם מחסנית כפולה, יכול להיות ש-Cloud SQL ישדרג את המכונה לארכיטקטורת הרשת החדשה באופן משתמע.
• אין שדרוג לאחור של הארכיטקטורה: שינויים ברשת אף פעם לא משדרגים לאחור את ארכיטקטורת הרשת של המכונה.
• דחיית בקשות: אם כדי להשלים שינוי ברשת נדרש שדרוג לאחור, Cloud SQL דוחה את הבקשה.
• אי אפשר להשתמש במכונות חדשות בטווחי כתובות ה-IP מארכיטקטורת הרשת הישנה: כשהפרויקט במצב מחסנית כפולה, אי אפשר ליצור מכונות שמשתמשות בטווחי כתובות ה-IP שמשויכים לחיבורי שירות מארכיטקטורת הרשת הישנה.

• אכיפת ארכיטקטורת הרשת החדשה: אתם יכולים לאלץ מכונה להשתמש בארכיטקטורת הרשת החדשה כשאתם יוצרים את המכונה או משנים את הגדרות הרשת שלה. כשמשתמשים בדגל --enforce-new-sql-network-architecture כדי ליצור או לעדכן את המכונה, המכונה ממוקמת בתת-רשת נפרדת ממכונות שמשתמשות בארכיטקטורת הרשת הישנה. ההפרדה היא קבועה, והיא נמשכת גם אחרי שמשדרגים את המכונות של ארכיטקטורת הרשת הישנה לארכיטקטורת הרשת החדשה.

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

כדי למנוע התנגשויות פוטנציאליות ולוודא ששדרוג הרשת יתבצע בצורה חלקה, מומלץ לתכנן את שדרוג כל המכונות בפרויקט לארכיטקטורה החדשה.

שדרוג ארכיטקטורת הרשת של Cloud SQL

כדי לשדרג את ארכיטקטורת הרשת של מכונת Cloud SQL:

1. בודקים את ארכיטקטורת הרשת של מכונה אחת של Cloud SQL או של כמה מכונות של Cloud SQL.
2. שדרוג ארכיטקטורת הרשת של מכונה ב-Cloud SQL

בדיקת ארכיטקטורת הרשת של מכונה אחת של Cloud SQL

כדי לבדוק את ארכיטקטורת הרשת הנוכחית של מכונה אחת, משתמשים בפקודה gcloud sql instances describe או ב-method‏ instances.get.

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך מתקינים את ה-CLI של gcloud ומתחילים להשתמש בו. למידע על הפעלת Cloud Shell, קראו את המאמר שימוש ב-Cloud Shell.

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

   gcloud sql instances describe INSTANCE_NAME
   

אם המכונה משתמשת בארכיטקטורת הרשת הישנה, התגובה תהיה דומה לזו:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE
  

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

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE
  

הפרמטר sqlNetworkArchitecture מציין אם המכונה משתמשת בארכיטקטורת הרשת הישנה (OLD_NETWORK_ARCHITECTURE) או בארכיטקטורת הרשת החדשה (NEW_NETWORK_ARCHITECTURE).

REST v1

כדי לבדוק את ארכיטקטורת הרשת של מכונה, משתמשים ב-method‏ instances.get של Cloud SQL Admin API.

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫INSTANCE_NAME: שם המכונה.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת מוגדר באופן הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

‫REST v1beta4

כדי לבדוק את ארכיטקטורת הרשת של מכונה, משתמשים ב-method‏ instances.get של Cloud SQL Admin API.

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫INSTANCE_NAME: שם המכונה.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת מוגדר באופן הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

בדיקת ארכיטקטורת הרשת של כמה מכונות Cloud SQL

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, משתמשים בפקודה gcloud sql instances list או ב-method‏ instance.list.

gcloud

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, מריצים את הפקודה הבאה:

gcloud sql instances list --show-sql-network-architecture

הפלט אמור להיראות כך:

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST v1

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, משתמשים ב-method‏ instance.list.

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת, לפי הפירוט הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

‫REST v1beta4

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, משתמשים ב-method‏ instance.list.

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת מוגדר באופן הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

שדרוג ארכיטקטורת הרשת של מכונה אחת של Cloud SQL

כדי לשדרג את ארכיטקטורת הרשת של מכונה אחת, משתמשים בפקודה gcloud sql instances patch, ב-method‏ instance.update או ב-method‏ instance.patch.

gcloud

כדי לשדרג את ארכיטקטורת הרשת של מכונה, מריצים את הפקודה הבאה:

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

פעולת השדרוג נמשכת כמה דקות.

במהלך השדרוג, מתחילה פעולה ממושכת ומוחזר טוקן של הפעולה:

operation_id

REST v1

כדי לשדרג את ארכיטקטורת הרשת של מכונה, משתמשים ב-instance.update או ב-method ‏instance.patch של Cloud SQL Admin API.

כשמשדרגים את ארכיטקטורת הרשת של Cloud SQL, אי אפשר לבצע עדכונים נוספים למכונה בבקשה. גוף הבקשה מכיל מופע של האובייקט DatabaseInstance, כאשר sqlNetworkArchitecture מוגדר כ-NEW_NETWORK_ARCHITECTURE.

במהלך השדרוג, מתחילה פעולה ממושכת ומוחזר טוקן של הפעולה:

operation_id

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫INSTANCE_NAME: שם המכונה.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת מוגדר באופן הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

אם השדרוג של המכונה נכשל, נסו שוב.

‫REST v1beta4

כדי לשדרג את ארכיטקטורת הרשת של מכונה, משתמשים ב-instance.update method או ב-instance.patch method של Cloud SQL Admin API.

כשמשדרגים את ארכיטקטורת הרשת של Cloud SQL, אי אפשר לבקש עדכונים נוספים למכונה. גוף הבקשה מכיל מופע של האובייקט DatabaseInstance, כאשר sqlNetworkArchitecture מוגדר כ-NEW_NETWORK_ARCHITECTURE.

במהלך השדרוג, מתחילה פעולה ממושכת ומוחזר אסימון הפעולה הבא:

operation_id

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫INSTANCE_NAME: שם המכונה.
• ‫NETWORK_ARCHITECTURE_TYPE: סוג הארכיטקטורה של הרשת מוגדר באופן הבא:
  • ‫OLD_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת הישנה.
  • ‫NEW_NETWORK_ARCHITECTURE: המכונה משתמשת בארכיטקטורת הרשת החדשה.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

תוכן בקשת JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

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

שאלות נפוצות

כאן מופיעות תשובות לשאלות נפוצות לגבי שדרוג ארכיטקטורת הרשת של Cloud SQL.

• איך השדרוג משפיע על המכונה שלי ב-Cloud SQL?
• האם כל התכונות פועלות באותו אופן אחרי השדרוג?
• אילו מכונות משתמשות בארכיטקטורת הרשת הישנה?
• האם כל המכונות החדשות של Cloud SQL נוצרות בארכיטקטורת הרשת החדשה?
• אפשר לעדכן את כל המכונות בפרויקט באמצעות פקודה אחת?
• האם הרפליקה משודרגת באופן אוטומטי אם משדרגים את המכונה הראשית?
• קיבלתי הודעה שארכיטקטורת הרשת של מכונות Cloud SQL שלי תשודרג. מה צריך לעשות?
• כשאני מנסה לשדרג את המכונה, מופיעה הודעת השגיאה "outside the reserved IP address range". מה צריך לעשות?

איך השדרוג ישפיע על המכונה שלי ב-Cloud SQL?

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

האם כל התכונות פועלות באותו אופן אחרי השדרוג?

כל התכונות של מכונת Cloud SQL פועלות בארכיטקטורה החדשה בדיוק כמו בארכיטקטורה הישנה. אחרי שמשדרגים מכונה לארכיטקטורת הרשת החדשה, אם רוצים להחליף את הרשת של המכונה, צריך לוודא שכל המכונות ברשת היעד משודרגות גם הן לארכיטקטורת הרשת החדשה.

אילו מכונות משתמשות בארכיטקטורת הרשת הישנה?

כל הפרויקטים החדשים שנוצרו אחרי אוגוסט 2021 משתמשים באופן אוטומטי בארכיטקטורת הרשת החדשה. פרויקטים קיימים יכולים להכיל מכונות של Cloud SQL שנוצרו לפני אוגוסט 2021 ועדיין משתמשות בארכיטקטורת הרשת הישנה. לכן, צריך לשדרג את כל המכונות בפרויקט קיים לפני שכל מכונה חדשה בפרויקט תוכל להתחיל להשתמש בארכיטקטורת הרשת החדשה.

האם כל המכונות החדשות של Cloud SQL נוצרות בארכיטקטורת הרשת החדשה?

כברירת מחדל, מכונות חדשות של Cloud SQL שנוצרו בפרויקטים שנוצרו אחרי אוגוסט 2021 משתמשות בארכיטקטורת הרשת החדשה.

אם רוצים ליצור מכונה בפרויקט שנוצר לפני אוגוסט 2021 ולהשתמש בארכיטקטורת הרשת החדשה, יש כמה אפשרויות:

• Update all existing instances: עדכון כל המכונות הקיימות בפרויקט לארכיטקטורת הרשת החדשה. אם אתם משתמשים ב-VPC משותף, אתם צריכים לעדכן את כל המכונות בפרויקטים שמשתתפים ב-VPC המשותף. אחרי שמעדכנים את כל המכונות הקיימות בפרויקט, צריך להמתין כמה שעות לפני שיוצרים מכונות נוספות בפרויקט. מכונות חדשות שתיצרו בפרויקט ישתמשו בארכיטקטורת הרשת החדשה.

• אכיפת השימוש בארכיטקטורת הרשת החדשה: אתם יכולים לאלץ את Cloud SQL להשתמש בארכיטקטורת הרשת החדשה באמצעות השדה sqlNetworkArchitecture ב-API או הדגל --enforce-new-sql-network-architecture ב-CLI של gcloud כשאתם יוצרים מכון או משנים את הגדרת הרשת של כתובת ה-IP הפרטית של מכון קיים. עם זאת, אם תאכפו ארכיטקטורת רשת חדשה למכונות לפני שהפרויקט ישודרג באופן מלא, יכול להיות שלא תצליחו ליצור מכונות אם אין מספיק מקום לכתובות IP. לפרטים נוספים על הקצאת טווחים של כתובות IP, קראו את המאמר טווחים של כתובות IP שהוקצו.

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

האם אפשר לעדכן את כל המכונות בפרויקט באמצעות פקודה אחת?

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

האם הרפליקה משודרגת באופן אוטומטי אם משדרגים את המכונה הראשית?

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

קיבלתי הודעה שארכיטקטורת הרשת של מכונות Cloud SQL שלי תשודרג. מה עליי לעשות?

אתם לא צריכים לעשות שום דבר.

במקרים מסוימים, כשהשדרוג האוטומטי מתרחש ברשת פרטית, הבקשה נדחית באופן זמני. כדי לעקוף את הבעיה, אתם יכולים לשדרג בעצמכם את ארכיטקטורת הרשת של המכונה, לפי ההוראות במאמר שדרוג ארכיטקטורת הרשת של מכונה אחת ב-Cloud SQL.

כשאני מנסה לשדרג את המכונה, מופיעה השגיאה "מחוץ לטווח כתובות ה-IP השמורות". מה עליי לעשות?

כדי להשתמש במכונות Cloud SQL ברשת VPC עם כתובת IP פרטית, צריך להקצות טווחים של כתובות IP כשמגדירים גישה לשירותים פרטיים ברשת ה-VPC.

לדוגמה, אם טווח כתובות ה-IP שהוקצה משתנה או נמחק, יכול להיות שתופיע שגיאה דומה לזו:

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

בדוגמה הזו, השם של טווח כתובות ה-IP המקורי שהוקצה הוא google-managed-services-VPC_NETWORK_NAME, וטווח כתובות ה-IP המקורי שהוקצה הוא 10.0.0.0/16. לאחר מכן יוצרים מכונה עם כתובת IP פרטית של 10.0.0.1. אם טווח כתובות ה-IP של google-managed-services-VPC_NETWORK_NAME נמחק או מעודכן כך שיתייחס לטווח של 10.1.0.0/16, הטווח הזה לא מכסה את כתובת ה-IP הפרטית של המכונה 10.0.0.1. לאחר מכן, כשמנסים לשדרג את ארכיטקטורת הרשת של המכונה, מופיעה השגיאה outside the reserved IP address range.

כדי לפתור את הבעיה, צריך לפעול לפי ההוראות במאמר הגדרת גישה לשירותים פרטיים ב-Cloud SQL. מקצים מחדש טווח כתובות IP שכולל את כתובת ה-IP של המכונה, לטווחים שהוקצו לגישה לשירותים פרטיים. לכל הפחות, אפשר להקצות את טווח כתובות ה-IP שדווח בהודעת השגיאה (בדוגמה הקודמת, 10.0.0.0/24).

ואז מנסים שוב לשדרג את ארכיטקטורת הרשת.

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

• מידע נוסף על Private Service Connect
• מידע נוסף על Assured Workloads
• מידע נוסף על הגדרת גישה לשירותים פרטיים ב-Cloud SQL
• מידע נוסף על Database Migration Service ל-AlloyDB ל-PostgreSQL