Windows Docker コンテナでの UFT One テストの実行

UFT One Docker イメージを使用すると，UFT One のメンテナンスとテストの実行が高速になります。

このトピックは，Docker の管理についてある程度の知識があることを前提としており，Docker の管理手順については詳しく説明しません。

このトピックの内容：

利用可能な UFT One Docker イメージ

UFT One Docker イメージを使用して，Windows Docker 環境でモバイル・テストまたは API テストを実行します。イメージは https://hub.docker.com/r/functionaltesting/ から入手できます。

すべてのイメージで，次の機能がサポートされています。

• Digital Lab（UFT Mobile） および UFT One 自動化スクリプトを使用してモバイル・テストを実行する。
• Windows Docker 環境で単一の API テストを実行する。

次のイメージを入手できます。

• uft イメージ。UFT One がインストールされた Windows Docker のフル・イメージです。

• uft_lite イメージ。機能はフル・イメージと同じですが，容量がはるかに小さく，短時間でダウンロードできます。

• 2 つの UFT One ユーティリティ Docker イメージ。uft または uft-lite イメージに基づいていますが，追加のユーティリティ・ツールも含まれています。

UFT One ユーティリティ Docker イメージを使用する利点

このイメージにより，次のように機能が拡張されます。

UFT One ユーティリティ Docker イメージは，uft および uft-lite イメージよりも頻繁にリリースされます。API テストの実行には，このイメージを使用することをお勧めします。このイメージの使用方法については，Docker Hub のイメージで利用可能なドキュメントを参照してください。

先頭に戻る

システム要件

次のいずれかのオペレーティング・システムの Windows Docker コンテナで UFT One テストを実行できます。

先頭に戻る

概要：UFT One の Docker イメージの使用

Docker コンテナで UFT One テストを実行するには，次の手順を実行する必要があります。この手順については，以下で詳しく説明します。

1. Docker ハブから UFT One Docker イメージをプルする。
2. Docker イメージに基づいてコンテナを作成する。
3. コンテナに UFT One のコンカレント・ライセンスをインストールする。
4. Docker コンテナで UFT One テストを実行する。

使用する各 UFT One Docker コンテナに UFT One ライセンスをインストールする必要があります。これは，次のいずれかの方法で行うことができます。

• UFT One ライセンスをインストールした後，このコンテナを新しいイメージにコミットします。この新しいイメージに基づいて残りのすべてのコンテナを作成して，ライセンスの追加インストールを回避します。

• UFT One ライセンスをインストールした後，後続の実行に同じコンテナを使用し，必要に応じてコンテナを停止および開始します。

• 新しいコンテナを作成し，コンカレント・ライセンスをインストールしてからテストを実行する Docker コマンドを使用します。

先頭に戻る

UFT One Windows Docker コンテナのセットアップ

このセクションでは，UFT One Windows Docker コンテナをセットアップする方法について説明します。

前提条件

1. Docker をコンピュータにインストールしてセットアップし，Docker Hub から Docker イメージをプルできるようにします。これにより，コンピュータが Docker ホストとしてセットアップされます。

   Microsoft のドキュメントの説明に従って，Docker エンジンとクライアントをインストールします。

   Docker のセットアップ方法の詳細については，Docker のドキュメントを参照してください。

2. コンピュータでハードウェアとソフトウェアの仮想化を有効にします。

3. Docker が Windows コンテナを実行するように設定されていることを確認します（Docker トレイ・アイコンを右クリックして，メニュー・オプションに［Switch to Linux containers］が表示されていることを確認します）。

イメージのプルとコンテナの作成

UFT Docker イメージをプルして，Docker Windows コンテナを作成します。

1. UFT Docker イメージをプルするには，ホスト・コンピュータのコマンド・ウィンドウで次のコマンドを実行します。

   docker pull <UFT One Docker イメージ名>[:tag]

   UFT One Docker イメージの名前は functionaltesting/uft または functionaltesting/uft_lite です。

   [:tag] は，特定の UFT One イメージバージョンに追加するオプションのフラグです。標準設定では，tag の値は latest です。

2. UFT Docker イメージから Docker Windows コンテナを作成するには，ホスト・コンピュータのコマンド・ウィンドウで次のコマンドを実行します。

   docker run -it --name <コンテナ名> <UFT One Docker イメージ名>[:tag] "cmd.exe"

   このコマンドによって，コンテナが作成され，コンテナに属するコマンド・ウィンドウが開きます。このウィンドウを次のステップで使用して，UFT One ライセンスをインストールします。

   注: UFT One Docker イメージは，Windows Server 2016（uft イメージ）および Windows Server 2019（uft_lite イメージ）に基づいています。別の OS の Docker ホストを使用すると，OS に互換性がないというメッセージが表示される場合があります。この問題を回避するには，Docker のドキュメントを参照してください。たとえば，
   コマンドに -isolation=hyperv または -isolation=process を追加すると，問題が解決する場合があります。

Docker コンテナへの UFT One ライセンスのインストール

UFT One の Docker イメージは，コンカレント・ライセンスでのみサポートされます。Docker コンテナが UFT One を使用するたびに，サーバからライセンスが消費されます。

Docker コンテナのコマンド・ウィンドウで，コンテナに UFT One のコンカレント・ライセンスをインストールします。詳細については，コマンド・ラインを使用したライセンスの管理を参照してください。

先頭に戻る

Docker コンテナでのモバイル・テストの実行

Docker コンテナをインストールして設定した後，UFT One と Digital Lab（UFT Mobile） の統合をセットアップし，UFT One オートメーション・スクリプトを作成して，Docker コンテナで実行します。

統合の設定

モバイル・デバイスで UFT One テストを実行するには，Digital Lab（UFT Mobile） とアプリケーションを統合用にセットアップする必要があります。詳細については，Digital Lab（UFT Mobile） と UFT One の統合のセットアップを参照してください。

次のステップで作成する UFT One オートメーション・スクリプトは，Digital Lab（UFT Mobile） への接続をセットアップします。

UFT One モバイル・オートメーション・スクリプトの作成

Docker コンテナで UFT One テストを実行するには，Digital Lab（UFT Mobile） でテストを実行するのに必要な特定のステップを含む UFT One オートメーション・スクリプトを使用します。

スクリプトには，次の部分を含める必要があります。

• UFT One を起動する。
• MCConnection オプション・オブジェクトを使用して，UFT One から Digital Lab（UFT Mobile） への接続を設定する。
• Launch メソッドを使用してアプリケーションを起動する。
• UFT One テストを実行する。
• テストを閉じる。
• UFT One を閉じる。

以下は，Digital Lab（UFT Mobile） で特定のテストを実行するために使用されるサンプル・スクリプトです。

Dim qtApp 'As QuickTest.Application ' Declare the Application object variable
Set qtApp = CreateObject("QuickTest.Application")
qtApp.Launch
qtApp.Visible = True
qtApp.Options.MCConnection.Server = "<Digital Lab（UFT Mobile） サーバ>"
qtApp.Options.MCConnection.Port = "<Digital Lab（UFT Mobile） サーバ・ポート>"
qtApp.Options.MCConnection.Username = "<Digital Lab（UFT Mobile） サーバ・ユーザ名>"
qtApp.Options.MCConnection.Password = "<Digital Lab（UFT Mobile） サーバ・ユーザ・パスワード>"
qtApp.Options.MCConnection.UseSSL = false
qtApp.Options.MCConnection.SharedSpace = "<Digital Lab（UFT Mobile） サーバ・テナント ID>"
qtApp.Options.MCConnection.WorkSpace = "<Digital Lab（UFT Mobile） サーバ・ワークスペース ID>"
qtApp.Options.MCConnection.ShowRemoteWndOnRun = true
qtApp.Open "<UFT スクリプト・パス>", True
Set qtMobileLauncher = qtApp.Test.Settings.Launchers("Mobile")
qtMobileLauncher.Lab = "MobileCenter"
qtMobileLauncher.Device.OS = "<デバイスの OS タイプ>"
qtMobileLauncher.Device.ID = "<デバイスの UDID>"
Set launchApp = qtMobileLauncher.LaunchOnStart
launchApp.IsPackaged = True
launchApp.Counter = 1
qtMobileLauncher.InstallApps = true
qtMobileLauncher.RestartApps = true
qtMobileLauncher.UninstallApps = false
qtMobileLauncher.TrackCPUMetric = true
qtMobileLauncher.TrackMemoryMetric = true
qtMobileLauncher.TrackFreeMemoryMetric = true
qtMobileLauncher.TrackLogs = true
Set qtpResultsOpt = CreateObject("QuickTest.RunResultsOptions") 'create the run Results Options object
qtpResultsOpt.ResultsLocation = "<HTML レポート・パス>"
qtApp.Test.Run qtpResultsOpt ' Run the test
qtApp.Test.Close
qtApp.Quit

詳細については，次を参照してください。

• UFT One オートメーション・スクリプト
• UFT One Automation Object Model Reference

Docker コンテナでのオートメーション・スクリプトの実行

ホスト・コンピュータのコマンド・ウィンドウで，次のコマンドを実行します。

ここで，

先頭に戻る

Docker コンテナでの API テストの実行

以下のいずれかの方法で UFT One API テストを実行します。

前提条件

• 前述の手順に従って，UFT One Docker コンテナをセットアップします。
• ホスト・コンピュータで，API テスト用のローカル・ディレクトリを作成し，テスト・フォルダを保存します。Docker は，このディレクトリを Docker コンテナ内のディレクトリにマウントします。

新しいコンテナでのテストの実行

UFT One ライセンスをインストールして作成したイメージに基づく新しいコンテナでテストを実行します。

ホスト・コンピュータのコマンド・ウィンドウで，次のコマンドを実行します。

ここで，

たとえば，ホスト・テスト・ディレクトリが C:\DockerProject\tests で，テスト名が apitest の場合，コマンドは次のようになります。

既存のコンテナでのテストの実行

ホスト・コンピュータのコマンド・ウィンドウで，次のコマンドを実行します。

ここで，

たとえば，コンテナ名が apirun，ホスト・テスト・ディレクトリが C:\DockerProject\tests，テスト名が apitest の場合，コマンドは次のようになります。

先頭に戻る

Jenkins を使用した，Docker での API テスト実行のトリガ

Docker コンテナをセットアップした後，Jenkins を使用して UFT One API テストの実行をトリガできます。

1. ホスト・コンピュータで，API テスト用のローカル・ディレクトリを作成し，テストを保存します。

2. Docker コンテナをスレーブとして Jenkins に追加します。

3. ビルド・ステップを追加し，［Execute Windows batch command］を選択します。

4. このステップにコマンドを挿入してテストをトリガします。次のいずれかを実行します。 

   • ライセンスのインストール後にコミットされた UFT One Docker イメージに基づいて新しいコンテナを作成し，API テストを実行します。

     docker run -v <host-test-directory >:<container-test-directory> --name <container-name> <image-with-licensed-uft> "<UFT One installation folder>\bin\HP.ST.Fwk.InternalExecuter.exe" -test <container-test-directory> -reportPath <report-directory-path>

   • ダウンロードした UFT One イメージに基づいて新しいコンテナを作成し，このコンテナにコンカレント・ライセンスをインストールして，API テストを実行します。

     docker run -dit --name <container-name> -v <host-test-directory >:<container-test-directory> <UFT One Docker image name>[:tag] cmd.exe /C " " <UFT One installation folder>/bin/HP.UFT.LicenseInstall.exe" concurrent <license ID> <license version> <primary server name/address>:<port> & "<UFT One installation folder>/bin\HP.ST.Fwk.InternalExecuter.exe" -test <container-test-directory> -reportPath <report-directory-path>

   このコマンドの詳細については，Docker コンテナでの API テストの実行を参照してください。

先頭に戻る

その他の参照項目：

• Docker ハブ上の UFT One イメージ