בדף הזה מוסבר איך להגדיר את יציאת הקונטיינר, את פקודת נקודת הכניסה ואת הארגומנטים של שירות Cloud Run.
כש-Cloud Run מפעיל קונטיינר, הוא מריץ את פקודת נקודת הכניסה שמוגדרת כברירת מחדל של קובץ האימג' ואת הארגומנטים של פקודת ברירת המחדל. אם רוצים לשנות את נקודת הכניסה וארגומנטי הפקודה שמוגדרים כברירת מחדל, אפשר להשתמש בשדות command ו-args בהגדרות של הקונטיינר. השדה command מציין את הפקודה בפועל שהקונטיינר מריץ. השדה args מציין את הארגומנטים שמועברים לפקודה הזו.
שימו לב שאפשר להגדיר עד 1,000 ארגומנטים לכל קונטיינר בכל שירות.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להגדרה ולפריסה של שירותי Cloud Run, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
- מפתח ב-Cloud Run (
roles/run.developer) בשירות Cloud Run - משתמש בחשבון שירות (
roles/iam.serviceAccountUser) בזהות השירות
אם אתם פורסים שירות או פונקציה מקוד מקור, אתם צריכים גם תפקידים נוספים בפרויקט ובחשבון השירות של Cloud Build.
רשימה של תפקידים והרשאות ב-IAM שמשויכים ל-Cloud Run מופיעה במאמרים תפקידי IAM ב-Cloud Run והרשאות IAM ב-Cloud Run. אם שירות Cloud Run מתממשק עם ממשקי API שלGoogle Cloud , כמו ספריות הלקוח ב-Cloud, עיינו במדריך להגדרת זהות השירות. מידע נוסף על הקצאת תפקידים זמין במאמרים הרשאות פריסה וניהול הגישה.
הגדרת יציאת הקונטיינר לשירות
כל שינוי בהגדרות יוצר גרסה חדשה. גם גרסאות עתידיות יקבלו את הגדרת התצורה הזו באופן אוטומטי, אלא אם תבצעו עדכונים מפורשים כדי לשנות אותה.
בשירותי Cloud Run, המערכת מוסיפה את משתנה הסביבה PORT לקונטיינר. אם פורסים כמה קונטיינרים בשירות, זהו קונטיינר ה-ingress. הקונטיינר מאזין ליציאה שמוגדרת על ידי משתנה הסביבה PORT, ולא ליציאה ספציפית שמוגדרת בקוד. אם זה לא אפשרי, צריך להגדיר האזנה ביציאה ששולחת בקשות למאגר. שימו לב שהגדרות היציאה לא חלות על משימות ב-Cloud Run.
המסוף
נכנסים לדף Cloud Run במסוף Google Cloud :
בתפריט הניווט של Cloud Run, לוחצים על Services:
אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.
אם אתם מגדירים שירות קיים, לוחצים על השירות.
לוחצים על הכרטיסייה מאגרי תגים.
מציינים את היציאה שאליה רוצים לשלוח את הבקשות, אם היא לא ערך ברירת המחדל של
8080. הפעולה הזו גם מגדירה את משתנה הסביבהPORT.כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.
gcloud
כדי לעדכן את הגדרת היציאה של השירות, משתמשים בפקודה הבאה:
gcloud run services update SERVICE --port PORT
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: שם השירות.
- PORT: היציאה שאליה נשלחות הבקשות. שימו לב שיציאת ברירת המחדל היא
8080.
אפשר גם להגדיר יציאות במהלך הפריסה באמצעות הפקודה:
gcloud run deploy --image IMAGE_URL --port PORT
מחליפים את IMAGE_URL בהפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמט LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
containerPort::apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE_URL ports: - containerPort: PORTמחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - PORT: היציאה שאליה נשלחות הבקשות.
-
REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם נותנים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:- מתחיל ב-
SERVICE- - מכיל רק אותיות קטנות, מספרים ו-
- - לא מסתיים ב-
- - לא חורג מ-63 תווים
- מתחיל ב-
מחליפים את השירות בהגדרה החדשה שלו באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:resource "google_cloud_run_v2_service" "default" {
name = "SERVICE"
location = "REGION"
template {
containers {
name = "hello-1"
ports {
container_port = PORT
}
image = "IMAGE_URL"
}
}
}
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
REGION: האזור של Google Cloud . לדוגמה:
europe-west1.
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.PORT: היציאה שאליה נשלחות הבקשות.
פיתוח נייטיב
כדי לציין את יציאת הקונטיינר בקובץ compose.yaml, מוסיפים את המאפיין ports להגדרת השירות.
services: web: image: IMAGE ports: - "PORT:PORT"
מחליפים את מה שכתוב בשדות הבאים:
- IMAGE: כתובת ה-URL של קובץ האימג' של הקונטיינר.
- PORT: היציאה שאליה נשלחות הבקשות.
פריסת השירותים
כדי לפרוס את השירותים, מריצים את הפקודה
gcloud run compose up:gcloud run compose up compose.yamlמשיבים
yלכל ההנחיות להתקנת הרכיבים הנדרשים או להפעלת ממשקי ה-API.אופציונלי: הפיכת השירות לציבורי אם רוצים לאפשר גישה לשירות ללא אימות.
אחרי הפריסה, כתובת ה-URL של שירות Cloud Run מוצגת. מעתיקים את כתובת ה-URL הזו ומדביקים אותה בדפדפן כדי לראות את הקונטיינר שפועל. אפשר להשבית את אימות ברירת המחדל במסוף Google Cloud .
הגדרת נקודת כניסה וארגומנטים
כל שינוי בהגדרות יוצר גרסה חדשה. גם גרסאות עתידיות יקבלו את הגדרת התצורה הזו באופן אוטומטי, אלא אם תבצעו עדכונים מפורשים כדי לשנות אותה.
הפקודה והארגומנטים שצוינו בקונטיינר מבטלים את ברירת המחדל של ENTRYPOINT ו-CMD בקובץ האימג'.
אתם יכולים להגדיר פקודת נקודת כניסה וארגומנטים באמצעות מסוף Google Cloud , ה-CLI של Google Cloud או קובץ YAML כשאתם יוצרים שירות חדש או פורסים גרסה חדשה:
המסוף
נכנסים לדף Cloud Run במסוף Google Cloud :
בתפריט הניווט של Cloud Run, לוחצים על Services:
אם אתם מגדירים שירות חדש, לוחצים על Deploy container וממלאים את דף הגדרות השירות הראשוני. ואז לוחצים על Containers, Networking, Security כדי להרחיב את דף הגדרת השירות.
אם אתם מגדירים שירות קיים, לוחצים על השירות.
לוחצים על הכרטיסייה מאגרי תגים.
מציינים את הפקודה שרוצים שהקונטיינר יריץ, אם היא לא הפקודה שמוגדרת בקונטיינר, ואם רוצים, מציינים את הארגומנטים של פקודת נקודת הכניסה.
כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.
gcloud
כדי לעדכן את פקודת ההפעלה והארגומנטים של שירות קיים:
gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N
מחליפים את מה שכתוב בשדות הבאים:
- COMMAND: הפקודה שהקונטיינר אמור להתחיל איתה, אם לא משתמשים בפקודת ברירת המחדל.
- ARG1: הארגומנט שאתם שולחים לפקודת הקונטיינר. אם יש יותר מארגומנט אחד, צריך להשתמש ברשימה מופרדת בפסיקים.
כדי לציין נקודת כניסה וארגומנטים במהלך פריסה של שירות חדש או קיים:
gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
מחליפים את IMAGE_URL בהפניה לקובץ האימג' של הקונטיינר, לדוגמה us-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמט LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
כדי למחוק את הפקודות והארגומנטים של נקודת הכניסה שהגדרתם (שחזור לברירות המחדל של הקונטיינר), צריך לספק מחרוזות ריקות באופן הבא:
gcloud run deploy --image IMAGE_URL --command "" --args ""
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיינים
commandו-args:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: spec: containers: - image: IMAGE_URL command: - COMMAND args: - ARG1 - ARG-N
מחליפים את מה שכתוב בשדות הבאים:
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - COMMAND: הפקודה שבאמצעותה המאגר יופעל אם לא משתמשים בפקודת ברירת המחדל.
- ARG1: הארגומנט שאתם שולחים לפקודת הקונטיינר. אם משתמשים בכמה ארגומנטים, צריך לציין כל אחד מהם בשורה נפרדת, כמו בדוגמה ARG-N.
-
מחליפים את השירות בהגדרה החדשה שלו באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:המשאב google_cloud_run_v2_service שלמעלה מציין פקודה וארגומנטים. מחליפים את /server בפקודה שמשמשת להפעלת הקונטיינר, ומוסיפים את הארגומנטים הנדרשים למערך args.
פיתוח נייטיב
כדי לציין נקודת כניסה וארגומנטים בקובץ compose.yaml, מוסיפים את המאפיין entrypoint או command להגדרת השירות.
services: web: image: IMAGE entrypoint: ["COMMAND"] command: ["ARG1", "ARG-N"]
מחליפים את מה שכתוב בשדות הבאים:
- IMAGE: כתובת ה-URL של קובץ האימג' של הקונטיינר.
- COMMAND: הפקודה שהקונטיינר אמור להתחיל איתה.
- ARG1: הארגומנט שאתם שולחים לפקודת הקונטיינר.
פריסת השירותים
כדי לפרוס את השירותים, מריצים את הפקודה
gcloud run compose up:gcloud run compose up compose.yamlמשיבים
yלכל ההנחיות להתקנת הרכיבים הנדרשים או להפעלת ממשקי ה-API.אופציונלי: הפיכת השירות לציבורי אם רוצים לאפשר גישה לשירות ללא אימות.
אחרי הפריסה, כתובת ה-URL של שירות Cloud Run מוצגת. מעתיקים את כתובת ה-URL הזו ומדביקים אותה בדפדפן כדי לראות את הקונטיינר שפועל. אפשר להשבית את אימות ברירת המחדל במסוף Google Cloud .
שימוש בסימני שוויון או בפסיקים בארגומנטים
אם אתם משתמשים בסימני שוויון בארגומנטים, צריך להזין אותם בפורמט הבא:
gcloud run deploy \
--args="--repo-allowlist=github.com/example/example_demo"
אם הארגומנטים כוללים פסיקים, עיינו בקטע הגדרת משתני סביבה כדי לדעת איך להוסיף להם תווי בריחה.
הגדרת ספריית עבודה
ספריית העבודה היא המקום שבו הקונטיינר מריץ את הפקודות והארגומנטים שלו. אתם יכולים לציין ספריית עבודה מותאמת אישית לתהליך של הקונטיינר במהלך הפריסה של שירות חדש או קיים. אם לא מציינים ספריית עבודה, המערכת משתמשת בספריית העבודה שמוגדרת כברירת מחדל בקובץ האימג' של הקונטיינר. כדי לאפס את השדה הזה לברירת המחדל, צריך להעביר מחרוזת ריקה או להסיר את השדה.
לדוגמה:
gcloud
כדי לעדכן את ספריית העבודה של שירות קיים:
gcloud run services update SERVICE --workdir WORKING_DIR
מחליפים את מה שכתוב בשדות הבאים:
- WORKING_DIR: ספריית העבודה של הקונטיינר. אם לא מציינים פקודה, המערכת משתמשת בברירת המחדל של קובץ האימג' של הקונטיינר. כדי לאפס את השדה הזה לברירת המחדל, מעבירים מחרוזת ריקה
"".
כדי לציין את ספריית העבודה במהלך הפריסה של שירות חדש או קיים:
gcloud run deploy --image IMAGE_URL --workdir WORKING_DIR
מחליפים את מה שכתוב בשדות הבאים:
-
IMAGE_URLעם הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - WORKING_DIR: ספריית העבודה של הקונטיינר.
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
workingDir::apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE_URL workingDir: WORKING_DIR ports: - containerPort: PORTמחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - WORKING_DIR: (אופציונלי) ספריית העבודה של הקונטיינר. אם לא מציינים את המשתמש, המערכת משתמשת בברירת המחדל של סביבת זמן הריצה של הקונטיינר, שאולי מוגדרת בקובץ האימג' של הקונטיינר.
- PORT: היציאה שאליה נשלחות הבקשות.
-
REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם נותנים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:- מתחיל ב-
SERVICE- - מכיל רק אותיות קטנות, מספרים ו-
- - לא מסתיים ב-
- - לא חורג מ-63 תווים
- מתחיל ב-
מחליפים את השירות בהגדרה החדשה שלו באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:resource "google_cloud_run_v2_service" "default" {
name = "SERVICE"
location = "REGION"
template {
containers {
name = "hello-1"
working_dir = WORKING_DIR
ports {
container_port = PORT
}
image = "IMAGE_URL"
}
}
}
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
- REGION: האזור של Google Cloud . לדוגמה:
europe-west1. - WORKING_DIR: (אופציונלי) ספריית העבודה של הקונטיינר. אם לא מציינים את המשתמש, המערכת משתמשת בברירת המחדל של סביבת זמן הריצה של הקונטיינר, שאולי מוגדרת בקובץ האימג' של הקונטיינר.
-
IMAGE_URL: הפניה לקובץ האימג' של הקונטיינר, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest. אם אתם משתמשים ב-Artifact Registry, המאגר REPO_NAME כבר צריך להיות קיים. כתובת ה-URL צריכה להיות בפורמטLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. - PORT: היציאה שאליה נשלחות הבקשות. שימו לב שיציאת ברירת המחדל היא
8080.
הגדרת סדר ההפעלה של קונטיינרים בפריסות של קונטיינרים מסוג sidecar
כדי לציין את סדר ההפעלה של קונטיינרים בפריסת sidecar, משתמשים בתכונה "יחסי תלות של קונטיינרים". אתם מציינים את כל הקונטיינרים שיש להם יחסי תלות, ומפרטים את הקונטיינרים שהם תלויים בהם: הקונטיינרים האלה מופעלים קודם. הקונטיינרים שאין להם יחסי תלות תמיד מופעלים ראשונים ובמקביל.
כדי להשתמש בתכונה הזו, צריך להשתמש בבדיקות תקינות של ההפעלה. בדיקת ההפעלה מאפשרת ל-Cloud Run לבדוק את התקינות של קונטיינר תלוי, ולוודא שהיא עוברת בהצלחה לפני הפעלת הקונטיינר הבא. אם לא משתמשים בבדיקות תקינות, הקונטיינרים מופעלים בסדר שצוין גם אם הקונטיינרים שהם תלויים בהם לא מופעלים.
שימו לב שלקונטיינרים של Ingress יש בדיקת תקינות של בדיקת ההפעלה כברירת מחדל.
אפשר להשתמש במסוף Google Cloud , ב-Google Cloud CLI או ב-YAML כדי לציין את סדר ההפעלה:
המסוף
נכנסים לדף Services של Cloud Run במסוף Google Cloud :
- בשירות קיים, לוחצים על השירות ואז על Containers.
- כדי ליצור שירות חדש, לוחצים על Deploy container כדי להציג את הטופס Create service.
בשירות חדש, מציינים את שם השירות, כתובת ה-URL של מאגר התגים של השרת, הקצאת המעבד (CPU), השליטה בתעבורת נתונים נכנסת (ingress) והאימות. בכרטיסייה Containers, Networking, Security:
- מגדירים את מאגר ה-ingress.
- כדי להוסיף את כל אחד מהמאגרים האחרים שאתם פורסים, לוחצים על Add container.
- לכל הקונטיינרים, חוץ מהקונטיינר של Ingress, מגדירים בדיקת תקינות של ההפעלה. למכולות Ingress יש בדיקת תקינות של ברירת מחדל בזמן ההפעלה.
- אם צריך להפעיל קודם קונטיינרים אחרים, משתמשים בתפריט Container startup order כדי לבחור את הקונטיינרים שצריך להפעיל קודם.
כדי לעשות את זה בשירות קיים:
- לכל הקונטיינרים, חוץ מהקונטיינר של Ingress, מגדירים בדיקת תקינות של ההפעלה. למכלים של Ingress יש בדיקת תקינות שמוגדרת כברירת מחדל בזמן ההפעלה.
- כל קונטיינר מוצג עם תפריט Container startup order משלו. אם קונטיינר מסוים צריך שקונטיינרים אחרים יופעלו לפניו, בתפריט Container startup order בוחרים את הקונטיינרים שצריכים לפעול קודם.
מסיימים את כל ההגדרות הנדרשות האחרות. כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים. מחכים שהפריסה תסתיים.
gcloud
לפני שמשתמשים ב-Google Cloud CLI כדי לציין את סדר ההפעלה, צריך להגדיר בדיקת תקינות של ההפעלה לכל מאגרי הנתונים, חוץ מהמאגר של Ingress. למאגרי Ingress יש בדיקת תקינות של הפעלה כברירת מחדל. אי אפשר להגדיר בדיקות תקינות באמצעות Google Cloud CLI.
-
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
כדי לפרוס כמה קונטיינרים בשירות עם סדר הפעלה מסוים, מריצים את הפקודה:
gcloud run deploy SERVICE \ --container CONTAINER_1_NAME --image='INGRESS_IMAGE' --port='CONTAINER_PORT' \ --container CONTAINER_2_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME \ --container CONTAINER_3_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAMECONTAINER_2_NAME
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: שם השירות שאתם פורסים. אפשר להשמיט את הפרמטר הזה לגמרי, אבל אם תשמיטו אותו תתבקשו להזין את שם השירות.
- CONTAINER_PORT: היציאה שבה מאזין מאגר ה-ingress לבקשות נכנסות. בניגוד לשירות עם קונטיינר יחיד, בשירות שמכיל קונטיינרים של Sidecar אין יציאת ברירת מחדל לקונטיינר ה-ingress. צריך להגדיר במפורש את יציאת הקונטיינר של קונטיינר ה-ingress, ורק קונטיינר אחד יכול לחשוף את היציאה.
-
INGRESS_IMAGE: הפניה לקובץ האימג' של הקונטיינר שאמור לקבל בקשות, לדוגמהus-docker.pkg.dev/cloudrun/container/hello:latest.
SIDECAR_IMAGE: הפניה לקובץ האימג' של הקונטיינר המשני.אם רוצים להגדיר כל קונטיינר בפקודת הפריסה, צריך לספק את ההגדרות של כל קונטיינר אחרי הפרמטרים של
container.
YAML
אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:
gcloud run services describe SERVICE --format export > service.yaml
מעדכנים את המאפיין
container-dependencies:apiVersion: serving.knative.dev/v1 kind: Service metadata: annotations: name: SERVICE spec: template: metadata: annotations: run.googleapis.com/container-dependencies: '{"CONTAINER1":["CONTAINER2"], "CONTAINER3":["CONTAINER1","CONTAINER2"]}'מחליפים את מה שכתוב בשדות הבאים:
- CONTAINER1: השם של הקונטיינר הראשון שתלוי בקונטיינר אחד או יותר. שימו לב שאפשר להגדיר את שם הקונטיינר ב-YAML: אם לא תציינו שם, Cloud Run ייצור שם באופן אוטומטי.
- CONTAINER2: שם הקונטיינר שצריך להפעיל לפני CONTAINER1.
- CONTAINER3: השם של הקונטיינר השני שתלוי בקונטיינר אחד או יותר.
בדוגמה שמוצגת בקטע הקוד של YAML, קודם מופעל CONTAINER2, אחר כך מופעל CONTAINER1 ובסוף מופעל CONTAINER3.
מחליפים את השירות בהגדרה החדשה שלו באמצעות הפקודה הבאה:
gcloud run services replace service.yaml
פיתוח נייטיב
כדי לציין את סדר ההפעלה של הקונטיינרים בקובץ compose.yaml, מגדירים את הקונטיינרים כשירותים נפרדים ומשתמשים במאפיין depends_on לקונטיינר התלוי.
services: web: image: IMAGE ports: - "8080:8080" container_name: web sidecar: image: SIDECAR_IMAGE container_name: sidecar depends_on: - web
מחליפים את מה שכתוב בשדות הבאים:
- IMAGE: כתובת ה-URL של קובץ האימג' הראשי של הקונטיינר, לדוגמה
us-docker.pkg.dev/my-project/my-repo/hello. - SIDECAR_IMAGE: כתובת ה-URL של קובץ האימג' של הקונטיינר המשני (sidecar).
פריסת השירותים
כדי לפרוס את השירותים, מריצים את הפקודה
gcloud run compose up:gcloud run compose up compose.yamlמשיבים
yלכל ההנחיות להתקנת הרכיבים הנדרשים או להפעלת ממשקי ה-API.אופציונלי: הפיכת השירות לציבורי אם רוצים לאפשר גישה לשירות ללא אימות.
אחרי הפריסה, כתובת ה-URL של שירות Cloud Run מוצגת. מעתיקים את כתובת ה-URL הזו ומדביקים אותה בדפדפן כדי לראות את הקונטיינר שפועל. אפשר להשבית את אימות ברירת המחדל במסוף Google Cloud .
Terraform
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
מוסיפים את הקוד הבא למשאבgoogle_cloud_run_v2_service בתצורה של Terraform:resource "google_cloud_run_v2_service" "default" {
name = "SERVICE"
location = "REGION"
template {
containers {
name = "CONTAINER1"
ports {
container_port = 8080
}
image = "us-docker.pkg.dev/cloudrun/container/hello"
depends_on = ["CONTAINER2"]
}
containers {
name = "CONTAINER2"
image = "us-docker.pkg.dev/cloudrun/container/hello"
env {
name = "PORT"
value = "8081"
}
startup_probe {
http_get {
port = 8081
}
}
}
containers {
name = "CONTAINER3"
image = "us-docker.pkg.dev/cloudrun/container/hello"
depends_on = ["CONTAINER1", "CONTAINER2"]
env {
name = "PORT"
value = "8080"
}
startup_probe {
http_get {
port = 8080
}
}
}
}
}
מחליפים את מה שכתוב בשדות הבאים:
- SERVICE: השם של שירות Cloud Run.
- REGION: האזור של Google Cloud . לדוגמה:
europe-west1. - CONTAINER1: השם של מאגר התגים הראשון שתלוי במאגר תגים אחד או יותר.
- CONTAINER2: השם של הקונטיינר שצריך להפעיל לפני CONTAINER1.
- CONTAINER3: השם של הקונטיינר שתלוי ב-CONTAINER1 וב-CONTAINER2.
הצגת הגדרות המאגר
כדי לראות את הגדרות הקונטיינר הנוכחיות של שירות Cloud Run:
המסוף
נכנסים לדף Services של Cloud Run במסוף Google Cloud :
לוחצים על השירות הרצוי כדי לפתוח את הדף Service details.
לוחצים על הכרטיסייה מאגרי תגים כדי לראות את ההגדרות.
gcloud
משתמשים בפקודה הבאה:
gcloud run services describe SERVICE
מאתרים את הגדרת מאגר התגים בהגדרות שהוחזרו.