Ciclo di vita del pacchetto
Questa pagina descrive il ciclo di vita del pacchetto di Manufacturing Data Engine (MDE).
Caricare un nuovo pacchetto di configurazione
Puoi caricare un nuovo pacchetto di configurazione MDE utilizzando
un endpoint REST o dall'interfaccia web
MDE fornendo un singolo file *.zip.
REST
Esegui la richiesta dell'API REST con le seguenti informazioni:
- Metodo: POST.
- Endpoint:
/configuration/v1/configuration-packages. - Corpo della richiesta:
multiform data with key=”packageArchive”, value=configuration-package-zip file. - Codice di risposta: 200 OK.
Corpo della risposta (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
- Fai clic su Configurazione cloud.
- Fai clic su AGGIUNGI NUOVO PACCHETTO DI CONFIGURAZIONE.
- Seleziona il file da caricare nella console.
- Fai clic su CARICA.
Dopo il caricamento del pacchetto, MDE lo elaborerà eseguendo le seguenti fasi:
Convalida: in questa fase, MDE convalida i contenuti del pacchetto, assicurandosi che tutti i file siano sintatticamente corretti e che si trovino nella posizione giusta. Se questa fase viene completata correttamente, MDE passa alla fase successiva.
Caricamento: in questa fase, MDE tenta di caricare e unire le configurazioni specificate nel pacchetto con le configurazioni dell'ambiente corrente. Controlla le dipendenze e si assicura che non vi siano collisioni di nomi con le configurazioni esistenti. Questa fase è atomica, il che significa che il pacchetto verrà caricato correttamente o verrà eseguito il rollback completo. Se il caricamento va a buon fine, MDE procederà con la fase successiva.
Attivazione: in questa fase MDE attiva la configurazione e la rende visibile agli altri utenti dell'ambiente. Inoltre, attiva la creazione di tutti gli elementi dell'infrastruttura richiesti come parte della configurazione del pacchetto (ad esempio, l'attivazione di un tipo).
MDE v1.5.0 non supporta gli aggiornamenti per i pacchetti già implementati o attivati. Puoi caricare di nuovo lo stesso pacchetto purché non sia attivo se è necessario per correggere eventuali errori nelle fasi di convalida o caricamento. Una volta impostato il pacchetto su attivo, non puoi caricarlo di nuovo o caricare un pacchetto che contiene entità di configurazione con nomi in conflitto.
Elenca i pacchetti di configurazione esistenti
Puoi elencare il pacchetto di configurazione MDE esistente utilizzando un endpoint REST o dall'interfaccia web MDE.
REST
Esegui la richiesta dell'API REST con le seguenti informazioni:
- Metodo: GET.
- Endpoint:
/configuration/v1/configuration-packages. - Codice di risposta: 200 OK.
Corpo della risposta (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
Puoi visualizzare l'elenco dei pacchetti di configurazione esistenti nella sezione Cloud Configuration della pagina Configurazioni.
Eliminare un pacchetto di configurazione esistente
A partire dalla versione 1.5.0, MDE supporta un flag di ambiente che può cambiare l'ambiente in modalità di sviluppo, che ti consente di eliminare le entità di configurazione e i pacchetti di configurazione. Una volta impostata questa modalità, puoi eliminare un pacchetto già attivato utilizzando l'endpoint REST o il pulsante di eliminazione dell'interfaccia web MDE.
REST
Esegui la richiesta dell'API REST con le seguenti informazioni:
- Metodo: DELETE
- Endpoint:
/configuration/v1/configuration-packages/$PACKAGE-ID - Codice di risposta: 200 OK
- Corpo della risposta (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
- Fai clic su Configurazione cloud.
- Seleziona il pacchetto di configurazione da eliminare.
- Fai clic su Azioni.
Fai clic su Elimina.
Conferma di voler eliminare il pacchetto di configurazione selezionato facendo clic su Rimuovi.
