מחזור החיים של חבילה
בדף הזה מתואר מחזור החיים של חבילה ב-Manufacturing Data Engine (MDE).
העלאת חבילת הגדרות חדשה
אפשר להעלות חבילת הגדרות חדשה של MDE באמצעות נקודת קצה של REST או מממשק האינטרנט של MDE, על ידי העלאה של קובץ *.zip יחיד.
REST
מריצים את בקשת ה-API בארכיטקטורת REST עם הפרטים הבאים:
- Method: POST.
- נקודת קצה (endpoint):
/configuration/v1/configuration-packages. - גוף הבקשה:
multiform data with key=”packageArchive”, value=configuration-package-zip file. - קוד תגובה: 200 OK.
גוף התגובה (JSON):
{ "id": "4adaecc2-54b9-482b-90d6-380f5d4b2be6", "name": "basic-configuration", "provider": "google", "latestStatus": "ACTIVATED", "status": [ { "code": "NOT_LOADED", "updatedTime": "1742566718210", "messages": [] }, { "code": "VALIDATED", "updatedTime": "1742566718210", "messages": [ { "severity": "INFO", "message": "Successfully validated all message classes in the package" }, { "severity": "INFO", "message": "Successfully validated all parsers in the package" }, { "severity": "INFO", "message": "Successfully validated all types in the package" } ] }, { "code": "LOADED", "updatedTime": "1742566718696", "messages": [ { "severity": "INFO", "message": "Successfully applied all message classes in the package" }, { "severity": "INFO", "message": "Successfully applied all types in the package" }, { "severity": "INFO", "message": "Successfully applied all parsers in the package" } ] }, { "code": "ACTIVATED", "updatedTime": "1742566718792", "messages": [ { "severity": "INFO", "message": "Successfully activated all ingestion-specification, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all message classes, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all buckets, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all metadata instance, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all types, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all parsers, if there is any, in the package" } ] } ] }
המסוף
- לוחצים על Cloud Configuration (הגדרת ענן).
- לוחצים על הוספת חבילת הגדרות חדשה.
- בוחרים את הקובץ שרוצים להעלות למסוף.
- לוחצים על העלאה.
אחרי שהחבילה מועלית, MDE מעבד אותה על ידי הרצת השלבים הבאים:
אימות: בשלב הזה, MDE מאמת את התוכן של החבילה, מוודא שכל הקבצים תקינים מבחינת התחביר ושנמצאים במקום הנכון. אם השלב הזה הושלם בהצלחה, MDE עובר לשלב הבא.
טעינה: בשלב הזה, MDE מנסה לטעון ולמזג את ההגדרות שצוינו בחבילה עם ההגדרות הנוכחיות של הסביבה. הוא בודק את כל התלות ומוודא שאין התנגשויות בשמות עם הגדרות קיימות. השלב הזה הוא אטומי, כלומר החבילה תיטען בהצלחה או שהמערכת תחזיר את המצב לקדמותו. אם הטעינה תצליח, MDE ימשיך לשלב הבא.
הפעלה: בשלב הזה, MDE מפעיל את ההגדרה והופך אותה לגלוי לכל שאר המשתמשים בסביבה. היא גם מפעילה את היצירה של רכיבי תשתית שנדרשים כחלק מהגדרת החבילה (לדוגמה, הפעלה של סוג).
גרסה MDE v1.5.0 לא תומכת בעדכונים של חבילות שכבר נפרסו או הופעלו. אם צריך לתקן שגיאות בשלבי האימות או הטעינה, אפשר להעלות שוב את אותה חבילה כל עוד היא לא פעילה. אחרי שמגדירים את החבילה כפעילה, אי אפשר להעלות את אותה חבילה שוב או להעלות חבילה שמכילה ישויות הגדרה עם שמות זהים.
הצגת רשימה של חבילות הגדרות קיימות
אפשר להציג ברשימה חבילת הגדרות קיימת של MDE באמצעות נקודת קצה (endpoint) של REST או מממשק האינטרנט של MDE.
REST
מריצים את בקשת ה-API בארכיטקטורת REST עם הפרטים הבאים:
- Method: GET.
- נקודת קצה (endpoint):
/configuration/v1/configuration-packages. - קוד תגובה: 200 OK.
גוף התגובה (JSON):
{ "configurationPackages": [ { "id": "0505ed17-ad20-458d-9128-d44783704acb", "name": "default-configuration-package", "provider": "google", "latestStatus": "ACTIVATED", "status": [ { "code": "NOT_LOADED", "updatedTime": "1742501535249", "messages": [] }, { "code": "VALIDATED", "updatedTime": "1742501535249", "messages": [ { "severity": "INFO", "message": "Successfully validated all buckets in the package" }, { "severity": "INFO", "message": "Successfully validated all message classes in the package" }, { "severity": "INFO", "message": "Successfully validated all metadata-instances in the package" }, { "severity": "INFO", "message": "Successfully validated all parsers in the package" }, { "severity": "INFO", "message": "Successfully validated all types in the package" } ] }, { "code": "LOADED", "updatedTime": "1742501536740", "messages": [ { "severity": "INFO", "message": "Successfully applied all message classes in the package" }, { "severity": "INFO", "message": "Successfully applied all buckets in the package" }, { "severity": "INFO", "message": "Successfully validated all metadata-instances in the package" }, { "severity": "INFO", "message": "Successfully applied all types in the package" }, { "severity": "INFO", "message": "Successfully applied all parsers in the package" } ] }, { "code": "ACTIVATED", "updatedTime": "1742501537289", "messages": [ { "severity": "INFO", "message": "Successfully activated all ingestion-specification, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all message classes, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all buckets, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all metadata instance, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all types, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all parsers, if there is any, in the package" } ] } ] }, { "id": "4adaecc2-54b9-482b-90d6-380f5d4b2be6", "name": "basic-configuration", "provider": "google", "latestStatus": "ACTIVATED", "status": [ { "code": "NOT_LOADED", "updatedTime": "1742566718210", "messages": [] }, { "code": "VALIDATED", "updatedTime": "1742566718210", "messages": [ { "severity": "INFO", "message": "Successfully validated all message classes in the package" }, { "severity": "INFO", "message": "Successfully validated all parsers in the package" }, { "severity": "INFO", "message": "Successfully validated all types in the package" } ] }, { "code": "LOADED", "updatedTime": "1742566718696", "messages": [ { "severity": "INFO", "message": "Successfully applied all message classes in the package" }, { "severity": "INFO", "message": "Successfully applied all types in the package" }, { "severity": "INFO", "message": "Successfully applied all parsers in the package" } ] }, { "code": "ACTIVATED", "updatedTime": "1742566718792", "messages": [ { "severity": "INFO", "message": "Successfully activated all ingestion-specification, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all message classes, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all buckets, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all metadata instance, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all types, if there is any, in the package" }, { "severity": "INFO", "message": "Successfully activated all parsers, if there is any, in the package" } ] } ] } ], "nextPageToken": "" }
המסוף
אפשר לראות את רשימת חבילות ההגדרות הקיימות בקטע Cloud Configuration בדף Configurations.
מחיקה של חבילת הגדרות קיימת
החל מגרסה 1.5.0, MDE תומך בדגל סביבה שיכול לשנות את הסביבה למצב פיתוח, שמאפשר לכם למחוק ישויות הגדרה וחבילות הגדרה. אחרי שמגדירים את המצב הזה, אפשר למחוק חבילה שכבר הופעלה באמצעות נקודת הקצה של REST או לחצן המחיקה בממשק האינטרנט של MDE.
REST
מריצים את בקשת ה-API בארכיטקטורת REST עם הפרטים הבאים:
- Method: DELETE
- נקודת קצה:
/configuration/v1/configuration-packages/$PACKAGE-ID - קוד תגובה: 200 OK
- גוף התגובה (JSON):
{
"id": "87e160db-8ff9-403a-a873-e6674f6ac3cb",
"name": "postman-test-configuration-package",
"provider": "google",
"latestStatus": "DELETED",
"status": [
{
"code": "NOT_LOADED",
"updatedTime": "1742550114832",
"messages": []
},
{
"code": "VALIDATED",
"updatedTime": "1742550114832",
"messages": [
{
"severity": "INFO",
"message": "Successfully validated all buckets in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all ingestion-specifications in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all message classes in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all metadata-instances in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all parsers in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all types in the package"
}
]
},
{
"code": "LOADED",
"updatedTime": "1742550115241",
"messages": [
{
"severity": "INFO",
"message": "Successfully applied all ingestion-specification in the package"
},
{
"severity": "INFO",
"message": "Successfully applied all message classes in the package"
},
{
"severity": "INFO",
"message": "Successfully applied all buckets in the package"
},
{
"severity": "INFO",
"message": "Successfully validated all metadata-instances in the package"
},
{
"severity": "INFO",
"message": "Successfully applied all types in the package"
},
{
"severity": "INFO",
"message": "Successfully applied all parsers in the package"
}
]
},
{
"code": "ACTIVATED",
"updatedTime": "1742550115327",
"messages": [
{
"severity": "INFO",
"message": "Successfully activated all ingestion-specification, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all message classes, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all buckets, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all metadata instance, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all types, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all parsers, if there is any, in the package"
}
]
},
{
"code": "DELETED",
"updatedTime": "1742567553260",
"messages": [
{
"severity": "INFO",
"message": "Successfully deleted all parsers, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully deleted all message classes, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully deleted all types, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully activated all metadata instance, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully deleted all buckets, if there is any, in the package"
},
{
"severity": "INFO",
"message": "Successfully deleted all ingestion-specification, if there is any, in the package"
}
]
}
]
}
המסוף
- לוחצים על Cloud Configuration (הגדרת ענן).
- בוחרים את חבילת ההגדרות שרוצים למחוק.
- לוחצים על פעולות.
לוחצים על Delete.
כדי לאשר את מחיקת חבילת ההגדרות שנבחרה, לוחצים על הסרה.
