טריגרים של HTTP (דור ראשון)

בפונקציות Cloud Run, טריגר HTTP מאפשר לפונקציה לפעול בתגובה לבקשות HTTP(S). כשמגדירים טריגר HTTP לפונקציה, מוקצית לפונקציה כתובת URL שדרכה היא יכולה לקבל בקשות. טריגרים של HTTP תומכים ב-methods של בקשות: GET,‏ POST,‏ PUT,‏ DELETE ו-OPTIONS.

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

משתמשים בפונקציות HTTP כדי להטמיע פונקציות של Cloud Run שיכולות לטפל בבקשות HTTP(S) כלליות.

פריסה

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

gcloud

אם מבצעים פריסה באמצעות ה-CLI של gcloud, משתמשים בדגלים שמוצגים כאן כדי להגדיר טריגרים של HTTP:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • הדגל --trigger-http מציין שהפונקציה משתמשת בטריגר HTTP.
  • הדגל --allow-unauthenticated מציין שאפשר להפעיל את הפונקציה בלי אימות. אם לא מציינים את הדגל הזה, נדרש אימות כדי להפעיל את הפונקציה. מידע נוסף זמין במאמר ביצוע אימות להפעלת פונקציה.
  • הדגל --security-level קובע אם נקודת הקצה של הפונקציה דורשת HTTPS. הערך secure-always מציין שנדרש HTTPS ובקשות HTTP שאינן SSL אינן נתמכות. הערך secure-optional מציין שהפרוטוקולים HTTP ו-HTTPS נתמכים. ערך ברירת המחדל הוא secure-always.

המסוף

אם אתם מבצעים פריסה באמצעות מסוף Google Cloud , תוכלו להגדיר טריגר HTTP בקטע Trigger:

  1. בשדה סוג הטריגר, בוחרים באפשרות HTTP.
  2. בשדה אימות, בוחרים באפשרות בהתאם לשאלה אם רוצים לאפשר הפעלות לא מאומתות של הפונקציה. כברירת מחדל, נדרש אימות. מידע נוסף זמין במאמר אימות להפעלה.
  3. מסמנים או מבטלים את הסימון של תיבת הסימון Require HTTPS כדי לקבוע אם נדרש HTTPS לנקודת הקצה של הפונקציה. אם מבטלים את הבחירה, יש תמיכה גם ב-HTTP וגם ב-HTTPS.

כתובת URL של פונקציה

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

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

https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

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

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

  --format="value(httpsTrigger.url)"

המסוף

  1. נכנסים לדף הסקירה הכללית של Cloud Run functions במסוף Google Cloud :

    כניסה לדף Cloud Run functions

  2. לוחצים על השם של הפונקציה שרוצים לאחזר את כתובת ה-URL שלה.

  3. לוחצים על הכרטיסייה 'עריכה'.

  4. כתובת ה-URL של הפונקציה מופיעה בקטע Trigger (טריגר).

השלבים הבאים