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

‫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	לא נתמך	נתמך
‫Private Service Connect	לא נתמך	נתמך
שימוש בטווח כתובות IP	טווחים נוספים של כתובות IP שמשמשים לרשתות משנה ייעודיות למכונות עם כתובות IP פרטיות ב-Cloud SQL ל-PostgreSQL	אין צריכה של טווחים נוספים של כתובות IP במכונות Cloud SQL ל-PostgreSQL
מכסת המכונות של Cloud SQL שמוגדרת כברירת מחדל לכל פרויקט	100	1000

תכנון השדרוג

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

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

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

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

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

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

• אם הרשת שלכם כוללת לפחות שתי מכונות שמשתמשות בכתובות IP פרטיות באותו אזור, Cloud SQL יארח את המכונות בארכיטקטורת הרשת החדשה בטווח נוסף (או בטווחים נוספים) של כתובות ברשת משנה עם חלוקה ל-24 מ הטווחים של כתובות ה-IP שהוקצו לגישה לשירותים פרטיים (PSA). אם המופע משתמש בכתובת IP פרטית מסוג RFC 1918 (לדוגמה, בטווח 10.0.0.0/8,‏ 172.16.0.0/12 או 192.168.0.0/16), הטווח החדש שמוקצה צריך להיות גם הוא בטווח RFC 1918. אי אפשר להשתמש בטווחים שאינם RFC 1918 (כמו carrier-grade NAT (CGNAT) 100.64.0.0/10) כטווח זמני למופעי RFC 1918, והשדרוג ייכשל. ההקצאה הנוספת היא זמנית, והיא מוסרת במהלך אירוע תחזוקה עתידי של Cloud SQL.

  לא ניתן לשדרג מכונות וירטואליות שמשתמשות בכתובות IP פרטיות שאינן RFC 1918. כפתרון עקיף, משנים את הרשת הפרטית של המכונה לרשת אחרת, ואז משנים אותה בחזרה לרשת המקורית באמצעות הדגל --enforce-new-sql-network-architecture.

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

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

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

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

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

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

• שדרוג מכונה באופן מרומז: כשמשנים את הרשת הפרטית של מכונה או מפעילים את כתובת ה-IP הפרטית בפרויקט עם תמיכה ב-IPv4 ו-IPv6, יכול להיות ש-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 או בשיטה 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 או בשיטה 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

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, משתמשים בשיטה 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

כדי לבדוק את ארכיטקטורת הרשת של כמה מכונות בפרויקט, משתמשים בשיטה 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, בשיטה instance.update או בשיטה instance.patch.

gcloud

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

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

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

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

operation_id

REST v1

כדי לשדרג את ארכיטקטורת הרשת של מכונה, משתמשים בשיטה instance.update או בשיטה 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 תשודרג. מה צריך לעשות?
• כשניסיתי לשדרג את המופע שלי, קיבלתי את השגיאה 'מחוץ לטווח כתובות ה-IP השמורות'. מה צריך לעשות?

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

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

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

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

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

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

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

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

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

• עדכון כל המכונות הקיימות: עדכון כל המכונות הקיימות בפרויקט לארכיטקטורת הרשת החדשה. אם אתם משתמשים ב-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
• מידע נוסף על שירות העברת מסדי נתונים ל-AlloyDB ל-PostgreSQL