בדף הזה נסביר איך מנהלים את מחזורי החיים של שירותים מנוהלים באמצעות הפקודות gcloud endpoints services של Google Cloud CLI.
לתרחישים מתקדמים של שימוש, תוכלו להיעזר ב-Service Management API כדי לנהל את השירותים באופן פרוגרמטי. מידע נוסף זמין במאמר תחילת השימוש ב-Service Management API
מבוא
שירות מנוהל הוא משאב פשוט שמייצג באופן לוגי שירות שמשולב עם Service Infrastructure, כמו ממשק ה-API של Gmail או Spanner API. השירות המנוהל עצמו כולל רק שני מאפיינים שלא ניתנים לשינוי: שם השירות והפרויקט לשירות המנוהל. עם זאת, היישום של שירות מנוהל יכול לספק פונקציונליות נרחבת. לדוגמה, Cloud Storage API מאפשר אחסון של אובייקטים ברחבי העולם עבור מיליוני מפתחים וארגונים.
לכל שירות מנוהל יש קבוצה של צרכני שירות, היסטוריה של הגדרות שירות שלא ניתנות לשינוי והיסטוריה של השקות שירות שלא ניתנות לשינוי.
הגדרות השירות שמצוינות בהשקת השירות האחרונה מייצגות את המצב הנוכחי של השירות. ההגדרות האלו כוללות את כל ההיבטים של השירות, החל מהשם המוצג ועד להגדרות המדדים והגבלות הקצב של יצירת בקשות. למפרט המלא, ראו: google.api.Service.
בדף הזה נסביר איך ליצור ולנהל את מחזורי החיים של השירותים שלכם. מידע נוסף על ניהול השירות זמין במדריכים.
יצירת שירות
כדי ליצור שירות:
במחשב, מתקינים ומפעילים את ה-CLI של gcloud.
יוצרים פרויקט ייעודי לשירות מנוהל, לאירוח השירות שלכם. יצירת פרויקט ייעודי תספק לשירות שלכם את האבטחה והבידוד הטובים ביותר, ותוכלו גם להעביר את הבעלות על השירות לצוות אחר ואפילו לחברה אחרת.
מפעילים בפרויקט את Service Management API ואת Service Control API.
מפעילים בפרויקט את החיוב ב-Cloud. כדי לשלב את השירות שלכם עם Service Infrastructure, אתם זקוקים לכמה מוצרים בתשלום של Google Cloud, כולל Service Control API, Cloud Logging API ו-Cloud Monitoring API.
מכינים קובץ yaml פשוט עבור הגדרות השירות, באופן הבא:
# Filename: endpointsapis.yaml type: google.api.Service config_version: 3 # Update the next line to use your own service name. name: endpointsapis.appspot.com # Update the next line to use your own producer project id. producer_project_id: endpointsapisכדי ליצור את השירות, פורסים את השירות עם הגדרת שירות ריקה באמצעות הפקודה
gcloud:gcloud endpoints services deploy endpointsapis.yaml
תהליך היצירה נמשך בערך דקה. לאחר מכן השירות אמור להופיע בדף Endpoints במסוףGoogle Cloud .
פרסום שירותים
כדי לפרסם את השירותים בפרויקט, השתמשו בפקודה הבאה:
gcloud endpoints services list --project endpointsapis
תיאור השירות
כדי לתאר את השירות ואת ההגדרות שלו, השתמשו בפקודה הבאה:
gcloud endpoints services describe endpointsapis.appspot.com
מחיקת שירות
אם כבר אין לכם צורך בשירות מסוים, תוכלו למחוק אותו באמצעות הפקודה הבאה:
gcloud endpoints services delete endpointsapis.appspot.com
הערה: לכל שירות מוגדרת תקופת חובה לשמירה של נתונים שנמחקו במשך 30 יום.
ביטול מחיקה של שירות
אפשר לבטל את המחיקה של שירות במסגרת חלון הזמן של שמירת נתונים, באמצעות הפקודה הבאה:
gcloud endpoints services undelete endpointsapis.appspot.com
השלבים הבאים
הממשק Service Management API משתמש במודל מבוסס-הצהרות לניהול שירותים. אחרי שיצרתם את השירות, כדי להגיע למצב הרצוי של השירות עליכם לדחוף את הגדרות השירות שלא ניתנות לשינוי ואת השקות השירות. הגדרות השירות משמשות להגדרה של תשתית השירות ב-Google Cloud ולתמיכה בשירות שלכם, כולל ההגדרות של חיוב ב-Cloud, Cloud Logging, Cloud Monitoring וניהול זהויות והרשאות גישה.
מידע נוסף על הגדרות השירות זמין במאמר ניהול הגדרות השירות. מידע נוסף על השקות של שירותים זמין במאמר ניהול השקות של שירותים.