ניהול שינויים

כשמבצעים פריסה לשירות או משנים את ההגדרות של שירות, נוצרת גרסה שלא ניתן לשנות.

השיקולים הבאים רלוונטיים לגרסאות:

• אתם יכולים לציין אם גרסה חדשה מקבלת את כל התנועה, חלק ממנה או אף חלק ממנה, להשיק בהדרגה גרסה חדשה, לפצל את התנועה בין כמה גרסאות ולבטל גרסה. מידע נוסף זמין במאמר בנושא החזרות לגרסה קודמת, השקות הדרגתיות והעברת תעבורה.
• אפשר להשתמש בתגי גרסה כדי לבדוק גרסה שלא מוצגת למשתמשים.
• אתם לא צריכים למחוק באופן ידני את הגרסאות, אבל אתם יכולים לעשות את זה אם אתם רוצים.
• גרסאות שלא מקבלות בקשות לא צורכות משאבים ולא מחויבות. עם זאת, אם הגדרתם מספר מינימלי של מופעים לגרסה, יש שיקולים שקשורים לחיוב שכדאי לזכור.
• יש מגבלה של 1,000 גרסאות לכל שירות: אם חורגים מהמגבלה הזו, גרסאות ישנות יותר נמחקות באופן אוטומטי.
• הסיומת של הגרסה מוקצית באופן אוטומטי. אם רוצים להשתמש בסיומת גרסה משלכם, אפשר לעשות זאת באמצעות הפרמטר --revision-suffix של ה-CLI של gcloud.

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

כדי לקבל את ההרשאות שדרושות לניהול שירותים ועדכונים של Cloud Run, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד מפתח Cloud Run (roles/run.developer) בשירות Cloud Run.

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

הצגת רשימת הגרסאות של שירות

המסוף

כדי לראות את רשימת הגרסאות בפרויקט:

1. כניסה ל-Cloud Run

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

3. לוחצים על הכרטיסייה Revisions (גרסאות) כדי להציג את רשימת הגרסאות הנוכחיות של השירות הזה.

   

gcloud

כדי לראות את רשימת הגרסאות של שירות מסוים:

1. ברשימת השירותים שזמינים בפרויקט, מחפשים את שם השירות:

   gcloud run services list

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

   gcloud run revisions list --service SERVICE --region REGION

   החלפה

   • SERVICE בשם של השירות.
   • ‫REGION עם Google Cloud האזור שבו ניתן השירות.

Cloud Code

כדי לראות את רשימת הגרסאות באמצעות Cloud Code, אפשר לקרוא את המדריכים של Cloud Run Explorer ל-IntelliJ ול-Visual Studio Code.

ספריות לקוח

כדי לראות את רשימת השינויים מהקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

API ל-REST

כדי לראות את רשימת הגרסאות, שולחים בקשת HTTP GET לנקודת הקצה revisions של Cloud Run Admin API.

לדוגמה, שימוש ב-curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions

מחליפים את:

• ‫ACCESS_TOKEN עם אסימון גישה תקף לחשבון שיש לו הרשאות IAM לצפייה בגרסאות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• SERVICE-NAME בשם של השירות.
• ‫REGION עם Google Cloud האזור שבו ניתן השירות.
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud

הצגת פרטי הגרסה

המסוף

כדי לראות את הפרטים של גרסה בפרויקט:

1. כניסה ל-Cloud Run

2. בוחרים את השירות ברשימת השירותים.

3. לוחצים על הכרטיסייה Revisions (גרסאות) כדי להציג את רשימת הגרסאות הנוכחיות של השירות הזה.

4. בוחרים את הגרסה של השירות שמעניינת אתכם:

5. בודקים את החלונית DETAILS בצד שמאל הרחוק כדי לקבל מידע ספציפי על הגרסה, כמו כתובת ה-URL של קובץ האימג' של הקונטיינר שנפרס, כמות הזיכרון שהוקצה, משתני הסביבה וגם מידע על ה-build ומאגר המקור.

   

gcloud

כדי לראות את הפרטים של גרסה בפרויקט:

1. ברשימת השירותים שזמינים בפרויקט, מחפשים את שם השירות:

   gcloud run services list

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

   gcloud run revisions list --service SERVICE --region REGION

   החלפה

   • SERVICE בשם של השירות.
   • ‫REGION עם Google Cloud האזור שבו ניתן השירות.

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

   gcloud run revisions describe REVISION --region REGION

   החלפה
   • ‫REVISION בשם הגרסה שרוצים לקבל עליה מידע נוסף.
   • ‫REGION עם Google Cloud האזור שבו ניתן השירות.

   אפשר להשתמש ב--format flag כדי לעצב את הפלט. לדוגמה, ב-YAML:

   gcloud run revisions describe REVISION --region REGION --format yaml

Cloud Code

כדי לראות את הפרטים של גרסה באמצעות Cloud Code, אפשר לקרוא את המדריכים של Cloud Run Explorer ל-IntelliJ ול-Visual Studio Code.

ספריות לקוח

כדי לראות את פרטי הגרסה מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

API ל-REST

כדי לראות פרטים על גרסה, שולחים בקשת HTTP לנקודת הקצה revisions של Cloud Run Admin API.GET

לדוגמה, שימוש ב-curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

מחליפים את:

• ‫ACCESS_TOKEN עם אסימון גישה תקף לחשבון שיש לו הרשאות IAM לצפייה בפרטי השירות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• SERVICE-NAME בשם של השירות.
• ‫REVISION-NAME בשם של הגרסה.
• ‫REGION עם Google Cloud האזור שבו ניתן השירות.
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud

שימו לב: יכול להיות שלגרסה לא עדכנית יהיה הסטטוס RETIRED, כלומר, Cloud Run הוציא משימוש את התשתית שנדרשת לגרסה הספציפית הזו.

מידע על גרסת ה-build ומאגר המקורות בחלונית פרטים

אם Artifact Analysis API מופעל והקונטיינר נוצר באמצעות Cloud Build, פרטי הבנייה מוצגים בחלונית פרטים.

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

מחיקת גרסאות

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

אי אפשר למחוק גרסה קודמת אם:

• היא יכולה לקבל תנועה,
• זו הגרסה היחידה של השירות,
• זו הגרסה העדכנית ביותר של השירות.

כשמוחקים גרסה, קובץ אימג' של קונטיינר שבו נעשה שימוש בגרסה הזו לא נמחק אוטומטית מ-Container Registry או מ-Artifact Registry. כדי למחוק קובץ אימג' של קונטיינר ממרשם, אפשר לעיין בהוראות המחיקה של Container Registry או של Artifact Registry.

אי אפשר לבטל מחיקה של גרסה קודמת.

אפשר להשתמש במסוף או בשורת הפקודה:

המסוף

כדי למחוק גרסה

1. כניסה ל-Cloud Run

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

3. לוחצים על הכרטיסייה Revisions (גרסאות) כדי להציג את רשימת הגרסאות הנוכחיות של השירות הזה.

4. מאתרים את הגרסה של השירות שרוצים למחוק.

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

   

6. לוחצים על מחיקה כדי למחוק את הגרסה.

gcloud

כדי למחוק גרסה, משתמשים בפקודה הבאה:

gcloud run revisions delete REVISION --region REGION

החלפה

• ‫REVISION בשם של הגרסה שרוצים למחוק.
• ‫REGION עם Google Cloud האזור שבו ניתן השירות.

ספריות לקוח

כדי למחוק גרסה מקוד:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• ‎.NET

API ל-REST

כדי למחוק גרסה, שולחים בקשת HTTP מסוג DELETE לנקודת קצה ל-API של Cloud Run Admin‏ revisions.

לדוגמה, שימוש ב-curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

מחליפים את:

• ‫ACCESS_TOKEN עם אסימון גישה תקף לחשבון שיש לו הרשאות IAM למחיקת שירות. לדוגמה, אם אתם מחוברים ל-gcloud, אתם יכולים לאחזר אסימון גישה באמצעות gcloud auth print-access-token. מתוך מופע קונטיינר של Cloud Run, אפשר לאחזר אסימון גישה באמצעות שרת המטא-נתונים של מופע הקונטיינר.
• SERVICE-NAME בשם של השירות.
• ‫REVISION-NAME בשם של הגרסה.
• ‫REGION עם Google Cloud האזור שבו ניתן השירות.
• ‫PROJECT-ID במזהה הפרויקט. Google Cloud

המאמרים הבאים

אחרי שמפעילים גרסה, אפשר:

• השקות הדרגתיות, חזרה לגרסאות קודמות, העברת תנועה