Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Erstellen einer Azure-Build-Pipeline entsprechend den Anforderungen Ihrer Implementierung

Konfigurieren Sie das von Talend bereitgestellte Pipeline-Skript, um die Projektelemente gemäß der zu erreichenden Maven-Phase und dem Repository zu generieren, in dem die Artefakte implementiert werden sollen.

Anpassen der YAML-Parameter an Ihre Umgebung

Einige Parameter und Anmeldedaten stammen aus den sicheren Dateien, die Sie in Azure DevOps gespeichert haben. Weitere Informationen zu den bei der Konfiguration einer Pipeline verwendbaren Talend Maven-Parametern finden Sie unter Benutzerdefinierte Talend Maven-Generierungsoptionen.

  1. Laden Sie folgende Datei herunter und extrahieren Sie sie: azure-pipeline.zip.
    InformationshinweisWarnung: Diese Datei ist lediglich ein Beispiel und muss vor der Verwendung an Ihre Umgebung angepasst werden. Sie liefert Ihnen einige vordefinierte Maven-Befehle und -Optionen, die Sie in Übereinstimmung mit Ihren Implementierungsanforderungen anpassen können. Beispielsweise ermöglicht Ihnen die Skriptdatei azure-pipeline.yml die Generierung und Veröffentlichung von Artefakten in Talend Management Console. Wenn Sie Artefakte in einem Artefakt-Repository oder in Docker veröffentlichen möchten, heben Sie die Auskommentierung der entsprechenden Parameter im Skript auf.
  2. Legen Sie Ihre eigenen Werte für die am Anfang des Skripts definierten Umgebungsvariablen fest (Projektname, Job-Name/-Version/-Typ, Repository-URL usw.).
    InformationshinweisTipp: Suchen Sie nach den XXX-Referenzen im von Talend bereitgestellten azure-pipeline.yml und ersetzen Sie sie durch die Ihrer Umgebung entsprechenden Werte.
    Beispiel für ein Projekt namens CICD, einen Job namens my_complex_job mit der Version 1.0 und einem Docker-Image namens cicd4talend:
    variables:
    - group: Talend Variables
    - name: project_name
      value: 'CICD'
    - name: jobs_to_build
      value: 'process/my_complex_job_1.0'
    - name: docker_image_name
      value: 'cicd4talend'
    InformationshinweisWarnung: Anforderungen an die Syntax:
    • Der Wert der Variable project_name muss aus Großbuchstaben bestehen, andernfalls könnte er einen Fehler bei der Generierung verursachen. Wenn Sie im Projektnamen Sonderzeichen verwendet haben oder sich in Bezug auf die definitive Syntax nicht sicher sind, können Sie dies in der übergeordneten Datei pom.xml Ihrer Projektvariablen (talend.project.name in <project>/poms/pom.xml) überprüfen.
    • Der Wert der Variable jobs_to_build muss aus Kleinbuchstaben bestehen, selbst wenn der Originalname des Jobs bzw. der Route oder des Dienstes Großbuchstaben enthält, da alle Artefakte in den für den Start der Generierung erforderlichen pom-Dateien in Kleinbuchstaben geschrieben sind.
    • Fügen Sie das „-SNAPSHOT“-Suffix nicht manuell zum Versionswert hinzu. Snapshots und Releases werden von der Version gelöst und dürfen nur über die Talend Studio-Präferenzen gehandhabt werden. Weitere Informationen finden Sie unter Gleichzeitiges Ändern der Implementierungsversion aller Artefakte.
  3. Bearbeiten Sie die URL des Artefakt-Repository in der zuvor von Ihnen erstellten Azure-Variablen artifact_url.
    Beispiel eines Befehls zur Implementierung von Artefakten in dem Nexus-Repository maven-releases (für stabile Release-Artefakte in einer Produktionsumgebung):
    -DaltDeploymentRepository=releases::default::http://nexus:8081/repository/maven-releases/

    Wenn Sie Jobs implementieren möchten, die benutzerdefinierte Komponenten verwenden, müssen Sie die Optionen -Dcomponents.* wie in Benutzerdefinierte Talend Maven-Generierungsoptionen beschrieben verwenden.

  4. Bearbeiten Sie den Arbeitsbereich und die Umgebung von Talend Cloud in der Variablengruppe talend_ci_config.

    Beispiel eines Befehls zur Implementierung von Artefakten (mit Screenshots) in einem Talend Cloud-Konto innerhalb des Arbeitsbereichs namens ci-workspace in einer prod-Umgebung bei gleichzeitiger Änderung der Kontextumgebung zu Prod (mithilfe von --context):

    -Dservice.url=$(talend_cloud_url)
    -Dcloud.token=$(talend_cloud_token)
    -Dcloud.publisher.screenshot=true
    -context=Prod
    -Dcloud.publisher.environment=prod
    -Dcloud.publisher.workspace=ci-workspace

    Diese Umgebung muss zuvor in Talend Studio definiert werden. Wenn Sie allerdings keine Kontextparameter festgelegt haben, können Sie diese zum Zeitpunkt der Generierung über --context_param festlegen.

  5. Führen Sie zur Definition der zu erreichenden Maven-Phase Folgendes durch: Vergewissern Sie sich, dass die auf den Zeilen options und goals angegebenen Phasen- und Generierungsprofile denjenigen entsprechen, die Sie ausführen möchten. In dem von Talend bereitgestellten Standardskript ist als Standardziel deploy (Implementieren) festgelegt.
    Weitere Informationen zu Maven-Phasen finden Sie in der Maven-Dokumentation.
    InformationshinweisTipp: Alle Generierungsprofile (-Pdocker, -Pnexus usw.) sind in der übergeordneten Datei pom.xml Ihres Projekts aufgeführt. Einige Standardparameter, wie z. B. der Name des Docker-Images oder des Open-JDK, können in dieser Datei überschrieben werden.
    Beispiel eines Befehls zur Implementierung der in JAR- oder ZIP-Dateien gepackten Artefakte im gewünschten Nexus-Repository:
    options: '--settings $(settings_xml.secureFilePath) -Pnexus -pl $(jobs_to_build) -am'
    goals: 'clean deploy'

    Beispiel eines Befehls zum Packaging des kompilierten Codes als Docker-Image und dessen Implementierung in der gewünschten Registry:

    options: '--settings $(settings_xml.secureFilePath) -X -Pdocker -pl $(jobs_to_build) -am -Dtalend.docker.name=$(docker_image_name)'
    goals: 'deploy'

Erstellen und Konfigurieren Ihrer Pipeline

Der erste Schritt zur Erstellung einer Pipeline besteht im Import des Git-Repository, in dem die Quellartefakte gespeichert sind.

  1. Gehen Sie zur Seite Pipelines.
  2. Klicken Sie auf Create pipeline (Pipeline erstellen).
  3. Wählen Sie in den Schritten Connect (Verbinden) und Select (Auswählen) den Typ Ihres Quell-Repository und das Repository aus, das Sie importieren möchten, und gewähren Sie Azure dann die Berechtigung, darauf zuzugreifen.
  4. Wählen Sie im Schritt Configure (Konfigurieren) die Starter pipeline (Start-Pipeline) aus, um die Schritte für Ihre Pipeline zu konfigurieren.
  5. Fügen Sie im Schritt Review (Prüfen) den Inhalt der zuvor an die Anforderungen Ihrer Umgebung angepassten Datei azure-pipeline.yml ein.

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!