בעזרת App Hub אתם יכולים לנהל שירותים ועומסי עבודה שרשומים ישירות או שזוהו, כדי לשמור על הדיוק של המטא-נתונים של האפליקציה. אם התשתית משתנה, אתם יכולים לראות את פרטי הרכיבים, לעדכן מאפיינים או לבטל את הרישום של רכיבים באפליקציה.
באפליקציות שנפרסו מתבנית, מעדכנים את הרכיבים ב-Application Design Center.
סקירה כללית
כשאתם בוחרים את מודל הגדרת האפליקציה, אתם מגדירים תחום לניהול אפליקציות לאפליקציות של App Hub בפרויקט ניהול. לאחר מכן תוכלו לרשום שירותים ועומסי עבודה באפליקציות בתוך הגבול הזה. במאמר הכנה לניהול מחזור החיים של אפליקציות מפורטים תרחישים לדוגמה שמומלץ להשתמש בהם כדי להציג שיטות לניהול אפליקציות.
כדי למנוע שינויים בהגדרות ולשמור על מקור מידע מהימן וברור, מומלץ לנהל את רכיבי האפליקציה בסביבה שבה הם הוגדרו במקור:
לאפליקציות שנפרסו מתבנית של Application Design Center: משתמשים ב-Application Design Center כדי לנהל ולעדכן את האפליקציה. אתם יכולים לשנות את התבנית כדי לשנות את עיצוב האפליקציה, או ליצור גרסה חדשה של האפליקציה כדי לעדכן הגדרות כמו פרטי האפליקציה והרכיבים.
לאפליקציות שנוצרו על ידי רישום משאבים קיימים ב-App Hub: ניהול אפליקציות, שירותים ועומסי עבודה ישירות ב-App Hub.
לפני שמתחילים
במסמך הזה אנחנו מניחים שיש לכם אפליקציה עם משאבים נתמכים שרשומים בה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לניהול שירותים ועומסי עבודה ב-App Hub, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט הניהול שמגדיר את התחום לניהול אפליקציות:
-
עדכון וביטול הרישום של שירותים ועומסי עבודה:
עריכה ב-App Hub (
roles/apphub.editor) -
צפייה בשירותים, בעומסי עבודה ובפרטים שלהם:
צפייה ב-App Hub (
roles/apphub.viewer)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
למידע נוסף על התפקידים ב-App Hub, קראו את המאמר תפקידים והרשאות של IAM ב-App Hub.
הצגת פרטים של שירותים ועומסי עבודה
כדי לראות את הפרטים של השירותים ועומסי העבודה בתחום לניהול האפליקציות, כולל הפרטים הבאים, פועלים לפי השלבים הבאים:
למידע נוסף על הפרטים האלה, ראו המושגים ומודל הנתונים של App Hub.
המסוף
כדי להציג פרטים של שירותים ועומסי עבודה של אפליקציה עם ערך סטטוס הרישום registered או detached:
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את הפרויקט לניהול.
עוברים לדף Applications מ-App Hub:
בדף מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לראות את פרטי השירות או עומס העבודה שלה.
בכרטיסייה Services and workloads, לוחצים על שם השירות או עומס העבודה שרוצים לראות.
בדף Details של הרכיב, אפשר לראות מידע כמו השם המוצג, המיקום, סטטוס הרישום, המאפיינים והתכונות.
לחלופין, אפשר להציג רשימה של כל השירותים ועומסי העבודה עם ערך סטטוס הרישום discovered או registered:
עוברים לדף Services and workloads מ-App Hub:
כניסה לדף 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. למידע נוסף, קראו את המאמר סטטוס הרישום של שירותים ועומסי עבודה.
כדי לצרף מחדש שירותים או עומסי עבודה לאפליקציה, צריך לרשום אותם שוב.
הצגת סכימות מורחבות של מטא-נתונים
App Hub מעשיר את השירותים ועומסי העבודה שלכם במטא-נתונים כדי לשפר את יכולת הגילוי, את הפיקוח ואת השילוב עם מערכות אחרות. אתם יכולים לחפש את הסכימות הזמינות של המטא-נתונים ולראות את ההגדרות שלהן באמצעות 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 מ-App Hub:
בדף מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לעדכן את מאפייני השירות או עומס העבודה שלה.
בכרטיסייה Services and workloads, מוצאים את השם של השירות או של עומס העבודה שרוצים לעדכן.
לוחצים על more_vert More, ואז על Edit service או על Edit workload.
בחלונית שנפתחת, עורכים את השדות לפי הצורך ולוחצים על שמירה.
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 } }
ביטול הרישום של שירותים ועומסי עבודה
ביטול הרישום של שירות או עומס עבודה מסיר אותם מהאפליקציה. המשאב הבסיסי לא נמחק. אם הוא עדיין נמצא בתחום לניהול אפליקציות, הוא הופך למשאב עם סטטוס הרישום זוהה, וזמין לרישום באפליקציה אחרת.
כדי לבטל את הרישום של שירותים ועומסי עבודה:
המסוף
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את הפרויקט לניהול.
עוברים לדף Applications מ-App Hub:
בדף מופיעה רשימה של האפליקציות שלכם.
לוחצים על שם האפליקציה שרוצים לבטל את הרישום של השירותים או עומסי העבודה שלה.
בכרטיסייה Services and workloads, לוחצים על שם השירות או עומס העבודה שרוצים לבטל את הרישום שלו.
בדף הפרטים של הרכיב, לוחצים על ביטול הרישום.
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 מסירה את הרישום מ-App Hub.
אחרי שמבטלים את הרישום של כל השירותים ועומסי העבודה, אפשר למחוק את האפליקציה.