מדריך למתחילים: יצירת מכונה של Cloud Run
בדף הזה מוסבר איך להשתמש ב-Cloud Run כדי ליצור מכונה של Cloud Run בקונטיינר לדוגמה, להציג את היומנים שלה ולנהל את מחזור החיים שלה באמצעות ה-CLI של gcloud.
לפני שמתחילים
-
התקינו את ה-CLI של Google Cloud.
-
הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.
-
כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:
gcloud init -
יוצרים או בוחרים פרויקט ב- Google Cloud .
התפקידים שנדרשים כדי לבחור או ליצור פרויקט
- בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
-
יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (
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 .
-
אם משתמשים בפרויקט קיים, מוודאים שיש את ההרשאות הנדרשות כדי להשלים את ההדרכה. אם משתמשים בפרויקט חדש, לא צריך לוודא כי כבר יש את ההרשאות הנדרשות.
מפעילים את Cloud Run Admin API ואת Cloud Logging API, אם הם עדיין לא מופעלים:
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידיםgcloud services enable run.googleapis.com
logging.googleapis.com - כדי להגדיר את פרויקט ברירת המחדל למכונה של Cloud Run:
gcloud config set project PROJECT_ID
- מוודאים שהרכיב
gcloud betaמותקן:gcloud components install beta
- למחירון של Cloud Run או למחשבון עלויות.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות להשלמת המדריך למתחילים, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
- אדמין של Cloud Run (
roles/run.admin) במכונה - משתמש בחשבון שירות (
roles/iam.serviceAccountUser) בזהות השירות - צפייה ביומנים (
roles/logging.viewer) בפרויקט
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
יצירת מכונה
כדי ליצור מכונה של Cloud Run בקונטיינר לדוגמה באמצעות ה-CLI של gcloud:
מריצים את הפקודה הבאה:
gcloud beta run instances create my-instance \ --image us-docker.pkg.dev/cloudrun/container/hello \ --region REGION \ --port 8080 \ --no-invoker-iam-check
מחליפים את REGION באזור נתמך של Google Cloud .
הדגל
--no-invoker-iam-checkמשבית את אימות ה-invoker של IAM, כך שכתובת ה-URL של המכונה נגישה בלי אימות IAM.מחכים עד שהמכונה תיווצר. בסיום, הפקודה מציגה פלט שדומה לזה:
Creating instance... Importing container..............done Provisioning resources.......done Starting instance.....done Done. Instance [my-instance] has successfully been created. URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
פותחים את כתובת ה-URL שהוחזרה בדפדפן כדי לקיים אינטראקציה עם הקונטיינר שפועל.
צפייה ביומני המכונה
כדי לראות את היומנים שנוצרו על ידי המכונה של Cloud Run:
במסוף Google Cloud , נכנסים לדף Logs Explorer:
מסננים את היומנים לפי המכונה הספציפית:
resource.type="cloud_run_instance" resource.labels.location="<var>REGION</var>" resource.labels.instance_name="my-instance"
הסרת המשאבים
כדי לא לצבור חיובים בחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, אתם צריכים לבצע את הפעולות הבאות.
מחיקת המכונה
כדי לעצור ולמחוק את המכונה של Cloud Run:
gcloud beta run instances delete my-instance --region REGION
מחיקת פרויקט הבדיקה
מחיקת הפרויקט ב- Google Cloud מפסיקה את החיוב על כל המשאבים באותו פרויקט. כדי לשחרר את כל המשאבים של Google Cloud בפרויקט:
כדי למחוק פרויקט ב- Google Cloud :
gcloud projects delete PROJECT_ID
המאמרים הבאים
מידע נוסף על מכונות של Cloud Run זמין במאמרים הבאים: