ניהול הגדרות של קישוריות פרטית

אתם יכולים להשתמש ב-Datastream API כדי ליצור, לאחזר, להציג ולמחוק הגדרות של חיבור מבודד. ההגדרות האלה מאפשרות ל-Datastream לתקשר באופן פרטי עם מקורות נתונים ב- Google Cloud או עם מקורות חיצוניים שמחוברים דרך Cloud VPN או Cloud Interconnect. אתם יכולים ליצור קישוריות פרטית באמצעות קישור בין רשתות VPC או ממשק Private Service Connect.

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

יצירת הגדרת חיבור מבודד באמצעות קישור בין רשתות VPC שכנות (peering)

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

  • רשת VPC לקישור לרשת הפרטית של Datastream. מידע נוסף על יצירת רשת VPC זמין במאמר שימוש ב-VPC Network Peering.
  • טווח כתובות IP זמין (עם בלוק CIDR של ‎ /29 לפחות) ברשת ה-VPC. ‫Datastream משתמש בטווח ה-IP הזה כדי ליצור קישור בין רשתות שכנות (peering) של VPC עם ה-VPC שצוין, כך שהטווח לא יכול לחפוף לתת-רשתות בתוך ה-VPC הזה. כתוצאה מכך, Datastream יכול לתקשר עם המקור.

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

  • ‫vpcName: מציינים את השם והנתיב של רשת ה-VPC.
  • ‫subnet: מציינים טווח כתובות IP זמין ברשת ה-VPC.

הקוד הבא מציג בקשה ליצירת הגדרת קישוריות פרטית, ומציין את שיטת הקישוריות כשימוש ב-VPC Peering (vpcPeeringConfig).

REST

POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID
{
  "displayName": "DISPLAY_NAME",
  "vpcPeeringConfig": {
      "vpcName": "VPC_NAME",
      "subnet": "SUBNET"
  }
}

לדוגמה:

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my-private-connection",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }
}

אחרי שיוצרים את הגדרת החיבור המבודד, אפשר להציג מידע עליה באמצעות קריאה ל-method‏ privateConnections/get. הפלט שמופיע אמור להיראות כך:

{
  "name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-22T16:17:37.159786963Z",
  "displayName": "my-private-connection",
  "state": "CREATED",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }  
}

gcloud

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --vpc=VPC_NAME --subnet=SUBNET

לדוגמה:

gcloud datastream private-connections create my-privateConnection --location=us-central1 --display-name=my-private-connection --vpc=my-vpc --subnet=10.11.12.13/29

יצירת הגדרה של חיבור מבודד באמצעות ממשק Private Service Connect

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

  • רשת VPC כדי להתחבר לרשת הפרטית של Datastream. מידע נוסף על יצירת רשת VPC זמין במאמר יצירה וניהול של רשתות VPC.

  • יוצרים חיבור לרשת בפרויקט ה-VPC.

  • מוודאים ש- Google Cloud וחומת האש המקומית מאפשרים תעבורה מטווח כתובות ה-IP של מחבר הרשת למסד הנתונים של המקור שממנו רוצים להעביר נתונים בסטרימינג.

הקוד הבא מראה בקשה ליצירת הגדרת חיבור מבודד באמצעות ממשקי Private Service Connect. קודם צריך להריץ פקודה כדי ליצור הגדרת חיבור מבודד עם הדגל validateOnly (--validate-only ב-Google Cloud CLI):

REST

POST "https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID&validateOnly=true"

gcloud

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME --validate-only

בתגובה, תקבלו את השם של פרויקט המפיק שצריך לאשר. צריך להוסיף אותו לרשימת הפרויקטים המותרים של חיבור הרשת:

  1. משתמשים ב-method‏ describe כדי לקבל את הערך הנוכחי של producer-accept-list של חיבור הרשת. למידע נוסף, קראו את המסמכים של Google Cloud SDK בנושא Compute Engine.
  2. מוסיפים את הפרויקט של המפיק לרשימה הזו באמצעות השיטה update. מידע נוסף זמין במאמרי העזרה של Google Cloud SDK בנושא Compute Engine.

אחרי שמוסיפים את הפרויקט של ה-producer לרשימת הפרויקטים המורשים, מריצים שוב את הפקודה ליצירת הגדרת הקישוריות הפרטית, והפעם בלי הדגל validateOnly:

REST

POST https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections?privateConnectionId=PRIVATE_CONNECTIVITY_CONFIGURATION_ID
{
  "displayName": "DISPLAY_NAME",
  "pscInterfaceConfig": {
      "networkAttachment": "NETWORK_ATTACHMENT_NAME"
  }
}

לדוגמה:

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my-private-connection",
  "pscInterfaceConfig": {
    "networkAttachment": "projects/my-project/regions/us-central1/networkAttachments/my-na"
  }
}

gcloud

gcloud datastream private-connections create PRIVATE_CONNECTION_NAME --location=LOCATION --display-name=DISPLAY_NAME --network-attachment=NETWORK_ATTACHMENT_NAME

לדוגמה:

gcloud datastream private-connections create my-private-connection --location=us-central1 --display-name=my-private-connection --network-attachment=my-network-attachment

קבלת מידע על הגדרת חיבור מבודד

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

REST

GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections/PRIVATE_CONNECTIVITY_CONFIGURATION_ID

לדוגמה:

GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
     

gcloud

מידע נוסף על השימוש ב-gcloud לאחזור מידע על הגדרת הקישוריות הפרטית זמין במסמכי התיעוד של Google Cloud SDK.

הצגת רשימה של הגדרות חיבור מבודד

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

REST

GET https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections

gcloud

מידע נוסף על השימוש ב-gcloud כדי לאחזר מידע על כל הגדרות הקישוריות הפרטית שלכם זמין במסמכי התיעוד של Google Cloud SDK.

מחיקת הגדרה של חיבור מבודד

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

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

REST

DELETE https://datastream.googleapis.com/v1/projects/PROJECT_ID/locations/
LOCATION/privateConnections/[private-connectivity-configuration-id] {"force": true} 

לדוגמה:

DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true} 

gcloud

מידע נוסף על השימוש ב-gcloud למחיקת הגדרת החיבור המבודד זמין במסמכי התיעוד של Google Cloud SDK.

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