Skip to main content

Node.jsエージェントの基本のインストールと設定

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

開始する前に

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

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

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

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

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

Node.jsエージェントのウィザードを開始

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

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

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

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

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

  1. 「アプリケーションのデプロイ法を選択」で、手動でインストールを選択します。

  2. 「エージェントをインストール」で、次のいずれかのオプションを選択します。

    • npmから最新バージョンのエージェントをインストール

    • yarnコマンドを実行してエージェントをインストール

  3. 表示されたコマンドを、アプリケーションのpackage.jsonファイルの"scripts"セクションに追加します。

エージェントを設定

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

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

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

  2. エージェントがContrastと通信するために、接続トークンまたはAPI設定が必要です。エージェントのバージョンが5.15.0以降の場合は、「接続トークンを使用」を選択します。

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

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

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

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

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

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

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

  5. 表示されたコード使用して、エージェントと一緒にアプリケーションを実行します。

エージェントのデプロイを確認

  1. 通常どおりにアプリケーションを使用して下さい。例えば、アプリケーションのWebインターフェイスを操作したり、API コマンドを送信してみて下さい。

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

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

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

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