הגדרת שירות Cloud Run

ב-Application Design Center, אתם יכולים להגדיר שירות Cloud Run כדי להריץ קונטיינרים ללא שמירת מצב (stateless) ישירות בתשתית של Google, שהיא מנוהלת וניתנת להתאמה לעומס. אתם יכולים להתאים אישית את השירות לחיבורים של הרכיבים הספציפיים ולפרמטרים של ההגדרות האישיות. הפרמטרים של ההגדרות מפורטים במודול Terraform של terraform-google-cloud-run ב-GitHub.

חיבורים של רכיבים

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

רכיב מחובר עדכונים לאפליקציות מידע רקע
Secret Manager
  • שירות Cloud Run יכול להפנות לנתוני הסוד.
  • השדה Secret Data ב-Secret Manager מקושר לשדה env_secret_vars ב-Cloud Run.
  • התפקיד roles/secretmanager.secretAccessor מוקצה לחשבון השירות של Cloud Run.
הגדרת סודות לשירותים

חשבון שירות

  • שירות Cloud Run משתמש בחשבון השירות בתור זהות השירות.
  • התפקיד roles/run.invoker מוקצה לחשבון השירות.
  • כתובת האימייל של חשבון השירות והמידע על ניהול הזהויות והרשאות הגישה (IAM) נוספים למשתני הסביבה של Cloud Run.
אימות בין שירותים
AlloyDB ל-PostgreSQL
  • שירות Cloud Run יכול להתחבר למכונה של AlloyDB.
  • המטא-נתונים של המשאב ב-AlloyDB נוספים למשתני הסביבה של Cloud Run.
  • התפקיד roles/alloydb.admin מוקצה לחשבון השירות של Cloud Run.
התחברות מ-Cloud Run
BigQuery
  • שירות Cloud Run יכול לקיים אינטראקציה עם מערך הנתונים ב-BigQuery.
  • המטא-נתונים של המשאב ב-BigQuery נוספים למשתני הסביבה של Cloud Run.
  • התפקיד roles/bigquery.dataEditor מוקצה לחשבון השירות של Cloud Run.
סקירה כללית על BigQuery

Bigtable

  • שירות Cloud Run יכול לבצע פונקציות ניהוליות במכונה של Bigtable.
  • פרטי המטא-נתונים של המשאב ב-Bigtable נוספים למשתני הסביבה של Cloud Run.
  • התפקיד roles/bigtable.admin מוקצה לחשבון השירות של Cloud Run.
סקירה כללית על Bigtable

שירות אחר של Cloud Run

  • שירות המקור של Cloud Run יכול לשלוח תנועה לשירות היעד של Cloud Run.
  • שירות המקור של Cloud Run מכיל את ה-URI של שירות היעד של Cloud Run במשתני הסביבה שלו.
מה זה Cloud Run

Cloud SQL (MySQL)

  • שירות Cloud Run יכול לקרוא נתונים ממכונת Cloud SQL (MySQL) ולכתוב אליה נתונים.
  • המטא-נתונים של החיבור ל-Cloud SQL נוספים לשירות Cloud Run.
  • התפקידים roles/cloudsql.instanceUser ו-roles/cloudsql.client מוקצים לחשבון השירות של Cloud Run.
  • חשבון השירות של Cloud Run נוסף כמשתמש IAM למכונה של Cloud SQL.
התחברות מ-Cloud Run

Cloud SQL (PostgreSQL)

  • שירות Cloud Run יכול לקרוא נתונים ממכונת Cloud SQL (PostgreSQL) ולכתוב אליה נתונים.
  • המטא-נתונים של החיבור ל-Cloud SQL נוספים לשירות Cloud Run.
  • התפקידים roles/cloudsql.instanceUser ו-roles/cloudsql.client מוקצים לחשבון השירות של Cloud Run.
  • חשבון השירות של Cloud Run נוסף כמשתמש IAM למכונה של Cloud SQL.
התחברות מ-Cloud Run

Cloud Storage

  • שירות Cloud Run יכול לנהל אובייקטים בקטגוריה של Cloud Storage.
  • פרטי ה-IAM של חשבון השירות של Cloud Run נוספים לקטגוריה של Cloud Storage.
  • התפקיד roles/storage.objectAdmin מוקצה לחשבון השירות של Cloud Run.
התחברות לשירותי Google Cloud

קצה עורפי גלובלי של Cloud Load Balancing

  • מאזן העומסים יכול לפזר את התנועה הנכנסת לשירות Cloud Run.
  • שירות Cloud Run נוסף כנקודת קצה לקצה העורפי בהגדרת הקצוות העורפיים של קבוצת נקודות קצה ברשת ללא שרת (serverless) ב-Cloud Load Balancing.
הגדרת מאזן עומסים גלובלי חיצוני של אפליקציות (ALB) באמצעות Cloud Run

Memorystore for Redis

  • שירות Cloud Run יכול לשמור נתונים במטמון במכונה של Memorystore for Redis.
  • פרטי החיבור של Memorystore for Redis נוספים למשתני הסביבה של Cloud Run.
  • התפקיד roles/redis.editor מוקצה לחשבון השירות של Cloud Run.
התחברות למכונה של Redis משירות Cloud Run

Memorystore for Redis Cluster

  • שירות Cloud Run יכול לשמור נתונים במטמון במכונה של Memorystore for Redis Cluster.
  • פרטי החיבור של Memorystore for Redis Cluster נוספים למשתני הסביבה של Cloud Run.
  • ‫App Design Center מקצה את התפקיד roles/redis.dbConnectionUser לחשבון השירות של Cloud Run.
התחברות למכונה של Memorystore for Redis Cluster

Memorystore for Valkey

  • שירות Cloud Run יכול לשמור נתונים במטמון במכונה של Memorystore for Valkey.
  • ‫App Design Center מוסיף את פרטי החיבור של Memorystore for Valkey למשתני הסביבה של Cloud Run.
  • ‫App Design Center מקצה את התפקיד roles/memorystore.dbConnectionUser לחשבון השירות של Cloud Run.
התחברות למכונה של Memorystore for Valkey

Pub/Sub

  • שירות Cloud Run יכול לקבל הודעות או לפרסם בנושא Pub/Sub.
  • מזהה הנושא של Pub/Sub נוסף למשתני הסביבה של Cloud Run.
  • התפקידים roles/pubsub.publisher ו-roles/pubsub.subscriber מוקצים לחשבון השירות של Cloud Run.
  • שירות Cloud Run נוסף לשדות של מינויי דחיפה ושליפה ב-Pub/Sub.
מדריך לשימוש ב-Pub/Sub עם Cloud Run

קצה עורפי אזורי של Cloud Load Balancing

  • מאזן העומסים יכול לפזר את התנועה הנכנסת לשירות Cloud Run.
  • שירות Cloud Run נוסף כנקודת קצה לקצה העורפי בהגדרת הקצוות העורפיים של קבוצת נקודות קצה ברשת ללא שרת (serverless) ב-Cloud Load Balancing.
הגדרת מאזן עומסים חיצוני אזורי של אפליקציות (ALB) עם Cloud Run

ממשק קצה (frontend) אזורי של Cloud Load Balancing

  • כתובות ה-IP של HTTP ו-HTTPS של מאזן העומסים זמינות לאפליקציה שפועלת בקונטיינר של Cloud Run.
  • המטא-נתונים של הכתובת של Cloud Load Balancing נוספים למשתני הסביבה של Cloud Run.
סקירה כללית של כללי העברה

Spanner

  • שירות Cloud Run יכול לנהל את המכונה של Spanner.
  • פרטי החיבור ל-Spanner נוספים למשתני הסביבה של Cloud Run.
  • התפקיד roles/spanner.databaseAdmin מוקצה לחשבון השירות של Cloud Run.
  • פרטי ה-IAM של חשבון השירות ב-Cloud Run נוספים למכונה של Spanner.
התחברות לשירותי Google Cloud

Vertex AI

  • שירות Cloud Run יכול לקיים אינטראקציה עם שירותי Vertex AI.
  • התפקיד roles/aiplatform.user מוקצה לחשבון השירות של Cloud Run.
אירוח של אפליקציות וסוכני AI ב-Cloud Run

פרמטרים נדרשים להגדרה

אם התבנית כוללת רכיב של Cloud Run, צריך להגדיר את הפרמטרים הבאים לפני הפריסה.

שם הפרמטר תיאור ומגבלות מידע רקע

מזהה פרויקט

הפרויקט שבו רוצים לפרוס את המשאב של Cloud Run.

הגדרת רכיבים

אזור

מיקום הפריסה של שירות Cloud Run.

מיקומים של Cloud Run

שם השירות

name שירות Cloud Run

פרמטרים אופציונליים להגדרה

הפרמטרים הבאים הם אופציונליים. כדי להציג פרמטרים מתקדמים, באזור Configuration בוחרים באפשרות Show advanced fields.

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

שם המאגר

name יצירת קונטיינרים
קונטיינרים

קובץ אימג' של קונטיינר

image פריסת קובצי אימג' של קונטיינרים ב-Cloud Run
קונטיינרים

ספריית עבודה

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

workingDir
קונטיינרים

תלוי במאגר

dependsOn[]‎ הגדרת סדר ההפעלה של קונטיינרים בפריסות של קונטיינר צדדי
קונטיינרים

ארגומנטים של קונטיינר

args[]‎ הגדרת קונטיינרים לשירותים
קונטיינרים

פקודת קונטיינר

command הגדרת קונטיינרים לשירותים
קונטיינרים: משתני סביבה

מפתח

name משתני סביבה לשירותים
קונטיינרים: משתני סביבה

ערך

ערך משתני סביבה לשירותים
קונטיינרים: משתני סביבה סודיים

מפתח

EnvVarSource איך מאפשרים ל-Cloud Run לגשת לסוד
קונטיינרים: משתני סביבה סודיים

Secret

secret איך מאפשרים ל-Cloud Run לגשת לסוד
קונטיינרים: משתני סביבה סודיים

גרסה

גרסה איך מאפשרים ל-Cloud Run לגשת לסוד
קונטיינרים: טעינת אמצעי אחסון

שם

name התחברות מ-Cloud Run
קונטיינרים: טעינת אמצעי אחסון

נתיב טעינה

mountPath התחברות מ-Cloud Run
קונטיינרים: יציאות

שם

name שימוש ב-HTTP/2 לשירותים
קונטיינרים: יציאות

יציאת קונטיינר

containerPort שימוש ב-HTTP/2 לשירותים
מאגרים: משאבים

מעבד (CPU)

מגבלות הגדרת מגבלות מעבד (CPU) לשירותים
מאגרים: משאבים

זיכרון

מגבלות הגדרת מגבלות זיכרון לשירותים
מאגרים: משאבים

CPU Idle

אם המעבד מוקצה רק במהלך בקשות.

cpuIdle
מאגרים: משאבים

האצת המעבד בזמן אתחול

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

סף הכישלון

failureThreshold הגדרת בדיקות תקינות של קונטיינרים לשירותים
קונטיינרים: בדיקת הפעלה

השהיה ראשונית בשניות

initialDelaySeconds הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

Timeout Seconds

timeoutSeconds הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

שניות בתקופה

periodSeconds הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

HTTP Get Path

path הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

יציאת HTTP Get

port הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

שם כותרות ה-HTTP

name הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

ערך כותרות HTTP

ערך הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

יציאת שקע TCP

port בדיקת ברירת המחדל של TCP להפעלה
קונטיינרים: בדיקת הפעלה

יציאת GRPC

port הגדרת בדיקות הפעלה
קונטיינרים: בדיקת הפעלה

שירות GRPC

service הגדרת בדיקות הפעלה
קונטיינרים

Liveness Probe

livenessProbe תרחישי שימוש

תיאור

description הגדרת תיאורי שירותים

יצירת חשבון שירות

יוצרים חשבון שירות חדש בשביל שירות Cloud Run.

הגדרת זהות שירות לשירותים

תפקידים בפרויקט של חשבון שירות

תפקידים שצריך להקצות לחשבון השירות החדש שנוצר. מפעילים את האפשרות Create Service Account ולא מזינים קלט בשדה Service Account.

הגדרת זהות שירות לשירותים

Ingress

IngressTraffic הגבלת תעבורת הנתונים הנכנסת (ingress) ברשת ב-Cloud Run

חברים

משתמשים וחשבונות שירות שיכולים להפעיל את השירות. כדי לאפשר גישה לכולם, מזינים allUsers. כדי לאפשר גישה למשתמשי Google שמחוברים לחשבון, מזינים allAuthenticatedUsers או רשימה של משתמשים וחשבונות שירות ספציפיים. מידע נוסף זמין במאמר בנושא חברים.

ניהול הגישה לשירותים
גישה ל-VPC

מחבר

connector VPC עם מחברים
גישה ל-VPC תעבורת נתונים יוצאת egress שליטה בתנועת הנתונים היוצאת של השירות
גישה ל-VPC: ממשקי רשת רשת network פריסת שירות
גישה ל-VPC: ממשקי רשת רשת משנה subnetwork פריסת שירות
גישה ל-VPC: ממשקי רשת תגים תגים פריסת שירות

הגנה מפני מחיקה ב-Cloud Run

מונעת מ-Terraform להרוס או ליצור מחדש משימות ושירותים של Cloud Run.

deletion_protection

הפעלת Prometheus Sidecar

מפעילים את קובץ העזר של Prometheus בשירות Cloud Run.

כתיבת מדדי Prometheus באמצעות Prometheus sidecar
נפחי אחסון

שם

name הגדרת ווליום בזיכרון
כרכים: סודות Secret secret איך מאפשרים ל-Cloud Run לגשת לסוד
כרכים: סודות מצב ברירת מחדל defaultMode איך מאפשרים ל-Cloud Run לגשת לסוד
כרכים: סודות נתיב path איך מאפשרים ל-Cloud Run לגשת לסוד
כרכים: סודות גרסה גרסה איך מאפשרים ל-Cloud Run לגשת לסוד
כרכים: סודות מצב mode איך מאפשרים ל-Cloud Run לגשת לסוד
נפחים: מכונה של Cloud SQL מכונות instances[]‎ התחברות מ-Cloud Run
אמצעי אחסון: Empty Dir בינונית medium הגדרת נקודות טעינה של אמצעי אחסון בזיכרון לשירותים
אמצעי אחסון: Empty Dir מגבלת גודל sizeLimit הגדרת נקודות טעינה של אמצעי אחסון בזיכרון לשירותים
אמצעי אחסון: GCS קטגוריה bucket הגדרת נקודות טעינה של נפח אחסון ב-Cloud Storage לשירותים
אמצעי אחסון: GCS לקריאה בלבד readOnly הגדרת נקודות טעינה של נפח אחסון ב-Cloud Storage לשירותים
אמצעי אחסון: NFS שרת server הגדרת נקודות טעינה של אמצעי אחסון ב-NFS לשירותים
אמצעי אחסון: NFS נתיב path הגדרת נקודות טעינה של אמצעי אחסון ב-NFS לשירותים
אמצעי אחסון: NFS לקריאה בלבד readOnly הגדרת נקודות טעינה של אמצעי אחסון ב-NFS לשירותים
התאמה לעומס (scaling) של שירותים

מספר המכונות המינימלי

minInstanceCount הגדרת מספר מינימלי של מכונות לשירותים

גרסה

גרסה גרסאות של שירות Cloud Run
התאמה לעומס (scaling) של תבנית

מספר המכונות המינימלי

minInstanceCount הגדרת מספר מינימלי של מכונות לשירותים
התאמה לעומס (scaling) של תבנית מספר המופעים המקסימלי maxInstanceCount מידע על מספר המופעים המקסימלי

מפתח הצפנה

encryptionKey שימוש במפתחות הצפנה בניהול הלקוח

מספר מקסימלי של בקשות בו-זמניות למכונה

maxInstanceRequestConcurrency מספר מקסימלי של בקשות מקבילות לשירותים

זיקה לסשן (session affinity)

sessionAffinity הגדרת זיקה לסשן (session affinity) לשירותים

סביבת הפעלה

executionEnvironment מידע על סביבות הרצה של שירותים
תעבורת נתונים

סוג

type חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
תעבורת נתונים Percent percent חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
תעבורת נתונים גרסה גרסה חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
תעבורת נתונים תג tag חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
תוויות שירות

מפתח

תוויות הגדרת תוויות לשירותים
תוויות שירות ערך תוויות הגדרת תוויות לשירותים
הערות לגבי השירות

מפתח

annotations annotations
הערות לגבי השירות ערך annotations annotations
לקוח

שם

מזהה שרירותי של לקוח ה-API.

client
לקוח גרסה

מזהה שרירותי של גרסת לקוח ה-API.

clientVersion

שלב ההשקה

LaunchStage שלבי השקת המוצר

קהלים בהתאמה אישית

customAudience הגדרת קהלים בהתאמה אישית לשירותים
Binary Authorization

הצדקה ל-Breakglass

breakglassJustification שימוש ב-breakglass
Binary Authorization שימוש בברירת המחדל useDefault שימוש ב-Binary Authorization
תוויות של תבנית

מפתח

תוויות הגדרת תוויות לשירותים
תוויות של תבנית ערך תוויות הגדרת תוויות לשירותים
הערות בתבניות

מפתח

annotations annotations
הערות בתבניות ערך annotations annotations

פסק זמן

timeout הגדרת זמן קצוב לתפוגה של בקשות לשירותים

חשבון שירות

serviceAccount הגדרת זהות שירות לשירותים