YAMLパラメーターを環境に適合化 - Cloud

クラウド版Talendソフトウェア開発ライフサイクル - ベストプラクティスガイド

Version
Cloud
Language
日本語 (日本)
Product
Talend Cloud
Module
Talend Artifact Repository
Talend Management Console
Talend Studio
Content
ジョブデザインと開発
デプロイメント
管理と監視

目標とするMavenフェーズと、アーティファクトのデプロイ先とするリポジトリーに従って、Talendが提供するパイプラインスクリプトを設定してプロジェクトアイテムを生成します。

注: 例として提供されているazure-pipeline.ymlスクリプトファイルでは、Talend Cloud Management Consoleにアーティファクトをビルドして公開できます。アーティファクトをアーティファクトリポジトリーやDockerに公開したい場合は、スクリプト内の対応するパラメーターをコメント解除します。

パラメーターや認証情報によっては、Azure DevOpsに保存したセキュアファイルや変数に派生するものもあります。パイプラインの設定で使用できるTalendMavenのパラメーターに関するその他の情報は、TalendのカスタムMavenビルドのオプションを参照してください。

手順

  1. スクリプトの先頭で定義した環境変数(プロジェクト名、ジョブ名/バージョン/タイプ、リポジトリーURLなど)に独自の値を設定します。
    ヒント: Talendが例として提供しているXXX参照をazure-pipeline-*.ymlスクリプト内で探し、お使いの環境に対応する値に置換します。

    プロジェクト名がCICD、ジョブ名がjob_feature956でバージョンが0.1の例:
    variables:
    - group: Talend Variables
    - name: project_name
      value: 'CICD'
    - name: jobs_to_build
      value: 'jobs/process/job_feature956_0.1'
    警告: 構文の要件:
    • project_name変数の値は大文字でなければならず、それ以外の場合はビルドエラーが発生する可能性があります。プロジェクト名に特殊文字を必要とするか、または最終構文に疑問がある場合は、プロジェクトの親pom.xmlファイル(<project>/poms/pom.xml内のtalend.project.name変数)で確認できます。
    • ジョブ/ルート/サービスの元の名前に大文字が含まれていた場合でも、jobs_to_build変数の値は小文字でなければなりません。これは、ビルドの起動に必要な.pomファイル内ではアーティファクトがすべて小文字であるためです。
    • -SNAPSHOTサフィックスはバージョン値に手動で追加しないでください。スナップショットとリリースはバージョン自体から切り離されており、Studioの環境設定からのみ操作する必要があります。各アーティファクトのデプロイメントバージョンを一括変更を参照してください。
  2. アーティファクトの公開先に合わせて、前に作成したartifact_urlというAzure変数に記述されているアーティファクトリポジトリーのURLを編集します。

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

    アーティファクトをNexus maven-releasesリポジトリーにデプロイできます(本番環境における安定リリース版のアーティファクト用)。

    注: カスタムコンポーネントを使うジョブをデプロイする場合は、TalendのカスタムMavenビルドのオプション-Dcomponents.*オプションを使う必要があります。
  3. talend_ci_config変数グループに記述されているTalend Cloudワークスペースと環境を編集します。

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

    (--contextを使って)コンテキスト変数をProdに変更しながら、PROD環境のci-workspaceという名前のワークスペースにあるTalend Cloudアカウントにアーティファクトを(スクリーンショットと共に)デプロイできます。この環境はTalend Studioで前もって定義しておく必要があります。ただし、コンテキストパラメーターが未定義の場合は、--context_paramを使用してビルド時に定義できます。

    注: Talend Cloudに公開するアーティファクトは400MBを超えないようにしてください。
  4. 到達するMavenフェーズを定義するには:options行に記述されているフェーズが自分が実行したいものであることを確認します。Talendで提供されているデフォルトスクリプトで定義されているデフォルト目標は、deployです。
    Mavenのフェーズについては、Mavenのドキュメンテーションをご覧ください。
    ヒント: すべてのビルドプロファイル(-Pdocker -Pnexusなど)がプロジェクトの親pom.xmlファイルにリスト表示されます。Dockerイメージ名や、Open JDK名など、一部のデフォルトパラメーターはこのファイルで上書きすることもできます。
  5. 変更を保存し、[Run] (実行)をクリックしてビルドパイプラインの実行を開始します。