Déploiement d'une configuration de pipeline
Vous déployez une configuration de pipeline en important un fichier ZIP contenant les fichiers de configuration YAML. Vous pouvez utiliser l'IU ou l'API Import pour créer de nouveaux projets ou mettre à jour des projets existants. Les deux acceptent le format YAML réduit et le format JSON hérité.
Lorsque vous utilisez le contrôle des versions, vous pouvez valider vos modifications et utiliser Appliquer depuis la branche distante pour les intégrer à Qlik Talend Data Integration.
Conditions préalables requises
Avant de procéder à l'import :
-
Vérifiez que toutes les connexions référencées dans les fichiers YAML existent dans l'espace cible. Les noms de connexion dans le fichier YAML doivent parfaitement correspondre.
-
Si le pipeline inclut des références interprojets, par exemple une tâche de pipeline qui effectue une lecture à partir d'une tâche de dépôt temporaire figurant dans un autre projet, commencez par importer le projet en amont.
-
Validez les fichiers de configuration pour confirmer qu'ils ne contiennent aucune erreur. Consultez Validation d'une configuration de pipeline.
Importation depuis l'IU
Création d'un projet
Pour créer un nouveau projet à partir d'un fichier de configuration :
-
Dans Intégration des données > Projets de pipeline, cliquez sur Créer.
-
Sélectionnez Importer le projet.
-
Sélectionnez l'espace cible.
-
Chargez le fichier ZIP contenant la configuration.
-
Cliquez sur Importer.
Si l'importation réussit, le projet s'ouvre. En cas d'erreurs, une liste de messages de validation s'affiche. Corrigez les erreurs dans vos fichiers de configuration et réessayez.
Mise à jour d'un projet existant
Pour mettre à jour un projet existant à l'aide d'une nouvelle configuration :
-
Dans Intégration des données > Projets de pipeline, cliquez sur
sur le projet et sélectionnez Importer. -
Chargez le fichier ZIP contenant la configuration mise à jour.
-
Cliquez sur Importer.
Importation à l'aide de l'API
L'API Import accepte un fichier ZIP et l'ID de l'espace cible. Elle renvoie le projet mis à jour en cas de réussite ou une liste d'erreurs si la validation échoue.
L'API Import supporte à la fois le format YAML (réduit ou complet) et les exports JSON hérités. Vous n'avez pas besoin de convertir les exports JSON existants avant l'importation.
Application des modifications depuis le contrôle des versions
Si le projet est connecté à un référentiel de contrôle des versions, vous pouvez appliquer les modifications distantes directement depuis le projet. Lorsque vous appliquez les modifications, Qlik Talend Data Integration lit les fichiers YAML actuels de la branche connectée et les importe.
La validation s'exécute avant l'application des modifications. En cas d'erreurs, vous recevez les mêmes messages d'erreur que pour un import manuel.
Pour des informations détaillées sur la configuration du contrôle des versions, consultez Gestion des projets de pipeline avec le contrôle des versions.
Traitement des erreurs d'import
En cas d'échec de l'import, Qlik Talend Data Integration renvoie une liste d'erreurs de validation. Chaque erreur inclut le type d'erreur et le chemin d'accès au fichier ou à la propriété dans lequel/laquelle le problème a été détecté.
Jusqu'à 50 erreurs sont renvoyées par tentative d'import. Corrigez les erreurs signalées et recommencez l'import pour vérifier s'il existe d'autres problèmes.
Pour obtenir une description de chaque type d'erreur et savoir comment le résoudre, consultez Validation d'une configuration de pipeline.