Jenkins連携

Jenkins連携

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

DevOpsツールは、コラボレーションを促進し、自動化を活用して、プロセスや進捗の追跡・監視を強化するためのツールです。顧客の要件が増える中、開発チームと運用チームには、短いフェーズで成果を出すことが求められます。特にアジャイルチームには、作業を整理し、期限どおりに成果を提供するために、DevOpsツールの導入を強くお勧めします。
Jenkinsは、Zoho Sprintsと安全に連携し、開発チームに必要なサポートを提供する、定評のあるツールです。

Jenkins連携のメリット

Jenkinsは、CI/CD(継続的インテグレーション/継続的デプロイ)に優れた自動化ツールです。開発者を支援し、ビルドの更新をスムーズにします。Jenkinsとの安定した連携により、アジャイルチームの作業を実行に移しながら、パイプライン内のさまざまなケースに応じて次の操作を行えます。
  1. Zoho Sprintsに移動せずに、作業項目、スプリント、リリースを追加できます。
  2. 作業項目、スプリント、リリースを更新できます。
  3. Jenkinsから直接スプリントを開始・完了できます。
  4. Jenkinsから直接、作業項目、スプリント、リリースにコメントを追加できます。
  5. Jenkinsでビルドが更新されるたびに、フィードにステータスを追加できます。
 
開発関連の作業項目をJenkinsから直接実行し、Zoho Sprintsで追跡できます。

アラート
メモ:Jenkins連携を有効にするには、最新バージョンのZoho Sprintsプラグインをインストールする必要があります。旧バージョンを使用している場合は、連携を引き続き利用するために、新しいバージョンに更新してください。

Sprints-Jenkinsプラグインのインストール

  1. 最新のSprintsプラグインをJenkinsインスタンスにインストールします。
  2. インストール後、Jenkinsインスタンスを再起動します。
    メモ:Zoho SprintsからのJenkins設定が完了すると、ポータル所有者の認証情報が自動的に共有されます。

 

Zoho Sprintsからの設定

  1. 右上の設定アイコンをクリックします。設定ページが表示されます。
  2. [その他]を[マーケットプレイス]内で選択します。連携用のアプリが表示されます。

  3. Jenkinsアプリに移動します。
  4. 利用規約に同意します。
  5. [今すぐ有効にする]ボタンをクリックします。

  6. [JenkinsホストURL]を入力します。
  7. [ユーザーID]を入力します。
  8. [APIトークン]を入力します。以下のセクションを参照してください。

  9. [設定を追加]ボタンをクリックします。設定が完了します。

  10. [設定]ボタンをクリックして、Zoho SprintsによるJenkinsへのアクセスの承認に進みます。
  11. [承認する]ボタンをクリックして連携を完了します。
APIトークンを生成するには
  1. Jenkinsにサインインします。
  2. 上部の[プロフィール]メニューを選択します。

  3. ドロップダウンの[設定]をクリックします。
  4. APIトークンのセクションで、[新しいトークンを追加]ボタンをクリックします。

  5. トークンの名前を入力します。
  6. [生成]ボタンをクリックします。

  7. 生成したトークンは作成時にしか表示されないため、コピーしておきます。
 

Zoho Sprintsでのビルド詳細の表示

Jenkinsで行われたすべてのビルド更新を、Zoho Sprintsのチームで追跡できます。
  1. Zoho Sprintsにサインインします。
  2. 左側のナビゲーションパネルで[CI/CD]を選択します。
  3. [Jenkins]を選択します。ビルド関連のすべてのログが一覧表示されます。

  4. カーソルを合わせて[詳細を表示]リンクをクリックすると、ビルドの詳細に移動します。ビルド名と詳細を確認できます。

  5. カーソルを合わせて[ログを表示]リンクをクリックすると、Jenkinsに移動してログを確認できます。
    メモ:ジョブ名のドロップダウンをクリックすると、ジョブを選択できます。
メモビルドの安定性の割合と、ビルドのステータス情報を確認できます。

Jenkinsの作業項目の入力項目

Jenkinsアカウントから作業項目を作成する際は、次の項目を使用できます:
  1. [プロジェクト番号]:プロジェクト番号を入力します。例:14。プロジェクト「#P14」から番号を取得します。
  2. [スプリント番号]:スプリント番号を入力します。例:7。スプリント「SP7」から番号を取得します。
  3. [作業項目番号]:作業項目番号を入力します。例:9。作業項目「I9」から番号を取得します。
  4. [作業項目名]:作業項目のタイトルと同じ名前を入力します。
  5. [説明]:作業項目の説明を入力します。
  6. [担当者]:作業項目のユーザーのメールアドレスをコンマで区切って入力します。
  7. [種類]:作業項目の種類を入力します。例:タスク、不具合、ストーリー。
  8. [ステータス]:作業項目のステータスを指定します。例:未着手。
  9. [優先度]:優先度を指定します。例:高。
  10. [開始日]:作業項目の開始日を指定します。例:2022-08-13T00:00:00Z。
  11. [終了日]:作業項目の終了日を指定します。例:2022-08-13T00:00:00Z。
  12. [期間]:スプリントのおおよその期間を指定します。厳格なスクラムが有効な場合、スプリントの期間は最長8週間です。無効な場合は、最長30週間まで設定できます。例:2hrs 50min。
  13. [カスタム項目]:こちらにカスタム項目の値を指定します。複数のカスタム項目がある場合は、項目ごとに改行して入力します。
    例:
カスタム項目の入力:
UDF1_BOOLEAN=123456
UDF1_TEXT=text value

Jenkinsのスプリントの項目

Jenkinsアカウントからスプリントを作成する際は、次の項目を使用できます:

  1. [プロジェクト番号]:プロジェクト番号を入力します。例:14。プロジェクト「#P14」から番号を取得します。
  2. [スプリント番号]:スプリント番号を入力します。例:7。スプリント「SP7」から番号を取得します。
  3. [スプリント名]:スプリントのタイトルと同じ名前を入力します。
  4. [説明]:スプリントの説明を入力します。
  5. [スクラムマスター]:スクラムマスターのメールアドレスを入力します。
  6. [スプリントのユーザー]:スプリントのユーザーのメールアドレスをコンマで区切って入力します。
  7. [開始日]:スプリントの開始日を指定します。例:2022-08-13T00:00:00Z。
  8. [終了日]:スプリントの終了日を指定します。例:2022-08-13T00:00:00Z。
  9. [期間]:スプリントのおおよその期間を指定します。厳格なスクラムが有効な場合、スプリントの期間は最長8週間です。無効な場合は、最長30週間まで設定できます。例:2hrs 50min。
  10. [カスタム項目]:こちらにカスタム項目の値を指定します。複数のカスタム項目がある場合は、項目ごとに改行して入力します。
    例:
    UDF1_BOOLEAN=12345
    UDF1_TEXT=text value

 Jenkinsのリリースの項目

Jenkinsアカウントからリリースを作成する際は、次の項目を使用できます:
  1. [プロジェクト番号]:プロジェクト番号を入力します。例:14。プロジェクト「#P14」から番号を取得します。
  2. [リリース名]:リリースの名前を入力します。例:1。リリース「R1」から番号を取得します。
  3. [リリースの目標]:リリースの目的を入力します。
  4. [開始日]:リリースの開始日を入力します。例:2022-08-13T00:00:00Z。
  5. [リリース日]:リリース日を入力します。例:2022-10-13T00:00:00Z。
  6. [所有者]:所有者のメールアドレスをコンマで区切って入力します。
  7. [リリースのステージ]:リリースの現在のステージを指定します。例:計画中。
  8. [カスタム項目]:こちらにカスタム項目の値を指定します。複数のカスタム項目がある場合は、項目ごとに改行して入力します。
    1. 例:
      UDF1_BOOLEAN=12345
      UDF1_TEXT=text value

 

Jenkinsのビルドアクション

Jenkinsでは、次のビルドアクションを利用できます:
  1. 作業項目の作成
  2. スプリントの作成
  3. リリースの作成
  4. 作業項目の更新
  5. スプリントの更新
  6. リリースの更新
  7. スプリントの開始
  8. スプリントの完了
  9. 作業項目、リリース、スプリントへのコメントの追加
  10. フィードへのステータスの追加
  11. ビルド失敗時の作業項目の作成

Jenkinsからの作業項目の作成

Jenkinsから作業項目を追加するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューで[設定]をクリックします。
  4. [ビルド手順を追加]をビルドセクションで選択します。

  5. [[Zoho Sprints] 作業項目を作成]をクリックします。作業項目の入力項目が表示されます。
  6. 作業項目の詳細を入力します。こちらを参照してください。
  7. 変更内容を[保存]し、[適用]します。

  8. [今すぐビルド]をクリックしてAPIを実行します。

 

Jenkinsからのスプリントの作成

Jenkinsからスプリントを作成するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューで[設定]をクリックします。
  4. [ビルド手順を追加]をビルドセクションで選択します。
  5. [[Zoho Sprints] スプリントを作成]をクリックします。スプリントの項目が表示されます。
  6. スプリントの詳細を入力します。こちらを参照してください。
  7. 変更内容を[保存]し、[適用]します。
  8. [今すぐビルド]をクリックしてAPIを実行します。

Jenkinsからのリリースの作成

Jenkinsからリリースを作成するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] リリースの作成]をクリックします。リリースの項目が表示されます。
  6. リリースの詳細を入力します。こちらをご参照ください。
  7. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  8. APIを実行するために[今すぐビルド]をクリックします。

Jenkinsからのアイテムの更新

Jenkinsからアイテムのステータスを更新するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] アイテムの更新]をクリックします。アイテムの項目が表示されます。
  6. 対象のプロジェクト、スプリント、アイテムの番号を入力します。こちらをご参照ください。
  7. 変更内容を入力します。たとえば、ステータスや優先度を変更します。
  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。


Jenkinsからのスプリントの更新

Jenkinsからアイテムのステータスを更新するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] スプリントの更新]をクリックします。スプリントの項目が表示されます。
  6. 対象のプロジェクトとスプリントの番号を入力します。こちらをご参照ください。
  7. 変更内容を入力します。たとえば、スプリントの開始日と終了日を変更します。
  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。
 

フィードへのステータスの追加

Jenkinsからプロジェクトのフィードに直接ステータスを追加できます。
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] フィードへのステータスの追加]をクリックします。
  6. 対象のプロジェクト番号を入力します。
  7. ステータスセクションにステータスの内容を入力します。メモ:スクリプトに関連する情報はすべて自動的に削除されます。

  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。

 

アイテムへのコメントの追加

Jenkinsからアイテムにコメントを追加できます。
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] アイテムへのコメントの追加]をクリックします。
  6. 対象のプロジェクト、スプリント、アイテムの番号を入力します。
  7. コメントを入力します。

  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。
 

リリースへのコメントの追加

Jenkinsからリリースにコメントを追加できます。
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] リリースへのコメントの追加]をクリックします。
  6. 対象のプロジェクトとリリースの番号を入力します。
  7. コメントを入力します。
  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。
 

スプリントへのコメントの追加

Jenkinsからスプリントにコメントを追加できます。
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] スプリントへのコメントの追加]をクリックします。スプリントの項目が表示されます。
  6. 対象のプロジェクトとスプリントの番号を入力します。
  7. コメントを入力します。
  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。

 

リリースの更新

リリースを更新するには:
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] リリースの更新]をクリックします。リリースの項目が表示されます。
  6. 対象のプロジェクトとリリースの番号を入力します。
  7. リリースの更新先のステージを入力します。こちらをご参照ください。
  8. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  9. APIを実行するために[今すぐビルド]をクリックします。

スプリントの開始

Jenkinsからスプリントを開始するには
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] スプリントの開始]をクリックします。
  6. 対象のプロジェクトとスプリントの番号を入力します。
  7. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  8. APIを実行するために[今すぐビルド]をクリックします。
 

スプリントの完了

Jenkinsからスプリントを完了するには
  1. Jenkinsアカウントにサインインします。
  2. [ビルド]に移動します。
  3. 左側のメニューから[設定]をクリックします。
  4. ビルドセクションで[ビルド手順の追加]を選択します。
  5. [[Zoho Sprints] スプリントの完了]をクリックします。
  6. 対象のプロジェクトとスプリントの番号を入力します。
  7. [保存]と[適用]をクリックして、変更内容を保存・適用します。
  8. APIを実行するために[今すぐビルド]をクリックします。

Jenkinsのビルド後の処理

上記のすべての操作は、Jenkinsアカウントからビルド後の処理として実行できます。また、ビルドが失敗した場合に新しいアイテムを作成することもできます。