יצירת פרופיל לחיבור מקור

פרופילי החיבור מתעדים את המזהים ואת פרטי הכניסה של מסדי הנתונים במקור. כל פרופיל חיבור מכיל את כמות המידע המינימלית שנדרשת ל-Database Migration Service כדי להעביר נתונים בין מקור הנתונים ליעד.

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

המסוף

  1. נכנסים לדף Connection Profiles במסוף Google Cloud .
  2. לוחצים על יצירת פרופיל.
  3. בדף Create a connection profile, בוחרים באפשרות Source ברשימה Profile role.
  4. ברשימה Database engine, בוחרים את המנוע של מסד הנתונים במקור.
  5. בשדה Connection profile name, מזינים שם קריא לאנשים לפרופיל החיבור. הערך הזה מוצג ברשימת פרופילי החיבורים.
  6. משאירים את הערך שנוצר אוטומטית בשדה Connection profile ID.
  7. מזינים שם מארח או כתובת IP.

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

    • בהעברות שמתחברות דרך האינטרנט הציבורי באמצעות רשימת היתרים של כתובות IP, צריך לספק את כתובת ה-IP הציבורית של מסד הנתונים של המקור.
  8. מזינים את היציאה שמשמשת לגישה למארח. יציאת ברירת המחדל של PostgreSQL היא 5432.
  9. מזינים שם משתמש וסיסמה למסד הנתונים של המקור. למשתמש צריכות להיות הרשאות הרפליקציה הנדרשות במסד הנתונים של המקור. מידע נוסף זמין במאמר הגדרת מסד נתונים של מקור.
  10. בקטע Connection profile region בדף, בוחרים את האזור שבו רוצים לשמור את פרופיל החיבור.

  11. אופציונלי: אם החיבור מתבצע דרך רשת ציבורית (באמצעות רשימות היתרים של כתובות IP), מומלץ להגדיר הצפנת SSL/TLS לחיבור בין מסדי הנתונים של המקור והיעד.

    בקטע אבטחת החיבור, בוחרים באחת מהאפשרויות הבאות להגדרת SSL או TLS:

    • ‫None: אשכול היעד של AlloyDB ל-PostgreSQL מתחבר למסד הנתונים של המקור בלי הצפנה.
    • אימות TLS: כשאשכול היעד של AlloyDB ל-PostgreSQL מתחבר למסד הנתונים של המקור, האשכול מאמת את המקור כדי לוודא שהאשכול מתחבר למארח הנכון בצורה מאובטחת. כדי להשתמש באימות TLS, צריך לספק את האישור בקידוד x509 PEM של רשות האישורים (CA) שחתמה על האישור של שרת המקור.
    • אימות mTLS: כשאשכול היעד מתחבר למקור, האשכול מאמת את המקור והמקור מאמת את האשכול. כדי להשתמש באימות mTLS, צריך לספק:
      • האישור של רשות האישורים שחתמה על האישור של שרת מסד הנתונים במקור (אישור ה-CA).
      • האישור שמשמש את האשכול לאימות מול שרת מסד הנתונים של המקור (אישור הלקוח).
      • המפתח הפרטי שמשויך לאישור הלקוח (מפתח הלקוח).

  12. לוחצים על יצירה.

    הדף Connection profiles מופיע, ומוצג בו פרופיל החיבור החדש שנוצר.

gcloud

בדוגמה הזו נעשה שימוש בדגל האופציונלי --no-async כדי שכל הפעולות יתבצעו באופן סינכרוני. זה אומר שיכול להיות שייקח קצת זמן עד שפקודות מסוימות יסתיימו. אפשר לדלג על הדגל --no-async כדי להריץ פקודות באופן אסינכרוני. אם כן, צריך להשתמש בפקודה gcloud database-migration operations describe כדי לוודא שהפעולה הצליחה.

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

  • ‫SOURCE_CONN_ID במזהה של פרופיל החיבור למקור.
  • ‫REGION באזור שבו רוצים לשמור את פרופיל החיבור.
  • ‫SOURCE_IP_ADDRESS בכתובת ה-IP של מסד הנתונים של המקור.
  • ‫SOURCE_PORT עם היציאה של מסד הנתונים של המקור (ברירת המחדל היא 5432).
  • ‫SOURCE_USER בשם המשתמש של המשתמש להעברה במסד הנתונים של המקור.
  • ‫SOURCE_PASSWORD בסיסמה של משתמש ההעברה במסד הנתונים של המקור.
  • אופציונלי: כדי לקבוע הגדרות נוספות לפרופיל החיבור של המקור, אפשר להעביר את הדגלים הבאים:
    • ‫--display-name: שם קריא לאנשים של פרופיל החיבור.
    • ‫--cloudsql-instance: המזהה של מכונת המקור ב-Cloud SQL ל-PostgreSQL, אם המקור הוא Cloud SQL ל-PostgreSQL.
    • ‫--ssl-type: סוג ההצפנה של SSL/TLS לחיבור למסד הנתונים של המקור (NONE,‏ SERVER_ONLY לאימות TLS עם --ca-certificate, או SERVER_CLIENT לאימות mTLS עם --ca-certificate,‏ --client-certificate ו---private-key).

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

‫Linux,‏ macOS או Cloud Shell

gcloud database-migration connection-profiles create postgresql \
  SOURCE_CONN_ID \
  --region=REGION \
  --role=SOURCE \
  --host=SOURCE_IP_ADDRESS \
  --port=SOURCE_PORT \
  --username=SOURCE_USER \
  --password=SOURCE_PASSWORD \
  --no-async

‏Windows (PowerShell)

gcloud database-migration connection-profiles create postgresql `
  SOURCE_CONN_ID `
  --region=REGION `
  --role=SOURCE `
  --host=SOURCE_IP_ADDRESS `
  --port=SOURCE_PORT `
  --username=SOURCE_USER `
  --password=SOURCE_PASSWORD `
  --no-async

Windows‏ (cmd.exe)

gcloud database-migration connection-profiles create postgresql ^
  SOURCE_CONN_ID ^
  --region=REGION ^
  --role=SOURCE ^
  --host=SOURCE_IP_ADDRESS ^
  --port=SOURCE_PORT ^
  --username=SOURCE_USER ^
  --password=SOURCE_PASSWORD ^
  --no-async

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

Waiting for connection profile [SOURCE_CONN_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile SOURCE_CONN_ID [OPERATION_ID]

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