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 を構成します。
-
ツールチェーン作成時にこのツール統合を構成する場合は、「構成可能な統合」セクションで**「Jenkins」**をクリックします。
-
ツールチェーンをお持ちで、そこにこのツールの統合を追加する場合は、 IBM Cloud コンソールで、 メニュー アイコン(
) > [Platform Automation ] > [Toolchains ] の順にクリックしてください。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。
a. **「ツールの追加」**をクリックします。
b. 「ツール統合」セクションで**「Jenkins」**をクリックします。
-
ツールチェーン内の Jenkins カードでこのツール統合に対して表示したい名前を入力します。
-
ツールチェーンから Jenkins カードをクリックしたときに開くようにしたい Jenkins サーバーの URL を入力します。
-
生成されたツールチェーン Web フックをコピーします。
-
Jenkins サーバーで、以下のステップを実行します。
a. IBM Cloud DevOpsプラグインをインストールする。
b. ツールチェーンに通知するように Jenkins を構成します。
c. Jenkins ツール統合の「統合の構成 (Configure the Integration)」ページに戻ります。
-
「統合の作成」 をクリックします。
-
ツールチェーンの「概要」ページの**「サード・パーティー・ツール」カードで、「Jenkins」**をクリックして Jenkins サーバーを表示します。
API を使用した Jenkins の設定
ツール Jenkins 統合は 、ツールチェーン HTTP API および SDK を使用してツール統合 を作成、 読み取り、 更新する際に使用できる以下の構成パラメータをサポートしています。
jenkins 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。
| パラメーター | 使用法 | タイプ | 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 フック。 |