Ciclo de vida del paquete
En esta página, se describe el ciclo de vida de los paquetes de Manufacturing Data Engine (MDE).
Cómo subir un paquete de configuración nuevo
Puedes subir un nuevo paquete de configuración del MDE con un extremo de REST o desde la interfaz web del MDE proporcionando un solo archivo *.zip.
REST
Ejecuta la solicitud a la API de REST con la siguiente información:
- Método: POST
- Extremo:
/configuration/v1/configuration-packages. - Cuerpo de la solicitud:
multiform data with key=”packageArchive”, value=configuration-package-zip file. - Código de respuesta: 200 OK.
Cuerpo de la respuesta (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
- Haz clic en Configuración de Cloud.
- Haz clic en AGREGAR UN PAQUETE DE CONFIGURACIÓN NUEVO.
- Selecciona el archivo que deseas subir a la consola.
- Haz clic en SUBIR.
Después de que se suba el paquete, el MDE lo procesará ejecutando las siguientes etapas:
Validación: En esta etapa, el MDE valida el contenido del paquete, se asegura de que todos los archivos sean sintácticamente correctos y de que estén en el lugar correcto. Si esta fase se completa correctamente, MDE pasa a la siguiente etapa.
Cargando: En esta etapa, el MDE intenta cargar y combinar las configuraciones especificadas en el paquete con las configuraciones del entorno actual. Verifica las dependencias y se asegura de que no haya conflictos de nombres con las configuraciones existentes. Esta etapa es atómica, lo que significa que el paquete se cargará correctamente o se revertirá por completo. Si la carga se realiza correctamente, el MDE continuará con la siguiente etapa.
Activación: En esta etapa, el MDE activa la configuración y la hace visible para el resto de los usuarios del entorno. También activa la creación de los elementos de infraestructura necesarios como parte de la configuración del paquete (por ejemplo, la activación de un tipo).
La versión 1.5.0 de MDE no admite actualizaciones para paquetes ya implementados o activados. Puedes volver a subir el mismo paquete siempre que no esté activo si es necesario corregir errores en las etapas de validación o carga. Una vez que el paquete se establece como activo, no puedes volver a subir el mismo paquete ni subir un paquete que contenga entidades de configuración con nombres en conflicto.
Enumera los paquetes de configuración existentes
Puedes enumerar el paquete de configuración de MDE existente con un extremo de REST o desde la interfaz web de MDE.
REST
Ejecuta la solicitud a la API de REST con la siguiente información:
- Método: GET
- Extremo:
/configuration/v1/configuration-packages. - Código de respuesta: 200 OK.
Cuerpo de la respuesta (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
Puedes ver la lista de paquetes de configuración existentes en la sección Cloud Configuration de la página Configurations.
Borra un paquete de configuración existente
A partir de la versión 1.5.0, MDE admite una marca de entorno que puede cambiar el entorno al modo de desarrollo, lo que te permite borrar entidades de configuración y paquetes de configuración. Después de configurar este modo, puedes borrar un paquete ya activado con el extremo de REST o el botón de borrado de la interfaz web del MDE.
Si el paquete contiene tipos, se borrará la tabla de ese tipo junto con sus datos de BigQuery y los demás receptores. Del mismo modo, si el paquete contiene un bucket, este y sus instancias de metadatos se borrarán de BigQuery y de las bases de datos internas del MDE. Por eso, estas funciones solo están habilitadas en el modo de desarrollo, y debes usarlas con precaución.REST
Ejecuta la solicitud a la API de REST con la siguiente información:
- Método: DELETE
- Endpoint:
/configuration/v1/configuration-packages/$PACKAGE-ID - Código de respuesta: 200 OK
- Cuerpo de la respuesta (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
- Haz clic en Configuración de Cloud.
- Selecciona el paquete de configuración que deseas borrar.
- Haz clic en Acciones.
Haz clic en Borrar.
Haz clic en Quitar para confirmar que quieres borrar el paquete de configuración seleccionado.
