IBM Cloud Docs
Jenkins の構成

Jenkins の構成

Jenkins は、ソフトウェアを継続的にビルドおよびテストする、サーバー・ベースのオープン・ソースのツールであり、継続的統合および継続的デリバリーの履行をサポートします。

Jenkins ツール統合を作成する前に、Jenkins サーバーを用意する必要があります。

Jenkins ツール統合を使用すれば、Jenkins ジョブ通知をツールチェーン内の他のツール (Slack や PagerDuty など) に送信できます。 デプロイメントでコードをトレースするために、デプロイメント・メッセージを Git コミットや関連 Git/JIRA 問題に追加できます。 また、デプロイメントを「ツールチェーン接続」ページに表示することもできます。 テスト結果を DevOps Insights に送信し、自動化された品質ゲートを追加し、デプロイメント・リスクをトラッキングすることができます。

アプリの継続的なビルド、テスト、デプロイメントを自動化するために Jenkins を構成します。

  1. ツールチェーン作成時にこのツール統合を構成する場合は、「構成可能な統合」セクションで**「Jenkins」**をクリックします。

  2. ツールチェーンがあり、そこにこのツール統合を追加する場合、IBM Cloudコンソールから、メニューアイコンハンバーガーアイコン>Platform Automation>Toolchains をクリックします。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。 あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。 次に、「概要」**をクリックします。

    a. **「ツールの追加」**をクリックします。

    b. 「ツール統合」セクションで**「Jenkins」**をクリックします。

  3. ツールチェーン内の Jenkins カードでこのツール統合に対して表示したい名前を入力します。

  4. ツールチェーンから Jenkins カードをクリックしたときに開くようにしたい Jenkins サーバーの URL を入力します。

  5. 生成されたツールチェーン Web フックをコピーします。

  6. Jenkins サーバーで、以下のステップを実行します。

    a. IBM Cloud DevOpsプラグインをインストールする

    b. ツールチェーンに通知するように Jenkins を構成します

    c. Jenkins ツール統合の「統合の構成 (Configure the Integration)」ページに戻ります。

  7. 「統合の作成」 をクリックします。

  8. ツールチェーンの「概要」ページの**「サード・パーティー・ツール」カードで、「Jenkins」**をクリックして Jenkins サーバーを表示します。

APIを使用したJenkinsの設定

Jenkins ツール統合では、 作成読み取り、および 更新 のツール統合時に ツールチェーンの HTTP API および SDK で使用できる以下の構成パラメーターがサポートされます。

jenkins 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

Jenkinsツール統合パラメータ
パラメーター 使用法 タイプ Terraform 引数 説明
API トークン オプション、更新可能 パスワード API トークン DevOps Insights が Jenkinsからデータを収集できるようにするために、 Jenkins REST API 呼び出しに使用する API トークン。 API トークンは、 Jenkins インスタンスの「構成」ページにあります。 このパラメーターには、ツールチェーン秘密参照を使用できます。 秘密参照について詳しくは、 Continuous Deliveryでの機密データの保護 を参照してください。
API ユーザー名 オプション、更新可能 ストリング API ユーザー名 Jenkins サーバーの API トークンで使用するユーザー名。これは、 DevOps Insights が Jenkinsからデータを収集できるようにするために必要です。 API ユーザー名は、 Jenkins インスタンスの「構成」ページで確認できます。
dashboard_url 必須、更新可能 ストリング dashboard_url このツール統合の Jenkins サーバー・ダッシュボードの URL。 グラフィカル UI では、 Jenkins ツール統合カードをクリックすると、ブラウザーがこのダッシュボードに移動します。
名前 必須、更新可能 ストリング 名前 このツール統合の名前。
Web フック URL オプション、更新可能 ストリング Web フック URL ツールチェーン内の他のツールに通知を送信するために Jenkins ジョブで使用する Web フック。