Skip to main content

コンテナでの.NET Coreエージェントのインストールと設定

以下のワークフローにより、.NET Coreエージェントの「新規登録」ウィザードで、コンテナを使用して.NET Coreエージェントをインストールして設定する手順を確認できます。新規にエージェントをデプロイする場合は、ウィザードを使用するのが最も簡単な方法です。

開始する前に

開始する前に、必要なものが揃っているか事前に確認してください。

  • エージェントが、Contrastインスタンスにアクセスできる必要があります。ローカル/オンプレミスのインスタンスでも、SaaS版のインスタンスでも良いです。ネットワークアクセスが制限されている環境では、プロキシを設定することができます。

  • Contrastのサポート対象テクノロジを使用しシステム要件を満たしていること。

  • 設定した値が有効になる優先順位を理解していること。

  • また、コマンドラインインターフェイス(エージェントをダウンロードするために選択したディレクトリを含む)と、ご利用になる組織のContrastサーバへのアクセスも必要です。

.NET Coreエージェントのウィザードを開始

  1. Contrast Webインターフェイスの右上で新規登録を選択します。

  2. アプリケーションのカードを選択します。

  3. 「言語を選択」で.NET Coreを選択します。

  4. 使用しているオペレーティングシステムを選択します。

コンテナでデプロイする方法を選択

  1. 「アプリケーションのデプロイ法を選択」で、コンテナを使用してインストールを選択します。

  2. 「コンテナでデプロイする方法を選択」で、 DockerfileまたはKubernetesを選択します。

Dockerfile：エージェントを使用してイメージをビルド

  1. 「エージェントを含めてビルド」で、表示されたコマンドをコピーして Dockerfile に追加します。

  2. 表示されたコマンドでイメージをビルドします。

Dockerfile：エージェントを設定

「エージェントを設定」で、エージェントがContrastと通信するために必要な設定情報を取得するための最適なオプションを選択します。

  1. 必要に応じて、 アプリケーションを登録を選択して下さい。

    アプリケーションを登録すると、アクセス制御のためにアプリケーションをグループに割り当てることができます。また、アプリケーションにタグやメタデータを付与することができます。

  2. エージェントのバージョンが4.2.22以降の場合は、接続トークンを使用を選択します。

    この設定方法では、1つの変数を使用して認証情報の値を指定します。接続トークンを使用する方法は、推奨される設定オプションです。

    表示されたコードをコピーし、エージェントがアクセスできる場所に接続トークンの環境変数を設定します。

  3. エージェントのバージョンが4.2.22より前の場合は、API設定を使用を選択します。

    この設定方法では、個々の変数を使用して認証情報の値を指定します。

    表示されたコードをコピーし、エージェントがアクセスできる場所に環境変数を設定します。

  4. YAMLファイルを使用してエージェントを設定する場合は、設定をダウンロードを選択します。

    表示されたコードをコピーして実行すると、認証情報の設定を含むYAMLファイルが作成されます。

Dockerfile：Contrastの設定をイメージに追加

「Contrastの設定をイメージに追加」で、表示されたコマンドをDockerfileに追加します。

このコマンドによって、エージェント設定ファイル(YAML)ファイルがDockerfileと同じ場所にダウンロードされます。このファイルを使用して、アプリケーションの全てのインスタンスで使用する設定を指定します。

Dockerfile：コンテナを実行

「コンテナを実行」で、表示されたコマンドをコピーしてコンテナを実行します。

Kubernetes：(Linuxのみ)

  1. 「エージェントオペレーターの設定方法を選択」で、 Helm(推奨)または マニフェストを選択します。

  2. Helm の場合：

    1. 「valuesファイルをダウンロードして設定」で、表示されたコマンドをコピーしてvaluesファイルを作成します。

    2. 「デプロイメントにラベルを追加」 で、表示されたコマンドを使用してデプロイメントにラベルを付けます。

    3. 「Helmチャートをインストールしてデプロイ」で、表示されたコマンドをコピーして設定を完了します。

  3. マニフェストの場合：

    1. 「オペレータをインストール」で、表示されたコマンドをコピーしてContrastエージェントオペレータをインストールします。

    2. 「オペレータを設定」で、表示されたコマンドをコピーしてContrastエージェントオペレータを設定します。

    3. 「ワークロードに組み込み」で、表示されたコマンドをコピーして AgentInjector設定エンティティを構成します。

    4. 必要に応じて、「クラスタエージェントおよびエージェントを設定」で、表示されたコマンドをコピーしてこれらのエンティティを設定して下さい。

手順

  1. 確認：Contrastが機能しているかを確認するために、通常通りにアプリケーションを使用します。例えば、アプリケーションのWebインターフェイスをクリックしたり、APIコマンドを送信してみてください。

  2. Contrast Webインターフェイスにアクセスして、ナビゲーションバーでアプリケーションを選択します。

  3. 一覧にアプリケーション名が表示されていることを確認します。

  4. Contrast Webインターフェイスのナビゲーションバーで、「サーバ」を選択します。

  5. 一覧にサーバ名が表示されていることを確認します。

このセクションの内容: