רישום המשאבים הקיימים ב- Google Cloud כשירותים ועומסי עבודה באפליקציה של App Hub מאפשר לכם לארגן את המשאבים לפי המטרה העסקית שלהם, וכך לפשט את הניהול. הגישה הזו מספקת ניראות, מעקב, פיקוח ושליטה תפעולית מאוחדים.
במדריך הזה נסביר איך לקבץ משאבים קיימים ב- Google Cloud שעדיין לא מוגדרים באופן רשמי כאפליקציה.
לפני שמתחילים
לפני שתוכלו לארגן משאבים באפליקציות, תצטרכו להשלים את ההגדרה הראשונית של ניהול האפליקציות. בדרך כלל התהליך הזה כולל את התפקידים והשלבים הבאים:
לאדמינים:
- בוחרים את מודל הגדרת האפליקציה. צריך להגדיר פרויקט ניהול ולקבוע תחום לניהול אפליקציות שכולל את משאבי Google Cloud שרוצים לארגן.
- מפעילים את ממשקי ה-API הנדרשים לכל המשאבים של Google Cloud שבהם רוצים להשתמש.
- לתת למשתמשים גישה. מקצים תפקידים מתאימים ב-IAM בהתאם לתחומי האחריות של המשתמש במחזור החיים של האפליקציה.
למפתחים ולמפעילים:
- מוודאים עם האדמין שההגדרה הראשונית הושלמה.
- ודאו שיש לכם את התפקידים הנדרשים ב-IAM למשימות שאתם רוצים לבצע.
- פותחים את הפרויקט לניהול במסוף Google Cloud או מאתרים את מזהה הפרויקט של הפרויקט לניהול, כדי לבצע אינטראקציות עם Terraform או עם Google Cloud CLI.
יצירת אפליקציה
יוצרים אפליקציה ב-App Hub שתשמש כמאגר לוגי למשאבי Google Cloud הקיימים:
המסוף
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את הפרויקט לניהול.
עוברים לדף Applications מ-App Hub:
לוחצים על Create application.
בכרטיסייה Application details, בוחרים את המיקום הכי מתאים לאפליקציה בהתאם לדרישות ההפצה הגיאוגרפית:
- בוחרים באפשרות Global כדי ליצור אפליקציה גלובלית.
- כדי ליצור אפליקציה במספר אזורים, בוחרים באפשרות Multi-regional.
לאחר מכן, בוחרים באפשרות של מספר אזורים נתמכים (
usאוeu) לאפליקציה. - כדי ליצור אפליקציה אזורית, בוחרים באפשרות Regional. לאחר מכן, בוחרים את האזור הספציפי של האפליקציה על סמך האזורים הנתמכים ב-App Hub.
למידע נוסף על המיקום הכי טוב לאפליקציה, קראו את המאמר אפליקציות גלובליות, אזוריות ובמספר אזורים.
נותנים שם לאפליקציה.
השם הזה הוא מזהה ייחודי שיכול להכיל רק אותיות קטנות, מספרים או מקפים. אי אפשר לשנות את השם הזה אחרי שיוצרים את האפליקציה.
אם רוצים, מוסיפים שם לתצוגה ותיאור לאפליקציה.
אלה לא מזהים ייחודיים, ואפשר לשנות אותם אחרי שיוצרים את האפליקציה.
לוחצים על Continue.
בכרטיסייה Application resources, מעיינים במשאבי התשתית ובוחרים את תיבות הסימון של המשאבים שרוצים לרשום כשירותים וכעומסי עבודה של האפליקציה.
אפשר לבחור עד 10 משאבים בכל פעם.
לוחצים על Continue.
בכרטיסייה Attributes and owners אפשר להוסיף מאפיינים לאפליקציה, כמו רמת קריטיות, סביבה ובעלי האפליקציה.
אתם יכולים להשתמש באותם מאפיינים ובעלים למשאבים שאתם רושמים לאפליקציה, או להגדיר אותם מאוחר יותר.
לוחצים על יצירה.
אחרי שיוצרים את האפליקציה, בדף Applications מוצגים הפרטים שלה, כולל המשאבים שרשמתם כשירותים וכעומסי עבודה. אחרי שיוצרים את האפליקציה, אפשר לרשום אליה עוד שירותים ועומסי עבודה.
gcloud
משתמשים ב-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_CRITICALHIGHMEDIUMLOW
אופציונלי:
ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:PRODUCTIONSTAGINGDEVELOPMENTTEST
אופציונלי:
DEV_NAMEו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.אופציונלי:
OPERATOR_NAMEו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.אופציונלי:
BUSINESS_NAMEו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.
- חובה:
מציגים את רשימת האפליקציות בפרויקט:
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 יזהה אותם גם אם הם כבר רשומים לאפליקציה אחרת, אבל יכול להיות שלא תוכלו לשנות את המאפיינים שלהם.
המסוף
אחרי שיוצרים אפליקציה, אפשר לרשום בה כמה משאבים:
במסוף Google Cloud , משתמשים בכלי לבחירת פרויקטים כדי לבחור את הפרויקט לניהול.
עוברים לדף Applications מ-App Hub:
לוחצים על שם האפליקציה שרוצים לרשום את המשאבים שלGoogle Cloud .
בדף של האפליקציה, בוחרים בכרטיסייה Services and workloads.
לוחצים על Register services or workloads.
בכרטיסייה Services and workloads, עוברים על משאבי התשתית ובוחרים את תיבות הסימון של המשאבים שרוצים לרשום כשירותים או כעומסי עבודה של האפליקציה.
אפשר לבחור עד 10 משאבים בכל פעם.
לוחצים על Continue.
בכרטיסייה Attributes and owners אפשר להוסיף מאפיינים למשאבים האלה, כמו רמת קריטיות, סביבה ובעלי המשאבים.
אתם יכולים להשתמש באותם מאפיינים ובעלים מהאפליקציה או להגדיר מאפיינים אחרים מאוחר יותר.
לוחצים על הרשמה.
בכרטיסייה Services and workloads מוצגים כל השירותים ועומסי העבודה הרשומים של האפליקציה.
gcloud
ב-App Hub אתם יכולים לבחור משאבים נתמכים שנמצאים בתחום לניהול אפליקציות כשירותים או כעומסי עבודה. אתם יכולים להשתמש ב-Google Cloud CLI כדי להציג רשימה של שירותים או עומסי עבודה שאפשר לרשום לאפליקציה מהטרמינל או מ-Cloud Shell. הפקודות לשירותים ולעומסי עבודה שונות קצת:
רישום שירותים
מציגים את השירותים הזמינים שאפשר לרשום לאפליקציה:
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_IDservice_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'}- חובה:
מעתיקים את מזהה השירות,
SERVICE_ID, מהפלט.רושמים את השירות לאפליקציה:
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_CRITICALHIGHMEDIUMLOW
אופציונלי:
ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:PRODUCTIONSTAGINGDEVELOPMENTTEST
אופציונלי:
DEV_NAMEו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.אופציונלי:
OPERATOR_NAMEו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.אופציונלי:
BUSINESS_NAMEו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.
- חובה:
מפרטים את השירותים הרשומים באפליקציה:
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
רישום עומסי עבודה
מציגים את רשימת עומסי העבודה הזמינים שאפשר לרשום לאפליקציה:
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'}- חובה:
מעתיקים את מזהה עומס העבודה,
WORKLOAD_ID, מהפלט.רושמים את עומס העבודה באפליקציה:
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_CRITICALHIGHMEDIUMLOW
אופציונלי:
ENVIRONMENT: השלב במחזור החיים של התוכנה. משתמשים באחד מהערכים הבאים:PRODUCTIONSTAGINGDEVELOPMENTTEST
אופציונלי:
DEV_NAMEו-DEV_EMAIL: השם המוצג וכתובת האימייל של הבעלים של חשבון הפיתוח, בהתאמה.אופציונלי:
OPERATOR_NAMEו-OPERATOR_EMAIL: השם המוצג וכתובת האימייל של הבעלים של המפעיל, בהתאמה.אופציונלי:
BUSINESS_NAMEו-BUSINESS_EMAIL: השם המוצג וכתובת האימייל של בעל העסק, בהתאמה.
- חובה:
מציגים את רשימת עומסי העבודה הרשומים באפליקציה:
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 כדי לרשום שירותים או עומסי עבודה, בהתאמה.
רישום שירותים
כדי לקבל מידע על שירות באמצעות ה-URI שלו:
data "google_apphub_discovered_service" "my-service" { location = "LOCATION" service_uri = "SERVICE_URI" }רושמים את השירות שזוהה באפליקציה, לדוגמה:
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." }
רישום עומסי עבודה
כדי לקבל מידע על עומס עבודה באמצעות ה-URI שלו:
data "google_apphub_discovered_workload" "my-workload" { location = "LOCATION" workload_uri = "WORKLOAD_URI" }רושמים את עומס העבודה שזוהה באפליקציה, לדוגמה:
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, צריך לתת למשתמשים גישה על סמך תחומי האחריות שלהם במחזור החיים, כדי לנהל את הקיבוץ הלוגי הזה כיחידה אחת:
- בהתאם לצורכי הגישה שלכם, אתם יכולים לתת הרשאות לאפליקציות ספציפיות או לכל האפליקציות. רשימת התפקידים המומלצים
- אם רוצים, אפשר לעבור אל Cloud Hub כדי לראות מרכז בקרה תפעולי מאוחד לאפליקציה שהגדרתם, כולל נתוני התקינות, הביצועים והעלות שלה.