DevOps チェンジベロシティ へのオンボードAzure DevOps - クラシック

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

    • Azure DevOpsツールレコードを作成して、Azure DevOpsツールデータを接続、検出、インポートするための DevOps チェンジベロシティ を作成します。

    始める前に

    必要なロール:sn_devops.admin または sn_devops.tool_owner

    このタスクについて

    アクション：
    • Azure DevOps組織またはプロジェクトに接続します。
    • 計画、リポジトリ、オーケストレーションタスク、パイプラインを検出します。
    • Azure DevOps で Webhook を構成します。
    • 作業 アイテム、計画バージョン、機能レコード、分岐とコミットのレコード、タスク実行とステップ実行のレコードをインポートします。

    作業アイテムの状態または種類の Azure Boardsインポートをカスタマイズする には、 DevOpsAzureDevOpsWorkItemHelper スクリプトインクルードを使用します。

    手順

    1. 次のように移動する。 DevOps > ツール > 新規作成 (従来).
    2. [ DevOps ツールを作成] フォームで、フィールドに入力します。
      フィールド 説明
      ツール名 このツールを識別する任意の名前。
      ツール統合 [Azure DevOps] を選択します。
      組織またはプロジェクトに接続 リストから選択します。
      • 組織を接続する: Azure DevOps 組織レベルで直接接続します。組織内のすべてのプロジェクトを検出でき、組織内で複数のプロジェクトを構成することを選択できます。
      • プロジェクトを接続:プロジェクトレベルで直接接続します。
      ツール URL Azure DevOps 以前の選択に応じて、組織の URL ( https://dev.azure.com/<your organization> または Azure DevOps プロジェクト URL ( https://dev.azure.com/<your organization>/<your project> など)。
      認証情報タイプ 認証情報のタイプ。 基本認証 または OAuth 2.0 です。

      基本認証

      1. ADO インスタンスのユーザー名を入力します。
      2. Azure DevOps インスタンスの個人アクセストークン (PAT) またはパスワードを入力します。
        注:

        Azure DevOpsの個人アクセストークン (PAT) を生成するときに、完全なアクセスを許可しない場合は、承認するスコープを選択する必要があります。「Azure DevOps の PAT スコープ DevOps」を参照してください。

      OAuth 2.0

      前提条件：
      [ ツール認証情報 ] フィールドで、OAuth 2.0 ツール認証情報レコードを選択します。
      注:
      使用されておらず、ADO 用に構成されていないレコードのみを、既存の認証情報レコードとして選択できます。

      Azure DevOps に接続するために認証情報に必要なすべての権限のリストについては、「DevOpsツールに必要な権限Azure DevOps権限」を参照してください。

    3. オプション: Azure DevOps インスタンスがMID サーバーに添付されている場合は、[MID サーバーを使用] オプションを選択して、その詳細を入力します。

      MID サーバーの詳細については、「MID サーバーの選択」を参照してください。

    4. [Submit (送信)] を選択します。

      ツールは、接続エイリアスと HTTP ツール接続 (基本認証情報) を使用して自動的に接続され、ツールレコードの詳細がフォームに表示されます。

      注:
      ツールのグローバルアドミン権限がない場合 (Webhook URL の自動構成を許可するため)、ツールアドミンユーザーに構成してもらう必要があります (Webhook URL を切り取ってツール構成に貼り付けます)。ツールで Webhook を構成したら、 手動構成モードを開始 してツールに手動で接続し、終了します。
    ツールが正常に作成されると、ツールレコードページが表示されます。
    1. オプション: ツールへのアクセスを制御する場合は、[アクセス] タブの [管理担当者] フィールドに、ツールへのアクセス権を付与する必要があるグループを追加します。
      グループ内のユーザーが実行できるタスクは、ユーザーにアサインされたロールによって異なります。
      • DevOps ツールオーナーロール:ツールを表示および編集できます。
      • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) のパイプラインステップ (該当する場合) を関連付け、検出、インポートし、パイプラインステップを変更できます。
      • DevOps アドミニストレーターロール:すべてのツールを編集できます。
      • その他の DevOps ロール:ツールを表示できます。
      注:
      [管理担当者] フィールドでは、DevOpsロールを持つユーザーを含むグループのみを選択できます。

      ツールへのアクセスを制限することを選択した場合、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ] オプションが選択可能になります。このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプラインステップの変更 (該当する場合) を行うことができます。

    2. 既存のアプリケーション計画 (ツールに関連付けられたプロジェクト)、リポジトリ、オーケストレーションタスク、パイプラインなどのツールオブジェクトを検出します。
      • 組織に接続済み: [プロジェクトの検出 ] を選択して、組織からプロジェクトを検出します。ディスカバリー後、組織のプロジェクトは [ プロジェクト ] 関連リストで利用できるようになります。
      • プロジェクトに接続済み:プロジェクトは接続の作成中に検出され、[ プロジェクト ] 関連リストで使用できます。ツールレコードページの [プロジェクト] タブから [プロジェクトの検出] を選択すると、組織内のすべてのプロジェクトが検出されます。

      [プロジェクト] 関連リストからプロジェクトを選択して、プロジェクトレコードページに移動します。[検出] を選択して、既存のプラン (ボード)、リポジトリ、パイプラインなどのプロジェクト オブジェクトを検出します。

    3. Azure DevOps で Webhook URL を構成します。
      1. ツールレコードページから直接、または各製品のプロジェクトレコードページから構成できます。
        • ツールレコードページから構成するには、 プロジェクトの構成 を選択します。構成するプロジェクトを選択し、[ 続行] を選択します。
        • プロジェクトレコードページから構成するには、まずツールレコードページからプロジェクトを選択し、[ 構成] を選択します。
      2. DevOps 統合ユーザーとパスワードを入力し、[送信] を選択します。

        送信時に、Webhook とサービス接続が Azure DevOps で自動的に作成されます。これにより、DevOps 統合ユーザーを使用して、Azure DevOps ツールからの通知が DevOps チェンジベロシティ に送信されます。統合ユーザーアカウントの設定については、「 での統合ユーザーアカウントの設定 DevOps チェンジベロシティ」を参照してください。

        注:
        • 統合ユーザー名とパスワードを入力するステップは、DevOps コンフィグがインストールされている場合、または This property decides whether to create a Generic Connection on configure operation for Azure DevOps プロパティが有効になっている場合にのみ構成する必要があります。この手順が不要な場合、Webhook はトークンベースの認証を使用して構成されます。
        • DevOps コンフィグがインストールされているか、Azure DevOps の構成操作の汎用接続プロパティが有効になっている場合は、ワークスペース UI からのみトークンを再生成 (新しいトークンで自動構成) できます。これにより、統合ユーザーのパスワードが更新されます。DevOps コンフィグがインストールされていない場合、トークンベースの認証のためにワークスペースとクラシック UI の両方からトークンを再生成できます。セキュリティを強化するために、定期的にトークンを再生成します。
      注:
      計画の場合、[ 追跡 ] フィールドは自動的に True に設定されます。
    4. 検出された計画について、ツールから履歴データをインポートし、アプリケーションを関連付けることもできます。
      1. [計画] 関連リストから計画レコードを開きます。
      2. [インポート] 関連リンクを選択します。
        計画のレコードは、[作業アイテム]、[計画バージョン]、および [機能] 関連リストに作成されます。
        • 作業アイテム関連リストには、タスク、バグ、およびストーリーが表示されます。

          作業項目の [ネイティブ状態] フィールドと [ネイティブの種類] フィールドには、ソース ツールの元の状態と種類の値が含まれています。

        • [計画バージョン] 関連リストにリリースが表示されます。
        • [機能] 関連リストには、エピックと機能が表示されます。
        注:
        Azure DevOps作業アイテムの履歴インポートは、アジャイルボード CMMI プロセスではサポートされていません。
      3. [アプリ] 関連リストで、[ 編集... ] を選択して計画 (プロジェクト) に関連付けるアプリを選択するか、[ 新規 ] を選択してアプリを作成します。
        計画立案ツールのセットアップを完了するには、計画に関連付けられたアプリレコードが必要です。
    5. 検出されたリポジトリについて、ツールの履歴データをインポートし、リポジトリをアプリに関連付けます。
      1. [リポジトリ] 関連リストからリポジトリレコードを開きます。
      2. [インポート] を選択します。
        インポートされた分岐レコードとリポジトリからのコミットレコードは、対応する関連リストに追加されます。
      3. [アプリ] フィールドで、ルックアップリストを選択し、リポジトリに関連付けるアプリレコードを選択するか、[新規] をクリックして作成します。
      インポートされた履歴データレコードは、対応する関連リストに追加されます。

    次のタスク

    Azureパイプラインの場合は、DevOps チェンジベロシティで構成を完了での Azure パイプラインのモデル化 DevOps。
    • 各パイプラインを特定のアプリにマッピングします。
    • パイプラインステップを作成し、各ステップを Azure パイプラインジョブにマッピングします。
    • 変更コントロールを構成します。