AOSを使用してTosca分散実行を設定する |HTTP

次の章では、 AOS あり/で HTTP バインディングを使用して、Tosca分散実行を設定する方法を段階的に説明します。それらは、 Tricentis が推奨するセットアッププロセスの順序で記載されております。

DEXサーバー をインストールする

Tosca Distribution Server（DEXサーバー）は、標準のToscaサーバーインストールの一部です。

DEXサーバー環境をインストールおよび構成するには、以下の手順に従います。

1. Tosca Serverのインストールを実行します。これを行うには、以下のオプションのいずれかを選択してください。

   • インストーラー経由でインストールする。

   • 無人モードでインストールする。

2. Tricentis Service Configuration にアクセスする

3. 「 Automation Object Service 」タブに移動して設定を入力する。

4. 配信サーバアドレスをダブルチェックする。デフォルトの 5007 とは異なるポートを DEX サーバーに使用する場合は、エンドポイントを変更してください：

5. Tosca Cloud とのテスト実行統合オプションを使用する場合は、 Elastic Execution Grid セクションまでスクロールして設定を入力します。

6. オプションで、さらに構成を検討することもできます：

   • DEX モニターのユーザー認証を有効にする。

   • 「 DEX サーバー」と「 DEX モニター」に異なるポートを選択する。

Automation Object Service がそのタスクを追跡する場所を定義する

Automation Object Service (AOS) は、実行中にデータのインポートや配信など、さまざまなタスクを実行します。デフォルトでは、 AOS は、「 C:C:\ProgramData\TRICENTIS\ToscaServer\ToscaAutomationObjectService 」にあるSQLiteデータベースでこれらのタスクを追跡します。

DEX でパラレル実行を最大限に活用したい場合、SQLiteが最適なオプションではない場合もあります。この場合、 AOS 同時トラフィックのサポートが優れているMS SQL Serverデータベースに切り替えることをお勧めします。

MS SQL Serverデータベースと AOS アクセスを準備する

AOS タスク用のMS SQL Serverデータベースは、Tosca Serverのインストールの一部ではありません。データベースをご自分の側でホストできるようにするには、以下の準備が必要です。

• 空のデータベースをセットアップする。AOS はすべてのスキーマとテーブルを作成します。

• AOS 用にユーザーを作成します。このユーザーには、スキーマの作成、テーブルの作成、データの書き込みの権限が必要です。通常、これは db_owner ユーザーとなります。

• データベースを DEX 環境に統合するための接続文字列を準備します。この接続文字列には、 TrustServerCertificate=true を含める必要があります。例：

  サーバー=myserver.com;データベース=myDataBase;ユーザーID=myUsername;パスワード=myPassword;TrustServerCertificate=TRUE

• 接続文字列には、任意でサポートされているキーコンテナーをご利用いただけます。構成ファイルにプレーンテキストの接続文字列を含めたくない場合のみ、この手続きを行う必要があります。

データベースを DEX 環境に統合する

MS SQL Serverデータベースを統合するには、以下の手順に従ってください。

1. Tricentisのサービスを停止してください。ToscaAutomationObjectServiceを再起動します。

2. appsettings.json ファイルを開きます。デフォルトのインストール後、このファイルは C：\Program Files(x86)\Tricentis\Tosca Server\AutomationObjectService にあります。

3. ストレージセクションに移動し、以下のストレージプロバイダー設定を記入してください。

   設定	説明
   Provider	SqlServer と入力します。
   CredentialsSource	以下のいずれかの値を入力してください。 ローカル。接続文字列をプレーンテキストで入力したい場合。 KeyVault 。サポートされている任意のキーコンテナーに保存されているクレデンシャルを使用したい場合。
   接続文字列	以下のいずれかの値を入力してください: CredentialsSource が Local の場合は、MS SQL Serverデータベースへの接続文字列を入力してください。 CredentialsSource が KeyVault の場合は、中括弧なしの動的式シークレットを使用します。たとえば、HashiCorp Vault の場合はシークレット[kv/tosca_dex/Agent/rdp][connectionString] です。

4. ファイルを保存して閉じます。

5. Tricentisのサービスを開始します。ToscaAutomationObjectService 。サービスが起動しない場合は、「 Windows イベントビューア」> 「Windows ログ」> 「アプリケーション」にデータベース接続の問題がないか確認してください。

Tosca Commander をインストールする

：

• テストイベントを作成し、その実行をトリガーしたいすべてのマシン。

• Tosca Distribution Server を保持しているマシン。

Tosca Commander のインストール方法については、 see chapter " Tricentis Toscaをインストールする" を参照してください。

エージェント をインストールする

Agent のインストールは、Tricentis Toscaのインストールの一部です。Agent をインストールするには、 Agent として機能するすべてのマシンにTricentis Toscaをインストールする必要があります。

Agent ごとに別々のマシンが必要です。Tosca Distributed Execution は、コンテナやターミナルサーバーのセットアップをサポートしておりません。

Agent をインストールするには、次の手順に従います。

1. Tricentis Tosca のインストールを開始します。

2. Tricentis ToscaInstaller のタイプ画面で、 Agent のタイプを選択します。

   • 実行エージェントをインストールするには、「 Execution Agent 」を選択します。実行エージェントは、 Engines 3.0 テストを実行するように設計されたスリム版のToscaです。

   • 完全なToscaクライアントをインストールするには、「 Tosca Commander 」を選択します。

3. Tricentis ToscaInstaller の指示に従ってインストールを完了します。

エージェント にプロキシサーバを接続する

プロキシサーバを使用したい場合にのみ、この手順を実行する必要があります。それ以外の場合は、この手順をスキップすることができます。

を自己署名証明書用またはプロキシサーバへの接続用に設定するには、エージェントの設定ファイルを変更する必要があります。これは、すべてのエージェントマシン上で行う必要があることにご注意ください。

そのためには、以下の手順に従ってください。

1. エージェントマシン上で、 ファイルを開きます。デフォルトでは、このファイルは %TRICENTIS_DEX_AGENT_HOME% にあります。

2. エージェントとプロキシ間の通信を確立するには、「 userSettings 」セクションに移動し、「 ProxyAddress 」、「 ProxyUsername 」、および「 ProxyPassword 」の設定を変更します。

<userSettings>
  <Tricentis.DistributionServer.Properties.Settings>
  ...
    <setting name="ProxyAddress" serializeAs="String">
      <value>http://11.1.11.11:1111</value>
    </setting>
    <setting name="ProxyUsername" serializeAs="String">
      <value>User1</value>
    </setting>
    <setting name="ProxyPassword" serializeAs="String">
      <value >Proxypassword</value>
    </setting>
  </Tricentis.DistributionServer.Properties.Settings>
</userSettings>

3. ファイルを保存して閉じます。

エージェント を開始し、接続する

ライセンスを管理する

Tricentis Toscaをインストールするすべてのマシンには、有効な Tosca ライセンスが必要です。

• 各 Agent マシンには ExecutionOnly ライセンスが必要です。

• テストを作成してその実行をトリガーする各マシンには、適切なTosca ライセンスが必要です。必要なライセンスは、作成するテストの種類によって異なります。ライセンスのオプションについては、 Tricentis Sales にお問い合わせください。

• AOS ワークスペースを DEX Server に設定するには、有効な Tosca ライセンスが必要です。

  このライセンスが必要なのは、ワークスペースを設定するときのみです。Tosca Distributed Execution が稼働し、 DEXサーバーのワークスペースを使用しない場合、サーバーマシンのライセンスはもはや不要です。

マシンにライセンスを設定する方法については、 see chapter "ライセンス管理" を参照してください。

ワークスペースを設定する

AOS なしで Tosca Distributed Execution を使用するには、別々のマルチユーザー作業スペースを設定する必要があります。

これらのワークスペースは、1つの共通のリポジトリにアクセスできなければなりません。

• テストを作成してトリガーする各マシン上に1つのマルチユーザーワークスペース。こちらはユーザー様の作業スペースです。

• Automation Object Service(AOS) 用の 1 つ以上のマルチユーザーワークスペース。リポジトリ内のすべての必要なテストArtifactsへの AOS アクセスを付与します。

ユーザーの作業スペースを作成する

ユーザーワークスペースを設定するには、以下の手順に従ってください。

1. ワークスペースを作成します。

   • すでに Tricentis Toscaをご利用中で、リポジトリやワークスペースをお持ちの場合は、この手順を飛ばしてもかまいません。

   • リポジトリとワークスペースをまだ設定していない場合は、今すぐ設定してください ()。テストを作成・実行する必要があるマシンごとに、1つのワークスペースが必要です。

     最初のワークスペースを作成する際には、ワークスペースの名前に英数字とアンダースコア「 _ 」のみが含まれていることを確認してください。

     その他の特殊文字は使用しないでください。

2. レポジトリに接続されているワークスペースを開いてください。

3. 「 ホーム」->「プロジェクト」の順に進みます。

4. 詳細タブでは、 というプロジェクトルート名にご注意ください。

   ワークスペースを Automation Object Service に対して設定する際に、この名前が必要となります。

すでにレポジトリとワークスペースがあるため、手順の1をスキップした場合は、プロジェクトルート名を確認します。 名前に含めることができるのは、英数字とアンダースコア「 _ 」のみとなります。 プロジェクト名に他の特殊文字が含まれている場合は、変更する必要があります。 プロジェクトルート要素をチェックアウトします。 既存の名前を新しい名前で上書きします。 チェックインします。

プロジェクトルート名を確認する

AOS ワークスペースを作成する

AOS ワークスペースは「バックグラウンド」ワークスペースで、 AOS 専用であってテスター用ではありません。これにより、 AOS はリポジトリ内のすべての必要なテストArtifactsにアクセスできるようになるため、サービスはそれらを転送して実行し、結果をインポートできるようになります。

AOS ワークスペースの作成を開始する前に "OSワークスペース：考慮事項" を確認します。このトピックでは次に関して説明します： AOS ワークスペースの基本、つまり何をすべきで、何をすべきでないか。また、パフォーマンスを最大化するために必要な AOS ワークスペースの数を把握できるようになります。

AOS ワークスペースを作成するには、次の手順に従います。

1. 分散実行（DEX）サーバーのマシンで、Toscaを開きます。

2. 「 プロジェクト->新規」にアクセスします。

3. 次の「新しいワークスペースを作成する」ウィンドウで、ドロップダウンメニューからリポジトリの種類を選択します。

4. ワークスペースをリポジトリに接続する：「既存のリポジトリを使用する」を選択し、リポジトリに接続文字列を入力します。

5. 「 新しいワークスペースの名前を選択する」フィールドに、新しい AOS ワークスペースの一意の名前を入力します。

6. 「スリムなワークスペースを作成する」を選択していないことを確認します。AOS ワークスペースはスリムなワークスペースにはできません。

7. ワークスペースを作成するには、「 OK 」を選択します。

8. Tricentis Service Configuration を開き、「 Automation Object Service 」タブに移動します。

9. 「 新規追加」を選択し、「ワークスペース」セクションでアスタリスク * 付きのすべてのフィールドに入力します。

10. 追加の AOS ワークスペースを設定するには、手順2から10を繰り返します。

11. 複数の結果をワークスペースがインポートするように指定するには、 "早期アクセス：結果のインポート作業スペースを定義する" で説明されている手順に従います。

12. どの実行環境を使用するかを定義します。

    • 分散実行のみ

    • Tosca Cloudのみ

    • 分散実行とTosca Cloud

13. 保存して閉じます。

複数の共有レポジトリ用に Distributed Execution with AOS を構成する（オプション）

デフォルトでは、 Tosca Distributed Execution は、1つの共通レポジトリで動作します。

複数のリポジトリと連携するように設定することができます。詳細については、 see chapter "複数のリポジトリを使用したDistributed Execution with AOS" を参照してください。

Tosca Commander を接続する

次は、 Tosca Commander と DEX サーバーの間の接続を指定する必要があります。

テストを作成して実行をトリガーしたいすべてのマシンでこれを行う必要があります。

あるいは、プロジェクト設定を作成することもできます。この場合、設定はリポジトリに接続されているすべてのワークスペースに適用されます。

Tosca Commander に接続するには、以下の手順に従ってください。

1. Tosca Commander を開きます。

2. プロジェクト ->設定 ->Commander->DistributedExecution - >;サーバーに移動します。

3. 設定 EndpointAddress の値として、次のように ToscaGatewayサービスのアドレスを入力します。

   http://<Tosca Server Gateway IP address or hostname>:<port>/DistributionServerService/ManagerService.svc

   デフォルトのポートは 1"="" ctype="x-Xpt" equiv-text='lt;MadCap:annotation MadCap:createDate="2021-11-29T15:45:13.0999604+01:00" MadCap:creator="vicfr" MadCap:initials="VI" MadCap:comment="TOS-64197 new sentence" MadCap:editor="vicfr" MadCap:editDate="2021-11-29T15:45:18.3455101+01:00" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd"gt;' id="1">=tricentis.product_name_server%] features"lt;/MadCap:xrefgt;"/ です。

   IPv6アドレスを使用する場合、サーバアドレスにはホスト名ではなくIPアドレスを含める必要があります。

4. プロキシサーバを使用したい場合は、設定の「プロキシ」の値にプロキシサーバの完全なネットワークアドレスを入力します。

   http://<Proxy server IP address or hostname>:<port>

5. プロジェクト->設定-&gt;Commander -&gt;DistributedExecution -& gt;Monitor URL に移動します。

6. 設定 URLの値として、次のようにToscaゲートウェイサービスのアドレスを入力します。

   http://<Tosca Server Gateway IP address or hostname>:<port>/Monitor/

パラレル実行を設定する

Tosca Distributed Execution の設定の最後のステップは任意です。

最後のステップでは、 ToscaのExecutionLists実行方法を定義できるようにプロジェクトルート設定をします。

ExecutionListのすべてのテストケースがそれぞれ独立している場合、そのExecutionListを複数のエージェント間で分割することができます。その後エージェントは同時にテストケースを実行し、テスト実行を高速化します。

プロジェクトルートを設定するためには、以下の手順に従ってください。

1. 共通リポジトリにアクセスできるワークスペースを開き、ホーム->; プロジェクトにアクセスしてください。

2. プロジェクトルート要素をチェックアウトします。

3. Properties definition タブに移動してください。

4. Properties definition タブで、 ExecutionList を右クリックし、 を選択します。ミニツールバーからプロパティを作成します。

5. 新しいプロパティの名前を TCDistribution に変更します。

6. Visible が選択されていることを確認します。

AOS REST APIにアクセスする

任意の RESTClientでAPIエンドポイントにアクセスするには、HTTP リクエストにヘッダー X-TRICENTIS を追加する必要があります。追加しない場合は、ウェブサービスは HTTP 400 バッドリクエストで応答します。

AOS REST APIにアクセスするには、以下のURLを入力してください。

http://<Tosca Server IP address or hostname> <port>/swagger/index.html

• IPv6アドレスを使用している場合は、ホスト名ではなく、サーバIPアドレスの使用が必要です。

• Tosca Distribution Server を保持しているマシンからREST APIにアクセスする場合、IPアドレスまたはホスト名の代わりに localhost を入力することができます。

• <AOS port> 、 TricentisTricentisTosca サービス構成で指定した AOS ポートに置き換えます。

AOS ワークスペースタスクの実行

AOS REST APIのリクエストとレスポンスについては、 AOS REST APIのSwaggerドキュメントを参照してください。

次は何を行いますか

Tosca Distributed Execution を設定したので、テストを開始する準備が整いました。詳細については、 see chapter "TestEventsを作成し、実行する" を参照してください。

現在のセットアップをカスタマイズする

Tosca分散実行機能は、セットアップした後でカスタマイズすることができます。以下の章で追加の構成オプションをご確認ください。

• "オプションの Tosca Distribution Server の設定"

• "オプションの Tosca Distribution Agent の設定"

• "オプションの Tosca Distributed Execution Monitor の設定"