כשבוחרים את מודל הגדרת האפליקציה, מגדירים גבול לניהול האפליקציה עבור האפליקציות ב-App Hub בפרויקט ניהול. לאחר מכן תוכלו לרשום שירותים ועומסי עבודה באפליקציות בתוך הגבול הזה. תרחישים מומלצים להטמעת שיטות לניהול אפליקציות מפורטים במאמר הכנה לניהול מחזור החיים של אפליקציות.
כדי להימנע מסחף הגדרות ולשמור על מקור אמת ברור, מומלץ לנהל את רכיבי האפליקציה בסביבה שבה הם הוגדרו במקור:
באפליקציות שנפרסו מתבנית של Application Design Center: משתמשים ב-Application Design Center כדי לנהל ולעדכן את האפליקציה. יש לכם שתי אפשרויות: לערוך את התבנית כדי לשנות את עיצוב האפליקציה או ליצור גרסה חדשה של האפליקציה כדי לעדכן הגדרות כמו פרטי האפליקציה והרכיבים.
באפליקציות שנוצרו על ידי רישום משאבים קיימים ב-App Hub: אפשר לנהל אפליקציות, שירותים ועומסי עבודה ישירות ב-App Hub.
בדף הזה מוסבר איך לנהל שירותים ועומסי עבודה שמתגלים או נרשמים ישירות ב-App Hub. אפשר לבצע את הפעולות האלה באמצעות מסוף Google Cloud או Google Cloud CLI. לגבי אפליקציות שנפרסו מתבנית, אפשר לעיין במסמכים של מרכז עיצוב האפליקציות.
לפני שמתחילים
במסמך הזה אנחנו מניחים שיש לכם אפליקציה עם משאבים נתמכים שרשומים בה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול שירותים ועומסי עבודה ב-App Hub, צריך לבקש מהאדמין לתת לכם את תפקידי ה-IAM הבאים בפרויקט הניהול שבו מוגדר הגבול של ניהול האפליקציה:
-
עדכון וביטול רישום של שירותים ועומסי עבודה:
עריכת מרכז האפליקציות (
roles/apphub.editor) -
צפייה בשירותים, בעומסי עבודה ובפרטים שלהם:
צפייה ב-App Hub (
roles/apphub.viewer)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
מידע נוסף על תפקידים ב-App Hub זמין במאמר תפקידים והרשאות ב-IAM ב-App Hub.
הצגת פרטים של שירותים ועומסי עבודה
כדי להציג את פרטי השירותים ועומסי העבודה בגבולות ניהול האפליקציות, כולל הפרטים הבאים, פועלים לפי השלבים הבאים:
מידע נוסף על הפרטים האלה זמין במאמר מושגים ומודל נתונים של מרכז האפליקציות.
המסוף
צפייה בפרטים משירותים ומעומסי עבודה של אפליקציה עם ערך סטטוס רישום של registered או detached:
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.
עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:
בדף הזה מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לראות את הפרטים שלה או של עומס העבודה שלה.
בכרטיסייה Services and workloads (שירותים ועומסי עבודה), לוחצים על שם השירות או עומס העבודה שרוצים לראות.
בדף Details של הרכיב, אפשר לראות מידע כמו השם לתצוגה, המיקום, סטטוס הרישום, המאפיינים והתכונות.
לחלופין, אפשר להציג רשימה של כל השירותים ועומסי העבודה עם ערך סטטוס רישום של discovered או registered:
עוברים לדף שירותים ועומסי עבודה ממרכז האפליקציות:
כניסה לדף Services and workloads
בדף הזה מוצגת רשימה של כל השירותים ועומסי העבודה שזוהו ונרשמו.
כדי לצמצם את התוצאות לפי מאפיינים, תכונות או סטטוס, אפשר להשתמש בשדה Filter ולהזין ערכים כמו Environment, Owners או Registration status.
gcloud
צפייה בפרטים משירותים ומעומסי עבודה של אפליקציה עם ערך סטטוס רישום של registered או detached:
איך מוצאים את מזהה הפרויקט של פרויקט הניהול.
כדי לבדוק את הפרטים של שירות או עומס עבודה מאפליקציה, כולל מאפיינים ותכונות, צריך לתאר את השירות או עומס העבודה:
תארו שירות:
gcloud apphub applications services describe SERVICE \ --project=PROJECT_ID \ --application=APPLICATION \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
SERVICE: מזהה השירות. -
PROJECT_ID: המזהה של פרויקט הניהול. -
APPLICATION: המזהה של האפליקציה שבה השירות רשום. -
LOCATION: המיקום של השירות. משתמשים ב-globalלמשאבים גלובליים או באזור ספציפי, כמוus-east1, למשאבים אזוריים.
-
תארי עומס עבודה:
gcloud apphub applications workloads describe WORKLOAD \ --project=PROJECT_ID \ --application=APPLICATION \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
WORKLOAD: המזהה של עומס העבודה. -
PROJECT_ID: המזהה של פרויקט הניהול. -
APPLICATION: המזהה של האפליקציה שעומס העבודה רשום אליה. -
LOCATION: המיקום של עומס העבודה. משתמשים ב-globalלמשאבים גלובליים או באזור ספציפי, כמוus-east1, למשאבים אזוריים.
-
בפלט מוצגים פרטים מהרכיב, כמו השם לתצוגה, המיקום וסטטוס הרישום. הוא כולל גם מאפיינים, אם הם קיימים במקור המידע.
לחלופין, אפשר להציג רשימה של כל השירותים ועומסי העבודה עם ערך סטטוס רישום של discovered או registered:
גילה
משאבים שזוהו בגבולות ניהול האפליקציה זמינים לרישום כשירותים או כעומסי עבודה באפליקציה. Google Cloud כדי להציג את המשאבים שזוהו:
רשימת השירותים שזוהו:
gcloud apphub discovered-services list \ --project=PROJECT_ID \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המזהה של פרויקט הניהול. -
LOCATION: המיקום שבו רוצים לגלות משאבים. משתמשים בערךglobalלמשאבים גלובליים או באזור ספציפי, כמוus-east1, למשאבים אזוריים.
-
הצגת רשימה של עומסי עבודה שנמצאו:
gcloud apphub discovered-workloads list \ --project=PROJECT_ID \ --location=LOCATION
רשום
שירותים ועומסי עבודה רשומים הם חלק מאפליקציה. כדי להציג רשימה של רכיבים רשומים של אפליקציה מסוימת, פועלים לפי השלבים הבאים.
אפשר לסנן את הרשימה לפי מאפיינים באמצעות הדגל --filter:
כדי להציג רשימה של שירותים רשומים באפליקציה:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSIONמחליפים את מה שכתוב בשדות הבאים:
-
APPLICATION_NAME: השם של האפליקציה. מציינים את הערך הזה כשיוצרים אפליקציה. -
PROJECT_ID: המזהה של פרויקט הניהול. -
LOCATION: המיקום של הרכיב. משתמשים ב-globalלרכיבים גלובליים או לאזור ספציפי, כמוus-east1לרכיבים אזוריים. - אופציונלי:
FILTER_EXPRESSION: ביטוי המסנן לציון מאפיינים. לדוגמה, כדי להציג רשימה של רכיבים עם סוג סביבהPRODUCTION, משתמשים בפקודהattributes.environment.type=PRODUCTION.
-
כדי לראות את רשימת עומסי העבודה הרשומים באפליקציה:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --filter=FILTER_EXPRESSION
סטטוס הרישום של שירותים ועומסי עבודה באפליקציה עשוי להשתנות למנותק אם מעבירים פרויקט או תיקייה מחוץ לגבולות ניהול האפליקציה או מוחקים את המשאב הבסיסי. שירותים ועומסי עבודה שהופרדו יישארו באפליקציה עד שתבטלו את הרישום שלהם, אבל מרכז האפליקציות לא יוכל יותר לנהל או לנטר אותם. מידע נוסף זמין במאמר בנושא סטטוס הרישום של שירותים ועומסי עבודה.
כדי לצרף מחדש שירותים או עומסי עבודה לאפליקציה, צריך לרשום אותם מחדש.
איפה אפשר לראות את סכימות המטא-נתונים המורחבות
מרכז האפליקציות מעשיר את השירותים ועומסי העבודה שלכם במטא-נתונים כדי לשפר את יכולת הגילוי, את השליטה ואת השילוב עם מערכות אחרות. אפשר לחפש את סכימות המטא-נתונים הזמינות ולראות את ההגדרות שלהן באמצעות App Hub API.
כדי לראות את הגדרת הסכימה של מאפיין המטא-נתונים המורחבים, פועלים לפי השלבים הבאים:
מידע נוסף על מאפיין המטא-נתונים המורחב זמין במאמר מאפיינים ומאפיינים. רשימה של סוגי המטא-נתונים הנתמכים והסכימות שלהם זמינה במאמר בנושא סכימות מורחבות של מטא-נתונים.
gcloud
הצגת רשימה של כל סכימות המטא-נתונים המורחבות שזמינות בפרויקט ובמיקום:
gcloud alpha apphub extended-metadata-schemas list \ --project=PROJECT_ID \ --location=LOCATION \מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: המזהה של פרויקט הניהול. -
LOCATION: המיקום של הרכיב. משתמשים ב-globalלרכיבים גלובליים או לאזור ספציפי, כמוus-east1לרכיבים אזוריים.
-
כדי לראות את הפרטים של סכימה ספציפית:
gcloud alpha apphub extended-metadata-schemas describe SCHEMA_NAME \ --project=PROJECT_ID \ --location=LOCATION \מחליפים את
SCHEMA_NAMEבשם המלא של הסכימה, לדוגמה,apphub.googleapis.com/AgentProperties.
Terraform
אפשר להשתמש במקור נתונים ב-Terraform כדי לאחזר את הפרטים של סכימה ספציפית. בדוגמה הבאה אפשר לראות את הפרטים של סכימת apphub.googleapis.com/AgentProperties של עומס עבודה עם סוג פונקציונלי AGENT בפרויקט my-project-id במיקום us-central1.
data "google_apphub_extended_metadata_schema" "agent_properties" {
project = "my-project-id"
location = "us-central1"
name = "apphub.googleapis.com/AgentProperties"
}
עדכון מאפייני השירות ועומס העבודה
כדי לשנות את המאפיינים של שירותים ועומסי עבודה שרשומים באפליקציה, פועלים לפי השלבים הבאים:
המסוף
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.
עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:
בדף הזה מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לעדכן את מאפייני השירות או העומס שלה.
בכרטיסייה Services and workloads, מוצאים את השם של השירות או של עומס העבודה שרוצים לעדכן.
לוחצים על more_vert אפשרויות נוספות, ואז לוחצים על עריכת השירות או על עריכת עומס העבודה.
בחלונית שנפתחת, עורכים את השדות לפי הצורך ולוחצים על שמירה.
gcloud
איך מוצאים את מזהה הפרויקט של פרויקט הניהול.
עדכון מאפייני השירות או העומס:
עדכון מאפייני השירות:
gcloud apphub applications services update SERVICE_NAME \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY_LEVEL \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAILמחליפים את
SERVICE_NAMEבשם השירות שרוצים לעדכן.עדכון מאפייני עומס העבודה:
gcloud apphub applications workloads update WORKLOAD_NAME \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATION \ --display-name=DISPLAY_NAME \ --criticality-type=CRITICALITY_LEVEL \ --environment-type=ENVIRONMENT \ --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \ --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \ --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAILמחליפים את
WORKLOAD_NAMEבשם של עומס העבודה שרוצים לעדכן.מחליפים את הדגלים הבאים שחובה למלא או שאפשר למלא:
- חובה:
APPLICATION_NAME: שם האפליקציה. מציינים את הערך הזה כשיוצרים אפליקציה. - חובה:
PROJECT_ID: מזהה פרויקט הניהול. - חובה:
LOCATION: מיקום הרכיב. משתמשים ב-globalלרכיבים גלובליים או באזור ספציפי, כמוus-east1, לרכיבים אזוריים. - אופציונלי:
DISPLAY_NAME: השם לתצוגה של הרכיב. אופציונלי:
CRITICALITY_LEVEL: רמת החשיבות של הרכיב. אפשר להשתמש באחד מהערכים הבאים:MISSION_CRITICALHIGHMEDIUMLOW
אופציונלי:
ENVIRONMENT: השלב במחזור החיים של התוכנה. אפשר להשתמש באחד מהערכים הבאים:PRODUCTIONSTAGINGDEVELOPMENTTEST
אופציונלי:
DEV_NAMEו-DEV_EMAIL: השם המוצג וכתובת האימייל של בעל האפליקציה, בהתאמה.אופציונלי:
OPERATOR_NAMEו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של בעל המפעיל, בהתאמה.אופציונלי:
BUSINESS_NAMEו-BUSINESS_EMAIL: השם לתצוגה וכתובת האימייל של בעל העסק, בהתאמה.
- חובה:
Terraform
כדי לעדכן מאפיינים של שירות או עומס עבודה באמצעות Terraform, משנים את הארגומנטים בבלוק המשאבים המתאים google_apphub_service או google_apphub_workload בקובץ ההגדרות. כשמחילים את השינויים, Terraform מעדכן את המשאב כך שיתאים להגדרות החדשות.
בדוגמאות הבאות מתעדכנים מאפייני הקריטיות והסביבה של שירותים ועומסי עבודה של אפליקציה אזורית:
עדכון מאפייני השירות:
resource "google_apphub_service" "example" { # ... other arguments attributes { criticality { type = "HIGH" # Updated criticality } environment { type = "PRODUCTION" } # ... other attributes } }עדכון מאפייני עומס העבודה:
resource "google_apphub_workload" "example" { # ... other arguments attributes { criticality { type = "HIGH" # Updated criticality } environment { type = "PRODUCTION" } # ... other attributes } }
ביטול הרישום של שירותים ועומסי עבודה
ביטול הרישום של שירות או עומס עבודה מסיר אותם מאפליקציה. המשאב הבסיסי לא נמחק. אם הוא עדיין נמצא בגבולות ניהול האפליקציה, הוא הופך למשאב עם ערך סטטוס רישום של discovered (זוהה), וזמין לרישום באפליקציה אחרת.
כדי לבטל את הרישום של שירותים ועומסי עבודה:
המסוף
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.
עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:
בדף הזה מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לבטל את הרישום שלה לשירותים או לעומסי עבודה.
בכרטיסייה שירותים ועומסי עבודה, לוחצים על השם של השירות או עומס העבודה שרוצים לבטל את הרישום שלהם.
בדף הפרטים של הרכיב, לוחצים על ביטול ההרשמה.
gcloud
איך מוצאים את מזהה הפרויקט של פרויקט הניהול.
ביטול הרישום של שירות או עומס עבודה:
ביטול הרישום של שירות:
gcloud apphub applications services delete SERVICE_NAME \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
SERVICE_NAME: השם של השירות שרוצים לבטל את הרישום שלו. -
APPLICATION_NAME: השם של האפליקציה. מציינים את הערך הזה כשיוצרים אפליקציה. -
PROJECT_ID: המזהה של פרויקט הניהול. -
LOCATION: המיקום של הרכיב. משתמשים ב-globalלרכיבים גלובליים או באזור ספציפי, כמוus-east1, לרכיבים אזוריים.
-
ביטול הרישום של עומס עבודה:
gcloud apphub applications workloads delete WORKLOAD_NAME \ --application=APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONמחליפים את
WORKLOAD_NAMEבשם של עומס העבודה שרוצים לבטל את הרישום שלו.
Terraform
כדי לבטל את הרישום של שירות או עומס עבודה שמנוהלים על ידי Terraform, מסירים את בלוק המשאבים התואם google_apphub_service או google_apphub_workload מקובץ ההגדרות ומריצים את הפקודה terraform apply. כשמחילים את השינויים, Terraform מסירה את הרישום ממרכז האפליקציות.
אחרי שמבטלים את הרישום של כל השירותים ועומסי העבודה, אפשר למחוק את האפליקציה.