Automation Pipelines を Jenkins と統合する方法
Automation Pipelines
を Jenkins と統合する方法Automation Pipelines
には、Jenkins プラグインが搭載されています。Jenkins ジョブをトリガしてソース コードをビルドおよびテストするというものです。この Jenkins プラグインは、テスト ケースを実行し、カスタム スクリプトを使用できます。 - バージョン 1.561 以降を実行している Jenkins サーバをセットアップします。
- Automation Pipelinesで、プロジェクトのメンバーであることを確認します。メンバーでない場合は、プロジェクトにメンバーとして追加するようにAutomation Pipelines管理者に依頼します。Automation Pipelinesでプロジェクトを追加する方法を参照してください。
- Jenkins サーバにジョブがあり、パイプライン タスクがそのジョブを実行できるようになっていることを確認します。
パイプラインで Jenkins ジョブを実行するには、Jenkins サーバを使用し、
Automation Pipelines
で Jenkins エンドポイントを追加します。次に、パイプラインを作成し、Jenkins タスクを追加します。 Automation Pipelines
で Jenkins タスクと Jenkins エンドポイントを使用すると、Jenkins でマルチブランチ ジョブをサポートするパイプラインを作成できます。マルチブランチ ジョブには、Git リポジトリの各ブランチに独立したジョブが含まれます。マルチブランチ ジョブをサポートするパイプラインを Automation Pipelines
内に作成するには、次の処理を行います。- Jenkins タスクは、Jenkins サーバ上の複数のフォルダにある Jenkins ジョブを実行できます。
- Jenkins タスク設定のフォルダ パスをオーバーライドして、別のフォルダ パスを使用できます。このパスは、Automation Pipelinesの Jenkins エンドポイントで定義されているデフォルトのパスをオーバーライドします。
- Automation Pipelinesのマルチブランチ パイプラインは、Git リポジトリまたは GitHub リポジトリに含まれる.groovyタイプの Jenkins ジョブ ファイルを検出し、リポジトリ内でスキャンした各ブランチでジョブの作成を開始します。
- Jenkins エンドポイントで定義されているデフォルトのパスを、Jenkins タスク設定で指定したパスでオーバーライドして、メインの Jenkins ジョブ内の任意のブランチに関連付けられたジョブとパイプラインを実行できます。
- Jenkins エンドポイントを追加し、検証します。
- の順にクリックします。
- プロジェクトを選択し、エンドポイントのタイプとしてJenkinsを選択します。次に、名前と説明を入力します。
- このエンドポイントがインフラストラクチャのビジネス クリティカルなコンポーネントである場合は、制限付きとしてマークを有効にします。
- Jenkins サーバの URL を入力します。
- Jenkins サーバにログインするためのユーザー名とパスワードを入力します。次に、その他の情報を入力します。Jenkins エンドポイントのその他の情報エンドポイントの入力情報説明フォルダ パスジョブをグループ化するフォルダのパス。Jenkins は、フォルダ内のすべてのジョブを実行できます。サブフォルダを作成できます。例：
- folder_1にjob_1を含めることができます
- folder_1にfolder_2を含め、そこにjob_2を含めることができます
folder_1のエンドポイントを作成するとフォルダ パスはjob/folder_1となり、エンドポイントにはjob_1のみが表示されます。folder_2という名前の子フォルダにあるジョブのリストを取得するには、そのフォルダ パスを/job/folder_1/job/folder_2/として使用するエンドポイントを別途作成する必要があります。マルチブランチ Jenkins ジョブのフォルダ パスマルチブランチ Jenkins ジョブをサポートするには、Jenkins タスクで、Jenkins サーバの URL とジョブの完全なパスを含むフル パスを入力します。Jenkins タスクにフォルダ パスを含めると、そのパスは Jenkins エンドポイントに表示されるパスをオーバーライドします。Jenkins タスクでカスタム フォルダ パスを使用した場合、Automation Pipelinesはそのフォルダ内のジョブだけを表示します。- 例：https://server.yourcompany.com/job/project
- パイプラインでメインの Jenkins ジョブもトリガする必要がある場合は、次のパスを使用します。https://server.yourcompany.com/job/project/job/main
URLJenkins サーバのホスト URL。URL をprotocol://host:portの形式で入力します。例：http://192.10.121.13:8080ポーリング間隔Automation Pipelinesが Jenkins サーバをポーリングして更新を確認する間隔。申請の再試行回数Jenkins サーバのスケジュール設定されたビルド申請を再試行する回数。再試行の待機時間Jenkins サーバのビルド申請を再試行するまでの待機時間（秒単位）。 - 検証をクリックし、エンドポイントがAutomation Pipelinesに接続されていることを確認します。接続されていない場合は、エラーを修正し、保存をクリックします。
- コードをビルドするには、パイプラインを作成し、Jenkins エンドポイントを使用するタスクを追加します。
- の順にクリックします。
- デフォルトのステージをクリックします。
- [タスク] 領域で、タスクの名前を入力します。
- タスク タイプにJenkinsを選択します。
- 作成した Jenkins エンドポイントを選択します。
- ドロップダウン メニューから、パイプラインが実行する Jenkins サーバ上のジョブを選択します。
- ジョブのパラメータを入力します。
- Jenkins ジョブの認証トークンを入力します。
- パイプラインを有効にして実行し、パイプラインの実行状況を表示します。
- パイプライン ダッシュボードで実行の詳細とステータスを確認します。障害があれば特定し、その理由を突き止めます。また、パイプラインの実行期間、完了、および障害に関するトレンドも表示できます。
完了です。エンドポイントを追加し、パイプラインを作成し、コードをビルドする Jenkins タスクを設定して、
Automation Pipelines
を Jenkins と統合しました。 Jenkins ビルド タスクの YAML の例
この例で使用したタイプの Jenkins ビルド タスクの場合、YAML は次のコードに似ています。通知が有効になっています。
test: type: Jenkins endpoints: jenkinsServer: jenkins input: job: Add two numbers parameters: Num1: '23' Num2: '23'
詳細については、他のセクションを参照してください。エンドポイントへの Automation Pipelines の接続を参照してください。