בדף הזה מוסבר איך להשתמש במפתחות הצפנה בניהול הלקוח (CMEK) שנוצרו באופן ידני ב-Spanner.
למידע נוסף על CMEK, קראו את הסקירה הכללית על מפתחות הצפנה בניהול הלקוח (CMEK).
יצירת מסד נתונים עם CMEK
יוצרים מפתח ב-Cloud Key Management Service (Cloud KMS). ב-Spanner אפשר להשתמש בסוגי המפתחות הבאים, שיש להם רמות הגנה שונות:
המפתח צריך להיות באותו מיקום שבו נמצא המכונה של Spanner. לדוגמה, אם המכונה של Spanner מוגדרת ב-
us-west1, גם המיקום של אוסף המפתחות של Cloud KMS צריך להיות ב-us-west1.לא לכל הגדרת מכונה במספר אזורים ב-Spanner יש מיקום תואם של אוסף מפתחות ב-Cloud KMS. במסדי נתונים של Spanner בהגדרות של מכונות בהתאמה אישית, בשני אזורים או במספר אזורים, אתם יכולים להשתמש בכמה מפתחות Cloud KMS אזוריים (באזור יחיד) כדי להגן על מסד הנתונים. לדוגמה:
- אם מסד הנתונים של Spanner נמצא במכונה עם הגדרה של מספר אזורים
nam14, אתם יכולים ליצור מפתחות Cloud KMS ב-us-east4, ב-northamerica-northeast1וב-us-east1. - אם למסד הנתונים יש הגדרת מכונה בהתאמה אישית שמשתמשת ב-
nam3בתור הגדרת המכונה הבסיסית, עם רפליקה נוספת לקריאה בלבד ב-us-central2, אתם יכולים ליצור מפתחות Cloud KMS ב-us-east4, ב-us-east1, ב-us-central1וב-us-central2.
אופציונלי: כדי לראות רשימה של מיקומי הרפליקות בהגדרת המכונה של Spanner, משתמשים בפקודה
gcloud spanner instances get-locations:gcloud spanner instances get-locations <var>INSTANCE_ID</var>מידע נוסף זמין במקורות המידע הבאים:
- אם מסד הנתונים של Spanner נמצא במכונה עם הגדרה של מספר אזורים
נותנים ל-Spanner גישה למפתח.
ב-Cloud Shell, יוצרים ומציגים את סוכן השירות, או מציגים אותו אם החשבון כבר קיים:
gcloud beta services identity create --service=spanner.googleapis.com \ --project=PROJECT_IDאם מוצגת בקשה להתקין את הרכיב gcloud Beta Commands, מקלידים
Y. אחרי ההתקנה, הפקודה מופעלת מחדש באופן אוטומטי.הפקודה
gcloud services identityיוצרת או מקבלת את סוכן השירות ש-Spanner יכול להשתמש בו כדי לגשת למפתח Cloud KMS בשמכם.המזהה של חשבון השירות נראה כמו כתובת אימייל:
Service identity created: service-xxx@gcp-sa-spanner.מקצים את התפקיד Cloud KMS CryptoKey Encrypter/Decrypter (
cloudkms.cryptoKeyEncrypterDecrypter) לחשבון השירות בכל אזור (--location) במערך של מכונת Spanner. כדי לעשות זאת, מריצים את הפקודהgcloud kms keys add-iam-policybinding:gcloud kms keys add-iam-policy-binding KMS_KEY \ --location KMS_KEY_LOCATION \ --keyring KMS_KEY_RING \ --project=PROJECT_ID \ --member serviceAccount:service-xxx@gcp-sa-spanner. \ --role roles/cloudkms.cryptoKeyEncrypterDecrypterהנה פלט לדוגמה:
Updated IAM policy for key [KMS_KEY]אם אתם משתמשים בכמה מפתחות Cloud KMS כדי להגן על מסד הנתונים, הריצו את הפקודה
gcloud kms keys add-iam-policybindingלכל המפתחות.התפקיד הזה מבטיח שלחשבון השירות יש הרשאה להצפין ולפענח באמצעות המפתח של Cloud KMS. מידע נוסף זמין במאמר הרשאות ותפקידים ב-Cloud KMS.
יוצרים את מסד הנתונים ומציינים את המפתח של Cloud KMS.
המסוף
אפשר להשתמש במסוף כדי ליצור מסדי נתונים בהגדרות של מכונות אזוריות.
נכנסים לדף Instances במסוף Google Cloud .
לוחצים על המכונה שבה רוצים ליצור מסד נתונים.
לוחצים על Create database וממלאים את שדות החובה.
לוחצים על הצגת אפשרויות ההצפנה.
בוחרים באפשרות מפתח Cloud KMS.
בוחרים מפתח מהרשימה הנפתחת.
רשימת המפתחות מוגבלת לפרויקט הנוכחי ב- Google Cloud . כדי להשתמש במפתח מפרויקט אחר ב- Google Cloud , צריך ליצור את מסד הנתונים באמצעות ה-CLI של gcloud במקום מסוףGoogle Cloud .
אחרי שיוצרים את מסד הנתונים, אפשר לוודא שהוא מוגן באמצעות CMEK בדף Database overview.

gcloud
כדי ליצור מסד נתונים עם CMEK במערך של מכונות אזוריות, בהתאמה אישית או במספר אזורים, מריצים את הפקודה gcloud spanner databases create:
gcloud spanner databases create DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--ddl="CREATE TABLE Users (Id INT64 NOT NULL, FirstName STRING(100) NOT NULL, LastName STRING(100) NOT NULL,) PRIMARY KEY (Id)" \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEYRING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]כדי לוודא שמסד הנתונים מוגן באמצעות CMEK, מריצים את הפקודה gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDמסדי נתונים שמופעל בהם CMEK כוללים שדה של encryptionConfig, כמו שמוצג בפלט לדוגמה הבא:
encryptionConfig:
kmsKeyNames:projects/my-kms-project/locations/eur5/keyRings/my-kms-key-ring/cryptoKeys/my-kms-key
name: projects/my-spanner-project/instances/my-instance/databases/my-db
state: READY
ספריות לקוח
C#
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
C++
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
המשך
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
Java
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
Node.js
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
PHP
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
Python
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
Ruby
כדי ליצור מסד נתונים עם CMEK במכונה אזורית:
כדי ליצור מסד נתונים עם CMEK במכונה שמוגדרת במספר אזורים:
שינוי הגדרות ההצפנה של מסד הנתונים
אתם יכולים לשנות את הגדרת ההצפנה של מסד נתונים קיים ב-Spanner בלי זמן השבתה, באמצעות ה-CLI של gcloud, ה-API ל-REST או ה-API ל-RPC. אפשר לבצע את השינויים הבאים בהגדרות ההצפנה של מסד נתונים קיים:
- הפעלת CMEK במסד נתונים שמשתמש ב- Google-owned and Google-managed encryption key.
- שינוי המפתחות של Cloud KMS במסד נתונים שמופעל בו CMEK, כולל מעבר בין מפתח במספר אזורים למספר מפתחות אזוריים, או החלפה של מפתח אזורי אחד או יותר. החלפה של מפתח אזורי כלשהו מצפינה מחדש את כל הנתונים במסד הנתונים, ולא רק את הנתונים באותו אזור.
- הסרת CMEK והחזרת מסד נתונים ל- Google-owned and Google-managed encryption key.
במהלך ההצפנה מחדש ברקע, יכול להיות שמספר קטן של טרנזקציות ייכשל עם שגיאת ABORTED שאפשר לנסות שוב. ספריות הלקוח של Spanner מנסות לבצע מחדש את הטרנזקציות האלה באופן אוטומטי. אם אתם משתמשים ישירות ב-API ל-REST או ל-RPC, נסו שוב את הטרנזקציות האלה באפליקציה.
מעבר ממפתח יחיד במספר אזורים למספר מפתחות אזוריים משנה את אופן הפעולה של ביטול המפתח. אם משביתים מפתח אחד או את כל המפתחות האזוריים בבת אחת, בדרך כלל מסד הנתונים הופך ללא נגיש תוך שעה. אם משביתים רק קבוצת משנה של מפתחות אזוריים, יכול להיות שיעברו עד 24 שעות לפני שלא תהיה גישה למסד הנתונים. מידע נוסף זמין במאמר השבתת המפתח.
הפעלה של CMEK או שינוי של מפתחות Cloud KMS
כדי להפעיל את CMEK במסד נתונים קיים או לשנות את מפתחות Cloud KMS במסד נתונים שמופעל בו CMEK:
יוצרים את מפתחות היעד של Cloud KMS במיקומים הנדרשים, ומקצים את התפקיד Cloud KMS CryptoKey Encrypter/Decrypter (
roles/cloudkms.cryptoKeyEncrypterDecrypter) בכל מפתח יעד לסוכן השירות של Spanner בפרויקט, כמו שמתואר בשלבים 1 ו-2 במאמר יצירת מסד נתונים שתומך ב-CMEK.מעדכנים את הגדרת ההצפנה של מסד הנתונים:
gcloud
מריצים את הפקודה
gcloud spanner databases updateומציינים את השמות המלאים של המשאבים של מפתחות Cloud KMS המטורגטים באמצעות הדגל--kms-keys.למפתח באזור אחד או במספר אזורים:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY"אם יש כמה מפתחות אזוריים בהגדרת מכונה בהתאמה אישית, בשני אזורים או במספר אזורים, צריך לציין רשימה מופרדת בפסיקים שמכילה את כל השמות של משאבי המפתחות הנדרשים של Cloud KMS לכל האזורים בהגדרת המכונה, גם אם מחליפים רק קבוצת משנה של המפתחות:
gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --kms-keys="projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2,projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3"REST
מפעילים את השיטה
projects.instances.databases.patchעםupdateMask=encryption_configומציינים את היעדencryptionConfig.למפתח באזור אחד או במספר אזורים:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KMS_KEY" ] } }כדי להגדיר כמה מפתחות אזוריים במערך מותאם אישית, בשני אזורים או במספר אזורים, צריך לציין מערך שמכיל את כל השמות של משאבי המפתחות של Cloud KMS שנדרשים לכל האזורים במערך, גם אם מחליפים רק קבוצת משנה של המפתחות:
PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": { "kmsKeyNames": [ "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_1/keyRings/KMS_KEY_RING_1/cryptoKeys/KMS_KEY_1", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_2/keyRings/KMS_KEY_RING_2/cryptoKeys/KMS_KEY_2", "projects/KMS_PROJECT_ID/locations/KMS_KEY_LOCATION_3/keyRings/KMS_KEY_RING_3/cryptoKeys/KMS_KEY_3" ] } }צריך להמתין עד שההצפנה מחדש ברקע תסתיים לפני שמשנים שוב את הגדרות ההצפנה של מסד הנתונים, או לפני שמשביתים, מבטלים או משמידים מפתחות קודמים של Cloud KMS. כדאי גם לשמור את המפתחות למקרה שתצטרכו אותם כדי לשחזר מגיבויים. כדי לבדוק אם ההצפנה מחדש ברקע הסתיימה, עיינו בקטע אימות השלמת ההצפנה מחדש ברקע.
חזרה לגרסה קודמת של מסד נתונים ב- Google-owned and Google-managed encryption key
כדי להסיר את מפתח ה-CMEK ממסד נתונים קיים ולהחזיר אותו ל-Google-owned and Google-managed encryption key, מבצעים את הפעולות הבאות:
מעדכנים את הגדרות ההצפנה של מסד הנתונים כדי למחוק את המפתחות של Cloud KMS:
gcloud
מריצים את הפקודה
gcloud spanner databases updateעם הדגל--clear-kms-keys:gcloud spanner databases update DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --clear-kms-keysREST
מבצעים קריאה ל-method
projects.instances.databases.patchעםupdateMask=encryption_configו-encryptionConfigריק:PATCH https://spanner.googleapis.com/v1/projects/SPANNER_PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE?updateMask=encryption_config { "encryptionConfig": {} }צריך להמתין עד שההצפנה מחדש ברקע תסתיים לפני שמשנים שוב את הגדרות ההצפנה של מסד הנתונים, או לפני שמשביתים, מבטלים או משמידים מפתחות קודמים של Cloud KMS. כדאי גם לשמור את המפתחות למקרה שתצטרכו אותם כדי לשחזר מגיבויים. כדי לבדוק אם ההצפנה מחדש ברקע הסתיימה, עיינו בקטע אימות השלמת ההצפנה מחדש ברקע.
אימות השלמת ההצפנה מחדש ברקע
פעולת העדכון של מסד הנתונים מסתיימת כשמפתח encryptionConfig החדש נשמר, ו-Spanner מצפין מחדש את הנתונים הקיימים במסד הנתונים באופן אסינכרוני ברקע. ההצפנה מחדש ברקע יכולה להימשך כמה שעות. שינוי או הסרה של מפתחות נמשכים יותר זמן מהוספת CMEK, ובמסדי נתונים גדולים יותר התהליך יכול להימשך יותר זמן.
כדי לבדוק את הסטטוס של ההצפנה מחדש ברקע, מריצים את הפקודה gcloud spanner databases describe:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--format="yaml(encryptionConfig,encryptionInfo)"משתמשים בפלט של encryptionInfo כדי לקבוע אם ההצפנה מחדש ברקע הושלמה:
- שינוי מפתחות של Cloud KMS: בזמן שההצפנה מחדש מתבצעת ברקע, ב-
encryptionInfoמופיעות גם הגרסאות הקודמות וגם הגרסאות המעודכנות של מפתחות Cloud KMS. ההצפנה מחדש מסתיימת כשב-encryptionInfoמופיעות רק גרסאות מפתח ששייכות למפתחות היעד ב-encryptionConfig. במסדי נתונים עם כמה מפתחות אזוריים, גרסאות קודמות של מפתחות יוצאות מ-encryptionInfoאזור אחד בכל פעם, לכן צריך להמתין עד שאף רשומה לא תפנה לגרסה קודמת של מפתח. - חזרה לגרסה Google-owned and Google-managed encryption key: בזמן שההצפנה מחדש מתבצעת ברקע, ב-
encryptionInfoממשיכות להופיע הגרסאות הקודמות של מפתחות Cloud KMS. ההצפנה מחדש מסתיימת כשאין יותר רשומות שלCUSTOMER_MANAGED_ENCRYPTIONב-encryptionInfo. - הפעלת CMEK במסד נתונים שנעשה בו שימוש ב- Google-owned and Google-managed encryption key:
יכול להיות שהשדה
encryptionInfoיהיה ריק למשך כמה דקות אחרי השינוי. לאחר מכן, מופיעה רשימה של גרסאות המפתחות החדשות של Cloud KMS אחרי שהן בשימוש, שעשויה להופיע לפני שכל הנתונים הקיימים שמוגנים על ידיGoogle-owned and Google-managed encryption key סיימו את ההצפנה מחדש ברקע. האירועencryptionInfoלא מציין מתי מסתיימת ההצפנה מחדש של הנתונים הקיימים.
הצגת גרסאות המפתחות שבשימוש
בשדה encryption_info של מסד הנתונים מוצג מידע על גרסאות המפתחות.
כשגרסת מפתח עוברת רוטציה ב-Cloud KMS, encryption_info מתעדכן ברגע שהגרסה החדשה נמצאת בשימוש. כשמשנים את הגדרת ההצפנה של מסד הנתונים, ב-encryption_info מופיעות גרסאות המפתחות שעדיין בשימוש, כולל גרסאות המפתחות הקודמות, עד שההצפנה מחדש ברקע מסתיימת. למידע נוסף, קראו את המאמר אימות השלמת ההצפנה מחדש ברקע.
המסוף
נכנסים לדף Instances במסוף Google Cloud .
לוחצים על המכונה שמכילה את מסד הנתונים שרוצים לראות.
לוחצים על מסד הנתונים.
פרטי ההצפנה מוצגים בדף Database details.

gcloud
כדי לקבל את הערך encryption_info של מסד נתונים, מריצים את הפקודה gcloud spanner databases describe או gcloud spanner databases list. לדוגמה:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDהנה פלט לדוגמה:
name: projects/my-project/instances/test-instance/databases/example-db
encryptionInfo:
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key1-location/keyRings/my-kms-key-ring1/cryptoKeys/my-kms-key1/cryptoKeyVersions/1
- encryptionType: CUSTOMER_MANAGED_ENCRYPTION
kmsKeyVersion: projects/my-kms-project/locations/my-kms-key2-location/keyRings/my-kms-key-ring2/cryptoKeys/my-kms-key2/cryptoKeyVersions/1
השבתת המפתח
משביתים את גרסאות המפתחות שנמצאות בשימוש, לפי ההוראות האלה לכל גרסת מפתח.
מחכים שהשינוי ייכנס לתוקף. השבתת מפתח יכולה להימשך עד שלוש שעות.
כדי לוודא שאין יותר גישה למסד הנתונים, מריצים שאילתה במסד הנתונים שבו הושבת ה-CMEK:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'מופיעה הודעת השגיאה הבאה:
KMS key required by the Spanner resource is not accessible.
הפעלת המפתח
מפעילים את גרסאות המפתחות שנמצאות בשימוש במסד הנתונים, לפי ההוראות האלה לכל גרסת מפתח.
מחכים שהשינוי ייכנס לתוקף. הפעלת מפתח יכולה להימשך עד שלוש שעות.
כדי לוודא שאין יותר גישה למסד הנתונים, מריצים שאילתה במסד הנתונים שמופעל בו CMEK:
gcloud spanner databases execute-sql DATABASE \ --project=SPANNER_PROJECT_ID \ --instance=INSTANCE_ID \ --sql='SELECT * FROM Users'אם השינוי נכנס לתוקף, הפקודה תתבצע בהצלחה.
גיבוי מסד נתונים
אתם יכולים להשתמש בגיבויים של Spanner כדי ליצור גיבויים של מסדי הנתונים. כברירת מחדל, גיבויים של Spanner שנוצרו ממסד נתונים משתמשים באותה תצורת הצפנה כמו מסד הנתונים עצמו. אפשר גם לציין הגדרת הצפנה אחרת לגיבוי.
אם מסד נתונים משתמש בכמה מפתחות Cloud KMS אזוריים, הגיבויים שלו מציגים רק את המפתחות של האזורים שבהם מאוחסנים נתונים. המפתח של אזור העד לא מופיע ברשימה כי עותקים של עדים לא מאחסנים נתוני גיבוי.
המסוף
איך משתמשים במסוף כדי ליצור גיבויים בהגדרות של מכונות אזוריות.
נכנסים לדף Instances במסוף Google Cloud .
לוחצים על שם המכונה שמכילה את מסד הנתונים שרוצים לגבות.
לוחצים על מסד הנתונים.
בחלונית הניווט, לוחצים על Backup/Restore (גיבוי/שחזור).
בכרטיסייה Backups, לוחצים על Create backup.
מזינים שם לגיבוי ובוחרים תאריך תפוגה.
אופציונלי: לוחצים על הצגת אפשרויות ההצפנה.
א. אם רוצים להשתמש בהגדרת הצפנה אחרת לגיבוי, לוחצים על פס ההזזה לצד Use existing encryption.
א. בוחרים באפשרות מפתח Cloud KMS.
א. בוחרים מפתח מהרשימה הנפתחת.
רשימת המפתחות מוגבלת לפרויקט הנוכחי ב- Google Cloud . כדי להשתמש במפתח מפרויקט אחר ב- Google Cloud , צריך ליצור את מסד הנתונים באמצעות ה-CLI של gcloud במקום מסוף Google Cloud .
לוחצים על יצירה.
בטבלה Backups מוצגים פרטי ההצפנה של כל גיבוי.

gcloud
כדי ליצור גיבוי עם CMEK במערך של מכונות אזוריות, בהתאמה אישית או במספר אזורים, מריצים את הפקודה gcloud spanner backups create:
gcloud spanner backups create BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_ID \
--database=DATABASE \
--retention-period=RETENTION_PERIOD \
--encryption-type=customer_managed_encryption \
--kms-project=KMS_PROJECT_ID \
--kms-location=KMS_KEY_LOCATION \
--kms-keyring=KMS_KEY_RING \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]
--asyncכדי לוודא שהגיבוי שנוצר מוצפן באמצעות CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDספריות לקוח
C#
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
C++
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
המשך
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
Java
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
Node.js
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
PHP
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
Python
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
Ruby
כדי ליצור גיבוי עם CMEK בתצורה של מכונה אזורית:
כדי ליצור גיבוי עם CMEK במערך של מכונות במספר אזורים:
העתקת גיבוי
אתם יכולים להעתיק גיבוי של מסד הנתונים ב-Spanner ממכונה אחת למכונה אחרת באזור או בפרויקט אחרים. כברירת מחדל, גיבוי מועתק משתמש באותה הגדרת הצפנה כמו הגיבוי המקורי, בין אם היא בניהול Google או בניהול הלקוח. כדי לשנות את ההתנהגות הזו, אתם יכולים לציין הגדרת הצפנה אחרת כשאתם מעתיקים את הגיבוי. אם אתם רוצים שהגיבוי שהועתק יוצפן באמצעות CMEK כשאתם מעתיקים בין אזורים, ציינו את מפתחות Cloud KMS שתואמים לאזורי היעד.
המסוף
איך משתמשים במסוף כדי להעתיק גיבוי בהגדרת מכונה אזורית.
נכנסים לדף Instances במסוף Google Cloud .
לוחצים על שם המכונה שמכילה את מסד הנתונים שרוצים לגבות.
לוחצים על מסד הנתונים.
בחלונית הניווט, לוחצים על Backup/Restore (גיבוי/שחזור).
בטבלה Backups, בוחרים באפשרות Actions של הגיבוי ולוחצים על Copy.
ממלאים את הטופס: בוחרים מכונה ליעד, נותנים שם ובוחרים תאריך תפוגה לעותק הגיבוי.
אופציונלי: אם רוצים להשתמש בהגדרת הצפנה אחרת לגיבוי, לוחצים על Show encryption options.
א. בוחרים באפשרות מפתח Cloud KMS.
א. בוחרים מפתח מהרשימה הנפתחת.
רשימת המפתחות מוגבלת לפרויקט הנוכחי ב- Google Cloud . כדי להשתמש במפתח מפרויקט אחר ב- Google Cloud , צריך ליצור את מסד הנתונים באמצעות ה-CLI של gcloud במקום מסוף Google Cloud .
לוחצים על Copy.
gcloud
כדי להעתיק גיבוי עם הגדרת הצפנה חדשה למכונה אחרת באותו פרויקט, מריצים את הפקודה הבאה של gcloud spanner backups copy:
gcloud spanner backups copy --async \
--source-instance=INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAME \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-backup=DESTINATION_BACKUP_NAME \
--expiration-date=EXPIRATION_DATE \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]כדי להעתיק גיבוי עם הגדרת הצפנה חדשה למכונה אחרת בפרויקט אחר, מריצים את הפקודה הבאה של gcloud spanner backups copy:
gcloud spanner backups copy --async \
--source-backup=SOURCE_BACKUP_NAME \
--destination-backup=DESTINATION_BACKUP_NAME \
--encryption-type=CUSTOMER_MANAGED_ENCRYPTION \
--kms-keys=KMS_KEY_1[, KMS_KEY_2 ... ]כדי לוודא שהגיבוי שהועתק מוצפן באמצעות CMEK:
gcloud spanner backups describe BACKUP \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDספריות לקוח
C#
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
C++
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
המשך
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
Java
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
Node.js
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
PHP
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
Python
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
Ruby
כדי להעתיק גיבוי עם CMEK במערך של מכונות במספר אזורים:
שחזור מהגיבוי
אתם יכולים לשחזר גיבוי של מסד נתונים ב-Spanner למסד נתונים חדש. כברירת מחדל, מסדי נתונים שמשוחזרים מגיבוי משתמשים באותה תצורת הצפנה כמו הגיבוי עצמו, אבל אפשר לשנות את ההתנהגות הזו על ידי ציון תצורת הצפנה אחרת למסד הנתונים המשוחזר. אם הגיבוי מוגן באמצעות CMEK, גרסת המפתח ששימשה ליצירת הגיבוי צריכה להיות זמינה כדי שיהיה אפשר לפענח אותו.
המסוף
איך משתמשים במסוף כדי לשחזר גיבוי בהגדרת מכונה אזורית.
נכנסים לדף Instances במסוף Google Cloud .
לוחצים על המכונה שמכילה את מסד הנתונים שרוצים לשחזר.
לוחצים על מסד הנתונים.
בחלונית הניווט, לוחצים על Backup/Restore (גיבוי/שחזור).
בטבלה Backups, בוחרים באפשרות Actions לגיבוי ולוחצים על Restore.
בוחרים את המכונה שרוצים לשחזר ונותנים שם למסד הנתונים המשוחזר.
אופציונלי: אם רוצים להשתמש בהגדרת הצפנה אחרת במסד הנתונים שמשחזרים, לוחצים על פס ההזזה שליד Use existing encryption.
א. בוחרים באפשרות מפתח Cloud KMS.
א. בוחרים מפתח מהרשימה הנפתחת.
רשימת המפתחות מוגבלת לפרויקט הנוכחי ב- Google Cloud . כדי להשתמש במפתח מפרויקט אחר ב- Google Cloud , צריך ליצור את מסד הנתונים באמצעות ה-CLI של gcloud במקום מסוף Google Cloud .
לוחצים על שחזור.
gcloud
כדי לשחזר גיבוי עם הגדרת הצפנה חדשה, מריצים את הפקודה הבאה של gcloud spanner databases restore:
gcloud spanner databases restore --async \
--project=SPANNER_PROJECT_ID \
--destination-instance=DESTINATION_INSTANCE_ID \
--destination-database=DESTINATION_DATABASE_ID \
--source-instance=SOURCE_INSTANCE_ID \
--source-backup=SOURCE_BACKUP_NAMEכדי לוודא שמסד הנתונים ששוחזר מוצפן באמצעות CMEK:
gcloud spanner databases describe DATABASE \
--project=SPANNER_PROJECT_ID \
--instance=INSTANCE_IDמידע נוסף זמין במאמר שחזור מגיבוי.
ספריות לקוח
C#
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
C++
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
המשך
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
Java
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
Node.js
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
PHP
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
Python
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
Ruby
כדי לשחזר גיבוי שמופעל בו CMEK בהגדרת מכונה אזורית:
כדי לשחזר גיבוי שמופעל בו CMEK במערך של מספר אזורים:
צפייה ביומני הביקורת של מפתח Cloud KMS
מוודאים שהרישום ביומן מופעל ל-Cloud KMS API בפרויקט.
במסוף Google Cloud , נכנסים לדף Logs Explorer.
כדי להגביל את רשומות היומן למפתח Cloud KMS, מוסיפים את השורות הבאות לכלי ליצירת שאילתות:
resource.type="cloudkms_cryptokey" resource.labels.location="KMS_KEY_LOCATION" resource.labels.key_ring_id="KMS_KEY_RING_ID" resource.labels.crypto_key_id="KMS_KEY_ID"בפעולות רגילות, פעולות ההצפנה והפענוח מתועדות ביומן ברמת החומרה
INFO. הרשומות האלה נרשמות ביומן כשהאזורים במכונה של Spanner דוגמים את המפתח של Cloud KMS בערך כל חמש דקות.אם Spanner לא מצליח לגשת למפתח, הפעולות מתועדות ביומן בתור
ERROR.