Azure DevOps Pipeline拡張機能

Azure DevOps Pipeline拡張機能

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

Azure DevOps Pipelineは、コードプロジェクトのビルド、テスト、実行を自動化するWebサービスです。Zoho SprintsにAzure DevOps Pipeline拡張機能をインストールできるようになりました。この拡張機能をインストールすると、Azure DevOps Pipelineから項目、スプリント、リリースに対する操作を実行できます。また、ビルドをZoho Sprintsの作業項目に関連付けたり、パイプラインのビルドの詳細を表示したりできます。

メモ
メモ:Azure DevOpsパイプラインの実行に関するトラブルシューティングで詳細ログやHTTPトレースログを有効にすると、ログファイルに機密情報が記録されます。これらのファイルは他の人と共有しないでください。

クラウドとサーバー向けのAzure DevOps Pipeline拡張機能の設定

拡張機能を設定するには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. [マーケットプレイス]セクションの[その他]をクリックします。一覧ページが表示されます。
  3. Azure DevOps Pipeline拡張機能の[設定]をクリックします。
  4. プロジェクトとアクセシビリティを選択し、[今すぐインストール]をクリックします。
  5. ドメイン/ホストのURLを入力します。

  6. [Azure DevOpsの組織]名(Azure DevOps Serverの場合は[コレクション名])を入力します。
  7. [保存して次へ]をクリックします。
  8. 外部連携と実行条件を認証します。Azure DevOpsの外部連携を認証する際は、次のスコープを指定してAzure DevOpsで個人アクセストークンを生成してください:
    1. Build.Read
    2. Code.Read
    3. プロジェクトとチームの読み取り
    4. 拡張機能の読み取りと管理(ポータル所有者のみ)
    5. サービス接続の読み取り、クエリー、管理(ポータル所有者のみ)
  9. Azure DevOpsから関連付けるプロジェクトを選択します。サーバーの場合は、AzureのAPI制限があるため、プロジェクトを1件だけ選択してください。

  10. [関連付ける]をクリックします。選択したプロジェクトが関連付けられます。
Azure DevOps Pipeline拡張機能をインストールすると、Visual StudioのZoho Sprints拡張機能が自動的にインストールされます。Zoho Sprints拡張機能をVisual Studioのマーケットプレイスから直接インストールしないでください。Zoho Sprintsのタスク操作は、関連付けられたプロジェクトでのみ実行できます。

Azureの認証の動作

AzureによるAPI制限のため、Azure DevOps連携の動作はクラウドとサーバーで異なります。クラウドのアカウントでは、最大5件のプロジェクトを関連付けることができます。サーバーのアカウントでは、動作が異なります。

サーバーのアカウントでは、API制限により、関連付けられるプロジェクトは1件のみです。ただし、インストール時に複数のプロジェクトを選択しても、最初に選択したプロジェクトだけが関連付けられ、インストールは完了します。しかし、連携の認証は解除されます。そのため、その後にプロジェクトを関連付けようとすると、Azureはその要求を未認証のアクセスとみなし、認証ページにリダイレクトします。連携を復元するには、再認証が必要です。

Azure DevOps Pipelineの共通タスクパラメーター

インストールが正常に完了すると、Azure DevOpsパイプラインからZoho Sprintsの作業項目、スプリント、リリースを作成、更新できます。データの入力形式については、以下の一覧を参照してください。データの取得方法を示すGIFを表示するには、こちらをクリックしてください。
 

項目

種類

プロジェクト番号

数値

スプリント番号

数値

項目番号

数値

リリース番号

数値

日付

2022-05-20T00:00:00Z(UTC形式)  

 

タスク

  1. Zoho Sprintsのフィードにステータスを追加
  2. Zoho Sprintsの項目にコメントを追加
  3. Zoho Sprintsのスプリントにコメントを追加
  4. Zoho Sprintsのスプリントを完了
  5. Zoho Sprintsで項目を作成
  6. Zoho Sprintsでリリースを作成
  7. Zoho Sprintsでスプリントを作成
  8. Zoho Sprintsのスプリントを開始
  9. Zoho Sprintsの項目を更新
  10. Zoho Sprintsのリリースを更新
  11. Zoho Sprintsのスプリントを更新
拡張機能を利用するには、Zoho Sprintsで有効にする必要があります。Zoho SprintsにAzure DevOps Pipelineをインストールすると、Azureの組織にZoho Sprints拡張機能が自動的にインストールされます。

タスクパラメーター

Zoho Sprintsの作業項目

Azure DevOps Pipelineのタスクから作業項目を作成、更新する際には、以下の項目を設定します。
  1. [プロジェクト]:プロジェクト番号を入力します。
  2. [スプリント]:スプリント番号を指定します(0はプロジェクトのバックログを表します)。
  3. [項目番号]:更新対象の項目の項目番号を入力します。
  4. [名前]:作業項目の名前を入力します。
  5. [説明]:作業項目の説明を入力します。
  6. [ステータス]:作業項目のステータスを指定します。
  7. [種類]:作業項目の種類を指定します(例:タスク)。
  8. [優先度]:作業項目の優先度を設定します(例:高)。
  9. [開始日]:作業項目の開始日を指定します(例:2022-08-13T00:00:00Z)。
  10. [終了日]:作業項目の終了日を指定します。開始日より後の日付にする必要があります(例:2022-09-13T00:00:00Z)。
  11. [項目の担当者]:項目のユーザーのメールアドレスをカンマ区切りで入力します。
  12. [見積もり指数]:項目に設定する見積もり指数のインデックスを指定します。たとえば、見積もりの種類がフィボナッチ数列の場合、2のインデックスは2、8のインデックスは5です。
  13. [コメント]:作業項目に追加するコメントを入力します。
  14. [期間]:作業項目に費やした時間を指定します(例:2時間50分)。
  15. [カスタム項目]:カスタム項目の値をこちらに指定します。複数のカスタム項目がある場合は、1行につき1項目ずつ入力してください。
    1. 例
    2. UDF1_BOOLEAN=123456
    3. UDF1_TEXT=text value

Zoho Sprintsのスプリント

Azure DevOps Pipelineのタスクからスプリントを作成、更新、開始、完了する際には、以下の項目を設定します。
  1. [プロジェクト]:プロジェクト番号を入力します。
  2. [スプリント]:スプリント番号を入力します。
  3. [スプリント名]:スプリントの名前を入力します。
  4. [説明]:スプリントの説明を入力します。
  5. [スクラムマスター]:スクラムマスターのメールアドレスを入力します。
  6. [スプリントのユーザー]:スプリントのユーザーのメールアドレスをカンマ区切りで入力します。
  7. [開始日]:スプリントの開始日を指定します(例:2022-08-13T00:00:00Z)。
  8. [終了日]:スプリントの終了日を指定します(例:2022-08-13T00:00:00Z)。
  9. [期間]:スプリントのおおよその期間を指定します。厳密なスクラムが有効な場合、スプリントの期間は8週間を超えることはできません。厳密なスクラムが無効な場合は、最大30週間まで設定できます(例:2時間50分)。
  10. [コメント]:スプリントに追加するコメントを入力します。
  11. [カスタム項目]:カスタム項目の値をこちらに指定します。複数のカスタム項目がある場合は、1行につき1項目ずつ入力してください。
    1. 例:
    2. UDF1_BOOLEAN=12345
    3. UDF1_TEXT=text value

Zoho Sprintsのリリース


Azure DevOps Pipelineのタスクからリリースを作成、更新する際には、以下の項目を設定します。
  1. [プロジェクト]:プロジェクト番号を入力します。
  2. [リリース名]:リリースの名前を入力します。
  3. [リリースの目標]:リリースの目的を入力します。
  4. [開始日]:リリースの開始日を入力します(例:2022-08-13T00:00:00Z)。
  5. [リリース日]:リリース日を入力します(例:2022-10-13T00:00:00Z)。
  6. [所有者]:所有者のメールアドレスをカンマ区切りで入力します。
  7. [リリースのステージ]:リリースの現在のステージを指定します(例:PLAN)。
  8. [カスタム項目]:カスタム項目の値をこちらに指定します。複数のカスタム項目がある場合は、1行につき1項目ずつ入力してください。
    1. 例:
    2. UDF1_BOOLEAN=12345
    3. UDF1_TEXT=text value

Azure DevOpsのビルドの関連付け

  1. Zoho Sprintsで作業項目の詳細ページに移動します。
  2. 右端のAzure DevOps Pipelineアイコンをクリックします。
  3. [ビルドを関連付ける]ボタンをクリックします。
  4. 必要な条件を入力します。
  5. [検索]をクリックします。
  6. 関連付けるビルドを選択し、[関連付ける]をクリックします。
 

Azure DevOps Pipelineのビルドステータスの表示

Azure DevOpsのパイプラインを確認するには:
  1. Zoho Sprintsにサインインします。
  2. 左側のナビゲーションパネルから[CI/CD]ビューを選択します。
  3. [Azure DevOps Pipeline]を選択します。
  4. カーソルを合わせ、[ログを表示]をクリックします。[ログを表示]ボタンをクリックすると、各パイプラインのログを表示できます。
  5. 特定の条件に基づいてパイプラインを表示することもできます。右上をクリックし、条件を設定して[フィルターを適用]をクリックします。


拡張機能の無効化

プラグインを一時的に無効にするには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. マーケットプレイスセクションの[すべて]をクリックします。一覧ページが表示されます。
  3. Azure DevOps Pipeline for Zoho Sprintsを探します。
  4. [無効にする]をクリックします。拡張機能が無効になります。

拡張機能のアンインストール

アンインストールするには:
  1. 右上の歯車アイコンをクリックします。設定画面が表示されます。
  2. マーケットプレイスセクションの[すべて]をクリックします。一覧ページが表示されます。
  3. Azure DevOps Pipeline for Zoho Sprintsを探します。
  4. [アンインストール]をクリックします。拡張機能がアンインストールされ、設定が削除されます。