מדריך למתחילים: פיתוח ופריסה של אפליקציית אינטרנט ב-Python ‏ (Gradio) ל-Cloud Run

מדריך למתחילים: פיתוח ופריסה של אפליקציית אינטרנט ב-Python ‏ (Gradio) ל-Cloud Run

בשיעור הזה נסביר איך להשתמש בפקודה אחת כדי ליצור ולפרוס אפליקציית אינטרנט Hello World מדוגמת קוד ל- Google Cloudבאמצעות Cloud Run.

אם פועלים לפי השלבים במדריך למתחילים הזה, Cloud Run יוצר בשבילכם באופן אוטומטי קובץ Dockerfile כשפורסים מקוד מקור. מידע נוסף על האופן שבו ה-buildpack של Python קובע את נקודת הכניסה (entrypoint) שמוגדרת כברירת מחדל לפריסות של קוד מקור ב-Cloud Run זמין במאמר פיתוח אפליקציית Python.

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

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

התקינו את ה-CLI של Google Cloud.

הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

יוצרים או בוחרים Google Cloud פרויקט.

תפקידים שנדרשים כדי לבחור או ליצור פרויקט

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

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

• יוצרים Google Cloud פרויקט:

  gcloud projects create PROJECT_ID

  מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

• בוחרים את הפרויקט שיצרתם: Google Cloud

  gcloud config set project PROJECT_ID

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

אם משתמשים בפרויקט קיים, מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה. אם משתמשים בפרויקט חדש, לא צריך לוודא כי כבר יש את ההרשאות הנדרשות.

מוודאים שהחיוב מופעל בפרויקט Google Cloud .

התקינו את ה-CLI של Google Cloud.

הערה: אם התקנתם את ה-CLI של gcloud, השתמשו בפקודה gcloud components update כדי לבדוק אם הגרסה העדכנית מותקנת.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

יוצרים או בוחרים Google Cloud פרויקט.

תפקידים שנדרשים כדי לבחור או ליצור פרויקט

• Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
• יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

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

• יוצרים Google Cloud פרויקט:

  gcloud projects create PROJECT_ID

  מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

• בוחרים את הפרויקט שיצרתם: Google Cloud

  gcloud config set project PROJECT_ID

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

אם משתמשים בפרויקט קיים, מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה. אם משתמשים בפרויקט חדש, לא צריך לוודא כי כבר יש את ההרשאות הנדרשות.

מוודאים שהחיוב מופעל בפרויקט Google Cloud .

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

    gcloud config set project PROJECT_ID

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

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

3. מפעילים את Cloud Run Admin API ואת Cloud Build APIs:

   תפקידים שנדרשים להפעלת ממשקי API

   כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

   gcloud services enable run.googleapis.com cloudbuild.googleapis.com

   אחרי שמפעילים את Cloud Run Admin API, נוצר באופן אוטומטי חשבון השירות שמוגדר כברירת מחדל ב-Compute Engine.

4. אפשר לעיין במחירון של Cloud Run או להשתמש במחשבון התמחור כדי לקבל הערכה של העלויות.

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

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

• אדמין Cloud Run (roles/run.admin) בפרויקט
• ‫Cloud Run Source Developer (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 builder מתעדכנת.

כתיבת האפליקציה לדוגמה

כדי לכתוב אפליקציה ב-Python:

1. יוצרים ספרייה חדשה בשם helloworld ועוברים אליה:

   mkdir helloworld
   cd helloworld
   

2. יוצרים קובץ בשם app.py ומדביקים בו את הקוד הבא:

   import gradio as gr
   
   def hello(name, intensity):
      """Return a friendly greeting."""
      return "Hello " + name + "!" * int(intensity)
   
   demo = gr.Interface(
      fn=hello,
      inputs=["text", "slider"],
      outputs=["text"],
      title="Hello World 👋🌎",
      description=("Type your name below and hit 'Submit', and try the slider to "
                  "make the greeting louder!"),
      theme="soft",
      flagging_mode="never",
   )
   
   demo.launch()
   

   הקוד הזה יוצר שירות אינטרנט שמגיב לבקשות HTTP GET.

3. יוצרים קובץ בשם requirements.txt ומדביקים בו את הקוד הבא:

   gradio~=5.0
   

   הקוד הזה מוסיף את חבילת Gradio שדרושה לדוגמה.

האפליקציה מוכנה לפריסה.

פריסה מקוד המקור ל-Cloud Run

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

כדי לפרוס מקוד המקור:

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

   gcloud run deploy --source .

   1. כשמופיעה בקשה להזין את שם השירות, לוחצים על Enter כדי לאשר את שם ברירת המחדל, לדוגמה helloworld.

   2. אם תתבקשו להפעיל ממשקי API נוספים בפרויקט, למשל Artifact Registry API, תצטרכו להגיב בהקשה על y.

   3. כשמוצגת בקשה לבחור אזור: בוחרים את האזור הרצוי, לדוגמה europe-west1.

   4. אם מוצגת בקשה ליצור מאגר באזור שצוין, משיבים על ידי לחיצה על y.

   5. אם מופיעה בקשה לאפשר גישה לכולם: משיבים y. יכול להיות שההנחיה הזו לא תוצג אם יש מדיניות ארגונית עם הגבלת דומיין שמונעת את זה. פרטים נוספים מופיעים בקטע לפני שמתחילים.

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

2. כדי להיכנס לשירות שפרסתם, פותחים את כתובת ה-URL של השירות בדפדפן אינטרנט.

הצלחה: פרסת אפליקציית אינטרנט ב-Python ב-Cloud Run.

מיקומים של Cloud Run

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

הקריטריונים העיקריים לבחירת האזור שבו יפעלו שירותי Cloud Run הם זמן האחזור, הזמינות או העמידות שנדרשים לכם. בדרך כלל אפשר לבחור את האזור הקרוב ביותר למשתמשים, אבל כדאי לקחת בחשבון את המיקום של מוצרים Google Cloud אחרים שבהם נעשה שימוש בשירות Cloud Run. השימוש במוצרים של Google Cloud 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 (מילאנו)
• europe-west9 (פריז) רמה נמוכה של CO₂
• me-west1 (תל אביב)
• northamerica-south1 (מקסיקו)
• us-central1 (אייווה) רמה נמוכה של CO₂
• us-east1 (דרום קרוליינה)
• ‫us-east4 (צפון וירג'יניה)
• us-east5 (Columbus)
• 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 (ורשה, פולין)
• ‫europe-west10 (Berlin)
• europe-west12 (טורינו)
• 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, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

כדי למחוק Google Cloud פרויקט:

gcloud projects delete PROJECT_ID

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

מידע נוסף על בניית מאגר תגים ממקור קוד ודחיפה למאגר זמין במאמרים הבאים:

• פיתוח שירותים ב-Cloud Run
• פיתוח קונטיינרים
• בדיקת שירות Cloud Run באופן מקומי
• פריסה מקוד מקור