מזהה אזור
הערך 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 של האפליקציה.
התרשים הבא מתאר את השינויים באפליקציה:
המעבר ל-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:
- מוודאים שיש לכם את ההרשאות הנדרשות
- יצירת אישור בניהול Google
- הגדרת Cloud Load Balancing
- בדיקת מאזן העומסים
- חיבור הדומיין למאזן העומסים
- מחיקת המיפוי של הדומיין המותאם אישית ב-App Engine
- הגדרת שליטה בתעבורת נתונים נכנסת (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
כדי ליצור את הרשאת ה-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 הזו.
-
שימו לב ל-CNAME שמוחזר על ידי הפקודה
gcloud. תצטרכו להשתמש בו כדי לעדכן את רשומת ה-DNS בשלבים הבאים.
הוספת רשומת CNAME להגדרות ה-DNS
בהתאם לפתרון ה-DNS שבו אתם משתמשים, Cloud DNS או פתרון של צד שלישי, פועלים לפי ההוראות שמתאימות לתרחיש לדוגמה שלכם:
Cloud DNS
כשיוצרים הרשאת DNS, הפקודה gcloud מחזירה את רשומת ה-CNAME התואמת. צריך להוסיף את רשומת ה-CNAME הזו להגדרות ה-DNS בתחום ה-DNS של דומיין היעד, באופן הבא:
מתחילים את הטרנזקציה של רשומת ה-DNS:
gcloud dns record-sets transaction start --zone="DNS_ZONE_NAME"
מחליפים את
DNS_ZONE_NAMEבשם של תחום ה-DNS הציבורי. אם אתם משתמשים ב- Google Cloud כדי לנהל את הדומיין ולקבל תנועה לדומיין הזה, כבר יצרתם אזור DNS ציבורי. כדי לראות את תחום ה-DNS הציבורי, קראו את המאמר הצגת רשימה ותיאור של תחומים מנוהלים.מוסיפים את רשומת ה-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 של היעד מהשלב הקודם.
-
מבצעים את הטרנזקציה של רשומת ה-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 שיצרתם בשלבים הקודמים, מריצים את הפקודות הבאות:
יוצרים אישור שמנוהל על ידי Google:
gcloud certificate-manager certificates create CERTIFICATE_NAME \ --domains=DOMAIN_NAME --dns-authorizations=AUTHORIZATION_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
CERTIFICATE_NAMEהוא שם ייחודי שמתאר את האישור. -
DOMAIN_NAMEהוא השם של הדומיין המותאם אישית של App Engine. -
AUTHORIZATION_NAMEהוא השם של הרשאת ה-DNS שנוצרה קודם.
-
מוודאים שהאישור פעיל.
כדי לוודא שהאישור עצמו פעיל לפני שפורסים אותו במאזן העומסים, משתמשים בפקודה הבאה: שימו לב: יכול להיות שיעברו כמה שעות עד שהסטטוס של האישור ישתנה ל-
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.
יצירת מפת אישורים
יוצרים מפת אישורים:
gcloud certificate-manager maps create CERTIFICATE_MAP_NAME
מחליפים את
CERTIFICATE_MAP_NAMEבשם ייחודי שמתאר את מפת האישורים.יוצרים רשומת מיפוי לאישורים ומשייכים אותה לאישור ולמפת האישורים מהשלבים הקודמים:
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כדי לוודא שהאישור ישמש כאישור ברירת המחדל אם לא צוין שם דומיין.-
מוודאים שמפת האישורים פעילה.
כדי לוודא שרשומת המיפוי לאישורים פעילה לפני שמצרפים את מפת האישורים המתאימה לשרת 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).
כללי העברה מנתבים בקשות נכנסות מכתובות IP חיצוניות ומפנים בקשות לשרת ה-proxy ל-HTTPS. מאזני העומסים מסוג HTTPS משתמשים במפות URL כדי להפנות בקשות לשירות לקצה העורפי, שמכיל קבוצת נקודות קצה ללא שרת (serverless NEG) בשביל שירות App Engine.
שמירת כתובת IP חיצונית
לפני שמגדירים את Cloud Load Balancing, צריך להגדיר כתובת IP חיצונית סטטית גלובלית כדי שהמשתמשים יוכלו להגיע למאזן העומסים.
המסוף
נכנסים לדף External IP addresses במסוף Google Cloud .
לוחצים על Reserve static address כדי לשמור כתובת IPv4.
נותנים לכתובת הסטטית Name, לדוגמה
appengine-external-ip.מגדירים את מסלול הרשת ל-Premium.
מגדירים את IP version ל-IPv4.
מגדירים את Type בתור Global.
לוחצים על Reserve.
gcloud
יצירת שמירה של כתובת IP חיצונית:
gcloud compute addresses create EXTERNAL_IP \ --network-tier=PREMIUM \ --ip-version=IPV4 \ --global
EXTERNAL_IPהוא השם של הכתובות שרוצים ליצור.שימו לב לכתובת ה-IPv4 שנשמרה:
gcloud compute addresses describe EXTERNAL_IP \ --format="get(address)" \ --global
הגדרת שירות לקצה העורפי של App Engine
קבוצה של נקודות קצה ברשת (NEG) משמשת כדי לציין קבוצה של נקודות קצה לקצה העורפי של מאזן עומסים. כדי לציין קצה עורפי שמפנה לשירות App Engine, מגדירים את ה-NEG ללא שרת (serverless) ואז מגדירים את שירות הקצה העורפי, את כללי הניתוב ואת שירות הקצה הקדמי ב-Cloud Load Balancing.
יוצרים קבוצת נקודות קצה ברשת ללא שרת (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.-
יוצרים את השירות לקצה העורפי:
gcloud compute backend-services create APP_ENGINE_BACKEND \ --global \ --load-balancing-scheme=EXTERNAL_MANAGED
מחליפים את
APP_ENGINE_BACKENDבשם של השירות לקצה העורפי שרוצים ליצור.מוסיפים את ה-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.
-
יוצרים מפת URL כדי לנתב בקשות נכנסות לשירות לקצה העורפי:
gcloud compute url-maps create URL_MAP_NAME \ --default-service APP_ENGINE_BACKENDמחליפים את מה שכתוב בשדות הבאים:
-
URL_MAP_NAMEהוא שם ייחודי למשאב של מפת URL שמגדיר את המיפוי של כתובות ה-URL לשירותים לקצה העורפי. -
APP_ENGINE_BACKENDהוא השם של שירות הקצה העורפי מהשלב הקודם.
-
יוצרים שרת 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 מהשלב הקודם.
-
יוצרים כלל העברה כדי לנתב בקשות נכנסות לשרת ה-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 של מאזן העומסים כדי לבדוק אותה לפני העברת הדומיין.
- נכנסים לדף Load balancing במסוף Google Cloud .
כניסה לדף Load balancing - לוחצים על מאזן העומסים שיצרתם.
- שימו לב ל-כתובת ה-IP של מאזן העומסים.
במאזן עומסים מסוג HTTPS, אפשר לבדוק את מאזן העומסים באמצעות דפדפן אינטרנט, על ידי מעבר אל
https://IP_ADDRESS. מחליפים אתIP_ADDRESSבכתובת ה-IP של מאזן העומסים, לדוגמה30.90.80.100.- אם זה לא עובד ואתם משתמשים באישור בניהול Google, ודאו שהאישור הוא
ACTIVEושמפת האישורים היאACTIVE. - אם אתם משתמשים באישור בחתימה עצמית לצורך בדיקה, הדפדפן יציג אזהרה. אתם צריכים להורות לדפדפן באופן מפורש לקבל אישור חתימה עצמית. לוחצים על האזהרה כדי לראות את הדף עצמו.
לאפשרויות הגדרה נוספות, ראו הגדרת מאזן עומסים גלובלי חיצוני מסוג HTTP(S) עם פלטפורמות ללא שרת (serverless).
- אם זה לא עובד ואתם משתמשים באישור בניהול Google, ודאו שהאישור הוא
חיבור הדומיין למאזן העומסים
אחרי שיוצרים את מאזן העומסים, שימו לב לכתובת ה-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 :
נכנסים לכרטיסייה Custom Domains בדף Settings של App Engine.
בוחרים את שם הדומיין המותאם אישית ולוחצים על מחיקה.
לחלופין, אתם יכולים להשתמש בפקודות gcloud או ב-Admin API כדי למחוק את הדומיין המותאם אישית.
הגדרת בקרת תעבורת נתונים נכנסת (ingress) כדי לאפשר גישה רק דרך Cloud Load Balancing
אחרי שבודקים את מאזן העומסים, מומלץ לעדכן את האפליקציה ב-App Engine כך שתקבל תנועה רק מ-Cloud Load Balancing. במאמר הגדרות Ingress מוסבר איך להגדיר אמצעי בקרה על תעבורת נתונים נכנסת (ingress) ב-internal-and-cloud-load-balancing.