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 ao fornecer um único arquivo *.zip.
REST
Execute a solicitação da 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 no lugar certo. Se essa fase for concluída com êxito, o MDE vai para a próxima etapa.
Carregamento: nesta 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 com êxito ou será revertido completamente. Se o carregamento for bem-sucedido, o MDE vai prosseguir 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 é compatível com atualizações de pacotes já implantados ou ativados. Você pode 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 é definido como ativo, não é 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 da 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 do Cloud da página Configurações.
Excluir um pacote de configuração
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, que permite excluir entidades e pacotes de configuração. Depois que esse modo for definido, você poderá 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 da 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 que você quer excluir.
- Clique em Ações.
Clique em Excluir.
Confirme que você quer excluir o pacote de configuração selecionado clicando em Remover.
