יצירת כתובות URL מותאמות אישית

בדף הזה מוסבר איך להגדיר ולנהל כתובות URL בהתאמה אישית, כדי לקבל כתובת URL קלה להקלדה, קליטה וזמינה בכל העולם לשירותי Cloud Run, במקום כתובת ה-URL שמוגדרת כברירת מחדל:

  • פורמט של כתובת URL מותאמת אישית: https://CUSTOM_URL_DOMAIN.cloud.run
  • פורמט ברירת המחדל של כתובת ה-URL: https://SERVICE_NAME-PROJECT_NUMBER.REGION.run.app

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

כשמשתמשים בכתובות URL מותאמות אישית לשירותי Cloud Run, נהנים מהיתרונות הבאים:

  • כתובות URL פשוטות: מיפוי השירות לפורמט נקי של https://CUSTOM_URL_DOMAIN.cloud.run.
  • זמינות גלובלית: אפשר לגשת לכתובות URL מותאמות אישית מכל מקום, כמו לכתובות URL רגילות של .run.app.
  • מחזור חיים גמיש: אפשר לצרף, לנתק או להעביר כתובת URL בהתאמה אישית בין שירותים בלי לפרוס גרסה חדשה.
  • מיפויים מרובים: אפשר למפות כמה כתובות URL בהתאמה אישית לשירות אחד.

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

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. הגדרת סביבת הפיתוח של Cloud Run בפרויקט Google Cloud .
  7. מתקינים ומפעילים את ה-CLI של gcloud.

התפקידים הנדרשים

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

  • כדי ליצור, לעדכן או למחוק מיפויי כתובות URL מותאמים אישית: אדמין של Cloud Run (roles/run.admin) בפרויקט

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

מגבלות

  • כברירת מחדל, אפשר למפות עד 50 דומיינים לכל פרויקט.
  • שם הדומיין המשני של כתובת ה-URL המותאמת אישית צריך לכלול בין 6 ל-63 תווים, לעמוד במוסכמות השמות הסטנדרטיות של DNS שמאפשרות שימוש בתווים אלפאנומריים ובמקפים, ולא להתחיל או להסתיים במקף.
  • יש הגבלות על חלק מתתי-הדומיינים.
  • אי אפשר להשבית באופן זמני כתובת URL מותאמת אישית, כמו שאפשר להשבית כתובת URL שמוגדרת כברירת מחדל..run.app כדי להפסיק את העברת התנועה ממנו, צריך למחוק את המיפוי.
  • שירותי Cloud Run שמגבילים את התעבורה הנכנסת לתעבורה פנימית או לתעבורה פנימית ולתעבורה של Cloud Load Balancing לא נתמכים.
  • אין תמיכה ב-Terraform לכתובות URL בהתאמה אישית. כדי להימנע משינויים שעלולים לשבור את הפונקציונליות, אל תשתמשו במשאב domain_mapping בגרסת התצוגה המקדימה.
  • כתובות URL מותאמות אישית הן עצמאיות לחלוטין. אם בוחרים להשבית את כתובת ה-URL של .run.app שמוגדרת כברירת מחדל לשירות, מיפוי כתובות ה-URL המותאם אישית נשאר פעיל וזמין.

צירוף או מיפוי של כתובת URL מותאמת אישית לשירות

אפשר לצרף כתובת URL בהתאמה אישית לשירות חדש כשפורסים אותו, או למפות כתובת URL בהתאמה אישית לשירות קיים באמצעות מסוף Google Cloud או gcloud.

צירוף כתובות URL מותאמות אישית לשירות חדש

כשפורסים שירות חדש של Cloud Run, אפשר לצרף כתובת URL בהתאמה אישית כחלק מהגדרות הפריסה.

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

    כניסה ל-Cloud Run

  2. לוחצים על פריסת מאגר תגים.

  3. ממלאים את פרטי ההגדרה הבסיסיים של השירות.

  4. בקטע כתובות URL מותאמות אישית, לוחצים על הוספת כתובת URL מותאמת אישית.

  5. מזינים דומיין חוקי של כתובת URL מותאמת אישית.

  6. זה שינוי אופציונלי. כדי להוסיף כמה כתובות URL מותאמות אישית, לוחצים שוב על הוספת כתובת URL מותאמת אישית.

  7. לוחצים על יצירה.

מיפוי כתובות URL מותאמות אישית לשירות קיים

אפשר למפות כתובת URL בהתאמה אישית לשירות קיים של Cloud Run באמצעות מסוףGoogle Cloud או ה-CLI של gcloud.

המסוף

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

    מעבר למיפוי דומיינים

  2. לוחצים על הוספת כתובת URL מותאמת אישית.

  3. ברשימה Service, בוחרים את השירות שרוצים למפות.

  4. מזינים את הדומיין של כתובת ה-URL המותאמת אישית.

  5. לוחצים על Continue.

כדי להוסיף כמה כתובות URL מותאמות אישית, לוחצים שוב על הוספת כתובת URL מותאמת אישית ופועלים לפי השלבים הקודמים.

gcloud

כדי ליצור מיפוי של דומיין עם כתובת URL מותאמת אישית לשירות קיים, מריצים את הפקודה הבאה:

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

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

  • ‫SERVICE_NAME: השם של השירות שאליו אתם ממפים את כתובת ה-URL המותאמת אישית.
  • ‫CUSTOM_URL_DOMAIN: תת-הדומיין שרוצים לצרף.

זה שינוי אופציונלי. כדי למפות כמה כתובות URL מותאמות אישית באמצעות ה-CLI של gcloud, מריצים את פקודת יצירת המיפוי שוב ושוב לכל כתובת URL מותאמת אישית:

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_1.cloud.run

gcloud beta run domain-mappings create \
    --service=SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN_2.cloud.run

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

  • ‫SERVICE_NAME: השם של השירות שאתם פורסים.
  • ‫CUSTOM_URL_DOMAIN_1: תת-הדומיין הראשון לצירוף.
  • ‫CUSTOM_URL_DOMAIN_2: תת-הדומיין השני לצירוף.

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

הצגה של רשימת כתובות URL מותאמות אישית

אתם יכולים להציג רשימה של כל כתובות ה-URL המותאמות אישית ולראות את פרטי המיפוי של הסביבה שלכם.

המסוף

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

    כניסה ל-Cloud Run

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

  3. עוברים לכרטיסייה Networking.

  4. מחפשים את כתובות ה-URL המצורפות בקטע דומיינים בהתאמה אישית מתחת לתווית נקודות קצה.

gcloud

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

gcloud beta run domain-mappings list

כדי להציג פרטים לגבי מיפוי של דומיין לכתובת URL מותאמת אישית ספציפית, מריצים את הפקודה:

gcloud beta run domain-mappings describe \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

מחליפים את CUSTOM_URL_DOMAIN בתת-הדומיין שרוצים לתאר.

אבטחה באמצעות קהלים בהתאמה אישית

אתם יכולים לצרף קהל בהתאמה אישית לכתובת URL מותאמת אישית כדי להגביל את הגישה.

gcloud beta run services update SERVICE_NAME \
    --add-custom-audiences=CUSTOM_URL_DOMAIN.cloud.run

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

  • ‫SERVICE_NAME: השם של השירות.
  • ‫CUSTOM_URL_DOMAIN: תת-הדומיין שמשמש כקהל המותאם אישית שלכם.

מחיקת כתובת URL מותאמת אישית

אפשר למחוק מיפוי של כתובת URL מותאמת אישית כשכבר לא צריך אותה.

המסוף

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

    מעבר למיפוי דומיינים

  2. מסמנים את התיבה לצד כתובת ה-URL המותאמת אישית שרוצים למחוק.

  3. לוחצים על Delete.

gcloud

כדי להסיר מיפוי של דומיין עם כתובת URL בהתאמה אישית משירות Cloud Run, מריצים את הפקודה הבאה:

gcloud beta run domain-mappings delete \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

מחליפים את CUSTOM_URL_DOMAIN בתת-הדומיין שרוצים למחוק.

בעיות מוכרות

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

  • עדכון או העברה של כתובת URL מותאמת אישית: אין פקודת עדכון ישירה לכתובות URL מותאמות אישית. כדי להעביר כתובת URL מותאמת אישית מצורפת משירות אחד לשירות אחר, צריך לבצע תהליך של מחיקה ויצירה מחדש.

    המסוף

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

      מעבר למיפוי דומיינים

    2. מסמנים את התיבה לצד כתובת ה-URL המותאמת אישית שרוצים להעביר.

    3. לוחצים על Delete.

    4. לוחצים על הוספת כתובת URL מותאמת אישית.

    5. ברשימה Service, בוחרים את שירות היעד החדש.

    6. מזינים את הדומיין המדויק של כתובת ה-URL המותאמת אישית שדרשתם בעבר.

    7. לוחצים על יצירה כדי להפנות את התנועה לשירות החדש.

    gcloud

    1. מוחקים את המיפוי הקיים מהשירות הישן:

      gcloud beta run domain-mappings delete \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

      מחליפים את CUSTOM_URL_DOMAIN בתת-הדומיין שרשמתם בעבר.

    2. תובעים בעלות על כתובת ה-URL וממפים אותה לשירות החדש:

      gcloud beta run domain-mappings create \
    --service=NEW_SERVICE_NAME \
    --domain=CUSTOM_URL_DOMAIN.cloud.run

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

      • ‫NEW_SERVICE_NAME: השם של השירות שאליו אתם מעבירים את כתובת ה-URL המותאמת אישית.
      • ‫CUSTOM_URL_DOMAIN: תת-הדומיין שרוצים לצרף.

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