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

インストール後の設定

インストール後、DAIサーバーの設定を調整して、組織内での使用に備えることができます。

DAI を使用したシングル サインオンの構成

DAIでシングルサインオン(SSO)を有効にするには、DAIでのシングルサインオン(SSO)認証の有効化を参照してください。

自己署名SSL証明書の設定を追加する

高度なインストールを完了し、自身の証明機関でSSL証明書に署名した場合、インストール後に設定を更新する必要があります。

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. 以下のエントリをenvキーの下に追加し、ファイルを保存します:

    config.yml
    env:
    REQUESTS_CA_BUNDLE: <ルート証明機関証明書へのパス>
  4. Digital Automation Intelligence Windowsサービスを再起動します。

WindowsでEggplant DAIのポートを変更する

Eggplant DAIはインストール時にデフォルトでポート8000を割り当てますが、後から別のポートを指定することも可能です:

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。
  2. 高度なインストールを繰り返し、ステップ3または4で、設定により新しいポート値を入力します。
  3. インストールが完了したら、Digital Automation Intelligence Windowsサービスを再起動します。

Eggplant DAIアプリケーションサーバーログのローテーションを設定する

Eggplant DAIアプリケーションサーバーはデフォルトで60日間のログローテーションがありますが、設定ファイルの下でローテーション設定を変更することが可能です:

  1. Windowsのサービスマネージャーを通じてDigital Automation Intelligence Serviceを停止します。
  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。
  3. DAI_SERVER_MAX_ROTATED_LOG_COUNT envキーを探します。
  4. ログローテーションカウント番号を変更します。
  5. Digital Automation Intelligence Windowsサービスを再起動します。

ログローテーションの挙動

  • Eggplant DAIでトランザクションログがある場合、ログファイルは毎日生成されます。
  • 新しいログファイルが入ってきたとき、そしてログフォルダが設定値と同数のログファイルを含むときにローテーションが行われます。例えば:
    • DAI_SERVER_MAX_ROTATED_LOG_COUNT: 3を設定します
    • DAIサービスログフォルダは生成されたログファイルを含む、例えば:
      • log.txt.2023-01-01, log.txt.2023-01-03, log.txt.2023-01-04
    • 1月6日に新しいログファイルが作成された場合、このログファイルは最古のログファイルlog.txt.2023-01-01を置き換えます。その結果、次のログファイルが利用可能になります:
      • log.txt.2023-01-03, log.txt.2023-01-04, log.txt.2023-01-06
    • そして新しいログファイルが入ってきたときに再びローテートします。例えば:
      • log.txt.2023-01-04, log.txt.2023-01-06, log.txt.2023-01-07
  • このログローテーション機能は、DAI 6.5で作成されたログファイルのみをローテートします。DAI 6.5以前に作成されたログファイルは手動で管理する必要があります。
  • DAI 6.5のログファイルの名前形式は、DAIの早期バージョンとは異なります。新しいログファイルの名前形式はlog.txt.<タイムスタンプ>です。
  • ログローテーションはPostgreSQL、Nginx、RabbitMQ、Keycloakのログを除外します。これらのログは手動で管理する必要があります。

Eggplant DAI Bug Huntingを設定する

DAI には、バグの発見に役立つ「Bug Hunting」機能が含まれています。詳細については、Bug Hunting を参照してください。 Bug Hunter は 2 つのモードで実行できます。

  • Bug Hunter Classic、(デフォルト) スタンドアロン プロセスおよび実行可能ファイルです。
  • Bug Hunter Lite。ai-api (DAI API) サービスの下で実行されます。

Bug Hunter Lite は、Bug Hunter Classic に比べてパフォーマンスが大幅に向上しています。ただし、使用するには有効にする必要があります。オプションで「DAI_LOG_FACTORS」を追加して Bug Hunter に関する情報を取得することもできます。

Bug Hunter Lite を有効にするには:

  1. Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. 次のエントリを追加し、ファイルを保存します。

    config.yml
     env:
    BUG_HUNTER_LITE_ENABLED: 1 <enabled to use Bug Hunter Lite>

    BUG_HUNTER_LITE_ENABLED を 0 に設定すると無効にできます。

    ノート

    この設定を以下で説明する DAI_LOG_FACTORS 設定とともに使用して、Bug Hunter に関する情報を取得できます。

  4. Digital Automation Intelligence Windows サービスを再起動します。

DAI モデルのAction優先度を決定する要素のログを有効にする

DAI は、探索的テストを実行するときに、いくつかの要素を使用してActionが実行される確率を決定します。デフォルトでは、DAI 実行ログにはこれらの要素に関する情報は含まれません。 DAI_LOG_FACTORS 設定を有効にすることで、この情報を取得できます。

ノート

DAI_LOG_FACTORS 設定は、DAI 6.5 以降で使用できます。

  1. Windows サービス マネージャーを使用して Digital Automation Intelligence Service を停止します。

  2. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  3. 次のエントリを追加し、ファイルを保存します。

    config.yml
     env:
    DAI_LOG_FACTORS: 1 <enabled to capture information about the Bug Hunter>

    DAI_LOG_FACTORS を 0 に設定すると無効にできます。

  4. Digital Automation Intelligence Windows サービスを再起動します。

スケジュールされたテストアーティファクトの削除の有効化

デフォルトでは、DAI はテスト成果物を無期限に保存するか、手動で削除するまで保存します。ただし、DAI サーバー設定ファイルで次の表に示す 2 つの環境変数を設定することで、スケジュールに基づいてそれらを削除するように DAI を設定できます。この機能を有効にすると、指定した日数のテスト結果、ログ、およびスクリーンショットのアーティファクトが保存され、その期間が経過すると、指定した昼間 (または夜間) に削除されます。

DAI サーバー設定ファイルには、デフォルトではこれらの変数は含まれていません。この機能を使用するには、手動でファイルに追加する必要があります。変更するファイルの名前は、実行しているDAIサーバー(オンプレミスまたはコンテナデプロイメント)のタイプによって異なります。各 DAI サーバー・インストール・タイプの構成ファイルを変更する手順については、表の後ろに説明します。

ノート
  • この機能は DAI 7.3 で実装されました。
  • スケジュール削除を有効にするには、次の両方の環境変数を DAI サーバー設定ファイルに追加する必要があります。
  • 環境変数は大文字と小文字が区別されるため、次の表に示すように入力する必要があります。
  • DELETE_RESULTS_TRIGGER_TIME 値は一重引用符で囲む必要があります。 一重引用符を使用しない場合、DAI Server サービスは再起動されません。
環境変数説明
DELETE_RESULTS_AFTER_DAYSデフォルト値 : 0 (無効) テストアーティファクトを削除する前に保存するための日数を指定します。この値は、0,1,10,20,60,120 などの整数である必要があります。この環境変数を DAI サーバー設定ファイルに追加しない場合、または追加してゼロ (0) に設定した場合、スケジュールされた削除が無効になります。この場合、DAI は結果を無期限に保存するか、手動で削除するまで保存します。これら 2 つの変数が設定ファイルに追加されていても、「DELETE_RESULTS_AFTER_DAYS」が無効になっている場合、「DELETE_RESULTS_TRIGGER_TIME」変数も無効になります。
DELETE_RESULTS_TRIGGER_TIME'03:00''Default Value : '03:00' (3 am)' ローカルサーバーの時刻に基づいてDAIが削除を実行する時刻。この変数は 24 時間形式を使用します。これは、デフォルトの午前 3 時や深夜 ('00:00') など、誰もサーバーを使用していない時間に設定することをお勧めします。時間の値は一重引用符で囲んで指定する必要があることに注意してください。DAI Server サービスは、一重引用符を含めない場合、再起動されません。

オンプレミス DAI の Windows インストールの場合

  1. C:\ProgramData\Eggplant\Digital Automation Intelligence\config.yml に移動し、テキスト編集ツールで .yml ファイルを開きます。

  2. 次のエントリを 'config.yml' ファイルに追加します。

    config.yml
     env:
    DELETE_RESULTS_AFTER_DAYS: 30 <an arbitrary integer specifying the number of days you want to keep your test artifacts before deleting them; set this to 0 to disable scheduled deletions>

    DELETE_RESULTS_AFTER_DAYS: '03:00' <the time in single quotes at which you want DAI perform the deletion based on the local server time>

  3. 変更を保存します。

  4. DAI Server サービスを再起動して、config.yml ファイルの変更で実行します。

  5. スケジュールの変更を確認します。スケジュールの変更を確認するために、ai-apiフォルダのログを参照する必要がある場合があります。

Helm (Garden) コンテナデプロイメントの場合

  1. Ai-api Helm フォルダーに移動して、'values.yaml' ファイル内の次の変数値を変更します。

  2. 次のエントリを追加します。

    values.yaml
     env:
    DELETE_RESULTS_AFTER_DAYS: 30 <an arbitrary integer specifying the number of days you want to keep your test artifacts before deleting them; set this to 0 to disable scheduled deletions>

    DELETE_RESULTS_AFTER_DAYS: '03:00' <the time at which you want DAI perform the deletion in single quotes>

  3. 変更を保存します。

  4. Garden deployは、values.yaml ファイルに次の変更を加えてデプロイします。

  5. Helm インスタンスでログを見つけるのにサポートが必要な場合は、カスタマーサクセスマネージャーまたは当社の カスタマー Support にお問い合わせください。