Implementando uma configuração de pipeline

Você implementa uma configuração de pipeline importando um arquivo ZIP contendo os arquivos de configuração YAML. Você pode usar a interface de usuário ou a API de Importação para criar novos projetos ou atualizar os existentes. Ambos aceitam YAML minimizado e o formato JSON legado.

Ao usar controle de versão, você pode confirmar suas alterações e executar Aplicar do remoto para obtê-los em Qlik Talend Data Integration.

Antes de começar

Antes de importar:

Verifique se todas as conexões referenciadas nos arquivos YAML existem no espaço de destino. Os nomes das conexões no arquivo YAML devem corresponder exatamente.
Se o pipeline incluir referências entre projetos, por exemplo, uma tarefa de pipeline que lê de uma tarefa de aterrisagem em outro projeto, importe o projeto upstream primeiro.
Validar os arquivos de configuração para confirmar que não há erros. Consulte Validando uma configuração de pipeline.

Importando da UI

Criando um novo projeto

Para criar um novo projeto a partir de um arquivo de configuração:

Em Integração de Dados > Projetos de pipeline, clique em Criar novo.
Selecione Importar projeto.
Selecione o espaço de destino.
Carregue o arquivo ZIP contendo a configuração.
Clique em Importar.

Se a importação for bem-sucedida, o projeto é aberto. Se houver erros, uma lista de mensagens de validação é exibida. Corrija os erros em seus arquivos de configuração e tente novamente.

Atualizando um projeto existente

Para atualizar um projeto existente com uma nova configuração:

Em Integração de Dados > Projetos de pipeline, clique no projeto e selecione Importar.
Envie o arquivo ZIP contendo a configuração atualizada.
Clique em Importar.

A importação de uma configuração sobrescreve as configurações atuais do projeto com os valores nos arquivos YAML. Configurações não presentes nos arquivos importados permanecem inalteradas se você exportou no formato minimizado, ou são redefinidas para os padrões se você exportou no formato completo.

Importando usando a API

A API de Importação aceita um arquivo ZIP e o ID do espaço de destino. Retorna o projeto atualizado em caso de sucesso, ou uma lista de erros se a validação falhar.

A API de Importação suporta exportações YAML (minimizadas ou completas) e JSON legadas. Você não precisa converter exportações JSON existentes antes de importar.

Use a API Validate-project-definitions antes da API Import em pipelines de CI/CD para separar falhas de validação de falhas de implementação. Consulte Validando uma configuração de pipeline.

Aplicando alterações do controle de versão

Se o projeto estiver conectado a um repositório de controle de versão, você pode aplicar alterações remotas diretamente do projeto. Ao aplicar as alterações, Qlik Talend Data Integration lê os arquivos YAML atuais da ramificação conectada e os importa.

A validação é executada antes que as alterações sejam aplicadas. Se houver erros, você recebe as mesmas mensagens de erro que em uma importação manual.

Para obter detalhes sobre como configurar o controle de versão, consulte Gerencie seus projetos de pipeline com controle de versão.

Tratamento de erros de importação

Quando a importação falha, Qlik Talend Data Integration retorna uma lista de erros de validação. Cada erro inclui o tipo de erro e o caminho para o arquivo ou propriedade onde o problema foi encontrado.

Até 50 erros são retornados por tentativa de importação. Corrija os erros relatados e reimporte para verificar se há problemas adicionais.

Para uma descrição de cada tipo de erro e como resolvê-lo, consulte Validando uma configuração de pipeline.

Tópicos relacionados

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo – um erro de digitação, uma etapa ausente ou um erro técnico – avise-nos!

Deixe seu feedback aqui