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

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

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

• אתם יכולים לציין אם גרסה חדשה מקבלת את כל התנועה, חלק ממנה או אף חלק ממנה, להשיק בהדרגה גרסה חדשה, לפצל את התנועה בין כמה גרסאות ולבטל שינויים שבוצעו בגרסה. מידע נוסף זמין במאמר בנושא החזרות לגרסה קודמת, השקות הדרגתיות והעברת תעבורה.
• אפשר להשתמש בתגי גרסה כדי לבדוק גרסה שלא מוצגת למשתמשים.
• אתם לא צריכים למחוק באופן ידני את הגרסאות, אבל אתם יכולים לעשות זאת אם תרצו.
• גרסאות שלא מקבלות בקשות לא צורכות משאבים ולא מחויבות. עם זאת, אם הגדרתם מספר מינימלי של מופעים לגרסה, יש שיקולים שקשורים לחיוב שכדאי לזכור.
• יש מגבלה של 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. בודקים את החלונית פרטים בצד שמאל הרחוק כדי לראות מידע ספציפי לגרסה, כמו כתובת ה-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 ומאגר המקורות בחלונית Details

אם 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 אל נקודת הקצה revisions של Cloud Run Admin API.

לדוגמה, באמצעות 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

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

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

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