טריגרים של 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. בקטע הזה מופיע מידע נוסף ספציפי להגדרת טריגרים של 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. בשדה Trigger type (סוג הטריגר), בוחרים באפשרות 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 (טריגר).

השלבים הבאים