ロード テストを実行するための CI/CD ワークフローを手動で構成する

CI/CD パイプラインを作成することで、Azure Load Testingでロード テストを自動化できます。 この記事では、Azure Load Testingで既存のテストを呼び出すように、GitHub Actions、Azure Pipelines、またはその他の CI ツールを手動で構成する方法について説明します。 ロード テストを自動化し、負荷条件下でアプリケーションのパフォーマンスと安定性を継続的に検証します。

次の手順で CI/CD パイプラインに既存のロード テストを追加します。

  • CI ツールが Azure ロード テスト リソースに接続できるようにサービス認証を構成します。
  • テスト スクリプトやロード テスト YAML 構成など、ロード テスト入力ファイルをリポジトリに追加します。
  • AZURE LOAD TESTINGを呼び出すように CI/CD パイプライン定義を更新します。

[前提条件]

サービス認証を構成する

CI/CD ワークフローでロード テストを実行するには、ロード テスト リソースにアクセスするためのアクセス許可を CI/CD ワークフローに付与する必要があります。 CI/CD ワークフローのサービス プリンシパルを作成し、ロード テスト共同作成者Azure RBAC ロールを割り当てます。

Azure Pipelinesでサービス接続を作成する

Azure Pipelinesでは、Azure DevOps プロジェクトに service connection を作成し、Azure サブスクリプション内のリソースにアクセスします。 サービス接続を作成すると、Azure DevOps Microsoft Entraサービス プリンシパル オブジェクトが作成されます。

  1. Azure DevOps組織 (https://dev.azure.com/<your-organization>) にサインインし、プロジェクトを選択します。

    <your-organization> テキスト プレースホルダーをプロジェクト識別子に置き換えます。

  2. プロジェクト設定>サービス接続>+ 新しいサービス接続 を選択します。

  3. 新しいサービス接続 ペインで、Azure Resource Manager を選択し、 Next を選択します。

  4. [サービス プリンシパル (自動)] 認証方法を選択し、[次へ] を選択します。

  5. サービス接続の詳細を入力し、[保存] を選択してサービス接続を作成します。

    フィールド 価値
    スコープのレベル [サブスクリプション]。
    サブスクリプション ロード テスト リソースをホストするAzure サブスクリプションを選択します。
    リソース グループ ロード テスト リソースが含まれるリソース グループを選択します。
    サービス接続名 サービス接続の一意の名前を入力します。
    すべてのパイプラインにアクセス許可を付与する オンにします。

  6. サービス接続の一覧から、前に作成した接続を選択し、[サービス プリンシパルの管理] を選択します。

    サービス プリンシパルを管理するための選択を示すスクリーンショット。

    Azure ポータルが別のブラウザー タブで開き、サービス プリンシパルの詳細が表示されます。

  7. Azure ポータルで、Display name 値をコピーします。

    次の手順でこの値を使用して、ロード テストを実行するためのアクセス許可をサービス プリンシパルに付与します。

Azure Load Testingへのアクセスを許可する

Azure Load Testingでは、Azure RBAC を使用して、ロード テスト リソースで特定のアクティビティを実行するためのアクセス許可を付与します。 CI/CD パイプラインからロード テストを実行するには、ロード テスト共同作成者ロールをサービス プリンシパルに付与します。

  1. Azure ポータルで、Azure Load Testing リソースに移動します。

  2. [アクセス制御 (IAM)]>[追加]>[ロールの割り当ての追加] の順に選択します。

  3. [ロール] タブのジョブ関数ロールの一覧で [ロード テスト共同作成者] を選択します。

    Azure ポータルの [ロールの割り当ての追加] ページで、ロード テスト共同作成者ロールが強調表示されているロールの一覧を示すスクリーンショットです。

  4. [メンバー] タブで [メンバーの選択] を選択し、前にコピーした表示名を使用してサービス プリンシパルを検索します。

  5. サービス プリンシパルを選択し、[選択] を選択します。

  6. [確認と 割り当て] タブで、[確認と割り当て] を選択して ロールの割り当てを追加します。

Azure Pipelines ワークフロー定義のサービス接続を使用して、Azureロード テスト リソースにアクセスできるようになりました。

リポジトリ内にロード テスト ファイルを追加する

CI/CD ワークフローでAzure Load Testingを使用してロード テストを実行するには、すべてのロード テスト入力ファイルをソース管理リポジトリに追加する必要があります。

既存のロード テストがない場合は、次のファイルをソース コード リポジトリに追加してください。

  • ロード テスト構成 YAML ファイル。 ロード テスト構成 YAML ファイルを作成する方法について確認してください。
  • テスト計画ファイル。 JMeter ベースのテストの場合は、JMeter テスト スクリプト (JMX ファイル) を追加します。 リロートベースのテストの場合は、リロート テスト スクリプト (.py ファイル) を追加します。 URL ベースのテストの場合は、要求 JSON ファイルを追加します。
  • 任意の JMeter ユーザー プロパティ ファイル。
  • テスト計画で使用される任意の入力データ ファイル。 たとえば、CSV データ ファイル。

既存のロード テストがある場合は、構成設定とすべての入力ファイルを Azure ポータルから直接ダウンロードできます。 Azure ポータルで既存のロード テスト用の入力ファイルをダウンロードするには、次の手順を実行します。

  1. Azure ポータルで、Azure Load Testing リソースに移動します。

  2. 左側のペインで、[テスト] を選択してロード テストのリストを表示し、対象のテストを選択します。

    Azure Load Testing リソースのテスト一覧を示すスクリーンショット。

  3. 使用しているテストの実行の横にある省略記号 (...) を選択し、[Download input file] (入力ファイルのダウンロード) を選択します。

    ブラウザーは、ロード テスト入力ファイルを含む zip 形式のフォルダーをダウンロードします。

    ロード テストの実行の結果ファイルをダウンロードする方法を示すスクリーンショット。

  4. 任意の zip ツールを使用して、入力ファイルを抽出します。

    このフォルダーには次のファイルが格納されています。

    • config.yaml: ロード テストの YAML 構成ファイル。 このファイルは、CI/CD ワークフロー定義で参照します。
    • .jmx または .py: JMeter または Locust テストスクリプト
    • ロード テストの実行に必要な CSV ファイルやユーザー プロパティ ファイルなどの追加の入力ファイル。

  5. 抽出されたすべての入力ファイルをソース管理リポジトリにコミットします。

    CI/CD パイプラインを構成するソース コード リポジトリを使用します。

CI/CD ワークフロー定義を更新する

Azure Load Testingでは、ロード テストを実行するためのGitHub ActionsとAzure Pipelinesの両方がサポートされます。

Azure DevOpsのAzure Load Testing拡張機能をインストールする

ロード テストを作成して実行するために、Azure Pipelines ワークフロー定義では、Azure DevOps Marketplace の Azure Load Testing task 拡張機能が使用されます。

  1. Azure DevOps Marketplace で Azure Load Testing タスク拡張機能を開き、 Get it free を選択します。

  2. Azure DevOps組織を選択し、Install を選択して拡張機能をインストールします。

    選択したAzure DevOps組織の管理者特権がない場合は、Request を選択して、拡張機能のインストールを管理者に要求します。

Azure Pipelines ワークフローを更新する

Azure Pipelines ワークフローを更新して、Azureロード テスト リソースのロード テストを実行します。

  1. Azure DevOps組織 (https://dev.azure.com/<your-organization>) にサインインし、プロジェクトを選択します。

  2. 左側のナビゲーションで [パイプライン] を選択し、パイプラインを選択して、[編集] を選択し、ワークフロー定義を編集します。

    または、Create Pipeline を選択して、Azure Pipelinesに新しいパイプラインを作成します。

  3. AzureLoadTest タスクを使用してロード テストを実行します。

    loadTestConfigFile プロパティで前にエクスポートしたロード テスト構成ファイルを指定します。

    <load-testing-resource> と <load-testing-resource-group> テキスト プレースホルダーを、Azureロード テスト リソースとリソース グループの名前に置き換えます。

        - task: AzureLoadTest@1
      inputs:
        azureSubscription: $(serviceConnection)
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>

    必要に応じて、env プロパティまたは secrets プロパティを使用して、パラメーターまたはシークレットをロード テストに渡すことができます。 ロード テストの実行が完了するのを待たずに続行する場合は、 waitForCompletion: false を設定します。

  4. publish タスクを使用して、Azure Pipelines ワークフロー実行でテスト結果を成果物として発行します。

        - publish: $(System.DefaultWorkingDirectory)/loadTest
      artifact: loadTestResults

ロード テストの結果の表示

CI/CD パイプラインからロード テストを実行すると、CI/CD 出力ログでサマリー結果を直接表示できます。 テスト結果をパイプライン成果物として発行した場合は、CSV ファイルをダウンロードしてさらにレポートすることもできます。

ワークフローのログ情報を示すスクリーンショット。

リソースをクリーンアップする

作成したどのリソースも使用する予定がない場合は、追加の課金が発生しないように削除します。

  1. Azure Pipelinesの変更を削除します。

    1. Azure DevOps組織 (https://dev.azure.com/<your-organization>) にサインインし、プロジェクトを選択します。

      <your-organization> テキスト プレースホルダーをプロジェクト識別子に置き換えます。

    2. 新しいパイプラインを作成した場合:

      1. [パイプライン] を選択し、使用するパイプラインを選択します。

      2. 省略記号を選択し、[削除] を選択します。

        Azure Pipelines 定義を削除する方法を示すスクリーンショット

      3. パイプライン名を入力し、[削除] を選択してパイプラインを削除します。

    3. 既存のワークフロー定義を変更した場合は、ロード テストを実行するための変更を元に戻し、ワークフローを保存します。

  2. サービス接続を削除します。

    1. Project設定>Service connections を選択し、サービス接続を選択します。
    2. [編集]>[削除] の順に選択して、サービス接続を削除します。

次のステップ

次の記事に進み、テストの失敗条件を定義し、テストの実行を比較することで、パフォーマンスの低下を特定する方法を参照してください。

  • Last updated on