רישום של משאבים קיימים באפליקציה

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

במדריך הזה נסביר איך לקבץ משאבים קיימים ב- Google Cloud שעדיין לא מוגדרים באופן רשמי כאפליקציה.

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

לפני שתוכלו לארגן משאבים באפליקציות, תצטרכו להשלים את ההגדרה הראשונית של ניהול האפליקציות. בדרך כלל התהליך הזה כולל את התפקידים והשלבים הבאים:

יצירת אפליקציה

יוצרים אפליקציה ב-App Hub שתשמש כמאגר לוגי למשאבי Google Cloud הקיימים:

המסוף

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

  2. עוברים לדף Applications מ-App Hub:

    מעבר אל Applications

  3. ‫לוחצים על Create application.

  4. בכרטיסייה Application details, בוחרים את המיקום הכי מתאים לאפליקציה בהתאם לדרישות ההפצה הגיאוגרפית:

    • בוחרים באפשרות Global כדי ליצור אפליקציה גלובלית.
    • כדי ליצור אפליקציה במספר אזורים, בוחרים באפשרות Multi-regional. לאחר מכן, בוחרים באפשרות של מספר אזורים נתמכים (us או eu) לאפליקציה.
    • כדי ליצור אפליקציה אזורית, בוחרים באפשרות Regional. לאחר מכן, בוחרים את האזור הספציפי של האפליקציה על סמך האזורים הנתמכים ב-App Hub.

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

  5. נותנים שם לאפליקציה.

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

  6. אם רוצים, מוסיפים שם לתצוגה ותיאור לאפליקציה.

    אלה לא מזהים ייחודיים, ואפשר לשנות אותם אחרי שיוצרים את האפליקציה.

  7. לוחצים על Continue.

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

    אפשר לבחור עד 10 משאבים בכל פעם.

  9. לוחצים על Continue.

  10. בכרטיסייה Attributes and owners אפשר להוסיף מאפיינים לאפליקציה, כמו רמת קריטיות, סביבה ובעלי האפליקציה.

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

  11. לוחצים על יצירה.

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

gcloud

  1. משתמשים ב-Google Cloud CLI כדי ליצור אפליקציה מהטרמינל או מ-Cloud Shell:

    gcloud apphub applications create APPLICATION_NAME \
      --project=PROJECT_ID \
      --scope-type=SCOPE_TYPE \
      --location=LOCATION \
      --display-name=DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --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
    

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

    משתמשים בדגלים אופציונליים כמו --criticality-type כדי להגדיר את המאפיינים ברמה העליונה של האפליקציה, ולתמוך ביכולת הגילוי ובפיקוח.

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

    • חובה: PROJECT_ID: המזהה של פרויקט הניהול.
    • חובה: SCOPE_TYPE: המיקום של האפליקציה, בהתאם לדרישות ההפצה הגיאוגרפית. משתמשים באחד מהערכים הבאים:

      • ‫REGIONAL לאפליקציות אזוריות.
      • ‫MULTI_REGIONAL לאפליקציות במספר אזורים.
      • GLOBAL לאפליקציות גלובליות.

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

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

      • אם המיקום של האפליקציה ב---scope-type מוגדר כ-REGIONAL, צריך לציין שם של אזור שנתמך ב-App Hub.
      • אם המיקום של --scope-type באפליקציה מוגדר ל-MULTI_REGIONAL, צריך לציין את us או את eu.
      • אם המיקום של --scope-type באפליקציה מוגדר ל-GLOBAL, צריך להשתמש ב-global.
    • אופציונלי: DISPLAY_NAME: השם המוצג של האפליקציה. השם המוצג הוא לא מזהה ייחודי, ואפשר לשנות אותו אחרי שיוצרים את האפליקציה.

    • אופציונלי: CRITICALITY: רמת החשיבות של האפליקציה לפעילות שלכם. משתמשים באחד מהערכים הבאים:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • אופציונלי: ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • אופציונלי: DEV_NAME ו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.

    • אופציונלי: OPERATOR_NAME ו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.

    • אופציונלי: BUSINESS_NAME ו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.

  2. מציגים את רשימת האפליקציות בפרויקט:

    gcloud apphub applications list \
      --project=PROJECT_ID \
      --location=LOCATION
    

    הפלט אמור להיראות כך:

    ID                 DISPLAY_NAME   CREATE_TIME
    APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48
    

Terraform

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

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

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    scope {
        type = "REGIONAL"
    }
    attributes {
        criticality {
            type = "MISSION_CRITICAL"
        }
        environment {
            type = "PRODUCTION"
        }
        business_owners {
            display_name = "Alice"
            email        = "alice@example.com"
        }
        developer_owners {
            display_name = "Bob"
            email        = "bob@example.com"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "charlie@example.com"
        }
    }
}

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

ב-App Hub אתם יכולים לבחור משאבים נתמכים שנמצאים בתחום לניהול האפליקציות, כדי לרשום אותם כשירותים וכעומסי עבודה. אחרי שיוצרים אפליקציה, אפשר לרשום בה משאבי Google Cloudכשירותים וכעומסי עבודה.

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

המסוף

אחרי שיוצרים אפליקציה, אפשר לרשום בה כמה משאבים:

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

  2. עוברים לדף Applications מ-App Hub:

    מעבר אל Applications

  3. לוחצים על שם האפליקציה שרוצים לרשום את המשאבים שלGoogle Cloud .

  4. בדף של האפליקציה, בוחרים בכרטיסייה Services and workloads.

  5. לוחצים על Register services or workloads.

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

    אפשר לבחור עד 10 משאבים בכל פעם.

  7. לוחצים על Continue.

  8. בכרטיסייה Attributes and owners אפשר להוסיף מאפיינים למשאבים האלה, כמו רמת קריטיות, סביבה ובעלי המשאבים.

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

  9. לוחצים על הרשמה.

בכרטיסייה Services and workloads מוצגים כל השירותים ועומסי העבודה הרשומים של האפליקציה.

gcloud

ב-App Hub אתם יכולים לבחור משאבים נתמכים שנמצאים בתחום לניהול אפליקציות כשירותים או כעומסי עבודה. אתם יכולים להשתמש ב-Google Cloud CLI כדי להציג רשימה של שירותים או עומסי עבודה שאפשר לרשום לאפליקציה מהטרמינל או מ-Cloud Shell. הפקודות לשירותים ולעומסי עבודה שונות קצת:

רישום שירותים

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

    gcloud apphub discovered-services list \
      --project=PROJECT_ID \
      --location=REGION \
      --filter=FILTER_EXPRESSION
    

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

    • חובה: PROJECT_ID: המזהה של פרויקט הניהול.
    • חובה: REGION: המיקום הספציפי של השירות שלכם, בהתאם לתפוצה הגיאוגרפית. משתמשים באחד מהערכים הבאים:

      • אם השירות הוא אזורי, מציינים את שם האזור שנתמך ב-App Hub.
      • אם השירות הוא במספר אזורים, צריך לציין את הערך us או eu.
      • אם השירות הוא גלובלי, משתמשים ב-global.
    • ‫FILTER_EXPRESSION (אופציונלי): ביטוי הסינון של הדגל --filter, כדי להציג רק שירותים מפרויקט מסוים בתחום לניהול אפליקציות או עם מאפיין מסוים, לדוגמה:

      • service_properties.gcp_project=projects/PROJECT_ID
      • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"

    הפלט אמור להיראות כך:

    ID            SERVICE_REFERENCE                                                                                             SERVICE_PROPERTIES
    SERVICE_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. מעתיקים את מזהה השירות, SERVICE_ID, מהפלט.

  3. רושמים את השירות לאפליקציה:

    gcloud apphub applications services create SERVICE_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION \
      --application=APPLICATION_NAME \
      --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \
      --display-name=SERVICE_DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --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 בשם שרוצים להשתמש בו כדי לרשום את השירות לאפליקציה.

    משתמשים בדגלים אופציונליים כמו --criticality-type כדי להגדיר את המאפיינים ברמה העליונה של השירות, ולתמוך ביכולת הגילוי ובפיקוח.

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

    • חובה: PROJECT_ID: המזהה של פרויקט הניהול.
    • חובה: APPLICATION_LOCATION: המיקום של האפליקציה. משתמשים באחד מהערכים הבאים:

      • אם האפליקציה היא אזורית, צריך לציין את שם האזור שנתמך ב-App Hub.
      • אם האפליקציה היא במספר אזורים, צריך לציין את us או את eu.
      • אם האפליקציה גלובלית, משתמשים ב-global.
    • חובה: APPLICATION_NAME: שם האפליקציה שבה רוצים לרשום את השירות.

    • חובה: REGION: המיקום של השירות שזוהה מהפלט הקודם.

    • חובה: SERVICE_ID: מזהה השירות שהעתקתם מהפלט הקודם.

    • ‫SERVICE_DISPLAY_NAME (אופציונלי): השם המוצג של השירות.

    • ‫CRITICALITY (אופציונלי): רמת החשיבות של השירות לפעילות שלכם. משתמשים באחד מהערכים הבאים:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • אופציונלי: ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • אופציונלי: DEV_NAME ו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.

    • אופציונלי: OPERATOR_NAME ו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.

    • אופציונלי: BUSINESS_NAME ו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.

  4. מפרטים את השירותים הרשומים באפליקציה:

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION
    

    הפלט שמתקבל לכל שירות רשום אמור להיראות כך:

    ID              DISPLAY_NAME            SERVICE_REFERENCE                                                                                             CREATE_TIME
    SERVICE_NAME    SERVICE_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    2023-11-01T21:38:08
    

רישום עומסי עבודה

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

    gcloud apphub discovered-workloads list \
      --project=PROJECT_ID \
      --location=REGION \
      --filter=FILTER_EXPRESSION
    

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

    • חובה: PROJECT_ID: המזהה של פרויקט הניהול.
    • ‫REGION: המיקום הספציפי של עומס העבודה, בהתאם לפריסה הגיאוגרפית. משתמשים באחד מהערכים הבאים:

      • אם עומס העבודה הוא אזורי, מציינים את שם האזור שנתמך ב-App Hub.
      • אם עומס העבודה הוא במספר אזורים, מציינים את us או את eu.
      • אם עומס העבודה הוא גלובלי, משתמשים ב-global.
    • ‫FILTER_EXPRESSION (אופציונלי): ביטוי הסינון של הדגל --filter, כדי להציג רק עומסי עבודה מפרויקט מסוים בתחום לניהול אפליקציות או עם מאפיין מסוים, לדוגמה workload_properties.gcp_project=projects/PROJECT_ID.

    הפלט אמור להיראות כך:

    ID             WORKLOAD_REFERENCE                                                                                    WORKLOAD_PROPERTIES
    WORKLOAD_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. מעתיקים את מזהה עומס העבודה, WORKLOAD_ID, מהפלט.

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

    gcloud apphub applications workloads create WORKLOAD_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION \
      --application=APPLICATION_NAME \
      --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \
      --display-name=WORKLOAD_DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --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 בשם שבו רוצים להשתמש כדי לרשום את עומס העבודה לאפליקציה.

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

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

    • חובה: PROJECT_ID: המזהה של פרויקט הניהול.
    • חובה: APPLICATION_LOCATION: המיקום של האפליקציה. משתמשים באחד מהערכים הבאים:

      • אם האפליקציה היא אזורית, צריך לציין את שם האזור שנתמך ב-App Hub.
      • אם האפליקציה היא במספר אזורים, צריך לציין את us או את eu.
      • אם האפליקציה גלובלית, משתמשים ב-global.
    • ‫APPLICATION_NAME: השם של האפליקציה שרוצים לרשום את עומס העבודה בשבילה.

    • ‫REGION: המיקום של עומס העבודה שזוהה מהפלט הקודם.

    • חובה: WORKLOAD_ID: מזהה עומס העבודה שהעתקתם מהפלט הקודם.

    • ‫WORKLOAD_DISPLAY_NAME: השם המוצג של עומס העבודה (אופציונלי).

    • ‫CRITICALITY (אופציונלי): רמת החשיבות של עומס העבודה לפעולות שלכם. משתמשים באחד מהערכים הבאים:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • אופציונלי: ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • אופציונלי: DEV_NAME ו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.

    • אופציונלי: OPERATOR_NAME ו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.

    • אופציונלי: BUSINESS_NAME ו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.

  4. מציגים את רשימת עומסי העבודה הרשומים באפליקציה:

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION
    

    צריך לקבל פלט שדומה לזה שלמטה לכל עומס עבודה רשום:

    ID               DISPLAY_NAME             WORKLOAD_REFERENCE                                                                                    CREATE_TIME
    WORKLOAD_NAME    WORKLOAD_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    2023-11-01T21:38:08
    

Terraform

כדי להשתמש ב-Terraform כדי לרשום משאבים של Google Cloud בתחום לניהול האפליקציות כשירותים או כעומסי עבודה באפליקציה, צריך להשתמש במקורות הנתונים google_apphub_discovered_service ו-google_apphub_discovered_workload כדי לאחזר באופן דינמי מידע על המשאבים שרוצים לרשום.

אחר כך משתמשים במשאבים google_apphub_service או google_apphub_workload כדי לרשום שירותים או עומסי עבודה, בהתאמה.

רישום שירותים

  1. כדי לקבל מידע על שירות באמצעות ה-URI שלו:

    data "google_apphub_discovered_service" "my-service" {
        location = "LOCATION"
        service_uri = "SERVICE_URI"
    }
    
  2. רושמים את השירות שזוהה באפליקציה, לדוגמה:

    resource "google_apphub_service" "example" {
        project            = "my-project-id"
        location           = "us-central1"
        application_id     = google_apphub_application.example.application_id
        service_id         = "frontend-load-balancer"
        discovered_service = data.google_apphub_discovered_service.my-forwarding-rule.name
        display_name       = "Frontend Load Balancer"
        description        = "The primary load balancer for the frontend."
    }
    

רישום עומסי עבודה

  1. כדי לקבל מידע על עומס עבודה באמצעות ה-URI שלו:

    data "google_apphub_discovered_workload" "my-workload" {
        location = "LOCATION"
        workload_uri = "WORKLOAD_URI"
    }
    
  2. רושמים את עומס העבודה שזוהה באפליקציה, לדוגמה:

    resource "google_apphub_workload" "example" {
        project             = "my-project-id"
        location            = "us-central1"
        application_id      = google_apphub_application.example.application_id
        workload_id         = "frontend-instance-group"
        discovered_workload = data.google_apphub_discovered_workload.my-mig.name
        display_name        = "Frontend Instance Group"
        description         = "The managed instance group for the frontend."
    }
    

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

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

מתן הרשאות והתחלת הפעולות

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

  1. בהתאם לצורכי הגישה שלכם, אתם יכולים לתת הרשאות לאפליקציות ספציפיות או לכל האפליקציות. רשימת התפקידים המומלצים
  2. אם רוצים, אפשר לעבור אל Cloud Hub כדי לראות מרכז בקרה תפעולי מאוחד לאפליקציה שהגדרתם, כולל נתוני התקינות, הביצועים והעלות שלה.