Jenkins の構成

Continuous Delivery 2027年2月12日をもって、以下の地域において提供が終了となります: au-syd、 ca-tor、 us-east。 また、同日をもって、Code Risk Analyzerもすべての地域で提供を終了いたします。 あるリージョンでこれらの機能が実際に利用されていない場合、そのリージョンの機能は早期に提供が終了し、新しいインスタンスの受け入れが停止される可能性があります。 詳細はこちら

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

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

Jenkins ツール統合を使用すれば、Jenkins ジョブ通知をツールチェーン内の他のツール (Slack や PagerDuty など) に送信できます。 デプロイメントでコードをトレースするために、デプロイメント・メッセージを Git コミットや関連 Git/JIRA 問題に追加できます。 また、デプロイメントを「ツールチェーン接続」ページに表示することもできます。

アプリの継続的なビルド、テスト、デプロイメントを自動化するために 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 トークン Jenkins のREST API呼び出しに使用するAPIトークン。 APIトークンは、 Jenkins インスタンスの「設定」ページで確認できます。 このパラメーターには、ツールチェーン秘密参照を使用できます。 シークレット参照の詳細については、 『 Continuous Delivery 』の「機密データの保護 」を参照してください。
API ユーザー名 オプション、更新可能 ストリング API ユーザー名 Jenkins サーバーのAPIトークンで使用するユーザー名。 APIユーザー名は、 Jenkins インスタンスの「設定」ページで確認できます。
dashboard_url 必須、更新可能 ストリング dashboard_url このツール統合のサーバー Jenkins ダッシュボードの URL グラフィカルUIでは、ツール統合 Jenkins カードをクリックするとブラウザがこのダッシュボードに移動します。
名前 必須、更新可能 ストリング 名前 このツール統合の名前。
Web フック URL オプション、更新可能 ストリング Web フック URL ツールチェーン内の他のツールに通知を送信するために Jenkins ジョブで使用する Web フック。