הגדרת שרת proxy בחלק הקדמי של האתר באמצעות Nginx

המסוף

1. נכנסים לדף Secret Manager במסוף Cloud de Confiance :

   מעבר אל Secret Manager

2. לוחצים על יצירת סוד.

3. בשדה הטופס name, מזינים nginx_config.

4. מעלים את הקובץ nginx.conf שנמצא במיקום multi-container/hello-nginx-sample/nginx.conf בתור הערך הסודי.

5. משאירים את ברירות המחדל (Google Cloud-powered encryption key, etc).

6. לוחצים על יצירת סוד.

7. נותנים לחשבון השירות של Compute בפרויקט גישה לסוד החדש הזה. כדי לעשות את זה, נכנסים לדף IAM במסוף Cloud de Confiance :

   כניסה לדף IAM

8. מחפשים את חשבון השירות הראשי עם השם: Compute Engine default service account ולוחצים על Edit principal (עריכת חשבון המשתמש).

9. לוחצים על Add another role ובוחרים באפשרות Secret Manager Secret Accessor.

10. לוחצים על Save.

gcloud

1. במסוף, משתמשים בפקודה הבאה כדי ליצור סוד חדש nginx_config ב-Secret Manager:

   gcloud secrets create nginx_config --replication-policy='automatic' --data-file='./nginx.conf'

2. נותנים לחשבון השירות של Compute בפרויקט גישה לסוד החדש באמצעות הפקודה

   export PROJECT_NUMBER=$(gcloud projects describe $(gcloud config get-value project) --format='value(projectNumber)')
   gcloud secrets add-iam-policy-binding nginx_config --member=serviceAccount:$PROJECT_NUMBER-compute@developer.s3ns-system.iam.gserviceaccount.com --role='roles/secretmanager.secretAccessor'

3. כדי לוודא שהסוד נוצר, מריצים את הפקודה gcloud secrets list.

המסוף

הוראות מלאות לשימוש במסוף מופיעות במאמר פריסת השירות.

YAML

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

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

2. ב-service.yaml, מוסיפים את הפריטים הבאים:

   metadata:
     name: "MC_SERVICE_NAME"
     labels:
       cloud.googleapis.com/location: "REGION"
     annotations:
       # Required to use Cloud Run multi-containers (preview feature)
       run.googleapis.com/launch-stage: BETA
       run.googleapis.com/description: sample tutorial service
       # Externally available
       run.googleapis.com/ingress: all

בקטע הזה מתואר גרסת השירות, שכוללת מאפיינים שיכולים להשתנות מגרסה לגרסה.

המסוף

הוראות מלאות לשימוש במסוף מופיעות במאמר פריסת השירות.

YAML

ב-service.yaml, מוסיפים את הטקסט הבא:

spec:
  template:
    metadata:
      annotations:
        # Defines container startup order within multi-container service.
        # Below requires hello container to spin up before nginx container,
        # which depends on the hello container.
        # https://cloud.google.com/run/docs/configuring/containers#container-ordering
        run.googleapis.com/container-dependencies: "{nginx: [hello]}"

שימו לב להערה container-dependencies שמורה ל-Cloud Run להמתין עד שהקונטיינר hello יופעל לפני הפעלת הקונטיינר nginx. אחרת, אם קונטיינר nginx יופעל ראשון, הוא עלול לנסות להעביר שרת proxy בקשה לאחזור מהרשת לקונטיינר של אפליקציית האינטרנט שלא מוכן, וכתוצאה מכך ייווצרו תגובות שגיאה באינטרנט.

אפשר להגדיר לכל קונטיינר מאפיין שם, שמשמש להפניה אליו בהוראות אחרות. קונטיינר ההצגה מפעיל את שרת ה-proxy שנקרא nginx. זהו הקונטיינר שאליו Cloud Run מעביר בקשות נכנסות, ולכן צריך לציין את הגרסה של HTTP ואת יציאת הקונטיינר שאליהן הבקשות יועברו.

המסוף

הוראות מלאות לשימוש במסוף מופיעות במאמר פריסת השירות.

YAML

בקובץ service.yaml, מוסיפים את השורות הבאות:

spec:
  containers:
    # A) Serving ingress container "nginx" listening at PORT 8080
    # Main entrypoint of multi-container service.
    # Source is stored in nginx_config secret in Secret Manager.
    # Any pings to this container will proxy over to hello container at PORT 8888.
    # https://cloud.google.com/run/docs/container-contract#port
    - image: nginx
      name: nginx
      ports:
        - name: http1
          containerPort: 8080
      resources:
        limits:
          cpu: 500m
          memory: 256Mi
      # Referencing declared volume below,
      # Declaring volume to mount in current ingress container's filesystem
      # https://cloud.google.com/run/docs/reference/rest/v2/Container#volumemount
      volumeMounts:
        - name: nginx-conf-secret
          readOnly: true
          mountPath: /etc/nginx/conf.d/
      startupProbe:
        timeoutSeconds: 240
        periodSeconds: 240
        failureThreshold: 1
        tcpSocket:
          port: 8080

השרת nginx דורש קובץ הגדרה בספרייה /etc/nginx/conf.d/. כדי לעשות את זה, צריך לטעון נפח אחסון שמכיל את הקובץ במיקום הזה. בקטע volumeMount מצוין שצריך להציב שם עוצמת קול שנקראת configuration. הווליום עצמו מוגדר בקטע משלו בהמשך הקובץ.

המסוף

הוראות מלאות לשימוש במסוף מופיעות במאמר פריסת השירות.

YAML

ב-service.yaml, מוסיפים את הטקסט הבא:

- image: us-docker.pkg.dev/cloudrun/container/hello
  name: hello
  env:
    - name: PORT
      value: "8888"
  resources:
    limits:
      cpu: 1000m
      memory: 512Mi
  startupProbe:
    timeoutSeconds: 240
    periodSeconds: 240
    failureThreshold: 1
    tcpSocket:
      port: 8888

גם לאפליקציית hello נדרש מידע על ההגדרות. הוא מאזין לבקשות נכנסות ביציאה שצוינה במשתנה הסביבה PORT. השם והערך האלה מצוינים בקטע env.

המסוף

הוראות מלאות לשימוש במסוף מופיעות במאמר פריסת השירות.

YAML

בקובץ service.yaml, מוסיפים את השורות הבאות:

volumes:
  - name: nginx-conf-secret
    secret:
      secretName: nginx_config
      items:
        - key: latest
          path: default.conf

מציינים את ההגדרה volume שמועלית בקטע volumeMount. הוא מכיל קובץ יחיד בשם nginx.conf שהתוכן שלו מוגדר כערך של הסוד שנקרא nginx-conf-secret.

המסוף

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

   כניסה ל-Cloud Run

2. בתפריט בוחרים באפשרות Services (שירותים) ולוחצים על Deploy container (פריסת מאגר) כדי להציג את הטופס Create service (יצירת שירות).

   1. בוחרים באפשרות Deploy one revision from an existing container image (פריסת עדכון אחד מקובץ אימג' קיים של קונטיינר) ומזינים את nginx בתור Container image URL (כתובת URL של קובץ אימג' של קונטיינר).
   2. בשדה Service name (שם השירות), מציינים שם לשירות, לדוגמה, hello-mc.
   3. ברשימה Region, בוחרים מיקום לפריסה, לדוגמה, us-west1.
   4. בקטע אימות, בוחרים באפשרות אפשר גישה לכולם. אם אין לכם הרשאות (תפקיד אדמין ב-Cloud Run) לבחור באפשרות הזו, השירות יופעל ויידרש אימות.

3. לוחצים על Containers, Networking, Security (מאגרי תגים, רשתות, אבטחה) כדי להרחיב את טופס ההגדרה.

   1. לוחצים על הכרטיסייה Volumes (אמצעי אחסון).
   2. לוחצים על הוספת עוצמת קול.
   3. ברשימה סוג נפח, בוחרים באפשרות סוד.
   4. בשדה Volume name, מזינים nginx-conf-secret.
   5. בשדה Secret (סוד), מזינים nginx_config.
   6. בקטע Specified paths for secret versions (נתיבים שצוינו לגרסאות של סודות), מציינים את default.conf כנתיב ואת latest כגרסה.
   7. לוחצים על Create (יצירה) כדי ליצור את נפח ה-Secret.

4. לוחצים על הכרטיסייה מאגרי תגים כדי להציג את הטופס עריכת מאגר תגים.

   1. לוחצים על הגדרות, ואז בקטע משאבים משנים את הזיכרון ל-256MiB ואת המעבד ל-1 CPU.
   2. לוחצים על Volume mounts (נקודות חיבור של אמצעי אחסון).
   3. לוחצים על Mount volume (התקנת אמצעי אחסון).
   4. בוחרים באפשרות nginx-conf-secret מתוך רשימת השמות.
   5. בשדה נתיב הטעינה, מזינים etc/nginx/conf.d.
   6. לוחצים על סיום כדי להשלים את ההגדרה של מאגר התגים הראשון.

5. לוחצים על Add container (הוספת מאגר) כדי להוסיף את מאגר ה-sidecar ולהציג את הטופס New container (מאגר חדש).

   1. בוחרים את כתובת ה-URL של קובץ האימג' של קונטיינר ברירת המחדל us-docker.pkg.dev/cloudrun/container/hello
   2. לוחצים על הכרטיסייה הגדרות, ואז בקטע משאבים משנים את הזיכרון ל-256MiB ואת המעבד ל-1 CPU.
   3. לוחצים על Variables & Secrets (משתנים וסודות).
   4. לוחצים על הוספת משתנה.
   5. מזינים PORT כשם משתנה הסביבה החדש ו-8888 כערך.
   6. לוחצים על סיום.

6. עוברים לטופס עריכת מאגר של המאגר הראשון (nginx).

   1. לוחצים על הכרטיסייה הגדרות.
   2. בקטע Container start up order, בוחרים באפשרות nginx מהרשימה Depends on. כלומר, קונטיינר nginx מתחיל לפעול רק אחרי שקונטיינר hello מתחיל לפעול בהצלחה.
   3. לוחצים על Create (יצירה) ומחכים לפריסת השירות.

YAML

כדי לפרוס את קונטיינר שרת ה-proxy ואת קונטיינר אפליקציית האינטרנט כשירות יחיד:

gcloud run services replace service.yaml

gcloud

1. בטרמינל, משכפלים את מאגר האפליקציה לדוגמה למחשב המקומי:

   git clone https://github.com/GoogleCloudPlatform/cloud-run-samples

2. עוברים לספרייה שמכילה את הקוד לדוגמה של Cloud Run:

   cd cloud-run-samples/multi-container/hello-nginx-sample/