パッケージのライフサイクル
このページでは、Manufacturing Data Engine（MDE）のパッケージのライフサイクルについて説明します。
新しい構成パッケージをアップロードする
REST エンドポイントを使用するか、MDE ウェブ インターフェースから 1 つの *.zip ファイルを指定して、新しい MDE の構成パッケージをアップロードできます。
REST
次の情報を使用して REST API リクエストを実行します。
- メソッド: POST。
- エンドポイント:
/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 の構成パッケージは、REST エンドポイントまたは MDE ウェブ インターフェースから一覧表示できます。
REST
次の情報を使用して REST API リクエストを実行します。
- メソッド: GET。
- エンドポイント:
/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 構成] セクションで確認できます。
既存の構成パッケージを削除する
v1.5.0 以降、MDE は環境フラグをサポートしています。このフラグを使用すると、環境を開発モードに変更できます。開発モードでは、構成エンティティと構成パッケージを削除できます。このモードを設定すると、REST エンドポイントまたは MDE ウェブ インターフェースの削除ボタンを使用して、すでに有効になっているパッケージを削除できます。
REST
次の情報を使用して REST API リクエストを実行します。
- メソッド: 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] をクリックします。
- 削除する構成パッケージを選択します。
- [操作] をクリックします。
[削除] をクリックします。
[削除] をクリックして、選択した構成パッケージを削除することを確認します。
