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

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

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

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

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

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

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

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

המסוף

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

  1. כניסה ל-Cloud Run

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

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

gcloud

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

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

    gcloud run services list

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

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

    החלפה

    • SERVICE בשם של השירות.
    • ‫REGION באזור של השירות ב- Cloud de Confiance .

Cloud Code

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

ספריות לקוח

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

‫API בארכיטקטורת REST

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

לדוגמה, באמצעות 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 באזור של השירות ב- Cloud de Confiance .
  • ‫PROJECT-ID במזהה הפרויקט ב- Cloud de Confiance .

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

המסוף

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

  1. כניסה ל-Cloud Run

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

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

  4. בוחרים את גרסת השירות שרוצים.

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

gcloud

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

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

    gcloud run services list

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

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

    החלפה

    • SERVICE בשם של השירות.
    • ‫REGION באזור של השירות ב- Cloud de Confiance .

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

    gcloud run revisions describe REVISION --region REGION
     החלפה

    • ‫REVISION בשם הגרסה שרוצים לקבל עליה מידע נוסף.
    • ‫REGION באזור של השירות ב- Cloud de Confiance .

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

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

Cloud Code

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

ספריות לקוח

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

‫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/REVISION-NAME

מחליפים את:

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

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

מידע על ה-build ועל מאגר המקור בחלונית Details

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

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

מחיקת גרסאות

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

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

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

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

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

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

המסוף

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

  1. כניסה ל-Cloud Run

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

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

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

  5. לוחצים על סמל האפשרויות הנוספות (3 נקודות אנכיות) שמימין לגרסה, ואז לוחצים על מחיקה כדי למחוק את הגרסה.

gcloud

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

gcloud run revisions delete REVISION --region REGION

החלפה

  • ‫REVISION בשם הגרסה שרוצים למחוק.
  • ‫REGION באזור של השירות ב- Cloud de Confiance .

ספריות לקוח

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

‫API בארכיטקטורת REST

כדי למחוק גרסה, שולחים בקשת HTTP מסוג DELETE לנקודת הקצה (endpoint) של 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 באזור של השירות ב- Cloud de Confiance .
  • ‫PROJECT-ID במזהה הפרויקט ב- Cloud de Confiance .

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

אחרי שפורסים גרסה, אפשר לבצע את הפעולות הבאות: