Adapter les paramètres YAML à votre environnement - 7.2

Talend Software Development Life Cycle - Guide de bonnes pratiques

Version
7.2
Language
Français (France)
Product
Talend Big Data
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Module
Studio Talend
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend JobServer
Content
Administration et monitoring
Création et développement
Déploiement

Configurez le script de pipeline fourni par Talend afin de générer des éléments de projet en fonction de la phase Maven que vous visez et du référentiel dans lequel vous souhaitez déployer les artefacts.

Certains paramètres et identifiants proviennent des fichiers et variables sécurisé(e)s que vous avez stocké(e)s dans Azure DevOps. Pour plus d'informations concernant les paramètres Maven Talend que vous pouvez utiliser pour configurer votre pipeline, consultez Options du build Maven Talend personnalisé.

Procédure

  1. Définissez vos propres valeurs pour les variables d'environnement au début du script (nom de projet, nom/version/type du Job, URL du référentiel Git, etc.).
    Conseil : Recherchez les XXX dans le script azure-pipeline-*.yml par Talend et remplacez-les par les valeurs adéquates pour votre environnement.

    Exemple

    Exemple d'un projet nommé CICD, d'un Job nommé job_feature956 avec la version 0.1 et d'une image Docker appelée cicd4talend :
    variables:
    - group: Talend Variables
    - name: project_name
      value: 'CICD'
    - name: artifact_name
      value: 'job_feature956'
    - name: artifact_version
      value: '0.1'
    - name: docker_image_name
      value: 'XXX'
    Avertissement : Syntaxe à respecter :
    • La valeur de la variable job_name doit être en majuscules, sinon elle risque de causer un échec du build. Si vous avez utilisé des caractères spéciaux dans le nom du projet ou que vous avez le moindre doute sur sa syntaxe finale, vous pouvez la vérifier dans le fichier parent pom.xml de votre projet (variable talend.project.name dans <project>/poms/pom.xml).
    • La valeur de la variable artifact_name doit être en minuscules même si le nom original de votre Job/Route/Service contient des majuscules, car tous les artefacts sont en minuscules dans les fichiers .pom requis pour lancer le build.
    • N'ajoutez pas manuellement le suffixe "-SNAPSHOT" à la valeur de la version. Les snapshots et les releases sont découplés de la version elle-même et doivent être gérés uniquement via les préférences du Studio, consultez Modifier la version de déploiement de chaque artefact en une fois.
  2. Modifiez l'URL du référentiel d'artefacts définie à la ligne mavenOptions. Le référentiel défini dans le script par défaut que fournit Talend est le référentiel Nexus snapshots.

    Exemple

    -DaltDeploymentRepository=releases::default::http://nexus:8081/repository/releases/

    vous permet de déployer des artefacts dans un référentiel Nexus releases (afin d'obtenir des artefacts de release stables dans un environnement de production).

  3. Modifiez l'espace de travail et l'environnement Talend Cloud définis à la ligne mavenOptions. L'espace de travail et l'environnement par défaut définis dans le script par défaut fourni par Talend sont l'espace de travail par défaut et l'environnement Personnel.

    Exemple

    -Dservice.url=$(talend_cloud_url) -Dcloud.publisher.environment=PROD -context=Prod
    -Dcloud.publisher.workspace=CI_WORKSPACE -Dcloud.publisher.screenshot=true

    vous permet de déployer des artefacts (avec les captures d'écran) dans un compte Talend Cloud dans un espace de travail nommé CI_WORKSPACE dans un environnement PROD, tout en changeant l'environnement de contexte en Prod (à l'aide de --context). Cet environnement doit avoir été précédemment défini dans Studio Talend, cependant, si vous n'avez pas défini de paramètre de contexte, vous pouvez utiliser --context_param pour les définir lors du build.

    Remarque : Si vous avez activé l'authentification unique (SSO) pour vous connecter à Talend Cloud, vous devez ajouter le paramètre -Dcloud.token=<MyAccessToken> à ces commandes.
  4. Afin de définir la phase Maven que vous visez : Assurez-vous que les profils de phase et de build définis aux lignes options et goals sont ceux que vous souhaitez effectuer. Le goal par défaut défini dans le script par défaut fourni par Talend est deploy.
    Pour plus d'informations concernant les phases Maven, consultez la documentation Maven (en anglais).
    Conseil : Tous les profils de build (-Pdocker, -Pnexus, etc.) sont listés dans le fichier pom.xml parent de votre projet. Certains paramètres par défaut, comme le nom de l'image Docker ou le nom Open JDK, peuvent également être écrasés dans ce fichier.

    Exemple

    options: '--settings $(settings_xml.secureFilePath) -Pnexus -pl jobs/routes/$(artifact_name)_$(artifact_version) -am'
    goals: 'clean deploy'

    vous permet de prendre la Route packagée en tant que jar ou .zip et de la déployer dans le référentiel Nexus de votre choix.

    Exemple

    options: '--settings $(settings_xml.secureFilePath) -X -Pdocker -pl jobs/process/$(artifact_name)_$(artifact_version) -am -Dtalend.docker.name=$(docker_image_name)'
    goals: 'deploy'

    vous permet de prendre le code compilé, de le packager en tant qu'image Docker et de le déployer dans le référentiel de votre choix.

  5. Sauvegardez vos modifications. Cela lancera automatiquement l'exécution de votre pipeline de build.