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

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

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

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

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.

ספריות לקוח

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

‫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. לוחצים על הכרטיסייה היסטוריית גרסאות כדי לראות את רשימת הגרסאות הנוכחיות של השירות.

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

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

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.

ספריות לקוח

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

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

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

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

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

gcloud

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

gcloud run revisions delete REVISION --region REGION

החלפה

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

ספריות לקוח

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

‫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

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

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