Pipeline dichiarative

Le pipeline dichiarative consentono di definire, configurare e distribuire Qlik Talend Data Integration progetti di pipeline interamente nel codice utilizzando file YAML. Si modificano i file in qualsiasi ambiente di sviluppo integrato o sistema di controllo versione, quindi li si distribuisce per creare o aggiornare progetti.

Quando usare pipeline dichiarative

Usa pipeline dichiarative per promuovere:

• Collaborazione

• Integrazione Continua / Consegna Continua

• Distribuzione ripetibile a diversi ambienti

• Automazione basata su API

Di seguito sono riportati alcuni casi d'uso tipici:

• Definisci pipeline nel codice per l'integrazione continua e l'automazione dello sviluppo.

• Implementa configurazioni di pipeline identiche su più ambienti (sviluppo, verifica, produzione).

• Riutilizzare e condividere definizioni di pipeline tra progetti o team.

• Automate la creazione di progetti su larga scala senza lavoro manuale.

Funzionamento

Un progetto di pipeline è rappresentato come un insieme di file YAML organizzato in una struttura di cartelle che rispecchia le attività e i set di dati del progetto. I file YAML sono più facili da leggere, vedere le differenze, revisionare, riutilizzare e creare automazione.

È possibile esportare un progetto esistente come YAML, modificare i file e importarli nuovamente per applicare le modifiche. Se il progetto è connesso al controllo della versione, i file YAML sono direttamente disponibili nel tuo repository GitHub.

Per maggiori informazioni sulla struttura del file YAML, vedere Recuperare e modificare una configurazione di pipeline.

Flusso di lavoro tipico

Prima di iniziare, devi configurare il tuo ambiente di sviluppo e il controllo della versione. Per ulteriori informazioni, vedere Introduzione alle pipeline dichiarative.

Un tipico flusso di lavoro di pipeline dichiarativa si presenta così:

1. Recupero della configurazione della pipeline

   È possibile esportare un progetto esistente come YAML, recuperarlo dal controllo della versione o iniziare da un modello.

   Recuperare e modificare una configurazione di pipeline

2. Modifica la configurazione della pipeline

   Modifica i file YAML nel tuo ambiente di sviluppo. È possibile aggiungere attività, modificare le selezioni di origine e aggiornare le impostazioni.

   Guida per sviluppatori: Pipeline dichiarative

3. Convalida la configurazione della pipeline

   Verifica i file per errori di sintassi e semantici prima di eseguire il deployment della pipeline.

   Validazione di una configurazione di pipeline

4. Distribuzione della configurazione della pipeline

   Importa i file per creare o aggiornare il progetto in Qlik Talend Data Integration.

   È anche possibile effettuare il commit dei file al controllo della versione e applicare dal controllo della versione nel progetto in Qlik Talend Data Integration.

   Distribuzione di una configurazione di pipeline

Rapporto con il controllo della versione

Quando un progetto è connesso al controllo di versione, i file YAML sono archiviati direttamente nel tuo repository GitHub. È possibile modificare i file YAML in GitHub o in qualsiasi IDE e quindi applicare le modifiche al progetto.

Per informazioni sulla connessione di un progetto al controllo della versione, vedere Gestione dei progetti pipeline con il controllo della versione.

Utilizzo di assistenti AI per configurare pipeline

Usa gli assistenti AI (come GitHub Copilot o Anthropic Claude) per semplificare la creazione e la modifica della configurazione YAML. Per garantire accuratezza e aderenza agli standard di progetto, segui queste procedure consigliate:

1. Seleziona un modello ad alta capacità — Utilizza un modello premium con contesto ampio (ad esempio, Anthropic Claude Sonnet 4.6 o superiore) piuttosto che un modello standard o "automatico" per la generazione complessa di YAML e l'aderenza allo schema. Modelli avanzati interpretano correttamente schemi di pipeline complessi e producono configurazioni più accurate.

2. Configura istruzioni AI specifiche per il progetto — Migliora la qualità della configurazione generata dall'IA fornendo il contesto del progetto al modello. Crea un file di istruzioni nella radice della tua area di lavoro di VS Code. scegliere una delle seguenti opzioni elencate di seguito.

   • CLAUDE.md (per l'estensione Anthropic Claude Code)

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

   Il contenuto del tuo file di istruzioni dovrebbe essere come segue:

   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