‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הגדרת ארגזי חול למופעים

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

בדף הזה מוסבר איך להגדיר ארגזי חול במאגר התגים. פרטים על כתיבת קוד לאינטראקציה עם ארגז החול באמצעות CLI מופיעים במאמר הרצת קוד ב-Cloud Run.

לפני שמתחילים

נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

מתקינים ומפעילים את ה-CLI של gcloud.
פריסה של מכונה של Cloud Run.

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

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

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

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

הפעלת ארגזי חול

כדי להפעיל ארגזי חול במופעי Cloud Run, משתמשים ב-Google Cloud CLI או בתצורת YAML:

gcloud

כדי ליצור או לעדכן את המכונה, מציינים את הדגל --sandbox-launcher:

כדי ליצור מופע חדש, מריצים את הפקודה הבאה:
```
gcloud beta run instances create INSTANCE --image IMAGE_URL --sandbox-launcher
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫INSTANCE: השם של מופע Cloud Run.
- ‫IMAGE_URL: הפניה לקובץ אימג' בקונטיינר, כמו us-docker.pkg.dev/cloudrun/container/hello:latest.
כדי לעדכן מופע קיים, מריצים את הפקודה הבאה:
```
gcloud beta run instances update INSTANCE --sandbox-launcher
```

YAML

אם אתם יוצרים מכונה חדשה, דלגו על השלב הזה. אם אתם מעדכנים מופע קיים, אתם צריכים להוריד את הגדרות ה-YAML שלו:
```
gcloud beta run instances describe INSTANCE --format export > instance.yaml
```
מעדכנים את קובץ ה-YAML כך שיכלול את מאפיין sandboxLauncher עם הערך true בתוך הגדרות הקונטיינר:
```
apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  containers:
  - name: CONTAINER
    image: IMAGE_URL
    sandboxLauncher: true
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫INSTANCE: השם של מופע Cloud Run.
- ‫CONTAINER: השם של הקונטיינר.
- ‫IMAGE_URL: הפניה לקובץ אימג' בקונטיינר, כמו us-docker.pkg.dev/cloudrun/container/hello:latest.
יוצרים או מעדכנים את המכונה באמצעות הפקודה הבאה:
```
gcloud beta run instances replace instance.yaml
```

ארגזי חול חולקים את המעבד (CPU) והזיכרון שהוקצו למאגר המארח. חשוב לוודא שהמגבלות של הקונטיינר הראשי לגבי CPU וזיכרון מספיקות כדי להכיל את האפליקציה ואת כל ארגזי החול הפעילים שמופעלים בו-זמנית.

השבתת ארגזי חול

כדי להשבית את האפשרות להפעיל ארגז חול במופע, משתמשים ב-Google Cloud CLI או בהגדרת YAML:

gcloud

כדי לעדכן את המופע באמצעות הדגל --no-sandbox-launcher, מריצים את הפקודה הבאה:

gcloud beta run instances update INSTANCE --no-sandbox-launcher

מחליפים את INSTANCE בשם המכונה.

YAML

אם אתם יוצרים מכונה חדשה, דלגו על השלב הזה. אם אתם מעדכנים מופע קיים, אתם צריכים להוריד את הגדרות ה-YAML שלו:
```
gcloud beta run instances describe INSTANCE --format export > instance.yaml
```
מעדכנים את קובץ ה-YAML כדי להסיר את המאפיין sandboxLauncher בהגדרות של מאגר התגים:
```
apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
spec:
  containers:
  - name: CONTAINER
    image: IMAGE_URL
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫INSTANCE: השם של מופע Cloud Run.
- ‫CONTAINER: השם של הקונטיינר.
- ‫IMAGE_URL: הפניה לקובץ אימג' בקונטיינר, כמו us-docker.pkg.dev/cloudrun/container/hello:latest.
יוצרים או מעדכנים את המכונה באמצעות הפקודה הבאה:
```
gcloud beta run instances replace instance.yaml
```

צפייה בהגדרות ארגז החול

כדי לראות את הגדרות הארגז הנוכחיות של מופע Cloud Run:

gcloud

משתמשים בפקודה הבאה:
```
gcloud beta run instances describe INSTANCE
```
מחליפים את INSTANCE בשם המכונה.
מחפשים את המאפיין sandboxLauncher: true בהגדרה שהוחזרה.

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

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

לפני שמתחילים

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

הפעלת ארגזי חול

gcloud

YAML

השבתת ארגזי חול

gcloud

YAML

צפייה בהגדרות ארגז החול

gcloud

הגדרת ארגזי חול למופעים