Pipelines declarativos

Pipelines declarativas permitem definir, configurar e implementar Qlik Talend Data Integration projetos de pipeline inteiramente em código usando arquivos YAML. Você edita os arquivos em qualquer ambiente de desenvolvimento integrado ou sistema de controle de versão, então os implementa para criar ou atualizar projetos.

Quando usar pipelines declarativos

Use pipelines declarativos para promover:

• Colaboração

• Integração Contínua / Entrega Contínua

• Implementação repetível para diferentes ambientes

• Automação baseada em API

Aqui estão alguns casos de uso típicos:

• Defina pipelines em código para integração contínua e automação de desenvolvimento.

• Implante configurações de pipeline idênticas em vários ambientes (desenvolvimento, verificação, produção).

• Reutilizar e compartilhar definições de pipeline entre projetos ou equipes.

• Automate criação de projetos em larga escala sem trabalho manual.

Como funciona

Um projeto de pipeline é representado como um conjunto de arquivos YAML organizado em uma estrutura de pastas que espelha as tarefas e conjuntos de dados do projeto. Arquivos YAML são mais fáceis de ler, ver diferenças, revisar, reutilizar e criar automação.

Você pode exportar um projeto existente como YAML, editar os arquivos e importá-los de volta para aplicar suas alterações. Se o projeto estiver conectado ao controle de versão, os arquivos YAML estarão diretamente disponíveis em seu repositório do GitHub.

Para mais informações sobre a estrutura do arquivo YAML, consulte Recuperando e editando uma configuração de pipeline.

Fluxo de trabalho típico

Antes de começar, você deve configurar seu ambiente de desenvolvimento e controle de versão. Para obter mais informações, consulte Primeiros passos com pipelines declarativos.

Um fluxo de trabalho de pipeline declarativo típico se parece com isto:

1. Recuperar a configuração da pipeline

   Você pode exportar um projeto existente como YAML, recuperá-lo do controle de versão, ou começar de um modelo.

   Recuperando e editando uma configuração de pipeline

2. Editar a configuração do pipeline

   Modifique os arquivos YAML no seu ambiente de desenvolvimento. Você pode adicionar tarefas, alterar seleções de origem e atualizar configurações.

   Guia do desenvolvedor: Pipelines declarativos

3. Validar a configuração da pipeline

   verifique os arquivos quanto a erros de sintaxe e semântica antes de implantar a pipeline.

   Validando uma configuração de pipeline

4. Implementar a configuração de pipeline

   Importe os arquivos para criar ou atualizar o projeto em Qlik Talend Data Integration.

   Você também pode fazer commit dos arquivos para o controle de versão e aplicar do controle de versão no projeto em Qlik Talend Data Integration.

   Implementando uma configuração de pipeline

Relação com controle de versão

Quando um projeto está conectado ao controle de versão, os arquivos YAML são armazenados diretamente no seu repositório do GitHub. Você pode editar os arquivos YAML no GitHub ou em qualquer IDE, e então aplicar as alterações de volta ao projeto.

Para obter informações sobre como conectar um projeto ao controle de versão, consulte Gerencie seus projetos de pipeline com controle de versão.

Usando assistentes de IA para configurar pipelines

Utilize assistentes de IA (como GitHub Copilot ou Anthropic Claude) para otimizar a criação e edição de configurações YAML. Para garantir a acurácia e a adesão aos padrões do projeto, siga estas práticas recomendadas:

1. Selecione um modelo de alta capacidade — Use um modelo premium de grande contexto (por exemplo, Anthropic Claude Sonnet 4.6 ou superior) em vez de um modelo padrão ou "automático" para geração complexa de YAML e aderência ao esquema. Modelos avançados interpretam corretamente esquemas de pipeline complexos e produzem configurações mais precisas.

2. Configurar instruções de IA específicas do projeto — Melhore a qualidade da configuração gerada por IA fornecendo contexto do projeto ao modelo. Crie um arquivo de instrução na raiz do seu espaço de trabalho do VS Code. Escolha um dos seguintes:

   • CLAUDE.md (para a extensão Anthropic Claude Code)

   • .github/copilot-instructions.md (para GitHub Copilot)

   O conteúdo do seu arquivo de instrução deve ser conforme a seguir:

   This is a Qlik Talend Cloud Pipeline (QTCP) project. Before any project advice or YAML edits, I MUST read the source of truth first:
   https://raw.githubusercontent.com/qlik-oss/schemas/refs/heads/main/qtcp/ai-instructions.md