YAMLを使用して Azure Pipelines でテストを自動化する

[アーティクル]
03/15/2023

この記事では、Azure DevOps サービスの YAML パイプラインを使用して、テストスタジオで作成されたキャンバスアプリテストを設定および実行する方法を説明します。

GitHub—Microsoft/PowerAppsTestAutomation— でパブリックプロジェクトを使用して、次のことができます。

アプリケーションへのサインインの操作を自動化します。
ビルドエージェントでブラウザーを開き、一連のテストケースおよびスイートを実行します。
Azure DevOps パイプラインでテスト実行の状態を表示します。

前提条件

開始する前に、次の手順を実行する必要があります。

GitHub で Microsoft/PowerAppsTestAutomation プロジェクトをフォークします。

注意

パブリックフォークを非公開にすることはできません。非公開リポジトリを作成する場合は、リポジトリを複製する必要があります。
パイプラインから実行するアプリテスト URL を含む、新しいテスト URL .json ファイルを作成します。
新しい Azure Pipelines YAML ファイルを作成します。
リポジトリに GitHub サービス接続を作成します。

ステップ 1 - PowerAppsTestAutomation プロジェクトをフォークする

フォーク はリポジトリのコピーです。リポジトリをフォークすることによって、元のプロジェクトに影響を与えずに変更を加えることができます。

GitHub にサインインします。
microsoft/PowerAppsTestAutomation リポジトリに移動します。代わりに microsoft/PowerAppsTestAutomation を検索して、リポジトリを選択することもできます。
フォークを選択します。
フォークを保存する場所を選択します。

フォークされたリポジトリが使用できるようになりました。

ステップ 2 - テスト URL .json ファイルを作成する

テスト URL .json ファイルには、アプリを検証するためのテストスイートおよびテストケースの URL が含まれます。アプリテストスイートおよびテストケースの URL は、テストスタジオで再生リンクをコピーするを選択することにより取得できます。

前の手順で作成したリポジトリで、サンプルファイルである Samples/TestAutomationURLs.json を見つけることができます。

リポジトリに TestURLs.json ファイルという名前の新しいファイルを作成するか、または任意のファイル名を使用します。ファイル名および場所は、ドキュメントの後半でパイプライン変数にマップされます。
Samples/TestAutomationURLs.json ファイルから形式をコピーします。
アプリで検証するテストで、テスト URL セクションを更新します。
変更をリポジトリにコミットします。

ステップ 3 - Azure Pipeline YAML ファイルを作成する

前の手順で作成したリポジトリで、サンプルファイルである Samples/azure-pipelines.yml を見つけることができます。

リポジトリに、azure-pipelines.yml ファイルという名前の新しいファイルを作成します。
Samples/azure-pipelines.yml ファイルからコンテンツをコピーします。
変更をリポジトリにコミットします。ステップ 4 でパイプラインを構成するときに、azure-pipelines.yml ファイルを参照して更新します。

ステップ 4 - GitHub サービス接続を作成する

Azure DevOps インスタンスにサインインします。
既存のプロジェクトを選択するか、または新しいプロジェクトを作成します。
左側のナビゲーションウィンドウの下部でプロジェクト設定を選択します。
パイプラインで、サービス接続を選択します。
サービス接続の作成を選択します。
GitHub サービスを選択します。
次へを選択します。
OAuth 構成で、AzurePipelines を選択します。
承認を選択します。
オプションで、サービス接続名を更新できます。
保存を選択します。

パイプラインの作成

左側のナビゲーションウィンドウで、パイプラインを選択します。
パイプラインの作成を選択します。
GitHub YAML を選択します。
リポジトリを検索または選択します。
既存の Azure Pipelines YAML ファイルを選択します。
前の手順で作成した Azure YAML パイプラインファイルへのパスを設定します。
続行を選択します。

azure-pipelines.yml ファイルが表示されます。
リポジトリにリポジトリ名を更新します。
エンドポイントを、前の手順で作成した GitHub サービス接続の名前に更新します。
TestAutomationURLs ファイル名を更新します。これは、前の手順で作成したテスト URL .json ファイルのファイルです。
変更した場合は、LocalProjectName 値をリポジトリ名に更新します。
TestAutomationURLFilePath を、リポジトリのテスト URL .json ファイルの場所に更新します。
変数を選択します。
OnlineUsername という名前の変数を追加し、アプリケーションにサインインするユーザーコンテキストの Microsoft Entra のメールアドレスを、その値に設定します。テストは、このユーザーアカウントのコンテキストで実行されます。
OK を選択します。
OnlinePassword という名前の別の変数を追加します。値を、前の手順で作成した Microsoft Entra アカウントのパスワードに設定します。
この値を秘密に保持する、およびこのパイプラインの実行時にユーザーがこの値を上書きできるようにするを選択します。
リポジトリの変更を保存および確定します。

テストを実行して分析する

テストが正常に実行されているかどうかを検証するには、実行を選択します。必要に応じて、オプションで、テストを実行するサーバーイメージおよびブラウザーの種類を選択できます。

ジョブを実行します。

ジョブの実行中に、それを選択して、実行中の各タスクの詳細な状態が表示されます。

ジョブの詳細。

ジョブが完了されると、高レベルのジョブの概要、およびエラーまたは警告を表示できます。 テスト タブを選択すると、実行したテストケースの特定の詳細を表示できます。

次の例は、Chrome ブラウザーを使用してテストを実行しているときに、少なくとも 1 つのテストケースが失敗したことを示しています。

Chrome - 失敗しました。

RunTestAutomation を選択し、失敗したテストケースに関する詳細をより細かく確認します。 添付ファイル タブで、テスト実行の概要およびテストスイートで失敗または合格したテストケースを見ることができます。

添付ファイルタブ。

注意

テストスイートを実行する場合、合格および失敗したテストケースの概要が表示されます。テストケースを実行すると、可能な場合、トレース情報とともに失敗に関する特定の詳細が表示されます。

既知の制限

多要素認証はサポートされていません。
テスト概要は、ブラウザーごとに 1 つのテスト結果を報告します。テスト結果には、1 つ以上のテストケースまたはテストスイートの結果が含まれます。
Microsoft Entra サインイン以外の任意の認証プロセスについて、PowerAppsTestAutomation ソリューションでサインインプロセスをカスタマイズする必要があります。