הגבלת תעבורת נכנסת (ingress) של נקודות קצה ברשת לשירותים ולמופעים של Cloud Run

המסוף

1. נכנסים לדף Services של Cloud Run במסוף Cloud de Confiance :

   כניסה ל-Cloud Run

2. אם מגדירים שירות חדש, לוחצים על Deploy container כדי להציג את הטופס Create service. ממלאים את דף ההגדרות הראשוניות של השירות.

3. אם אתם מגדירים שירות קיים, לוחצים על השירות ואז על הכרטיסייה Networking.

4. בוחרים את תעבורת הנתונים הנכנסת (ingress) שרוצים לאפשר.

5. כדי ליצור שירות חדש, לוחצים על יצירה. לוחצים על View diff & redeploy ואז על Deploy changes בשירות קיים.

gcloud

1. אם אתם פורסים שירות חדש, צריך לפרוס אותו עם הדגל --ingress:

   gcloud run deploy SERVICE \
       --image IMAGE_URL \
       --ingress INGRESS

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫SERVICE: שם השירות.
   • ‫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.
   • ‫INGRESS: אחת מהגדרות התעבורה הנכנסת הזמינות:
     • all
     • internal
     • internal-and-cloud-load-balancing

2. אם אתם משנים את תעבורת הנתונים הנכנסת של שירות קיים:

   gcloud run services update SERVICE \
       --ingress INGRESS

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫SERVICE: שם השירות
   • ‫INGRESS: אחת מהגדרות התעבורה הנכנסת הזמינות:
     • all
     • internal
     • internal-and-cloud-load-balancing

YAML

1. אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:

   gcloud run services describe SERVICE --format export > service.yaml

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

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/ingress: INGRESS
   spec:
     template:
       metadata:
         name: REVISION

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫SERVICE: השם של שירות Cloud Run.
   • ‫INGRESS: אחת מהגדרות התעבורה הנכנסת הזמינות:
     • all
     • internal
     • internal-and-cloud-load-balancing
   • ‫REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם מספקים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:
     • מתחיל ב-SERVICE-
     • מכיל רק אותיות קטנות, מספרים ו--
     • לא מסתיים ב--
     • לא חורג מ-63 תווים

3. מחליפים את השירות בהגדרות החדשות שלו באמצעות הפקודה הבאה:

   gcloud run services replace service.yaml

Terraform

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

resource "google_cloud_run_v2_service" "default" {
  provider = google-beta
  name     = "ingress-service"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  # For valid annotation values and descriptions, see
  # https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/cloud_run_v2_service#ingress
  ingress = "INGRESS_TRAFFIC_INTERNAL_ONLY"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello" #public image for your service
    }
  }
}

המסוף

1. נכנסים לדף Services של Cloud Run במסוף Cloud de Confiance :

   כניסה ל-Cloud Run

2. לוחצים על שירות קיים.

3. לוחצים על הכרטיסייה Networking.

4. בכרטיס נקודות קצה, מבטלים את הסימון של הפעלה בקטע כתובת ה-URL של נקודת הקצה המוגדרת כברירת מחדל ל-HTTPS.

5. לוחצים על View diff & redeploy ואז על Deploy changes.

כדי לשחזר את כתובת ה-URL שמוגדרת כברירת מחדל, לוחצים על הפעלה.

gcloud

• בשירות קיים, מריצים את הפקודה gcloud run services update עם הדגל --no-default-url, לדוגמה:

  gcloud run services update SERVICE_NAME --no-default-url

• בשירות חדש, מריצים את הפקודה gcloud run deploy עם הדגל --no-default-url, לדוגמה:

  gcloud run deploy SERVICE_NAME --no-default-url

  מחליפים את SERVICE_NAME בשם של שירות Cloud Run.

  בפלט, כתובת ה-URL מוצגת בתור None.

כדי לשחזר את כתובת ה-URL שמוגדרת כברירת מחדל, משתמשים בדגל --default-url.

YAML

1. אם אתם יוצרים שירות חדש, דלגו על השלב הזה. אם אתם מעדכנים שירות קיים, הורידו את הגדרת ה-YAML שלו:

   gcloud run services describe SERVICE --format export > service.yaml

2. כדי להשבית את כתובת ה-URL של s3nsrun.fr, משתמשים בהערה run.googleapis.com/default-url-disabled:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     annotations:
       run.googleapis.com/default-url-disabled: true
     name: SERVICE
   spec:
     template:
       metadata:
         name: REVISION

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫SERVICE: השם של שירות Cloud Run.
   • ‫REVISION: שם גרסה חדש או מחיקה של השם (אם הוא קיים). אם אתם מספקים שם חדש לגרסה, הוא חייב לעמוד בקריטריונים הבאים:
     • מתחיל ב-SERVICE-
     • מכיל רק אותיות קטנות, מספרים ו--
     • לא מסתיים ב--
     • לא חורג מ-63 תווים

3. יוצרים או מעדכנים את השירות באמצעות הפקודה הבאה:

   gcloud run services replace service.yaml

   כברירת מחדל, הפקודה gcloud run services replace משתמשת בקובץ service.yaml אם הוא קיים.

כדי לשחזר את כתובת ה-URL שמוגדרת כברירת מחדל, מסירים את ההערה run.googleapis.com/default-url-disabled.

Terraform

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

  resource "google_cloud_run_v2_service" "disable_default_url_service" {
    name     = "cloudrun-service"
    location = "europe-west1"
    default_uri_disabled = true

    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/hello"
      }
      annotations = {
        "run.googleapis.com/ingress" = "all"   # "all" or "internal-only"
      }

    }
  }

מוודאים שהשורות launch_stage ו-default_uri_disabled נמצאות בקובץ main.tf. המשאב google_cloud_run_v2_service שלמעלה מציין שירות Cloud Run שבו כתובת ה-URL שמוגדרת כברירת מחדל מושבתת בגרסת טרום-השקה (Preview).

כדי לשחזר את כתובת ה-URL שמוגדרת כברירת מחדל, מסירים את הארגומנטים default_uri_disabled ו-launch_stage.