מחיקת מכונות

‫MySQL   |  PostgreSQL   |  SQL Server

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

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

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

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

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

ההרשאות הנדרשות

כברירת מחדל, רק לחשבונות משתמשים או לחשבונות שירות עם התפקיד Cloud SQL Admin (roles/cloudsql.admin) או Owner (roles/owner) יש הרשאה למחוק מכונה של Cloud SQL (cloudsql.instances.delete).

אפשר גם להגדיר תפקיד בהתאמה אישית ב-IAM למשתמש או לחשבון השירות, שכולל את ההרשאה cloudsql.instances.delete. ההרשאה הזו נתמכת בתפקידים בהתאמה אישית ב-IAM.

מחיקת מכונה

אפשר למחוק מכונה של Cloud SQL באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API. אם רוצים לשמור את הגיבויים של המכונה לפני שמוחקים אותה, אפשר לעיין במאמר ניהול הגיבויים שנשמרו.

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

אם השתמשתם ב-Cloud Key Management Service כדי להצפין את המכונה, אבל אין גישה למפתחות ה-KMS, אחרי שתמחקו את המכונה הסטטוס של הגיבוי הסופי יהיה FAILED. במקרה כזה, תוכלו לבקש לשחזר את המכונה באמצעות פנייה ל-Cloud Customer Care תוך 4 ימים מהמועד שבו מחקתם את המכונה.

אם מוחקים מכונה שמופעל בה Private Service Connect, מתרחשות הפעולות הבאות:

• הקובץ המצורף לשירות יוסר באופן אוטומטי. עם זאת, נקודת הקצה של Private Service Connect שמפנה לצירוף השירות לא נמחקת באופן אוטומטי. אם תציגו את כלל ההעברה שמשויך לנקודת הקצה, תוכלו לראות שהסטטוס של הכלל הוא CLOSED. אחרי שמופיע הסטטוס הזה, אפשר למחוק את נקודת הקצה.
• החיבור לנקודת הקצה נכשל בגלל פסק זמן.

כדי להימנע מעלויות נוספות, מומלץ מאוד למחוק גם את תחום ה-DNS ואת רשומת ה-DNS המתאימים.

המסוף

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

   כניסה לדף Cloud SQL Instances

2. כדי לפתוח את הדף Overview של מכונה, לוחצים על שם המכונה.
3. לוחצים על Delete.
4. בתיבת הדו-שיח Delete instance, מבצעים את הפעולות הבאות:
1. בשדה הטקסט, מזינים את מזהה המכונה שמופיע.

2. אם רוצים ליצור גיבוי סופי של המכונה, משאירים את תיבת הסימון Take a final backup מסומנת, מרחיבים את התפריט Retention options, ובשדה Retain for מזינים את מספר הימים לשמירת הגיבוי הסופי. אפשר לציין בין יום אחד ל-365 ימים.

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

3. באזור הטקסט Describe this backup, אפשר להוסיף תיאור של הגיבוי.
4. לוחצים על Delete.

gcloud

כדי למחוק מכונה, משתמשים בפקודה gcloud sql instances delete:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

מחליפים את הפרטים הבאים:

• ‫INSTANCE_NAME: השם של המכונה
• ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שרוצים למחוק.

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

• ‫--enable-final-backup: מגדירים את הערך של הדגל הזה ל-true כדי ליצור גיבוי סופי. אם רוצים למחוק את המכונה בלי ליצור גיבוי סופי, צריך להגדיר את הערך ל-false.
• ‫--final-backup-description: פרטים על הגיבוי הסופי. ערך ברירת המחדל ריק.
• ‫--final-backup-ttl-days: מציינים את מספר הימים לשמירת הגיבוי הסופי. הזמן הזה נקרא "אורך חיים" (TTL). ערך ברירת המחדל הוא 30 ימים. תקופת השמירה המותרת משתנה, בין יום אחד ל-365 ימים. כדי לציין את תקופת השמירה, צריך להשתמש בדגל הזה או בדגל --final-backup-expiry-time.
• ‫--final-backup-expiry-time: חותמת זמן (ב-UTC) של מועד התפוגה של הגיבוי. התקופה לא יכולה להיות ארוכה משנה. כדי לציין את תקופת השמירה, צריך להשתמש בדגל הזה או בדגל --final-backup-ttl-days.

REST v1

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

• ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שרוצים למחוק.
• ‫INSTANCE_NAME: השם של המכונה

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

• enable_final_backup: מגדירים את הערך של הפרמטר הזה ל-true כדי ליצור גיבוי סופי. אם רוצים למחוק את המכונה בלי ליצור גיבוי סופי, צריך להגדיר את הערך ל-false.
• ‫final_backup_description: פרטים על הגיבוי הסופי. ערך ברירת המחדל ריק.
• ‫final_backup_ttl_days: מציינים את מספר הימים לשמירת הגיבוי הסופי. הזמן הזה נקרא "אורך חיים" (TTL). ערך ברירת המחדל הוא 30 ימים. תקופת השמירה המותרת משתנה, בין יום אחד ל-365 ימים. כדי לציין את תקופת השמירה, צריך להשתמש בפרמטר הזה או ב-final_backup_expiry_time.
• ‫final_backup_expiry_time: חותמת זמן (ב-UTC) של מועד התפוגה של הגיבוי. התקופה לא יכולה להיות ארוכה משנה. כדי לציין את תקופת השמירה, צריך להשתמש בפרמטר הזה או ב-final_backup_ttl_days.

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

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

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

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

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

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

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

מריצים את הפקודה הבאה:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, אפשר לעיין ב-APIs Explorer בדף instances:delete.

REST v1beta4

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

• ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט ב- Google Cloud שמכיל את המכונה שרוצים למחוק.
• ‫INSTANCE_NAME: השם של המכונה

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

• enable_final_backup: מגדירים את הערך של הפרמטר הזה ל-true כדי ליצור גיבוי סופי. אם רוצים למחוק את המכונה בלי ליצור גיבוי סופי, צריך להגדיר את הערך ל-false.
• ‫final_backup_description: פרטים על הגיבוי הסופי. ערך ברירת המחדל ריק.
• ‫final_backup_ttl_days: מציינים את מספר הימים לשמירת הגיבוי הסופי. הזמן הזה נקרא "אורך חיים" (TTL). ערך ברירת המחדל הוא 30 ימים. תקופת השמירה המותרת משתנה, בין יום אחד ל-365 ימים. כדי לציין את תקופת השמירה, צריך להשתמש בפרמטר הזה או ב-final_backup_expiry_time.
• ‫final_backup_expiry_time: חותמת זמן (ב-UTC) של מועד התפוגה של הגיבוי. התקופה לא יכולה להיות ארוכה משנה. כדי לציין את תקופת השמירה, צריך להשתמש בפרמטר הזה או ב-final_backup_ttl_days.

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

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

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

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

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

מריצים את הפקודה הבאה:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

‎PowerShell (Windows)

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

מריצים את הפקודה הבאה:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, אפשר לעיין ב-APIs Explorer בדף instances:delete.

שחזור של מכונה שנמחקה

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

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

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

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