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

בדף הזה מוסבר איך מגדירים תיאור בהתאמה אישית לשירותי Cloud Run. תיאור הוא טקסט אופציונלי שניתן לקריאה על ידי בני אדם ומצורף לשירות. התיאור מוגבל ל-512 תווים. אם התיאור קיים, הוא מוצג כשמציגים את הפרטים של שירות באמצעות gcloud run services describe.

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

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

‫Cloud Run Developer (roles/run.developer) בשירות Cloud Run
משתמש בחשבון שירות (roles/iam.serviceAccountUser) בזהות השירות

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

רשימת ההרשאות והתפקידים ב-IAM שמשויכים ל-Cloud Run מופיעה במאמרים תפקידי IAM ב-Cloud Run והרשאות IAM ב-Cloud Run. אם שירות Cloud Run שלכם מתקשר עםGoogle Cloud ממשקי API, כמו ספריות לקוח ב-Cloud, כדאי לעיין במדריך להגדרת זהות שירות. מידע נוסף על מתן תפקידים זמין במאמרים הרשאות פריסה וניהול גישה.

הגדרה או שינוי של תיאור

אפשר להגדיר תיאור בשירותי Cloud Run.

gcloud

אפשר להגדיר או לעדכן את התיאור במהלך הפריסה:

gcloud run deploy SERVICE --description DESCRIPTION

החלפה

‫SERVICE מחליפים בשם של שירות Cloud Run
DESCRIPTION עם תיאור השירות

YAML

אם אתם יוצרים שירות חדש, דלגו על השלב הזה. כדי לעדכן שירות קיים, מורידים את הגדרות ה-YAML שלו:
```
gcloud run services describe SERVICE --format export > service.yaml
```

מעדכנים את ההערה run.googleapis.com/description:

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
    run.googleapis.com/description: "DESCRIPTION"
spec:
  template:
    ...

החלפה

‫SERVICE בשם של שירות Cloud Run
DESCRIPTION עם תיאור השירות

יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:
```
gcloud run services replace service.yaml
```

Terraform

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

מוסיפים את השורות הבאות למשאב google_cloud_run_v2_service בקובץ התצורה של Terraform:

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-description"
  location = "us-central1"

  description = "This service has a custom description"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
  }

}

מחליפים את התיאור בערך הרצוי.

הגדרת תיאורי שירות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.