フレックスエージェントを使用してエージェントを更新

フレックスエージェントを使用してエージェントを更新すると、フレックスエージェントはエージェントのパブリックリポジトリにアクセスし、最新バージョンを照会します。そのエージェントのバージョンが現在システムにインストールされていない場合、フレックスエージェントがそのバージョンをダウンロードします。

最新バージョンに更新すると、更新されたエージェントが、ホスト上の新しいプロセスに接続されるデフォルトのエージェントになります。

フレックスエージェントには、サポート対象言語の最新のエージェントが含まれています(フレックスエージェントのリリース時点)。現在サポートされている言語は以下のとおりです。

エージェントをピン留めすると、特定のアプリケーションに対してバージョンを使用するよう明示的に指定されていない場合に、そのアプリケーションにアタッチされるエージェントのデフォルトバージョンが設定されます。デフォルトでは、フレックスエージェント は利用可能なエージェントの最新バージョンを使用します。

エージェントをピン留めするには、pinコマンドを使用します。

コマンド使用法：

Usage: contrast-flex-service agents pin <AGENT_LANGUAGE> <PIN_VERSION>

AGENT_LANGUAGEオプションは、指定された言語のエージェントのみを表示します。サポートされている言語オプションのいずれかを指定してください：Java、.NET Core、Python、Node、PHP。

PIN_VERSION オプションは、最新の、または有効なセマンティックバージョンを指定する必要があります。

例：

Javaバージョン6.18.1をデフォルトのJavaエージェントバージョンにするには、このコマンドを使用してください。

contrast-flex-service agents pin java 6.18.1

エージェントのピン留めを解除すると、以前設定されていたバージョンが最新のエージェントバージョンに変更されます。

コマンド使用法：

Usage: contrast-flex-service agents unpin <AGENT_LANGUAGE>

AGENT_LANGUAGEオプションは、指定された言語のエージェントのみを表示します。サポートされている言語オプションのいずれかを指定してください：Java、.NET Core、Python、Node、PHP。

例：

Javaエージェントのピン留めを解除するには、以下のコマンドを使用します。

contrast-flex-service agents unpin java

すべてのエージェントまたは特定のエージェントの言語とバージョンを更新するには、 updateコマンドを使用します。

コマンド使用法：

contrast-flex agents update <AGENT_LANGUAGE> [UPDATE_VERSION]

AGENT_LANGUAGEオプションは、指定された言語のエージェントのみを表示します。サポートされている言語オプションのいずれかを指定してください：Java、.NET Core、Python、Node、PHP。

UPDATE_VERSIONオプションを指定する場合、最新のバージョンまたは有効なセマンティック バージョンを指定する必要があります。バージョンを指定しない場合は、フレックスエージェント最新バージョンを使用します。

例：

特定の言語のエージェントを最新バージョンに更新するには、以下のコマンドを使用します。

contrast-flex-service agents java update 

Javaエージェントを特定のバージョンに更新するには、このコマンドを使用します。

contrast-flex-service agents java update 6.20.1

エージェントの更新には、パブリックなものと同等の基準に従う限り、プライベートまたはサードパーティのリポジトリを使用できます。

.NET Core と NuGet

既定では、フレックスエージェント は、指定されたバージョンの Contrast.SensorsNetCore アーティファクトを取得するために、https://www.nuget.org にアクセスします。別のリポジトリに場所を変更するには、このコマンドを使用します。

contrast-flex config set-key flex_agent.agent.dotnet-core.repository ${URL}

${URL} をカスタムリポジトリのURLに置き換えてください。

JavaとMaven

デフォルトでは、フレックスエージェントはhttps://repo1.maven.org/maven2にアクセスして、指定されたバージョンのcom/contrastsecurity/contrast-agentアーティファクトを取得します。別のリポジトリに移動するには、このコマンドを使用します。

contrast-flex config set-key flex_agent.agent.java.repository ${URL}

${URL} をカスタムリポジトリのURLに置き換えてください。

NodeとNPM

デフォルトでは、フレックスエージェント は、指定されたバージョンの @contrast/agent-bundle アーティファクトを取得するために、https://registry.npmjs.org にアクセスします。別のリポジトリに場所を変更するには、このコマンドを使用します。

contrast-flex config set-key flex_agent.agent.node.repository ${URL}

${URL} をカスタムリポジトリのURLに置き換えてください。

PHPとDebian

デフォルトでは、フレックスエージェント は、指定されたバージョンのcontrast-php-agentアーティファクトを取得するために、https://pkg.contrastsecurity.com/debian-public にアクセスします。別のリポジトリに移動するには、このコマンドを使用します。

contrast-flex config set-key flex_agent.agent.php.repository ${URL}

${URL} をカスタムリポジトリのURLに置き換えてください。

PythonとPyPI

デフォルトでは、フレックスエージェントは、指定されたバージョンのcontrast-agent-bundleアーティファクトを取得するために、https://pypi.orgにアクセスします。別のリポジトリに移動するには、このコマンドを使用します。

contrast-flex config set-key flex_agent.agent.python.repository ${URL}

${URL} をカスタムリポジトリのURLに置き換えてください。