エージェントアクション

Coordinator Manager のAgent List で、Build Group や Log Level などの設定を変更することができます。1つのエージェントを変更するには、3つのドットのメニューを使用するか、任意のエージェントを右クリックします。

  • Enabled as Helper 一時的にこのAgentエージェントがビルドを支援しないようにするには、チェックボックスをオフにします。

  • Allow to Enable/Disable as Helper このAgent自身をヘルパーとして無効化し、ビルドを一時的に支援しないようにします。

  • License Configuration: 手動で エージェントにライセンスを割り当てることができます。割り当てが利用可能な場合、デフォルトでは、新しいAgentはライセンスを受け取ります。

  • Enable Build Cache ：イニシエータエージェントで Build Cache を有効化し、エージェントがローカルキャッシュ、 共有キャッシュ、またはその両方を使用するかどうかを定義できます。

  • Buildの構成 ：Build Cacheのエンドポイントのサイズと場所を変更することができます。これらは、Agent自体のAgent設定で変更することもできます。

  • Unsubscribe Agent: エージェントからすべてのライセンスを削除します。

  • Agentの説明：Agentを識別するために使用するフリーテキストです。

  • Assignment Priority: タスクを割り当てる際にCoordinatorがこの ヘルパーエージェントに与える優先順位です。高い優先順位を持つAgentは、低い優先順位のエージェントよりも容易にタスクを割り当てることができます。優先順位は最高が1で最低が5です。

  • Build Priority: このAgentが開始したビルドに割り当てられる優先度です。すべてのビルドに対して十分なヘルパーがない場合、ビルドの優先順位によって、どのビルドがヘルパーを得るかを定義します。最も優先順位の高い(1)ビルドは、常に、優先順位の低いビルドのどれよりも前に、全ヘルパーを受け取ります。人数が足りない場合、2-4の優先順位は、ヘルパーを分配します。最も優先順位の低い（5）は、他のすべてのビルドが完全に分配された場合にのみヘルパーを受け取ります。

  • Build Group: 既存のBuild GroupにAgentを割り当て、ビルドの配布を特定のエージェントセットに制限することができます。詳しくは、Build Groups をご覧ください。

  • Log Level: ログに含まれる詳細の程度。この値は、Incredibuild サポートチームから特に要求がない限り、Minimal （最小）に設定する必要があります。

  • Resize Helper Cache: Helperキャッシュは、 ヘルパーエージェントが以前のビルドからデータを再利用できるようにします。

  • Advanced Configuration: これらのオプションにより、1つまたは複数のAgentの様々な設定をリモートで変更することができます。(詳しくは後述)。

  • Update Version: Coordinatorをアップグレードした後、各Agentも自動的に同じバージョンにアップグレードされます。何らかの理由でアップグレードが行われなかった場合、このオプションを使用して、手動によるリモートでエージェントをアップグレードすることができます。

  • 説明の設定： 識別のためにAgentの説明をフリーテキストで追加します。

  • Clean Helper Cache: Helperのキャッシュを削除します。

複数のAgentを変更する（一括操作）

任意のアクションを複数のエージェントに適用することができます。Agentのリストを最初にフィルタリングすれば、Agentのステータスに基づいて、ライセンスやBuild Groupの割り当てなどの一括アクションを迅速に実行することができます。

リスト内のAgentにカーソルを合わせると、左のチェックボックスが表示されます。関連するエージェントをチェックし、アクション ボタンをクリックするか、右クリックします。変更した内容は、選択したすべてのAgentに適用されます。

Tip: タイトルバーのチェックボックスの隣にあるドロップダウンを使って、特定のタイプのAgentをすべて選択することができます。

高度なエージェント構成

これらのオプションにより、1台または複数のエージェントの様々な設定をリモートで変更することができます。

  • 並列リンクを許可する： 複数のリンクステップを並行して実行することができるようにします。

  • ローカルを避ける： ヘルパーにタスクを分散させることが可能な場合は、ローカルでの実行を回避します。

  • ビルドモニタの出力フォント： ビルドモニターのアウトプット表示で使用使用するフォントです。

  • Coordinator Port： エージェントが関連付けられているCoordinator への接続に必要なポートを変更します。

  • Coordinator Server: Agentが関連付けられているCoordinator を変更します。

  • Enable MsBuild: Visual StudioのビルドでMSBuild.exe（有効）またはdevenv.exe（無効）を実行するかどうかを定義します。

  • Force CPU Count for Initiator: ビルドの実行時に使用されるイニシエータ上の最大CPUコア数です。これには、Incredibuildエージェントサービスを再起動する必要があります。

  • 英語のビルドモニターを強制 VS ビルドモニターの出力を強制的に英語にします。

  • Helper Activity Report Timeout: このタイムアウト期間後にイニシエータとの通信に失敗した場合、Helperを無効化します。デフォルトでは、タイムアウトは40秒です。

  • PDBファイルインスタンスの最大発生件数 ：同時にビルドできる（同じプロジェクトに属する）ファイルの最大数。0は制限なしを意味します。

  • 最大ファイル同期スレッド数： イニシエータと ヘルパー間の 1 回のファイル転送に使用されるスレッドの最大数。

  • 最大並列リンク数： 並行して実行可能なリンクステップの最大数。「並列リンクの許可」が有効になっている必要があります。

  • 最大ログサイズ： ログファイルの最大サイズ（MB）を定義します。デフォルトでは、制限はありません。これは、Build CacheやTest Consoleなど、最大になりがちなログにのみ影響します。

  • Only Fail on Local: このオプションを有効にすると、リモートで失敗したタスクがローカルマシンで再試行されます。

  • 投機的実行： 予測実行を有効化します。

  • Use 64 Bit Toolset: デフォルトの32ビットツールセットではなく、Visual Studioのネイティブ64ビットツールセットを使用してVisual Studioのビルドを実行します。