スポンサーリンク

E2EテストをAzure Container Apps Jobsで実行する方法|GitHub Actionsとの使い分け

E2EテストをAzure Container Apps Jobsで実行する方法|GitHub Actionsとの使い分け

E2Eテストを自動化するとき、実行環境をどこに用意するか悩むことがあります。

GitHub Actionsのホステッドランナーを利用すれば、特別な実行環境を用意しなくてもテストを実行できます。しかし、テストの実行時間が長い場合や、特定のネットワーク環境にアクセスする必要がある場合は、実行環境の構成を検討する必要があります。

その選択肢の一つが、Azure Container Apps Jobsです。

Azure Container Apps Jobsを利用すると、コンテナ化したE2Eテストを必要なタイミングで起動し、テストが完了したら実行環境を終了できます。

この記事では、E2EテストをAzure Container Apps Jobsで実行する構成、GitHub Actionsとの違い、導入するメリットや注意点について解説します。

Azure Container Apps Jobsとは

Azure Container Apps Jobsは、一定時間だけ実行するコンテナ処理を実行するためのAzureサービスです。

通常のAzure Container AppsがWebアプリケーションやAPIなどの継続的に稼働するサービスに適しているのに対し、Jobsは処理が完了したら終了するタスクに適しています。

例えば、次のような用途があります。

  • 定期的なバッチ処理
  • データの集計や加工
  • ファイルの変換処理
  • 自動テストの実行
  • オンデマンドで実行するバックグラウンド処理

Azure Container Apps Jobsには、主に3種類の実行方式があります。

実行方式内容使用例
Manual必要なときに手動で実行E2Eテスト、バッチ処理
Scheduleスケジュールに従って実行毎日の自動テスト
Eventイベントをきっかけに実行キューにメッセージが追加されたときの処理

E2Eテストの場合は、手動実行やスケジュール実行が利用しやすい構成です。

例えば、開発者が必要なタイミングでテストを実行したり、毎晩決まった時間に回帰テストを実行したりできます。

参考:Azure Container Apps Jobs – Microsoft Learn

E2EテストをAzure Container Apps Jobsで実行する構成

E2Eテストを実行する場合、GitHub ActionsとAzure Container Apps Jobsを組み合わせる構成が考えられます。

例えば、次のような構成です。

  1. GitHub Actionsでテスト用コンテナイメージをビルドする
  2. Azure Container Registryにイメージを登録する
  3. GitHub ActionsからAzure Container Apps Jobsを起動する
  4. コンテナ内でE2Eテストを実行する
  5. テストが完了したらコンテナを終了する
  6. 実行結果やログを確認する

この構成では、GitHub Actionsがパイプラインの制御を担当し、Azure Container Apps Jobsがテストの実行環境を担当します。

GitHub Actionsだけでテストを実行する構成とは異なり、テスト実行環境をAzure側に分離できるのが特徴です。

構成イメージ

GitHub Repository
       |
       v
GitHub Actions
       |
       | 1. コンテナイメージをビルド
       v
Azure Container Registry
       |
       | 2. イメージを取得
       v
Azure Container Apps Jobs
       |
       | 3. E2Eテストを実行
       v
Playwright / Reqnroll
       |
       v
テスト結果・実行ログ

例えば、PlaywrightやReqnrollを使用したE2Eテストをコンテナイメージに含めておけば、そのイメージを利用してAzure上でテストを実行できます。

テストコードと実行環境をコンテナにまとめられるため、実行環境の構築を毎回行う必要がありません。

Azure Container Apps JobsでE2Eテストを実行するメリット

1. テスト実行環境を分離できる

E2Eテストは、ブラウザやテストフレームワークなど、さまざまな依存関係を必要とします。

例えば、Playwrightを利用する場合は、ブラウザや関連するライブラリも必要になります。

これらをコンテナイメージに含めておけば、テスト実行環境を固定できます。

また、開発用の環境とテスト実行環境を分離できるため、テストによる環境への影響も抑えやすくなります。

2. テストが完了したら実行環境を終了できる

通常のAzure Container Appsは、継続的にサービスを稼働させる用途に適しています。

一方、Azure Container Apps Jobsは、処理を開始して完了したら停止する用途に適しています。

E2Eテストのように、必要なときだけ実行する処理と相性がよい仕組みです。

常時稼働するテスト専用サーバーを用意せずに済むため、実行環境の管理を簡素化できます。

3. Azureのネットワーク環境を利用できる

E2Eテストの対象システムが社内ネットワークやプライベートネットワーク内に存在する場合、テスト実行環境からアクセスできるネットワーク構成が必要になります。

Azure Container Appsでは、環境のネットワーク構成に応じて、仮想ネットワークなどを利用できます。

例えば、Azure上のプライベートなテスト環境に対してE2Eテストを実行する構成が考えられます。

ただし、ネットワークへの接続にはVNetやDNS、ファイアウォールなどの設定が必要になる場合があります。

4. 実行タイミングを柔軟に設定できる

Azure Container Apps Jobsには、手動実行とスケジュール実行があります。

そのため、次のような使い分けができます。

  • 開発者が必要なタイミングで実行する
  • 夜間に回帰テストを実行する
  • リリース前にE2Eテストを実行する
  • CI/CDパイプラインから実行する

特に、毎回のビルドで実行する必要がない重いE2Eテストを、別のタイミングで実行する構成にも利用できます。

Azure Container Apps JobsとGitHub Actionsの違い

E2Eテストを自動化する場合、GitHub Actionsだけで実行する方法もあります。

では、Azure Container Apps Jobsを利用する必要はあるのでしょうか。

それぞれの特徴を比較します。

比較項目GitHub ActionsAzure Container Apps Jobs
主な用途CI/CDの実行コンテナ処理の実行
実行環境ホステッドランナーなどAzure上のコンテナ
実行タイミングPush、PR、手動など手動、スケジュール、イベント
環境構築ランナー上で設定コンテナイメージで管理
ネットワークランナーの接続環境に依存Azure側のネットワークを利用可能
実行結果ワークフローのログジョブの実行履歴やログ

重要なのは、両者は単純な代替関係ではないという点です。

GitHub Actionsはワークフローの制御に適しており、Azure Container Apps Jobsはコンテナ化された処理の実行に適しています。

そのため、両者を組み合わせる構成も有効です。

GitHub Actionsだけで十分なケース

次のような場合は、GitHub ActionsだけでE2Eテストを実行する方がシンプルです。

  • テスト実行時間が短い
  • GitHubホステッドランナーからテスト対象にアクセスできる
  • 特別なネットワーク構成が必要ない
  • テスト環境を個別に管理する必要がない

このようなケースでは、わざわざAzure Container Apps Jobsを追加する必要はありません。

Azure Container Apps Jobsを検討したいケース

一方、次のような場合はAzure Container Apps Jobsを検討できます。

  • Azure上のネットワーク環境からテスト対象にアクセスしたい
  • テスト実行環境をコンテナとして固定したい
  • テストをCI/CDパイプラインから独立して実行したい
  • 定期的なE2Eテストを実行したい
  • テスト専用の実行環境を継続的に管理したくない

ただし、Azure Container Apps Jobsを利用する場合は、コンテナイメージのビルドやレジストリへの登録、Azure側の設定が必要です。

構成が複雑になるため、導入するメリットがあるかを先に確認することが重要です。

Azure Container Apps JobsをAzure CLIで実行する方法

Azure Container Apps Jobsは、Azure CLIから実行できます。

例えば、手動実行タイプのジョブを作成する場合は、次のようなコマンドを使用します。

az containerapp job create \
  --name "e2e-test-job" \
  --resource-group "my-resource-group" \
  --environment "my-environment" \
  --trigger-type "Manual" \
  --replica-timeout 1800 \
  --replica-retry-limit 0 \
  --replica-completion-count 1 \
  --parallelism 1 \
  --image "myregistry.azurecr.io/e2e-test:latest" \
  --cpu "1.0" \
  --memory "2Gi"

各パラメーターの意味は次のとおりです。

パラメーター内容
–nameジョブ名
–resource-groupリソースグループ
–environmentContainer Apps環境
–trigger-type実行方式
–replica-timeoutレプリカの最大実行時間(秒)
–replica-retry-limit失敗時の再試行回数
–replica-completion-count完了に必要なレプリカ数
–parallelism同時実行するレプリカ数
–image実行するコンテナイメージ
–cpuCPU割り当て
–memoryメモリ割り当て

上記は構成例です。CPUやメモリは、実際のテスト内容に合わせて調整してください。

ジョブを作成したら、次のコマンドで実行できます。

az containerapp job start \
  --name "e2e-test-job" \
  --resource-group "my-resource-group"

このコマンドをGitHub Actionsのワークフローから実行することで、パイプラインからAzure Container Apps Jobsを起動する構成にできます。

ジョブの実行履歴を確認する

実行履歴はAzure CLIから確認できます。

az containerapp job execution list \
  --name "e2e-test-job" \
  --resource-group "my-resource-group"

また、Azure Portalからもジョブの実行履歴を確認できます。

テストの失敗原因を調査する場合は、コンテナの標準出力や標準エラー出力などをログとして確認できるようにしておくことが重要です。

参考:Azure Container Apps Jobsの作成 – Microsoft Learn

Azure Container Apps Jobsを利用する際の注意点

1. コンテナイメージの管理が必要

Azure Container Apps Jobsでテストを実行するには、テストに必要な環境を含むコンテナイメージが必要です。

Playwrightの場合は、ブラウザや必要なシステムライブラリも考慮する必要があります。

テストコードを変更した場合は、イメージの更新も必要になります。

2. テスト結果の保存方法を考える

コンテナが終了すると、コンテナ内の一時的なファイルをそのまま長期保存する用途には向きません。

そのため、テストレポートやスクリーンショットなどを保存したい場合は、Azure Blob Storageなどの外部ストレージに出力する構成を検討します。

例えば、次のような成果物が考えられます。

  • PlaywrightのHTMLレポート
  • スクリーンショット
  • トレースファイル
  • テスト実行ログ

テストが失敗した場合でも原因を調査できるように、成果物の保存先を事前に決めておきましょう。

3. 実行時間とリトライ回数を設定する

E2Eテストは、画面の読み込みやAPIの応答などに依存するため、実行時間が長くなる場合があります。

Azure Container Apps Jobsでは、レプリカのタイムアウトや再試行回数を設定できます。

例えば、テストが失敗した場合に再実行するかどうかは、テストの性質に応じて判断します。

ただし、単純に再試行回数を増やすと、テストの不安定さを見逃したり、実行時間やコストが増加したりする可能性があります。

4. 実行コストを確認する

Azure Container Apps Jobsは、必要なときにコンテナを起動して処理を実行する仕組みです。

そのため、常時稼働するテストサーバーを用意する構成とは異なります。

ただし、実際の料金はCPUやメモリ、実行時間、利用するネットワークやストレージなどによって変わります。

GitHub Actionsの利用料金も含めて比較し、全体のコストを確認することが重要です。

まとめ

Azure Container Apps Jobsは、E2Eテストのように一定時間だけ実行するコンテナ処理と相性のよいサービスです。

特に、テスト実行環境をコンテナ化して管理したい場合や、Azureのネットワーク環境からテストを実行したい場合に検討する価値があります。

一方で、すべてのE2EテストをAzure Container Apps Jobsに移行する必要はありません。

GitHub Actionsだけで十分に実行できる場合は、既存の構成を維持する方がシンプルです。

使い分けとしては、次のように考えるとよいでしょう。

  • 簡単なE2Eテスト:GitHub Actions
  • Azureのネットワーク環境が必要なテスト:Azure Container Apps Jobs
  • 定期的な回帰テスト:Azure Container Apps Jobsのスケジュール実行
  • CI/CDから独立したテスト実行:Azure Container Apps Jobs

テストの実行環境やネットワーク要件に合わせて、適切な実行方法を選択しましょう。