Jenkins の構成
Jenkins は、ソフトウェアを継続的にビルドおよびテストする、サーバー・ベースのオープン・ソースのツールであり、継続的統合および継続的デリバリーの履行をサポートします。
Jenkins ツール統合を作成する前に、Jenkins サーバーを用意する必要があります。
Jenkins ツール統合を使用すれば、Jenkins ジョブ通知をツールチェーン内の他のツール (Slack や PagerDuty など) に送信できます。 デプロイメントでコードをトレースするために、デプロイメント・メッセージを Git コミットや関連 Git/JIRA 問題に追加できます。 また、デプロイメントを「ツールチェーン接続」ページに表示することもできます。 テスト結果を DevOps Insights に送信し、自動化された品質ゲートを追加し、デプロイメント・リスクをトラッキングすることができます。
アプリの継続的なビルド、テスト、デプロイメントを自動化するために 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 トークン | 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 フック。 |