Paketlebenszyklus

Auf dieser Seite wird der Paketlebenszyklus von Manufacturing Data Engine (MDE) beschrieben.

Neues Konfigurationspaket hochladen

Sie können das Konfigurationspaket eines neuen MDE über einen REST-Endpunkt oder über die MDE-Weboberfläche hochladen, indem Sie eine einzelne *.zip-Datei bereitstellen.

REST

Führen Sie die REST API-Anfrage mit den folgenden Informationen aus:

  • Methode: POST.
  • Endpunkt: /configuration/v1/configuration-packages.
  • Anfragetext: multiform data with key=”packageArchive”, value=configuration-package-zip file.
  • Antwortcode: 200 OK.
  • Antworttext (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"
                    }
                ]
            }
        ]
    }
    

Console

  1. Klicken Sie auf Cloud-Konfiguration.
  2. Klicken Sie auf NEUES KONFIGURATIONSPAKET HINZUFÜGEN.
  3. Wählen Sie die Datei aus, die Sie in die Console hochladen möchten.
  4. Klicken Sie auf HOCHLADEN.

Neues Konfigurationspaket

Nachdem das Paket hochgeladen wurde, wird es von MDE in den folgenden Phasen verarbeitet:

  1. Validierung: In dieser Phase validiert MDE den Inhalt des Pakets. Es wird geprüft, ob alle Dateien syntaktisch korrekt sind und sich am richtigen Ort befinden. Wenn diese Phase erfolgreich abgeschlossen ist, fährt MDE mit der nächsten Phase fort.

  2. Laden: In dieser Phase versucht MDE, die im Paket angegebenen Konfigurationen zu laden und mit den aktuellen Umgebungskonfigurationen zusammenzuführen. Es werden alle Abhängigkeiten geprüft und es wird darauf geachtet, dass es keine Namenskonflikte mit vorhandenen Konfigurationen gibt. Diese Phase ist atomar. Das bedeutet, dass das Paket entweder erfolgreich geladen oder vollständig zurückgesetzt wird. Wenn das Laden erfolgreich ist, fährt MDE mit der nächsten Phase fort.

  3. Aktivierung: In dieser Phase aktiviert MDE die Konfiguration und macht sie für die anderen Nutzer der Umgebung sichtbar. Außerdem wird dadurch die Erstellung aller Infrastrukturelemente ausgelöst, die im Rahmen der Paketkonfiguration erforderlich sind (z. B. die Aktivierung eines Typs).

MDE v1.5.0 unterstützt keine Updates für bereits bereitgestellte oder aktivierte Pakete. Sie können dasselbe Paket noch einmal hochladen, solange es nicht aktiv ist, wenn dies erforderlich ist, um Fehler in der Validierungs- oder Ladephase zu beheben. Sobald das Paket auf „Aktiv“ gesetzt ist, können Sie es nicht noch einmal hochladen oder ein Paket hochladen, das Konfigurationsentitäten mit in Konflikt stehenden Namen enthält.

Vorhandene Konfigurationspakete auflisten

Sie können das Konfigurationspaket für vorhandene MDEs über einen REST-Endpunkt oder über die MDE-Weboberfläche auflisten.

REST

Führen Sie die REST API-Anfrage mit den folgenden Informationen aus:

  • Methode: GET.
  • Endpunkt: /configuration/v1/configuration-packages.
  • Antwortcode: 200 OK.
  • Antworttext (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": ""
    }
    

Console

Eine Liste der vorhandenen Konfigurationspakete finden Sie im Abschnitt Cloud-Konfiguration auf der Seite Konfigurationen.

Konfigurationspaket auflisten

Vorhandenes Konfigurationspaket löschen

Ab Version 1.5.0 unterstützt MDE ein Umgebungsflag, mit dem die Umgebung in den Entwicklermodus geändert werden kann. In diesem Modus können Sie Konfigurationseinheiten und Konfigurationspakete löschen. Nachdem dieser Modus festgelegt wurde, können Sie ein bereits aktiviertes Paket über den REST-Endpunkt oder die Schaltfläche zum Löschen in der MDE-Weboberfläche löschen.

REST

Führen Sie die REST API-Anfrage mit den folgenden Informationen aus:

  • Methode: DELETE
  • Endpunkt: /configuration/v1/configuration-packages/$PACKAGE-ID
  • Antwortcode: 200 OK
  • Antworttext (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"
                }
            ]
        }
    ]
}

Console

  1. Klicken Sie auf Cloud-Konfiguration.
  2. Wählen Sie das zu löschende Konfigurationspaket aus.
  3. Klicken Sie auf Aktionen.
  4. Klicken Sie auf Löschen.

    Konfigurationspaket löschen

  5. Bestätigen Sie, dass Sie das ausgewählte Konfigurationspaket löschen möchten, indem Sie auf Entfernen klicken.

Löschen des Konfigurationspakets bestätigen