Jenkins を自動化で使用する

この記事では、現在展開している機能について説明します。これらの機能がサイト上で公開される時期は、リリース ノートまたはアトラシアン コミュニティでご確認ください。

自動化と Jenkins の統合は、Jira Service Management Cloud Premium プランまたは Enterprise プランのお客様のみがご利用になれます。プランのアップグレード方法をご確認ください。

Jenkins アカウントをスペースに接続すると、コード デリバリー プロセスの管理のプロセスを自動化できます。

これらのアクションを使用するには、Jenkins アプリをアトラシアン自動化に接続する必要があります。ほとんどの自動化アクションでは、選択すると接続セットアップ メッセージが表示されます。接続が確立されると、Jenkins イベントに基づいてアクションを自動化し、トリガーを設定できます。

はじめる前に

Jira スペースの自動化を管理するには、次のような適切なスペース権限が必要です。

グローバル自動化を管理するには、Jira 管理権限が必要です。Jira Cloud のグローバル権限に関する詳細についてご確認ください。

自動化ルールを Jenkins と統合する

  1. [自動化] に移動して [ルールを作成] を選択します。

  2. ルールに適用する Jenkins アクションを選択します。

  3. [接続] を選択して、Jenkins との接続を作成します。接続すると、自動化ルールによって他のツールや製品からデータを取得できるようになります。

  4. Jenkins との接続を確立するために必要な以下の情報を入力します。

  • 接続名: Jenkins 接続の名前を入力します。

  • Username (ユーザー名): Jenkins のユーザー名を入力します。

  • API token (API トークン): Jenkins から、アトラシアン自動化に接続するための API キーを入力します。

  • Domain URL (ドメイン URL):Jenkins のベース URL を入力します。

5. [接続] を選択して接続の作成を完了します。

操作

Jenkins のシステム情報を取得する

このアクションを使用すると、Jenkins インスタンスに関する重要な詳細を含むシステム ヘルス、ジョブ、およびステータスを取得できます。

スマート値

{{fetchedJenkinsInfo}} — Jenkins のシステム情報を返します。

ジェンキンス ジョブの詳細を取得する

このアクションを使用すると、ビルド履歴、健全性、構成など、Jenkins ジョブの詳細を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • Job name (ジョブ名): 詳細を取得したい Jenkins ジョブの名前を入力します。

  • JSON filter (JSON フィルター): 取得するジョブの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsJob}} — Jenkins ジョブを返します。

Jenkins ビルドをトリガーする

このアクションを使用すると、Jenkins ジョブの新しいビルドを開始し、既定構成を使用してジョブをキューに追加できます。

次のフィールドに入力するか、スマート値を使用して選択します。

Job name (ジョブ名): ビルドする Jenkins ジョブの名前を入力します。

スマート値

{{fetchedJenkinsBuild}} — Jenkins ビルドを返します。

Jenkins の最新のビルド情報を入手する

このアクションを使用すると、ステータス、期間、結果など、Jenkins ジョブの最新のビルドに関する情報を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • Job name (ジョブ名): チェックする Jenkins ジョブの名前を入力します。

  • JSON filter (JSON フィルター): 取得するビルドの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsBuild}} — Jenkins ビルドを返します。

Jenkins ビルド キューを取得する

このアクションを使用すると、現在の Jenkins ビルド キューを取得し、保留中のビルドとシステム負荷を確認できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • JSON filter (JSON フィルター): 取得するキューの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsBuild}} — Jenkins ビルドを返します。

Jenkins ビルドの情報を取得する

このアクションを使用すると、ログ、成果物、実行の詳細など、特定の Jenkins ビルドの詳細を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • Job name (ジョブ名): Jenkins ジョブの名前を入力します。

  • Build ID (ビルド ID): 情報を取得するビルド ID を入力します。

  • JSON filter (JSON フィルター): 取得するビルドの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • Detail level (詳細レベル): 含める詳細レベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsBuild}} — Jenkins ビルドを返します。

Jenkins のすべてのジョブを取得する

このアクションによって、すべての Jenkins ジョブの名前とステータス カラーが含まれたリストを取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • JSON filter (JSON フィルター): 取得するキューの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsJobList}} — Jenkins ジョブのリストを返します。

Jenkins ユーザーの詳細を取得する

このアクションによって、ユーザー プロパティ、権限、アカウントの詳細など、特定の Jenkins ユーザーに関する詳細を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • Username (ユーザー名): ユーザーの名前を入力します。

  • JSON filter (JSON フィルター): 取得するキューの詳細を指定する JSON フィルターを入力します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

スマート値

{{fetchedJenkinsUser}} — Jenkins ユーザーの詳細を返します。

Jenkins プラグイン情報を取得する

このアクションによって、バージョン、ステータス、依存関係など、インストールされている Jenkins プラグインに関する情報を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • JSON フィルター: JSON フィルターを入力して、返すフィールドを指定します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

Jenkins のノード情報をすべて取得する

このアクションによって、ステータス、実行者、システム リソース、監視データなど、すべての Jenkins ノードに関する詳細を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • JSON フィルター: JSON フィルターを入力して、返すフィールドを指定します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

Jenkins のノード情報を取得する

このアクションによって、実行者ステータス、システム監視データ、ラベル、設定の詳細など、特定の Jenkins ノードに関する詳細を取得できます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • ノード名: Jenkins ノードの名前を入力します。

  • JSON フィルター: JSON フィルターを入力して、返すフィールドを指定します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

Jenkins ビューの情報を取得する

このアクションによって、Jenkins ビューの詳細を取得できます。これは、カスタマイズされた基準に基づくジョブの整理やフィルタリングに役立ちます。

次のフィールドを入力するか、スマート値を使用して選択します。

  • ビュー名: Jenkins ビューの名前を入力します。

  • JSON フィルター: JSON フィルターを入力して、返すフィールドを指定します。例: jobs[name,color]

  • 詳細レベル: 詳細のレベルを選択します。レベルが高いほど、より多くのネストされたデータが含まれます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。