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

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

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

בטבלה הבאה מפורטים הרכיבים שאפשר לחבר לשירות 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 ל-PostgreSQL. המטא-נתונים של המשאב AlloyDB ל-PostgreSQL נוספים למשתני הסביבה של Cloud Run. התפקיד roles/alloydb.admin של AlloyDB ל-PostgreSQL נוסף לחשבון השירות של Cloud Run.	התחברות מ-Cloud Run
BigQuery	שירות Cloud Run יכול לקיים אינטראקציה עם מערך הנתונים ב-BigQuery. המטא-נתונים של המשאב ב-BigQuery נוספים למשתני הסביבה של Cloud Run. התפקיד roles/bigquery.dataEditor ב-BigQuery נוסף לחשבון השירות של 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[]‎	הגדרת סדר ההפעלה של קונטיינרים לפריסות של קונטיינרים מסוג sidecar
		Container Args	args[]‎	הגדרת קונטיינרים לשירותים
		פקודת קונטיינר	command	הגדרת קונטיינרים לשירותים
	משתני סביבה	מפתח	name	משתני סביבה לשירותים
		ערך	ערך	משתני סביבה לשירותים
	משתני סביבה סודיים	מפתח	EnvVarSource	ניהול סודות
		Secret	secret	ניהול סודות
		גרסה	גרסה	ניהול סודות
	נקודות טעינה של אמצעי אחסון	שם	name	התחברות מ-Cloud Run
		נתיב טעינה	mountPath	התחברות מ-Cloud Run
	יציאות	שם	name	שימוש ב-HTTP/2 לשירותים
		יציאת קונטיינר	containerPort	שימוש ב-HTTP/2 לשירותים
	משאבים	מעבד (CPU)	מגבלות	הגדרת מגבלות מעבד (CPU) לשירותים
		זיכרון	מגבלות	הגדרת מגבלות זיכרון לשירותים
		CPU Idle	אם המעבד מוקצה רק במהלך בקשות.	cpuIdle
		האצת המעבד בזמן אתחול	startupCPUBoost	הגדרת האצת המעבד בזמן אתחול
	בדיקת הפעלה	Failure Threshold	failureThreshold	הגדרת בדיקות תקינות של קונטיינרים לשירותים
		השהיה ראשונית בשניות	initialDelaySeconds	הגדרת בדיקות
		זמן קצוב לתפוגה בשניות	timeoutSeconds	הגדרת בדיקות
		שניות בתקופה	periodSeconds	הגדרת בדיקות
		נתיב HTTP Get	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 עם מחברים
		תעבורת נתונים יוצאת	egress	שליטה בתעבורת נתונים יוצאת של שירות
	ממשקי רשת	רשת	network	פריסת שירות
		רשת משנה	subnetwork	פריסת שירות
		תגים	תגים	פריסת שירות
		הגנה מפני מחיקה ב-Cloud Run	מונעת מ-Terraform להרוס או ליצור מחדש משימות ושירותים של Cloud Run.	deletion_protection
		הפעלת Prometheus Sidecar	מפעילים את Prometheus sidecar במכונה של Cloud Run.	כתיבת מדדי Prometheus באמצעות Prometheus sidecar
נפחי אחסון		שם	name	הגדרת אמצעי אחסון בזיכרון
	סוד	Secret	secret	איך מאפשרים ל-Cloud Run לגשת לסוד
		מצב ברירת מחדל	defaultMode
		נתיב	path	איך מאפשרים גישה לסוד ב-Cloud Run
		גרסה	גרסה	איך הופכים סוד לזמין ב-Cloud Run
		מצב	mode	איך הופכים סוד לזמין ב-Cloud Run
	מכונה של Cloud SQL	מכונות	instances[]‎	התחברות מ-Cloud Run
	ספרייה ריקה	בינונית	medium	הגדרת נקודות טעינה של אמצעי אחסון בזיכרון לשירותים
		מגבלת גודל	sizeLimit	הגדרת נקודות טעינה של אמצעי אחסון בזיכרון לשירותים
	GCS	קטגוריה	bucket	הגדרת נקודות טעינה של Cloud Storage לשירותים
		לקריאה בלבד	readOnly	הגדרת נקודות טעינה של Cloud Storage לשירותים
	NFS	שרת	server	הגדרת נקודות טעינה של אמצעי אחסון ב-NFS לשירותים
		נתיב	path	הגדרת נקודות טעינה של אמצעי אחסון NFS לשירותים
		לקריאה בלבד	readOnly	הגדרת נקודות טעינה של אמצעי אחסון ב-NFS לשירותים
התאמה לעומס (scaling) של שירותים		מספר המכונות המינימלי	minInstanceCount	הגדרת מספר מינימלי של מכונות לשירותים
		גרסה	גרסה	גרסאות של שירות Cloud Run
שינוי קנה המידה של התבנית		מספר המכונות המינימלי	minInstanceCount	הגדרת מספר מינימלי של מכונות לשירותים
		מספר המופעים המקסימלי	maxInstanceCount	מידע על מספר המכונות המקסימלי
		מפתח הצפנה	encryptionKey	שימוש במפתחות הצפנה בניהול הלקוח
		מספר מקסימלי של בקשות בו-זמניות למכונה	maxInstanceRequestConcurrency	מספר מקסימלי של בקשות מקבילות לשירותים
		זיקה לסשן (session affinity)	sessionAffinity	הגדרת זיקה לסשן (session affinity) לשירותים
		סביבת הפעלה	executionEnvironment	מידע על סביבות הרצה של שירותים
תעבורת נתונים		סוג	type	חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
		Percent	percent	חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
		גרסה	גרסה	חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
		תג	tag	חזרה למצב קודם, השקות הדרגתיות והעברת תנועה
תוויות שירות		מפתח	תוויות	הגדרת תוויות לשירותים
		ערך	תוויות	הגדרת תוויות לשירותים
הערות לגבי השירות		מפתח	annotations	annotations
		ערך	annotations	annotations
לקוח		שם	מזהה שרירותי של לקוח ה-API.	client
		גרסה	מזהה שרירותי של מזהה הגרסה.	clientVersion
		שלב ההשקה	LaunchStage	שלבי השקת המוצר
		קהלים בהתאמה אישית	customAudience	הגדרת קהלים בהתאמה אישית לשירותים
Binary Authorization		הצדקה ל-Breakglass	breakglassJustification	שימוש ב-breakglass
		שימוש בברירת המחדל	useDefault	שימוש ב-Binary Authorization
תוויות של תבנית		מפתח	תוויות	הגדרת תוויות לשירותים
		ערך	תוויות	הגדרת תוויות לשירותים
הערות בתבנית		מפתח	annotations	annotations
		ערך	annotations	annotations
		פסק זמן	timeout	הגדרת זמן קצוב לתפוגה של בקשות לשירותים
		חשבון שירות	serviceAccount	הגדרת זהות שירות לשירותים