התחברות למופע באמצעות Private Service Connect

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   כניסה אל Private Service Connect

2. לוחצים על הכרטיסייה מדיניות חיבור.

3. לוחצים על יצירת מדיניות לקישור.

4. מזינים שם למדיניות החיבור.

5. בקטע Service details, בשדה Service class, בוחרים באפשרות google-cloud-alloydb.

6. בקטע Endpoints scope, בוחרים Network ו-Region שהמדיניות הזו חלה עליהם.

7. בקטע Endpoints configuration, בוחרים תת-רשת אחת או יותר מהתפריט Subnetworks. תת-הרשתות משמשות להקצאת כתובות IP לנקודות קצה.

8. אופציונלי: מציינים מגבלת חיבור למדיניות. המגבלה קובעת כמה נקודות קצה אפשר ליצור ב-AlloyDB עבור מדיניות החיבור הזו. אם לא מציינים מגבלת חיבור, אין מגבלה.

9. לוחצים על יצירת מדיניות.

gcloud

כדי ליצור מדיניות לחיבור שירות, משתמשים בפקודה service-connection-policies create.

gcloud network-connectivity service-connection-policies create POLICY_NAME \
    --network=NETWORK \
    --project=PROJECT_ID \
    --region=REGION \
    --service-class=SERVICE_CLASS \
    --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETS \
    --psc-connection-limit=LIMIT \
    --description="DESCRIPTION" \
    --producer-instance-location=PRODUCER_INSTANCE_LOCATION \
    --allowed-google-producers-resource-hierarchy-level=LIST_OF_NODES

מחליפים את מה שכתוב בשדות הבאים:

• POLICY_NAME: השם של מדיניות חיבור השירות.
• ‫NETWORK: הרשת שהמדיניות הזו חלה עליה.
• ‫PROJECT_ID: מזהה הפרויקט או מספר הפרויקט של רשת ה-VPC. ברשתות VPC משותפות, צריך לפרוס מדיניות של חיבור שירות בפרויקט המארח, כי אין תמיכה במדיניות כזו בפרויקטים של שירותים.
• ‫REGION: האזור שהמדיניות הזו חלה עליו. אותה מדיניות צריכה להתקיים בכל אזור שבו רוצים להפוך את הקישוריות לשירות לאוטומטית.
• ‫SERVICE_CLASS: מזהה המשאב של סוג השירות שסופק על ידי היצרן. ב-AlloyDB, סוג השירות הוא google-cloud-alloydb.
• ‫SUBNETS: תת-רשת צרכנית רגילה אחת או יותר שמשמשת להקצאת כתובות IP לנקודות קצה של Private Service Connect. כתובות ה-IP האלה מוקצות באופן אוטומטי ומוחזרות למאגר של תת-הרשת כשמופעלות ונמחקות דוגמאות של שירותים מנוהלים. תת-הרשתות צריכות להיות באותו אזור כמו מדיניות חיבור השירות. אם כמה מדיניות חיבור שירות משתפות את אותו אזור, אפשר לעשות שימוש חוזר באותה תת-רשת במדיניות הזו. אפשר להזין כמה תת-רשתות ברשימה מופרדת בפסיקים.
• ‫LIMIT: המספר המקסימלי של נקודות קצה שאפשר ליצור באמצעות המדיניות הזו. אם לא מציינים מגבלה, אין מגבלה.
• ‫DESCRIPTION: תיאור אופציונלי של מדיניות חיבור השירות.

• ‫PRODUCER_INSTANCE_LOCATION: מציין אם המדיניות מבצעת אוטומציה של חיבורים למופעי AlloyDB. אפשר להגדיר את הערך הזה באחת מהדרכים הבאות:

  • ‫none (ברירת מחדל): מופע AlloyDB נמצא באותו פרויקט כמו מדיניות חיבור השירות. בסביבת VPC משותף, אם מופע AlloyDB נמצא בפרויקט שירות ואתם יוצרים את מדיניות החיבור בפרויקט המארח, אתם צריכים להגדיר את הפרמטר הזה ל-none.custom-resource-hierarchy-levels
  • ‫custom-resource-hierarchy-levels: מחייב להגדיר את נתיב המיקום של מנהל המשאבים לפרויקטים שרוצים להפוך את הקישוריות שלהם לאוטומטית באמצעות הפרמטר allowed-google-producers-resource-hierarchy-level.

• ‫LIST_OF_NODES: צריך להגדיר את הפרמטר הזה אם המיקום של מופע היצרן מוגדר ל-custom-resource-hierarchy-levels. הפרמטר הזה הוא רשימה של פרויקטים, תיקיות וארגונים שבהם נמצאים המקרים שרוצים להפוך את הקישוריות שלהם לאוטומטית. הרשימה היא מהצורה projects/PROJECT_ID, folders/FOLDER_ID או organizations/ORGANIZATION_ID.

לדוגמה, הפקודה הבאה יוצרת מדיניות של חיבור שירות עבור מחלקת השירות google-cloud-alloydb שמקצה כתובות IP מתת-הרשת managed-services. אפשר ליצור באמצעות המדיניות הזו עד 10 נקודות קצה מסוג Private Service Connect. צריך ליצור את נקודות הקצה בפרויקטים שנמצאים באותו ארגון כמו מופע השירות המנוהל. מופע AlloyDB נמצא בפרויקט myproject.

gcloud network-connectivity service-connection-policies create alloydb-policy \
    --network=default \
    --project=my-project \
    --region=us-central1 \
    --service-class=google-cloud-alloydb \
    --subnets=managed-service-subnet \
    --psc-connection-limit=10 \
    --producer-instance-location=custom-resource-hierarchy-levels \
    --allowed-google-producers-resource-hierarchy-level=projects/myproject

המסוף

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

   מעבר אל Clusters

2. לוחצים על יצירת אשכול.

3. בשדה Cluster ID (מזהה האשכול), מזינים my-cluster.

4. מזינים סיסמה. חשוב לשים לב לסיסמה הזו כי תצטרכו להשתמש בה במדריך הזה.

5. שמירה של גרסת מסד הנתונים שמוגדרת כברירת מחדל.

6. בוחרים את האזור us-central1 (Iowa).

7. משאירים את מזהה ברירת המחדל של המכונה, my-cluster-primary.

8. בקטע Zonal availability (זמינות אזורית), משאירים את האפשרות Single zone (אזור יחיד) כבחירה. למרות שאנחנו לא ממליצים על שימוש במופע של אזור יחיד בסביבת ייצור, במדריך הזה נעשה שימוש באזור יחיד כדי לצמצם את העלויות. מידע נוסף מפורט במאמר איך להקטין את העלויות באמצעות מכונות בסיסיות.

9. בוחרים את 2 vCPU, 16 GB סוג המכונה.

10. שמירה על קישוריות של כתובת IP פרטית.

    1. בוחרים באפשרות Private Service Connect (PSC).
    2. לוחצים על הוספת נקודת קצה.
    3. בוחרים את הפרויקט שבו רוצים ליצור את נקודת הקצה.
    4. בוחרים את הרשת.
    5. כדי לקבל מידע על מדיניות חיבור השירות, לוחצים על בדיקת מדיניות.

11. משאירים את הגדרות ברירת המחדל בקטע אבטחת רשת.

12. אל תבצעו שינויים באפשרות הצגת אפשרויות מתקדמות.

13. לוחצים על יצירת אשכול. יכול להיות שיחלפו כמה דקות עד ש-AlloyDB ייצור את האשכול ויציג אותו בדף Overview של האשכול הראשי.

gcloud

כדי ליצור את האשכול, משתמשים בפקודה gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --password=PASSWORD \
  --region=REGION_ID \
  --project=PROJECT_ID \
  --enable-private-service-connect

מחליפים את מה שכתוב בשדות הבאים:

• ‫CLUSTER_ID: המזהה של האשכול שאתם יוצרים. הוא צריך להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.

• ‫PASSWORD: הסיסמה שבה יש להשתמש עבור משתמש ברירת המחדל postgres.

• ‫REGION_ID: האזור שבו רוצים למקם את האשכול.

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את האשכול.

הפקודה הזו מפעילה פעולה ממושכת ומחזירה מזהה פעולה.

כדי ליצור את מכונת AlloyDB, ראשית או מאגר לקריאה לשימוש ב-Private Service Connect, משתמשים בפקודה gcloud alloydb instances create. חשוב לכלול את הפרמטר --allowed-psc-projects כדי לציין אילו פרויקטים של צרכנים יכולים ליצור נקודות קצה להתחברות למופע הזה.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \
    --psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECT

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSTANCE_ID: המזהה של המכונה שאתם יוצרים. הוא צריך להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
• ‫CPU_COUNT: מספר ליבות ה-CPU הווירטואליות שרוצים להקצות למופע. הערכים התקינים כוללים את האפשרויות הבאות:
  • ‫2: 2 vCPUs, ‏ 16 GB RAM
  • ‫4: 4 vCPUs, ‏ ‎32 GB RAM
  • ‫8: 8 vCPUs, ‏ ‎64 GB RAM
  • ‫16: 16 vCPUs, ‏ 128 GB RAM
  • ‫32: 32 vCPUs, ‏ 256 GB RAM
  • ‫64: 64 vCPUs, ‏ 512 GB RAM
  • ‫96: 96 vCPUs, ‏ 768 GB RAM
  • ‫128: 128 vCPUs, ‏ 864 GB RAM
• ‫AVAILABILITY: מציין אם המופע הזה צריך להיות בעל זמינות גבוהה (HA), עם צמתים בכמה אזורים. הערכים התקפים כוללים:
  • ‫REGIONAL: יוצרת מופע HA עם צמתים פעילים ונפרדים במצב המתנה, ומעבר אוטומטי לגיבוי בין הצמתים. זהו ערך ברירת המחדל, שמתאים לסביבות ייצור.
  • ‫ZONAL: יוצר מופע בסיסי, שמכיל רק צומת אחד, וללא מעבר אוטומטי לגיבוי.
• ‫REGION_ID: האזור שבו רוצים למקם את המכונה.
• ‫CLUSTER_ID: המזהה של האשכול שיצרתם קודם.
• ‫ALLOWED_PROJECT_LIST: רשימה מופרדת בפסיקים של מזהי פרויקטים או מספרי פרויקטים שרוצים לאפשר להם גישה למופע – לדוגמה, my-project-1, 12345,my-project-n.
• ‫NETWORK_ATTACHMENT_URI (אופציונלי): שם המשאב המלא של כתובת ה-URI של רשת ה-VPC שיוצרים לקישוריות יוצאת. לדוגמה: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• ‫CONSUMER_NETWORK: הנתיב לרשת ה-VPC שבה צריך ליצור נקודות קצה של Private Service Connect. לדוגמה: projects/my-host-project/global/networks/default. האפשרות הזו רלוונטית כשיוצרים נקודות קצה באופן אוטומטי. חשוב לוודא שמדיניות חיבור השירות נוצרה. אפשר ליצור את המדיניות לפני או אחרי שיוצרים את המופע.
• ‫CONSUMER_PROJECT: הפרויקט שבו נוצרת נקודת הקצה של Private Service Connect. אם אתם משתמשים ברשת VPC משותפת, זה יכול להיות פרויקט המארח או פרויקט השירות. כל הפרויקטים שאתם מציינים בפרמטרים של החיבור האוטומטי מתווספים אוטומטית לרשימת הפרויקטים המורשים. לחלופין, אם אתם רוצים ליצור נקודות קצה של Private Service Connect באופן ידני בפרויקטים מסוימים, אתם יכולים להוסיף את הפרויקטים האלה לרשימת הפרויקטים המורשים.

אשכול משני שנוצר עבור אשכול ראשי שמופעל בו Private Service Connect מקבל בירושה באופן אוטומטי את ההגדרה של Private Service Connect. מידע נוסף זמין במאמר בנושא יצירת אשכול משני.

Terraform

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

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"
  machine_config {
    cpu_count = 2
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

resource "google_compute_network" "default" {
    name = "alloydb-network"
    auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

המסוף

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

   מעבר אל Clusters

2. לוחצים על יצירת אשכול.

3. בשדה Cluster ID (מזהה האשכול), מזינים my-cluster.

4. מזינים סיסמה. חשוב לשים לב לסיסמה הזו כי תצטרכו להשתמש בה במדריך הזה.

5. שמירה של גרסת מסד הנתונים שמוגדרת כברירת מחדל.

6. בוחרים את האזור us-central1 (Iowa).

7. משאירים את מזהה ברירת המחדל של המכונה, my-cluster-primary.

8. בקטע Zonal availability (זמינות אזורית), משאירים את האפשרות Single zone (אזור יחיד) כבחירה. למרות שאנחנו לא ממליצים על שימוש במופע של אזור יחיד בסביבת ייצור, במדריך הזה נעשה שימוש באזור יחיד כדי לצמצם את העלויות. מידע נוסף מפורט במאמר איך להקטין את העלויות באמצעות מכונות בסיסיות.

9. בוחרים את 2 vCPU, 16 GB סוג המכונה.

10. שמירה על קישוריות של כתובת IP פרטית.

    1. בוחרים באפשרות Private Service Connect(PSC).
    2. לוחצים על הוספת נקודת קצה.
    3. בוחרים את הפרויקט שבו רוצים ליצור את נקודת הקצה.
    4. בוחרים את הרשת.
    5. כדי לקבל מידע על מדיניות חיבור השירות, לוחצים על בדיקת מדיניות.

11. משאירים את הגדרות ברירת המחדל בקטע אבטחת רשת.

12. אל תבצעו שינויים באפשרות הצגת אפשרויות מתקדמות.

13. לוחצים על יצירת אשכול. יכול להיות שיחלפו כמה דקות עד ש-AlloyDB ייצור את האשכול ויציג אותו בדף Overview של האשכול הראשי.

gcloud

כדי ליצור את האשכול, משתמשים בפקודה gcloud alloydb clusters create.

gcloud alloydb clusters create CLUSTER_ID \
  --password=PASSWORD \
  --region=REGION_ID \
  --project=PROJECT_ID \
  --enable-private-service-connect

מחליפים את מה שכתוב בשדות הבאים:

• ‫CLUSTER_ID: המזהה של האשכול שאתם יוצרים. הוא צריך להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.

• ‫PASSWORD: הסיסמה שבה יש להשתמש עבור משתמש ברירת המחדל postgres.

• ‫REGION_ID: האזור שבו רוצים למקם את האשכול.

• ‫PROJECT_ID: מזהה הפרויקט שבו רוצים למקם את האשכול.

הפקודה הזו מפעילה פעולה ממושכת ומחזירה מזהה פעולה.

כדי ליצור את המכונה הראשית, משתמשים בפקודה gcloud alloydb instances create.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --availability-type=AVAILABILITY \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --allowed-psc-projects=ALLOWED_PROJECT_LIST \
    --psc-network-attachment-uri=NETWORK_ATTACHMENT_URI \

מחליפים את מה שכתוב בשדות הבאים:

• ‫INSTANCE_ID: המזהה של המכונה שאתם יוצרים. הוא צריך להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
• ‫CPU_COUNT: מספר ליבות ה-CPU הווירטואליות שרוצים להקצות למופע. הערכים התקינים כוללים את האפשרויות הבאות:
  • ‫2: 2 vCPUs, ‏ 16 GB RAM
  • ‫4: 4 vCPUs, ‏ ‎32 GB RAM
  • ‫8: 8 vCPUs, ‏ ‎64 GB RAM
  • ‫16: 16 vCPUs, ‏ 128 GB RAM
  • ‫32: 32 vCPUs, ‏ 256 GB RAM
  • ‫64: 64 vCPUs, ‏ 512 GB RAM
  • ‫96: 96 vCPUs, ‏ 768 GB RAM
  • ‫128: 128 vCPUs, ‏ 864 GB RAM
• ‫AVAILABILITY: מציין אם המופע הזה צריך להיות בעל זמינות גבוהה (HA), עם צמתים בכמה אזורים. הערכים התקפים כוללים:
  • ‫REGIONAL: יוצרת מופע HA עם צמתים פעילים ונפרדים במצב המתנה, ומעבר אוטומטי לגיבוי בין הצמתים. זהו ערך ברירת המחדל, שמתאים לסביבות ייצור.
  • ‫ZONAL: יוצר מופע בסיסי, שמכיל רק צומת אחד, וללא מעבר אוטומטי לגיבוי.
• ‫REGION_ID: האזור שבו רוצים למקם את המכונה.
• ‫CLUSTER_ID: המזהה של האשכול שיצרתם קודם.
• ‫ALLOWED_PROJECT_LIST: רשימת מזהי הפרויקטים או מספרי הפרויקטים שרוצים לאפשר להם גישה למופע, מופרדים בפסיקים. לדוגמה: my-project-1, 12345,my-project-n.
• ‫NETWORK_ATTACHMENT_URI (אופציונלי): שם המשאב המלא של כתובת ה-URI של רשת ה-VPC שיוצרים לקישוריות יוצאת. לדוגמה: projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID.
• ‫CONSUMER_NETWORK: הנתיב לרשת ה-VPC שממנה צריך ליצור נקודות קצה של Private Service Connect. לדוגמה: projects/my-host-project/global/networks/default. האפשרות הזו רלוונטית כשיוצרים נקודות קצה באופן אוטומטי. מוודאים שמדיניות חיבור השירות נוצרה. אפשר ליצור את המדיניות לפני או אחרי שיוצרים את המופע.
• ‫CONSUMER_PROJECT: הפרויקט שבו נוצרת נקודת הקצה של Private Service Connect. אם אתם משתמשים ברשת VPC משותפת, זה יכול להיות פרויקט המארח או פרויקט השירות. כל הפרויקטים שאתם מציינים בפרמטרים של החיבור האוטומטי מתווספים אוטומטית לרשימת הפרויקטים המורשים. לחלופין, אם אתם רוצים ליצור נקודות קצה של Private Service Connect באופן ידני בפרויקטים מסוימים, אתם יכולים להוסיף את הפרויקטים האלה לרשימת הפרויקטים המורשים.

אשכול משני שנוצר עבור אשכול ראשי שמופעל בו Private Service Connect מקבל בירושה באופן אוטומטי את ההגדרה של Private Service Connect. מידע נוסף זמין במאמר בנושא יצירת אשכול משני.

Terraform

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

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"
  machine_config {
    cpu_count = 2
  }
  psc_instance_config {
  allowed_consumer_projects = ["123456789"]
  psc_interface_configs {
    network_attachment_resource = google_compute_network_attachment.default.id
  }
  }
}

resource "google_compute_network" "default" {
    name = "alloydb-network"
    auto_create_subnetworks = false
}

resource "google_compute_subnetwork" "default" {
    name = "alloydb-subnetwork"
    region = "us-central1"
    network = google_compute_network.default.id
    ip_cidr_range = "10.0.0.0/16"
}

resource "google_compute_network_attachment" "default" {
  name                  = "alloydb-network-attachment"
  region                = "us-central1"
  connection_preference = "ACCEPT_AUTOMATIC"
  subnetworks = [
    google_compute_subnetwork.default.self_link
  ]
}

data "google_project" "project" {}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

Java

אם אתם משתמשים ב-Private Service Connect כדי להתחבר למופע AlloyDB, צריך לכלול את הפרטים הבאים:

config.addDataSourceProperty("alloydbIpType", "PSC");

מידע נוסף על שימוש בנקודת קצה (endpoint) של Private Service Connect במחברים של Java Language זמין במאגר GitHub.

Python ‏ (pg8000)

אם אתם משתמשים ב-Private Service Connect כדי להתחבר למופע AlloyDB, צריך לכלול את הפרטים הבאים:

  def getconn() -> pg8000.dbapi.Connection:
      conn: pg8000.dbapi.Connection = connector.connect(
          inst_uri,
          "pg8000",
          user=user,
          password=password,
          db=db,
          # use ip_type to specify PSC
          ip_type=IPTypes.PSC,
      )
      return conn

מידע נוסף על שימוש בנקודת קצה (endpoint) של Private Service Connect במחברים של שפת Python זמין במאגר GitHub.

Python (asyncpg)

אם אתם משתמשים ב-Private Service Connect כדי להתחבר למופע AlloyDB, צריך לכלול את הפרטים הבאים:

  async def getconn() -> asyncpg.Connection:
    conn: asyncpg.Connection = await connector.connect(
        inst_uri,
        "asyncpg",
        user=user,
        password=password,
        db=db,
        # use ip_type to specify PSC
        ip_type=IPTypes.PSC,
    )
    return conn

מידע נוסף על שימוש בנקודת קצה (endpoint) של Private Service Connect במחברים של שפת Python זמין במאגר GitHub.

‫Go (pgx)

אם אתם משתמשים ב-Private Service Connect כדי להתחבר למופע AlloyDB, צריך לכלול את הפרטים הבאים:

d.Dial(ctx, instURI, alloydbconn.WithPSC())

מידע נוסף על שימוש בנקודת קצה של Private Service Connect במחברים של Go Language זמין במאגר GitHub.

‫Go (database/sql)

אם אתם משתמשים ב-Private Service Connect כדי להתחבר למופע AlloyDB, צריך לכלול את הפרטים הבאים:

  cleanup, err := pgxv5.RegisterDriver(
    "alloydb",
    alloydbconn.WithDefaultDialOptions(alloydbconn.WithPSC())
)

מידע נוסף על שימוש בנקודת קצה של Private Service Connect במחברים של Go Language זמין במאגר GitHub.