ניהול שירותים ועומסי עבודה

כשבוחרים את מודל הגדרת האפליקציה, מגדירים גבול לניהול האפליקציה עבור האפליקציות ב-App Hub בפרויקט ניהול. לאחר מכן תוכלו לרשום שירותים ועומסי עבודה באפליקציות בתוך הגבול הזה. תרחישים מומלצים להטמעת שיטות לניהול אפליקציות מפורטים במאמר הכנה לניהול מחזור החיים של אפליקציות.

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

בדף הזה מוסבר איך לנהל שירותים ועומסי עבודה שמתגלים או נרשמים ישירות ב-App Hub. אפשר לבצע את הפעולות האלה באמצעות מסוף Google Cloud או Google Cloud CLI. לגבי אפליקציות שנפרסו מתבנית, אפשר לעיין במסמכים של מרכז עיצוב האפליקציות.

לפני שמתחילים

במסמך הזה אנחנו מניחים שיש לכם אפליקציה עם משאבים נתמכים שרשומים בה.

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

כדי לקבל את ההרשאות שדרושות לניהול שירותים ועומסי עבודה ב-App Hub, צריך לבקש מהאדמין לתת לכם את תפקידי ה-IAM הבאים בפרויקט הניהול שבו מוגדר הגבול של ניהול האפליקציה:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

מידע נוסף על תפקידים ב-App Hub זמין במאמר תפקידים והרשאות ב-IAM ב-App Hub.

הצגת פרטים של שירותים ועומסי עבודה

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

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

המסוף

צפייה בפרטים משירותים ומעומסי עבודה של אפליקציה עם ערך סטטוס רישום של registered או detached:

  1. במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.

  2. עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:

    מעבר אל Applications

    בדף הזה מופיעה רשימה של האפליקציות שלכם.

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

  4. בכרטיסייה Services and workloads (שירותים ועומסי עבודה), לוחצים על שם השירות או עומס העבודה שרוצים לראות.

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

לחלופין, אפשר להציג רשימה של כל השירותים ועומסי העבודה עם ערך סטטוס רישום של discovered או registered:

  1. עוברים לדף שירותים ועומסי עבודה ממרכז האפליקציות:

    כניסה לדף Services and workloads

    בדף הזה מוצגת רשימה של כל השירותים ועומסי העבודה שזוהו ונרשמו.

  2. כדי לצמצם את התוצאות לפי מאפיינים, תכונות או סטטוס, אפשר להשתמש בשדה Filter ולהזין ערכים כמו Environment,‏ Owners או Registration status.

gcloud

צפייה בפרטים משירותים ומעומסי עבודה של אפליקציה עם ערך סטטוס רישום של registered או detached:

  1. איך מוצאים את מזהה הפרויקט של פרויקט הניהול.

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

    • תארו שירות:

      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 כדי להציג את המשאבים שזוהו:

  1. רשימת השירותים שזוהו:

    gcloud apphub discovered-services list \
        --project=PROJECT_ID \
        --location=LOCATION
    

    מחליפים את מה שכתוב בשדות הבאים:

    • PROJECT_ID: המזהה של פרויקט הניהול.
    • LOCATION: המיקום שבו רוצים לגלות משאבים. משתמשים בערך global למשאבים גלובליים או באזור ספציפי, כמו us-east1, למשאבים אזוריים.
  2. הצגת רשימה של עומסי עבודה שנמצאו:

    gcloud apphub discovered-workloads list \
        --project=PROJECT_ID \
        --location=LOCATION
    

רשום

שירותים ועומסי עבודה רשומים הם חלק מאפליקציה. כדי להציג רשימה של רכיבים רשומים של אפליקציה מסוימת, פועלים לפי השלבים הבאים. אפשר לסנן את הרשימה לפי מאפיינים באמצעות הדגל --filter:

  1. כדי להציג רשימה של שירותים רשומים באפליקציה:

    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.
  2. כדי לראות את רשימת עומסי העבודה הרשומים באפליקציה:

    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"
}

עדכון מאפייני השירות ועומס העבודה

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

המסוף

  1. במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.

  2. עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:

    מעבר אל Applications

    בדף הזה מופיעה רשימה של האפליקציות שלכם.

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

  4. בכרטיסייה Services and workloads, מוצאים את השם של השירות או של עומס העבודה שרוצים לעדכן.

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

  6. בחלונית שנפתחת, עורכים את השדות לפי הצורך ולוחצים על שמירה.

gcloud

  1. איך מוצאים את מזהה הפרויקט של פרויקט הניהול.

  2. עדכון מאפייני השירות או העומס:

    • עדכון מאפייני השירות:

      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_CRITICAL
        • HIGH
        • MEDIUM
        • LOW
      • אופציונלי: ENVIRONMENT: השלב במחזור החיים של התוכנה. אפשר להשתמש באחד מהערכים הבאים:

        • PRODUCTION
        • STAGING
        • DEVELOPMENT
        • TEST
      • אופציונלי: 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 (זוהה), וזמין לרישום באפליקציה אחרת.

כדי לבטל את הרישום של שירותים ועומסי עבודה:

המסוף

  1. במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את פרויקט הניהול.

  2. עוברים לדף Applications (אפליקציות) ממרכז האפליקציות:

    מעבר אל Applications

    בדף הזה מופיעה רשימה של האפליקציות שלכם.

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

  4. בכרטיסייה שירותים ועומסי עבודה, לוחצים על השם של השירות או עומס העבודה שרוצים לבטל את הרישום שלהם.

  5. בדף הפרטים של הרכיב, לוחצים על ביטול ההרשמה.

gcloud

  1. איך מוצאים את מזהה הפרויקט של פרויקט הניהול.

  2. ביטול הרישום של שירות או עומס עבודה:

    • ביטול הרישום של שירות:

      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 מסירה את הרישום ממרכז האפליקציות.

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

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