העברה של דומיין מותאם אישית ב-App Engine ל-Cloud Load Balancing

מזהה אזור

הערך REGION_ID הוא קוד מקוצר ש-Google מקצה על סמך האזור שאתם בוחרים כשאתם יוצרים את האפליקציה. הקוד לא תואם למדינה או למחוז, למרות שחלק ממזהי האזורים עשויים להיראות דומים לקודים נפוצים של מדינות ומחוזות. באפליקציות שנוצרו אחרי פברואר 2020, REGION_ID.r נכלל בכתובות ה-URL של App Engine. באפליקציות קיימות שנוצרו לפני התאריך הזה, מזהה האזור הוא אופציונלי בכתובת ה-URL.

מידע נוסף על מזהי אזורים

במדריך הזה מוסבר איך להגדיר נקודת קצה ציבורית חדשה לאפליקציית App Engine באמצעות Cloud Load Balancing.

ב-Cloud Load Balancing, מגדירים את נקודת הקצה של הדומיין המותאם אישית כשירות לקצה הקדמי, ומגדירים את אפליקציית App Engine כשירות לקצה העורפי באמצעות קבוצה של נקודות קצה ברשת (NEG) ללא שרת. תנועת הנתונים לנקודת הקצה של שירות הקצה הקדמי של Cloud Load Balancing מנותבת באותו אופן כמו קודם, כולל כל כללי הניתוב שהגדרתם בקובץ dispatch.yaml של האפליקציה.

התרשים הבא מתאר את השינויים באפליקציה:

לקחת דומיין מותאם אישית של App Engine ולהעביר בקשות נכנסות לשירות ממשק קצה של Cloud Load Balancing, שמפיץ בקשות לשירות App Engine לקצה העורפי.

המעבר ל-Cloud Load Balancing מאפשר לכם ליהנות מגמישות רבה יותר בטיפול בתנועה שמגיעה לדומיין שלכם, כמו הצגת תוכן סטטי מ-Cloud Storage או הוספת שירותים שפועלים בפלטפורמות מחשוב אחרות כמו Cloud Run ו-Google Kubernetes Engine.

בנוסף, תקבלו גישה ליכולות Google Cloud חשובות שלא זמינות ב-App Engine, כולל:

  • ‫Google Cloud Armor, לשיפור האבטחה באמצעות הגנה מתקדמת מפני מתקפות DDoS, אמצעי בקרת גישה שמבוססים על כתובת IP ומיקום גיאוגרפי, כללים של חומת אש ליישומי אינטרנט (WAF) ועוד
  • ‫Cloud CDN, להעברת תוכן שנשמר במטמון
  • כללי מדיניות SSL, לניהול תכונות ה-SSL וגרסאות ה-TLS שהאפליקציה תקבל

במדריך הזה מוסבר איך להעביר בקשות נכנסות משירות App Engine עם דומיין בהתאמה אישית לשירות קצה קדמי של Cloud Load Balancing:

  1. מוודאים שיש לכם את ההרשאות הנדרשות
  2. יצירת אישור בניהול Google
  3. הגדרת Cloud Load Balancing
  4. בדיקת מאזן העומסים
  5. חיבור הדומיין למאזן העומסים
  6. מחיקת המיפוי של הדומיין המותאם אישית ב-App Engine
  7. הגדרת שליטה בתעבורת נתונים נכנסת (ingress) כדי לאפשר גישה רק דרך Cloud Load Balancing

לפני שמתחילים

אפליקציית App Engine עם דומיין מותאם אישית שמוגדר בהגדרות של App Engine.

הגדרת ההרשאות

כדי לפעול לפי המדריך הזה, צריך ליצור בפרויקט אישור בניהול Google, קבוצת נקודות קצה של רשת (NEG) ללא שרת ומאזן עומסים חיצוני מסוג HTTP(S). אתם צריכים להיות בעלים או עורכים של הפרויקט, או שיהיו לכם תפקידי ה-IAM הבאים:

משימה התפקיד הנדרש
יצירת אישור SSL בניהול Google באמצעות Certificate Manager בעלים של Certificate Manager או עריכה של Certificate Manager, וגם אדמין של Compute Load Balancer
עדכון רשומות ה-DNS של הדומיין המותאם אישית אדמין של Cloud DNS אם משתמשים ב-Cloud DNS כפתרון ה-DNS.

אם אתם משתמשים בספק DNS אחר, תצטרכו הרשאות כדי להוסיף ולעדכן את רשומות ה-DNS של הדומיין המותאם אישית.
יצירת מאזן עומסים ורכיבי רשת אדמין של רשת Compute
יצירה ושינוי של קבוצות NEG Compute Instance Admin
יצירה ושינוי של אישורי SSL אדמין אבטחה של Compute
מחיקת דומיינים מותאמים אישית בהגדרות של App Engine התפקיד "אדמין App Engine" או תפקיד שכולל את ההרשאה appengine.applications.update.

יצירת אישור SSL בניהול Google

אישור SSL בניהול Google (שנקרא גם אישור TLS במסמכי התיעוד) מאפשר ל- Google Cloud לקבל, לנהל ולחדש אישורים באופן אוטומטי. כדי להעביר את ממשק המשתמש ל-Cloud Load Balancing בלי לגרום לזמן השבתה של שירות App Engine הקיים, צריך להשתמש ב-Certificate Manager כדי ליצור הרשאת DNS ואישור בניהול Google.

שימו לב שבמסמכי התיעוד של Cloud Load Balancing יש הוראות דומות ליצירת אישור SSL בניהול Google, אבל ההוראות שם משתמשות בהרשאה של מאזן העומסים, שדורשת זמן השבתה של שירות App Engine שיכול להימשך עד כמה שעות. למידע נוסף, קראו את המאמר הרשאת דומיין לאישורים בניהול Google.

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

יצירת הרשאת DNS

  1. כדי ליצור את הרשאת ה-DNS ב-Certificate Manager, מריצים את הפקודות הבאות:

    gcloud certificate-manager dns-authorizations create AUTHORIZATION_NAME \
        --domain="DOMAIN_NAME"
    gcloud certificate-manager dns-authorizations describe AUTHORIZATION_NAME
    

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

    • ‫AUTHORIZATION_NAME הוא שם ייחודי שמתאר את הרשאת ה-DNS הזו.
    • ‫DOMAIN_NAME הוא השם של הדומיין המותאם אישית ב-App Engine שעבורו אתם יוצרים את הרשאת ה-DNS הזו.
  2. שימו לב ל-CNAME שמוחזר על ידי הפקודה gcloud. תצטרכו להשתמש בו כדי לעדכן את רשומת ה-DNS בשלבים הבאים.

הוספת רשומת CNAME להגדרות ה-DNS

בהתאם לפתרון ה-DNS שבו אתם משתמשים, Cloud DNS או פתרון של צד שלישי, פועלים לפי ההוראות שמתאימות לתרחיש לדוגמה שלכם:

Cloud DNS

כשיוצרים הרשאת DNS, הפקודה gcloud מחזירה את רשומת ה-CNAME התואמת. צריך להוסיף את רשומת ה-CNAME הזו להגדרות ה-DNS בתחום ה-DNS של דומיין היעד, באופן הבא:

  1. מתחילים את הטרנזקציה של רשומת ה-DNS:

    gcloud dns record-sets transaction start --zone="DNS_ZONE_NAME"
    

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

  2. מוסיפים את רשומת ה-CNAME לתחום ה-DNS של היעד:

    gcloud dns record-sets transaction add CNAME_RECORD \
      --name="_acme-challenge.DOMAIN_NAME." \
      --ttl="30" \
      --type="CNAME" \
      --zone="DNS_ZONE_NAME"
    

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

    • ‫CNAME_RECORD הוא הערך המלא של רשומת ה-CNAME שהוחזרה על ידי הפקודה gcloud שיצרה את הרשאת ה-DNS התואמת.
    • ‫DOMAIN_NAME הוא שם הדומיין המותאם אישית של App Engine. חובה לכלול את הנקודה בסוף שם דומיין היעד.
    • ‫DNS_ZONE_NAME הוא השם של אזור ה-DNS של היעד מהשלב הקודם.
  3. מבצעים את הטרנזקציה של רשומת ה-DNS כדי לשמור את השינויים:

    gcloud dns record-sets transaction execute --zone="DNS_ZONE_NAME"
    

    מחליפים את DNS_ZONE_NAME בשם של תחום ה-DNS לטירגוט מהשלב הקודם.

פתרון DNS אחר

מוסיפים רשומת CNAME להגדרות ה-DNS של הדומיין, באמצעות השם (המארח) (_acme-challenge.DOMAIN_NAME) ושדות הנתונים מהקטע הקודם. כדאי לעיין במסמכי התיעוד של פתרון ה-DNS של הצד השלישי.

יצירת אישור בניהול Google שמפנה להרשאת ה-DNS

כדי ליצור אישור בניהול Google שמפנה להרשאת ה-DNS שיצרתם בשלבים הקודמים, מריצים את הפקודות הבאות:

  1. יוצרים אישור שמנוהל על ידי Google:

    gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains=DOMAIN_NAME --dns-authorizations=AUTHORIZATION_NAME
    

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

    • ‫CERTIFICATE_NAME הוא שם ייחודי שמתאר את האישור.
    • ‫DOMAIN_NAME הוא השם של הדומיין המותאם אישית של App Engine.
    • ‫AUTHORIZATION_NAME הוא השם של הרשאת ה-DNS שנוצרה קודם.
  2. מוודאים שהאישור פעיל.

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

    gcloud certificate-manager certificates describe CERTIFICATE_NAME
    

    מחליפים את CERTIFICATE_NAME בשם של האישור בניהול Google שנוצר קודם.

    הכלי gcloud מחזיר פלט דומה לזה:

    certificatePem: myPEM
    createTime: '2021-10-20T12:19:53.370778666Z'
    expireTime: '2022-05-07T05:03:49Z'
    managed:
      authorizationAttemptInfo:
      - domain: example.com
        state: AUTHORIZED
      dnsAuthorizations:
      - projects/my-project/locations/global/dnsAuthorizations/myAuth
      domains:
      - example.com
      state: ACTIVE
    name: projects/myProject/locations/global/certificates/myCert
    scope: myScope
    sanDnsnames:
    - example.com
    updateTime: '2021-10-20T12:19:55.083385630Z'
    

    אם הכלי gcloud מחזיר פלט אחר, עיינו במאמר פתרון בעיות ב-Certificate Manager.

יצירת מפת אישורים

  1. יוצרים מפת אישורים:

    gcloud certificate-manager maps create CERTIFICATE_MAP_NAME
    

    מחליפים את CERTIFICATE_MAP_NAME בשם ייחודי שמתאר את מפת האישורים.

  2. יוצרים רשומת מיפוי לאישורים ומשייכים אותה לאישור ולמפת האישורים מהשלבים הקודמים:

    gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
        --map=CERTIFICATE_MAP_NAME \
        --certificates=CERTIFICATE_NAME \
        --set-primary
    

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

    • ‫CERTIFICATE_MAP_ENTRY_NAME הוא שם ייחודי שמתאר את רשומת המיפוי לאישורים.
    • ‫CERTIFICATE_MAP_NAME הוא השם של מפת האישורים שאליה מצורפת רשומת המיפוי לאישורים.
    • ‫CERTIFICATE_NAME הוא שם האישור שרוצים לשייך לרשומת מיפוי לאישורים זו.

    אפשר להוסיף את הדגל --set-primary כדי לוודא שהאישור ישמש כאישור ברירת המחדל אם לא צוין שם דומיין.

  3. מוודאים שמפת האישורים פעילה.

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

    gcloud certificate-manager maps entries describe CERTIFICATE_MAP_ENTRY_NAME \
        --map=CERTIFICATE_MAP_NAME
    

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

    • ‫CERTIFICATE_MAP_ENTRY_NAME הוא השם של רשומת המיפוי לאישורים מהשלב הקודם.
    • ‫CERTIFICATE_MAP_NAME הוא השם של מפת האישורים שאליה מצורפת רשומת המיפוי לאישורים.

    הכלי gcloud מחזיר פלט דומה לזה:

    createTime: '2021-09-06T10:01:56.229472109Z'
    name: projects/my-project/locations/global/certificateMaps/myCertMap/certificateMapEntries/myCertMapEntry
    state: ACTIVE
    updateTime: '2021-09-06T10:01:58.277031787Z'
    

למידע נוסף על השימוש ב-Certificate Manager, ראה איך Certificate Manager פועל.

הגדרת Cloud Load Balancing

אחרי שיש לכם אישור בניהול Google, אתם יכולים להחליף את הדומיין המותאם אישית של App Engine בשירות קצה קדמי של Cloud Load Balancing.

בתרשים הבא מוצג מאזן עומסים מסוג HTTPS עם שירות לקצה העורפי יחיד וקבוצת נקודות קצה ללא שרת (serverless NEG).

הפצת תנועה לאפליקציה ב-App Engine

כללי העברה מנתבים בקשות נכנסות מכתובות IP חיצוניות ומפנים בקשות לשרת ה-proxy ל-HTTPS. מאזני העומסים מסוג HTTPS משתמשים במפות URL כדי להפנות בקשות לשירות לקצה העורפי, שמכיל קבוצת נקודות קצה ללא שרת (serverless NEG) בשביל שירות App Engine.

שמירת כתובת IP חיצונית

לפני שמגדירים את Cloud Load Balancing, צריך להגדיר כתובת IP חיצונית סטטית גלובלית כדי שהמשתמשים יוכלו להגיע למאזן העומסים.

המסוף

  1. נכנסים לדף External IP addresses במסוף Google Cloud .

    נכנסים אל External IP addresses

  2. לוחצים על Reserve static address כדי לשמור כתובת IPv4.

  3. נותנים לכתובת הסטטית Name, לדוגמה appengine-external-ip.

  4. מגדירים את מסלול הרשת ל-Premium.

  5. מגדירים את IP version ל-IPv4.

  6. מגדירים את Type בתור Global.

  7. לוחצים על Reserve.

gcloud

  1. יצירת שמירה של כתובת IP חיצונית:

    gcloud compute addresses create EXTERNAL_IP \
        --network-tier=PREMIUM \
        --ip-version=IPV4 \
        --global
    

    ‫EXTERNAL_IP הוא השם של הכתובות שרוצים ליצור.

  2. שימו לב לכתובת ה-IPv4 שנשמרה:

    gcloud compute addresses describe EXTERNAL_IP \
        --format="get(address)" \
        --global
    

הגדרת שירות לקצה העורפי של App Engine

קבוצה של נקודות קצה ברשת (NEG) משמשת כדי לציין קבוצה של נקודות קצה לקצה העורפי של מאזן עומסים. כדי לציין קצה עורפי שמפנה לשירות App Engine, מגדירים את ה-NEG ללא שרת (serverless) ואז מגדירים את שירות הקצה העורפי, את כללי הניתוב ואת שירות הקצה הקדמי ב-Cloud Load Balancing.

  1. יוצרים קבוצת נקודות קצה ברשת ללא שרת (serverless) בשביל האפליקציה ב-App Engine:

    gcloud compute network-endpoint-groups create APP_ENGINE_NEG \
    --network-endpoint-type=serverless \
    --app-engine-app \
    --region=APP_ENGINE_REGION
    

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

    • ‫APP_ENGINE_NEG הוא השם של קבוצת נקודות הקצה ברשת.
    • ‫APP_ENGINE_REGION הוא האזור שהוגדר ב-App Engine.

    אפשר להוסיף את הדגל --app-engine-app למעלה כדי להשתמש בניתוב שמוגדר כברירת מחדל, במקום להפנות לשירות ספציפי של App Engine. שימוש בניתוב ברירת מחדל פירושו שהבקשות יישלחו לשירות ברירת המחדל (https://PROJECT_ID.REGION_ID.r.appspot.com), ובמקרים אחרים הן יפעלו לפי כל כללי הניתוב שהגדרתם בקובץ dispatch.yaml. ההתנהגות הזו זהה להתנהגות של דומיינים מותאמים אישית שהוגדרו באמצעות App Engine.

  2. יוצרים את השירות לקצה העורפי:

    gcloud compute backend-services create APP_ENGINE_BACKEND \
      --global \
      --load-balancing-scheme=EXTERNAL_MANAGED
    

    מחליפים את APP_ENGINE_BACKEND בשם של השירות לקצה העורפי שרוצים ליצור.

  3. מוסיפים את ה-NEG ללא שרת לשירות לקצה העורפי של App Engine:

    gcloud compute backend-services add-backend APP_ENGINE_BACKEND \
    --global --network-endpoint-group=APP_ENGINE_NEG \
    --network-endpoint-group-region=APP_ENGINE_REGION
    

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

    • ‫APP_ENGINE_BACKEND הוא השם של שירות הקצה העורפי מהשלב הקודם.
    • ‫APP_ENGINE_NEG הוא השם של קבוצת נקודות הקצה ברשת.
    • ‫APP_ENGINE_REGION הוא האזור שהוגדר ב-App Engine.
  4. יוצרים מפת URL כדי לנתב בקשות נכנסות לשירות לקצה העורפי:

    gcloud compute url-maps create URL_MAP_NAME \
          --default-service APP_ENGINE_BACKEND
    

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

    • ‫URL_MAP_NAME הוא שם ייחודי למשאב של מפת URL שמגדיר את המיפוי של כתובות ה-URL לשירותים לקצה העורפי.
    • ‫APP_ENGINE_BACKEND הוא השם של שירות הקצה העורפי מהשלב הקודם.
  5. יוצרים שרת proxy ל-HTTPS לניתוב בקשות למפת URL:

    gcloud compute target-https-proxies create TARGET_HTTPS_PROXY_NAME \
          --certificate-map=CERTIFICATE_MAP_NAME \
          --url-map=URL_MAP_NAME
    

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

    • ‫TARGET_HTTPS_PROXY_NAME הוא שם ייחודי שאתם בוחרים כדי לתאר את שרת ה-Proxy ל-HTTPS.
    • ‫CERTIFICATE_MAP_NAME הוא השם של מפת האישורים שמפנה לרשומת המיפוי לאישורים ולאישור שמשויך אליה.
    • ‫URL_MAP_NAME הוא השם של מפת URL מהשלב הקודם.
  6. יוצרים כלל העברה כדי לנתב בקשות נכנסות לשרת ה-proxy:

    gcloud compute forwarding-rules create HTTPS_FORWARDING_RULE_NAME \
          --load-balancing-scheme=EXTERNAL_MANAGED \
          --network-tier=PREMIUM \
          --address=EXTERNAL_IP \
          --target-https-proxy=TARGET_HTTPS_PROXY_NAME \
          --global \
          --ports=443
    

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

    • ‫HTTPS_FORWARDING_RULE_NAME הוא שם ייחודי שמתאר את כלל ההעברה לניתוב התנועה ברשת לשרת ה-Proxy ל-HTTPS.
    • ‫TARGET_HTTPS_PROXY_NAME הוא השם של שרת ה-proxy ל-HTTPS מהשלב הקודם.
    • ‫EXTERNAL_IP הוא השם של כתובת ה-IPv4 שנוצרה קודם.

בדיקת מאזן העומסים

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

  1. נכנסים לדף Load balancing במסוף Google Cloud .
    כניסה לדף Load balancing
  2. לוחצים על מאזן העומסים שיצרתם.
  3. שימו לב ל-כתובת ה-IP של מאזן העומסים.
  4. במאזן עומסים מסוג HTTPS, אפשר לבדוק את מאזן העומסים באמצעות דפדפן אינטרנט, על ידי מעבר אל https://IP_ADDRESS. מחליפים את IP_ADDRESS בכתובת ה-IP של מאזן העומסים, לדוגמה 30.90.80.100.

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

    לאפשרויות הגדרה נוספות, ראו הגדרת מאזן עומסים גלובלי חיצוני מסוג HTTP(S) עם פלטפורמות ללא שרת (serverless).

חיבור הדומיין למאזן העומסים

אחרי שיוצרים את מאזן העומסים, שימו לב לכתובת ה-IP שמשויכת אליו, לדוגמה 30.90.80.100. כדי להפנות את הדומיין למאזן העומסים, צריך ליצור רשומת A באמצעות שירות הרישום של הדומיין. אם הוספתם כמה דומיינים לאישור ה-SSL, צריך להוסיף רשומת A לכל אחד מהם, כשכולם מפנים לכתובת ה-IP של מאזן העומסים. לדוגמה, כדי ליצור רשומות A בשביל www.example.com ובשביל example.com, משתמשים בפקודה הבאה:

NAME                  TYPE     DATA
www                   A        30.90.80.100
@                     A        30.90.80.100

אם אתם משתמשים ב-Cloud DNS כספק ה-DNS, קראו את המאמר הוספה, שינוי ומחיקה של רשומות.

מחיקת המיפוי של הדומיין המותאם אישית ב-App Engine

במסוף Google Cloud :

  1. נכנסים לכרטיסייה Custom Domains בדף Settings של App Engine.

    אל "דומיינים מותאמים אישית"

  2. בוחרים את שם הדומיין המותאם אישית ולוחצים על מחיקה.

לחלופין, אתם יכולים להשתמש בפקודות gcloud או ב-Admin API כדי למחוק את הדומיין המותאם אישית.

הגדרת בקרת תעבורת נתונים נכנסת (ingress) כדי לאפשר גישה רק דרך Cloud Load Balancing

אחרי שבודקים את מאזן העומסים, מומלץ לעדכן את האפליקציה ב-App Engine כך שתקבל תנועה רק מ-Cloud Load Balancing. במאמר הגדרות Ingress מוסבר איך להגדיר אמצעי בקרה על תעבורת נתונים נכנסת (ingress) ב-internal-and-cloud-load-balancing.