הגדרת נקודות קצה אזוריות

נקודות קצה אזוריות ב-App Hub מאפשרות לנתב את התנועה ישירות לאזור מסוים, כדי לעמוד בדרישות שנוגעות למיקום אחסון הנתונים. אפשר להגדיר את נקודות הקצה האלה ב-Google Cloud CLI, ב-API בארכיטקטורת REST, ב-Terraform ובספריות הלקוח, ולהגביל את השימוש בנקודות קצה גלובליות באמצעות כללי מדיניות של הארגון.

מהן נקודות קצה אזוריות?

נקודות קצה אזוריות הן נקודות קצה של בקשות, שמאפשרות לשלוח בקשה רק אם המשאב המושפע נמצא במיקום שצוין בנקודת הקצה. לדוגמה, בקשה לניהול משאבים בנקודת הקצה https://apphub.us-central1.rep.googleapis.com תתבצע רק אם האפליקציה או הרכיב הרשום ממוקמים ב-us-central1.

בניגוד לנקודות קצה גלובליות, שבהן עיבוד הבקשות יכול להתבצע במיקום שונה מזה שבו נמצא המשאב, נקודות קצה אזוריות מעבדות בקשות רק במיקום שצוין בנקודת הקצה. נקודות קצה אזוריות מסיימות סשנים של TLS במיקום שצוין על ידי נקודת הקצה לבקשות שהתקבלו מהאינטרנט, ממשאבים אחרים של Google Cloud , כמו מכונות וירטואליות של Compute Engine, משירותים מקומיים באמצעות VPN או Interconnect ומעננים וירטואליים פרטיים (VPCs).

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

מגבלות

אי אפשר להשתמש בנקודות קצה אזוריות כדי לנהל משאבים גלובליים או במספר אזורים ב-App Hub, כמו אפליקציות גלובליות, אפליקציות במספר אזורים (us ו-eu), קבצים מצורפים של פרויקטים של שירות וגבולות.

הקישורים והגבולות של פרויקטים של שירות קיימים רק במיקום global, ונקודות קצה אזוריות דוחות כל בקשה שהמיקום בנתיב שלה לא תואם לאזור שצוין בנקודת הקצה, כולל /locations/global/,‏ /locations/us/,‏ /locations/eu/ או אזור אחר. לדוגמה, אם תשלחו את GET .../locations/global/applications/globalApp לנקודת קצה אזורית, הבקשה תידחה.

כדי לנהל משאבים גלובליים או משאבים במספר אזורים, משתמשים בנקודת הקצה הגלובלית https://apphub.googleapis.com.

מיקומים נתמכים

אפשר להשתמש בנקודות קצה אזוריות בכל המיקומים האזוריים שבהם App Hub זמין. כאן תוכלו למצוא רשימה של האזורים הנתמכים.

כלים לשימוש בנקודות קצה אזוריות

אתם יכולים להגדיר את Google Cloud CLI או לשלוח בקשות ישירות ל-API ל-REST או ל-RPC באמצעות נקודות קצה אזוריות.

Google Cloud CLI

כדי להגדיר את Google Cloud CLI לשימוש עם נקודות קצה אזוריות:

  1. חשוב לוודא שאתם משתמשים בגרסה 468.0.0 ואילך של Google Cloud CLI.

  2. מגדירים את המאפיין api_endpoint_overrides/apphub לנקודת הקצה האזורית שבה רוצים להשתמש:

    gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/
    

    מחליפים את LOCATION באזור נתמך, כמו us-central1.

לחלופין, מגדירים את משתנה הסביבה CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB לנקודת הקצה:

CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/ \
  gcloud apphub applications list --location=LOCATION

ממשקי API בארכיטקטורת REST

כדי לשלוח בקשות לנקודות קצה אזוריות, משתמשים ב-URI הבא ומחליפים את LOCATION באזור נתמך:

https://apphub.LOCATION.rep.googleapis.com

לדוגמה, אתם יכולים להשתמש בנקודת הקצה הבאה כדי לגשת ל-App Hub באזור us-central1:

https://apphub.us-central1.rep.googleapis.com

Terraform

כדי להשתמש בנקודות קצה אזוריות עם Terraform, צריך לשנות את נקודת הקצה של App Hub בבלוק של ספק Google.

כשמגדירים נקודת קצה אזורית כנקודת הקצה בהתאמה אישית, אי אפשר להשתמש ב-Terraform כדי לנהל משאבים גלובליים או משאבים במספר אזורים, כמו google_apphub_service_project_attachment, ‏google_apphub_boundary או אפליקציות ב-global, ‏us או eu.

provider "google" {
  project = "project-id"
  region = "us-central1"
  # Override the App Hub API endpoint to use a regional endpoint
  apphub_custom_endpoint = "https://apphub.us-central1.rep.googleapis.com/v1/"
}

ספריות לקוח

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

בדוגמה הבאה נעשה שימוש בספריית הלקוח של Python.

from google.cloud import apphub_v1
from google.api_core import client_options

rep_endpoint = "apphub.us-central1.rep.googleapis.com"
options = client_options.ClientOptions(api_endpoint=rep_endpoint)

# Instantiate the client
client = apphub_v1.AppHubClient(client_options=options)

הגבלת השימוש בנקודת הקצה הגלובלית ל-API

כדי לאכוף את השימוש בנקודות קצה אזוריות, אתם יכולים להשתמש באילוץ מדיניות הארגון constraints/gcp.restrictEndpointUsage כדי לחסום בקשות לנקודת קצה ל-API גלובלית. מידע נוסף על הגבלת השימוש בנקודות קצה זמין במאמר הגבלת השימוש בנקודות קצה.