Deklarative Pipelines | Qlik Cloud Hilfe
Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Deklarative Pipelines

Deklarative pipelines ermöglichen es Ihnen, Qlik Talend Data Integration pipeline-Projekte vollständig in Code mithilfe von YAML-Dateien zu definieren, zu konfigurieren und bereitzustellen. Sie bearbeiten die Dateien in jeder integrierten Entwicklungsumgebung oder jedem Versionskontrollsystem, dann stellen Sie sie bereit, um Projekte zu erstellen oder zu aktualisieren.

Wann deklarative Pipelines verwendet werden sollten

Verwenden Sie deklarative Pipelines, um zu fördern:

  • Zusammenarbeit

  • Fortlaufende Integration / Kontinuierliche Bereitstellung

  • Wiederholbare Bereitstellung in verschiedene Umgebungen

  • API-gesteuerte Automatisierung

Im Folgenden finden Sie einige typische Anwendungsfälle:

  • Definieren Sie Pipelines im Code für die kontinuierliche Integration und Entwicklungsautomatisierung.

  • Identische pipeline-Konfigurationen über mehrere Umgebungen hinweg bereitstellen (Entwicklung, Verifizierung, Produktion).

  • pipeline-Definitionen projekt- oder teamübergreifend wiederverwenden und teilen.

  • Automate groß angelegte Projekterstellung ohne manuellen Aufwand.

So funktioniert es

Ein Pipeline-Projekt wird als ein Satz von YAML-Dateien dargestellt, die in einer Ordnerstruktur organisiert sind, welche die Aufgaben und Datasets des Projekts widerspiegelt. YAML-Dateien sind einfacher zu lesen, Diffs zu sehen, zu überprüfen, wiederzuverwenden und Automatisierung zu erstellen.

Sie können ein bestehendes Projekt als YAML exportieren, die Dateien bearbeiten und sie wieder importieren, um Ihre Änderungen anzuwenden. Wenn das Projekt mit der Versionskontrolle verbunden ist, sind die YAML-Dateien direkt in Ihrem GitHub-Repository verfügbar.

Weitere Informationen zur YAML-Dateistruktur finden Sie unter Abrufen und Bearbeiten einer pipeline-Konfiguration.

InformationshinweisBindungsdateien (qtcp_bindings_definition.json und binding.json) bleiben im JSON-Format, um die Kompatibilität mit der Bindungs-API zu gewährleisten. Für den Legacy-Export oder in bestehenden GitHub-Projekten heißt die Datei bindingTemplate.json und nicht qtcp_bindings_definition.json.

Typischer Workflow

Bevor Sie beginnen, müssen Sie Ihre Entwicklungsumgebung und die Versionskontrolle einrichten. Weitere Informationen finden Sie unter Einstieg in deklarative Pipelines.

Ein typischer deklarativer pipeline-Workflow sieht folgendermaßen aus:

  1. pipeline-Konfiguration abrufen

    Sie können ein bestehendes Projekt als YAML exportieren, es aus der Versionskontrolle abrufen oder von einer Vorlage starten.

    Abrufen und Bearbeiten einer pipeline-Konfiguration

  2. Pipeline-Konfiguration bearbeiten

    Ändern Sie die YAML-Dateien in Ihrer Entwicklungsumgebung. Sie können Aufgaben hinzufügen, Quellauswahlen ändern und Einstellungen aktualisieren.

    Entwicklerhandbuch: Deklarative Pipelines

  3. Validieren Sie die pipeline Konfiguration

    Überprüfen Sie die Dateien auf Syntax- und semantische Fehler vor der Bereitstellung der pipeline.

    Validieren einer pipeline-Konfiguration

  4. Bereitstellen der Pipeline-Konfiguration

    Importieren Sie die Dateien, um das Projekt in Qlik Talend Data Integration zu erstellen oder zu aktualisieren.

    Sie können die Dateien auch in die Versionskontrolle committen und aus der Versionskontrolle im Projekt in Qlik Talend Data Integration anwenden.

    Bereitstellen einer Pipeline-Konfiguration

Beziehung zur Versionskontrolle

Wenn ein Projekt mit der Versionskontrolle verbunden ist, werden die YAML-Dateien direkt in Ihrem GitHub-Repository gespeichert. Sie können die YAML-Dateien in GitHub oder in einer beliebigen IDE bearbeiten und die Änderungen dann wieder in das Projekt übernehmen.

Informationen zum Verbinden eines Projekts mit der Versionskontrolle finden Sie unter Verwalten Ihrer Pipeline-Projekte mit Versionskontrolle.

InformationshinweisWenn Sie ein bestehendes Projekt haben, das mit der Versionskontrolle verbunden ist und das ältere JSON-Format verwendet, können Sie es zu YAML migrieren. Weitere Informationen finden Sie unter Migration eines Projekts in das YAML-Format.

Mithilfe von KI-Assistenten zur Konfiguration von Pipelines

Nutzen Sie KI-Assistenten (wie GitHub Copilot oder Anthropic Claude), um die Erstellung und Bearbeitung von YAML-Konfigurationen zu optimieren. Um Genauigkeit und die Einhaltung von Projektstandards zu gewährleisten, folgen Sie diesen Best Practices:

  1. Wählen Sie ein leistungsstarkes Modell — Verwenden Sie ein Premium-Modell mit großem Kontext (zum Beispiel Anthropic Claude Sonnet 4.6 oder höher) anstelle eines Standard- oder „Auto“-Modells für die komplexe YAML-Generierung und Schema-Einhaltung. Fortschrittliche Modelle interpretieren komplexe pipeline-Schemata korrekt und erzeugen genauere Konfigurationen.

  2. Projektspezifische KI-Anweisungen konfigurieren — Verbessern Sie die Qualität der KI-generierten Konfiguration, indem Sie dem Modell Projektkontext bereitstellen. Erstellen Sie eine Anweisungsdatei im Stammverzeichnis Ihres VS Code-Arbeitsbereichs. Wählen Sie eine der folgenden Optionen aus:

    • CLAUDE.md (für Anthropic Claude Code Erweiterung)

    • .github/copilot-instructions.md (für GitHub Copilot)

    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

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!