# 前提条件

自動アーティファクト実行およびデプロイメントのスケジューリングを開始する前に、前提条件をいくつか確認する必要があります。

* 継続的インテグレーションサーバー/サービス(ここではJenkinsまたはAzure DevOps)が適切に設定されていること。詳細は、[JenkinsのWebサイト](https://jenkins-ci.org/)と[Azure DevOpsのWebサイト](https://azure.microsoft.com/ja-jp/services/devops/)をご覧ください。

* ジョブの実行に必要な外部ライブラリーがこのプロジェクトに適切にインストールされており、アーティファクトリポジトリーが開始されていること。

* Jenkinsを使用する場合は、Apache Maven 3.6.3以上のバージョンがサーバーにインストールされていることの確認も必要です。詳細は、[Apache MavenのWebサイト](https://maven.apache.org/index.html)をご覧ください。

* (オプション)自動的に実行したいプロジェクト内にテストケースが作成済みであること。詳細は、[テストをデザイン](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/ci-test-cases)をご覧ください。

  情報メモ注: プロジェクトをビルドしてデプロイする場合、テストケースはJUnit Surefireレポートとなり、Mavenのpackagingフェーズの前にビルドされます。

* (オプション) DockerイメージをDockerレジストリーにプッシュできるよう、Docker環境をインストールし、設定済みであること。詳細は、[DockerのWebサイト](https://www.docker.com/)をご覧ください。DockerコンテナーレジストリーはAzure DevOpsアカウント内にインストールできます。

* 継続的インテグレーションのビルドを使ってアーティファクトを公開する時、Talend Management ConsoleにGitの情報(作者、コミットID、コミット日時)を表示させるためには、この階層ストラクチャーでGitプロジェクトのリポジトリーを設定し、全プロジェクトをci-workspaceフォルダーに(移動ではなく)コピーする必要があります。

  ```
  ci-workspace
      |- .repositories
           |- <any_unique_name>
                |- .git
                |- MAINPROJ1
           |- <any_unique_name>
                |- .git
                |- REFPROJ1
           |- <any_unique_name>
                |- .git
                |- REFPROJ2
                |- REFPROJ3
      |- MAINPROJ1
      |- REFPROJ1
      |- REFPROJ2 
      |- REFPROJ3
  ```

* Talend Data Mapper X12 HIPAAパッケージやHL7v2パッケージを必要とするアーティファクトをビルドするためにCIを使用している場合は、次の操作が必要です。

  * Talend\_Full\_Studio\_p2\_repository--YYYYYYYY\_YYYY-VA.B.C.zipアーカイブを&lt;folder&gt;/org.talend.transform.standard.p2.repository-A.B.Cに抽出します。
  * ジョブをビルドする前に、次のコマンドを使ってTalend CommandLineにこれらのパッケージをインストールします。
    ```
    Talend-Studio-win-x86_64.exe -nosplash -consoleLog -application org.eclipse.equinox.p2.director 
    -repository file:///<folder>/org.talend.transform.standard.p2.repository-A.B.C 
    -installIU org.talend.transform.standard.x12.hipaa.5010.feature.feature.group
    ```

情報メモ警告: 次の前提条件は、Talendが提供するP2アップデートサイトアーカイブを有するユーザーのみが対象です。

ビルド中にTalend CommandLineがTalendアップデートサイトから自動的にダウンロードおよびインストールされ、プロジェクトアーティファクトを生成して実行します。詳細は、[Talend CIゼロインストールワークフロー](https://help.qlik.com/talend/ja-JP/software-dev-lifecycle-best-practices-guide/8.0/talend-ci-zero-install)をご覧ください。

ビルド時にTalend CommandLineが自動的にダウンロードされるようにするには、Talendが提供するTalend\_Full\_Studio\_p2\_repository-YYYYMMDD\_HHmm-VA.B.C.zipアーカイブをローカルのHTTPサーバーでホストする必要があります。詳細は、[アップデートリポジトリーをホストして設定](https://help.qlik.com/talend/r/ja-JP/8.0/installation-guide-windows/setting-up-update-repositories-by-hosting-them)をご覧ください。

Talendは、1台のマシンでTalend CommandLineを同時に2つ以上実行することはお勧めしません。これを防ぐ最も簡単な方法は、サーバーでのエグゼキューターの数を1つに制限することです。

まとめると、必要なアプリケーションは次のようになります: 継続的インテグレーションサーバーまたはサービス、Git、アーティファクトリポジトリー、P2アップデートサイトをホストするサーバー(Talend CommandLine、および自分のアーティファクトのビルドに必要なその他のプラグインを保存)。アーティファクトをどこにデプロイするかによって、アーティファクトリポジトリー、Docker、Talend Cloudにアクセスする必要があります。