メインコンテンツまでスキップ
バージョン: DAI 7.1

コマンドラインモードでのエージェントの実行（DAIランエージェント）

DAI ランエージェントは、ユーザーインターフェイスなしでコマンドラインから設定および実行することができます。

  1. コマンドプロンプトからエージェントディレクトリに移動します。例えば：

    • Windows の場合：C:\Program Files (x86)\eggplantDAIRunAgent\
    • Mac の場合：/Applications
    • Linux の場合：（eggplantDAIRunAgent実行ファイルが抽出されたパス）

  2. エージェント実行ファイルを実行し、適切な引数を追加します：

    • Windows の場合：eggplantDAIRunAgent.exe [引数]
    • Mac の場合：./eggplantDAIRunAgent [引数]
    • Linux の場合：./eggplantDAIRunAgent [引数]
警告

コマンドウィンドウを介してコマンドライン引数でエージェントを起動する際には注意してください。引数の入力を間違えると、コマンドウィンドウが即座に閉じてしまい、ログは作成されません。

DAI ランエージェントの実行例​

DAI ランエージェントにダウンロードした.iniファイルのパスを提供し、そのファイルに設定が 1 セクションだけ含まれている場合、追加の引数を提供する必要はありません。Mac または Linux ベースのシステムの bash シェル端末で、EPF の GUI が必要ない場合は、次の引数でランエージェントを起動できます：

./eggplantDAIRunAgent --ini-file "my envs/my_env.ini"

ファイルパスにスペースが含まれている場合は、引用符で囲む必要があります。

以下は、より詳細ですがオプションの引数を使用して、異なるオペレーティングシステムで DAI ランエージェントを実行する例です。.iniファイルに複数のセクションが含まれている場合、DAI デザインエージェントが使用するものとして、--host-urlと--env-idのみを提供する必要があります。

Windows​

cd C:\Program Files (x86)\eggplantDAIRunAgent
eggplantDAIRunAgent.exe --ini-file envs\my_env.ini --host-url https://server.company.com --env-id 1 --gui True --log-level DEBUG

Mac/Linux​

./eggplantDAIRunAgent --ini-file envs/my_env.ini --host-url https://server.company.com --env-id 1 --gui True --log-level DEBUG

コマンドライン引数​

コマンドライン引数の完全なリスト、使用方法、および機能については、--helpフラグを使用してランナーを起動することで確認できます。

Windows の場合：

cd C:\Program Files (x86)\eggplantDAIRunAgent
eggplantDAIRunAgent.exe --help

Mac/Linux の場合：

./eggplantDAIRunAgent --help

以下は、サポートされているコマンドライン引数と対応する環境変数のリストです。

引数環境変数説明
--ini-file FILEDAI_AGENT_INI_FILEDAI サーバーからダウンロードされた環境設定（.ini）ファイルの場所。(.ini)ファイルは、ダウンロードされた ini ファイルをロードする際にのみ作成されます。

デフォルト:
Windows: C:\Users\{user}\.eggplantDAI.ini（非表示にマークされています。）
Mac: ~/.eggplantDAI.ini
Linux: ~/.eggplantDAI.ini
--host-url TEXTDAI_HOST_URL接続する Eggplant DAI サーバー、例：https://server.company.com。これは、環境設定（.ini）ファイルのhost_urlにマップされます。
--env-idと組み合わせて.iniファイルの適切なセクションを選択するために使用します。
指定されていない場合は、.ini ファイルの最初のセクションを使用します。
--env-id INTEGERDAI_EXEC_ENV_IDDAI サーバー上の実行環境の ID。
--host-urlと組み合わせて.iniファイルの適切なセクションを選択するために使用します。
指定されていない場合は、.ini ファイルの最初のセクションを使用します。
--suite-root DIRECTORYEGGDRIVE_SUITE_ROOTダウンロードされたスイートを保存するためのフォルダ。
Eggplant Functional スイートは、指定されたルートフォルダのサブルダとしてアップロードおよびダウンロードされます。

デフォルト:
Windows: C:\ProgramData\Eggplant\agent\Suites
Mac: ~/Library/Application Support/agent/suites
Linux: ~/.local/share/agent/suites
--gui [True&#124False]Eggplant Functional の UI を表示するかどうかを指定します。

デフォルト: False
--drive-port INTEGEREGGDRIVE_PORTEggplant Functional が eggDrive コマンドをリッスンするために使用するポート。
指定されていない場合は、ランダムに割り当てられた空きポートを使用します。
--epf FILEEGGDRIVE_EXECEggplant Functional runscript ファイルの場所。runscript ファイルはコマンドラインから Eggplant Functional を実行するために使用されます。

デフォルト:
Windows: C:\Program Files\Eggplant\Eggplant.app\runscript.exe
Mac: /Applications/Eggplant.app/Contents/MacOS/runscript
Linux: /usr/local/bin/runscript
--log-level [INFO&#124DEBUG&#124TRACE]ログレベル。

INFO: 物事が期待通りに動作していることを確認する基本的なメッセージ。
DEBUG: 問題の診断時に詳細なメッセージを提供します。
TRACE: すべてのレベルのログを表示します。

デフォルト: DEBUG
--log-folder DIRECTORYDAI_AGENT_LOG_FOLDERログファイルを保存するためのフォルダ。

デフォルト:
Windows: C:\ProgramData\Eggplant\agent\logs
Mac: ~/Library/Logs/agent
Linux: ~/.cache/agent/log
--licenser-host TEXT[オプション] Licenser ホストを指定するための追加の EPF 引数。
--versionバージョンを表示します。
--helpヘルプメッセージを表示し、終了します。

テスト設定実行のための Eggplant Functional 停止および再起動設定​

テスト設定を実行する際に、Eggplant Functional（EPF）を再起動するまでの実行時間や、ポーリング停止および再起動のための猶予期間を次の環境変数で設定できます。 詳細はテスト設定実行のための Eggplant Functional 停止および再起動設定を参照してください。

環境変数デフォルト説明
RESTART_EPF_AFTER_SECONDS1800EPF が起動してから次の EPF 再起動までの期間。この変数は現在のステップが終了し、次のステップに移る前に有効になります。これは DAI ランエージェントでのテスト設定実行にのみ適用されます。ライブランでは、EPF は再起動せずに連続して実行されます。デフォルトは 30 分です。
EPF_QUIT_POLL_TIME_SECONDS20再起動プロセス中に EPF が終了するための猶予期間。
EPF_RESTART_POLL_TIME_SECONDS120EPF が終了した後に起動するための猶予期間。EPF_RESTART_POLL_TIME_SECONDSにはEPF_QUIT_POLL_TIME_SECONDSは含まれません。
に最終更新