מדריך למתחילים: פריסת פונקציית Cloud Run באמצעות מסוף Google Cloud

מדריך למתחילים: פריסת פונקציית Cloud Run באמצעות מסוף Google Cloud

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

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

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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

2. למחירון של Cloud Run או למחשבון עלויות.

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

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

• אדמין של Cloud Run ‏ (roles/run.admin) בפרויקט
• מפתח מקור ב-Cloud Run ‏ (roles/run.sourceDeveloper) בפרויקט
• משתמש בחשבון שירות (roles/iam.serviceAccountUser) בזהות השירות
• צפייה ביומנים (roles/logging.viewer) בפרויקט

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

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

מתן גישה לפרויקט לחשבון השירות של Cloud Build

כברירת מחדל, Cloud Build משתמש בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine בתור חשבון השירות שמוגדר כברירת מחדל ב-Cloud Build כדי ליצור את קוד המקור ואת המשאב של Cloud Run, אלא אם משנים את ההתנהגות הזו.

כדי ש-Cloud Build יוכל ליצור את המקורות, צריך להקצות לחשבון השירות של Cloud Build את התפקיד Cloud Run Builder‏ (roles/run.builder) בפרויקט:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \
    --role=roles/run.builder

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloudואת SERVICE_ACCOUNT_EMAIL_ADDRESS בכתובת האימייל של חשבון השירות של Cloud Build. אם אתם משתמשים בחשבון השירות שמוגדר כברירת מחדל ב-Compute Engine בתור חשבון השירות של Cloud Build, השתמשו בפורמט הבא לכתובת האימייל של חשבון השירות:

[e-mail]

מחליפים את PROJECT_NUMBER במספר הפרויקט ב- Google Cloud.

במאמר יצירה וניהול של פרויקטים מוסבר איך למצוא את מזהה הפרויקט ואת מספר הפרויקט.

הקצאת התפקיד "מפתח ב-Cloud Run" מתעדכנת תוך כמה דקות.

פריסת הפונקציה

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

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

   כניסה ל-Cloud Run

2. לוחצים על כתיבת פונקציה.

3. בשדה Service name, מזינים שם שמתאר את הפונקציה, למשל my-nodejs-http-function. שמות של שירותים יכולים להתחיל רק באות, ויכולים להכיל עד 49 תווים, כולל אותיות, מספרים או מקפים. שמות השירותים לא יכולים להסתיים במקפים, והם צריכים להיות ייחודיים לכל אזור ופרויקט. אי אפשר לשנות את שם השירות בשלב מאוחר יותר, והוא גלוי לכולם.

4. ברשימה Region, משתמשים בערך ברירת המחדל europe-west1 או בוחרים את האזור שבו רוצים לפרוס את הפונקציה.

5. ברשימה Runtime, משתמשים בערך ברירת המחדל או בוחרים גרסת סביבת זמן ריצה.

6. בקטע Authentication, בוחרים באפשרות Allow public access. אם אין לכם הרשאות (תפקיד אדמין ב-Cloud Run) לבחור באפשרות הזו, השירות ייפרס ויידרש אימות.

7. לוחצים על Create ומחכים ש-Cloud Run ייצור את השירות באמצעות גרסה זמנית. המסוף יפנה אתכם לכרטיסייה Source, שבה תוכלו לראות את קוד המקור של הפונקציה.

8. בכרטיסייה Source, לוחצים על Save and redeploy. אם רוצים, לוחצים על Show Payload כדי לראות את אובייקט הבקשה הנכנסת.

9. אחרי הפריסה, כתובת ה-URL של הקונטיינר מוצגת ליד הטקסט URL:‎. כדי לראות את הפלט של הפונקציה, לוחצים על Copy to clipboard כדי להעתיק את כתובת ה-URL שלה, ומדביקים את כתובת ה-URL בסרגל הכתובות של הדפדפן.

   הצלחה: פרסתם פונקציית HTTP של Cloud Run באמצעות מסוף Google Cloud .

מיקומים של Cloud Run

‫Cloud Run הוא שירות אזורי, כלומר התשתית שמפעילה את שירותי Cloud Run נמצאת באזור ספציפי ומנוהלת על ידי Google, כך שהיא זמינה באופן יתיר בכל האזורים באותו אזור.

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

אפשר להשתמש ב-Cloud Run באזורים הבאים:

בכפוף לתמחור ברמה 1

• asia-east1 (טייוואן)
• asia-northeast1 (טוקיו)
• asia-northeast2 (אוסקה)
• ‫asia-south1 (מומבאי, הודו)
• asia-southeast3 (בנגקוק)
• ‫europe-north1 (פינלנד) רמה נמוכה של CO₂
• europe-north2 (שטוקהולם) רמה נמוכה של CO₂
• ‫europe-southwest1 (מדריד) רמה נמוכה של CO₂
• ‫europe-west1 (בלגיה) רמה נמוכה של CO₂
• ‫europe-west4 (הולנד) רמה נמוכה של CO₂
• ‫europe-west8 (מילאנו) רמה נמוכה של CO₂
• ‫europe-west9 (פריז) רמה נמוכה של CO₂
• me-west1 (תל אביב)
• northamerica-south1 (מקסיקו)
• us-central1 (אייווה) רמה נמוכה של CO₂
• us-east1 (קרוליינה הדרומית)
• us-east4 (צפון וירג'יניה)
• us-east5 (קולומבוס)
• us-south1 (דאלאס) רמה נמוכה של CO₂
• us-west1 (אורגון) רמה נמוכה של CO₂

בכפוף לתמחור ברמה 2

• africa-south1 (יוהנסבורג)
• asia-east2 (הונג קונג)
• asia-northeast3 (סיאול, דרום קוריאה)
• asia-southeast1 (סינגפור)
• asia-southeast2 (ג'קרטה)
• asia-south2 (דלהי, הודו)
• australia-southeast1 (סידני)
• australia-southeast2 (מלבורן)
• europe-central2 (ורשה, פולין) רמה נמוכה של CO₂
• europe-west10 (ברלין)
• ‫europe-west12 (טורינו) רמה נמוכה של CO₂
• ‫europe-west2 (לונדון, בריטניה) רמה נמוכה של CO₂
• europe-west3 (פרנקפורט, גרמניה)
• europe-west6 (ציריך, שווייץ) רמה נמוכה של CO₂
• me-central1 (דוחא)
• me-central2 (דמאם)
• ‫northamerica-northeast1 (מונטריאול) רמה נמוכה של CO₂
• ‫northamerica-northeast2 (טורונטו) רמה נמוכה של CO₂
• ‫southamerica-east1 (סאו פאולו, ברזיל) רמה נמוכה של CO₂
• southamerica-west1 (סנטיאגו, צ'ילה) רמה נמוכה של CO₂
• us-west2 (לוס אנג'לס)
• us-west3 (סולט לייק סיטי)
• us-west4 (לאס וגאס)

אם כבר יצרתם שירות Cloud Run, אתם יכולים לראות את האזור במרכז הבקרה של Cloud Run במסוףGoogle Cloud .

אישור

הסרת המשאבים

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

מחיקת המאגר

ב-Cloud Run לא תחויבו כשהשירות שפרסתם לא בשימוש. עם זאת, יכול להיות שעדיין תחויבו על אחסון קובץ האימג' של הקונטיינר ב-Artifact Registry. כדי למחוק מאגרים של Artifact Registry, פועלים לפי השלבים שמפורטים במאמר מחיקת מאגרים במסמכי התיעוד של Artifact Registry.

מחיקת השירות

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

המסוף

כדי למחוק שירות:

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

   כניסה ל-Cloud Run

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

3. לוחצים על Delete. כל הגרסאות של השירות יימחקו.

gcloud

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

gcloud run services delete SERVICE --region REGION

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

• ‫SERVICE: שם השירות.
• ‫REGION: Google Cloud האזור של השירות.

מחיקת פרויקט הבדיקה

מחיקת הפרויקט ב- Google Cloud מפסיקה את החיוב על כל המשאבים באותו פרויקט. כדי לשחרר את כל המשאבים של Google Cloud בפרויקט:

זהירות: כשמוחקים פרויקט:
• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.
1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

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

• כדי לפרוס פונקציה לדוגמה ב-Cloud Run באמצעות Google Cloud CLI, קראו את המאמר מדריך למתחילים: פריסת פונקציה ב-Cloud Run באמצעות ה-CLI של gcloud.

• כדי לפרוס פונקציות באמצעות מסוף Google Cloud ו-Google Cloud CLI, קראו את המאמר פריסת פונקציות.

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

• כדי ליצור קונטיינרים של פונקציות ב-toolchain שלכם ולפרוס אותם ב-Cloud Run, קראו את המאמר יצירת פונקציות.

• כדי ליצור טריגרים באמצעות Eventarc, קראו את המאמר יצירת טריגרים באמצעות Eventarc.