Ciclo de vida do pacote
Esta página descreve o ciclo de vida do pacote do Manufacturing Data Engine (MDE).
Fazer upload de um novo pacote de configuração
É possível fazer upload de um novo pacote de configuração do MDE usando um endpoint REST ou na interface da Web do MDE, fornecendo um único arquivo *.zip.
REST
Execute a solicitação de API REST com as seguintes informações:
- Método: POST.
- Endpoint:
/configuration/v1/configuration-packages. - Corpo da solicitação:
multiform data with key=”packageArchive”, value=configuration-package-zip file. - Código de resposta: 200 OK.
Corpo da resposta (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
- Clique em Configuração da nuvem.
- Clique em ADICIONAR NOVO PACOTE DE CONFIGURAÇÃO.
- Selecione o arquivo para fazer upload no console.
- Clique em FAZER UPLOAD.
Depois que o pacote for enviado, o MDE vai processá-lo executando as seguintes etapas:
Validação: nessa etapa, o MDE valida o conteúdo do pacote, garantindo que todos os arquivos estejam sintaticamente corretos e que estejam no lugar certo. Se essa fase for concluída, o MDE vai para a próxima etapa.
Carregamento: nessa etapa, o MDE tenta carregar e mesclar as configurações especificadas no pacote com as configurações do ambiente atual. Ele verifica as dependências e garante que não haja conflitos de nomenclatura com as configurações atuais. Essa etapa é atômica, o que significa que o pacote será carregado ou revertido completamente. Se o carregamento for bem-sucedido, o MDE vai para a próxima etapa.
Ativação: nessa etapa, o MDE ativa a configuração e a torna visível para o restante dos usuários do ambiente. Ele também aciona a criação de elementos de infraestrutura necessários como parte da configuração do pacote (por exemplo, ativar um tipo).
O MDE v1.5.0 não oferece suporte a atualizações de pacotes já implantados ou ativados. É possível fazer upload do mesmo pacote novamente, desde que ele não esteja ativo, se isso for necessário para corrigir erros nas etapas de validação ou carregamento. Depois que o pacote estiver ativo, não será possível fazer upload do mesmo pacote novamente ou de um pacote que contenha entidades de configuração com nomes conflitantes.
Listar pacotes de configuração atuais
É possível listar o pacote de configuração do MDE usando um endpoint REST ou na interface da Web do MDE.
REST
Execute a solicitação de API REST com as seguintes informações:
- Método: GET.
- Endpoint:
/configuration/v1/configuration-packages. - Código de resposta: 200 OK.
Corpo da resposta (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
É possível conferir a lista de pacotes de configuração na seção Configuração da nuvem, na página Configurações.
Excluir um pacote de configuração atual
A partir da v1.5.0, o MDE oferece suporte a uma flag de ambiente que pode mudar o ambiente para o modo de desenvolvimento, o que permite excluir entidades de configuração e pacotes de configuração. Depois que esse modo for definido, será possível excluir um pacote já ativado usando o endpoint REST ou o botão de exclusão da interface da Web do MDE.
REST
Execute a solicitação de API REST com as seguintes informações:
- Método: DELETE
- Endpoint:
/configuration/v1/configuration-packages/$PACKAGE-ID - Código de resposta: 200 OK
- Corpo da resposta (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
- Clique em Configuração da nuvem.
- Selecione o pacote de configuração a ser excluído.
- Clique em Ações.
Clique em Excluir.
Confirme que você quer excluir o pacote de configuração selecionado clicando em Remover.
