Node.jsエージェントのアップデート

SaaS版：npmからエージェントの最新バージョンを入手します。 エージェントを使用する前に検証を必要とする場合、承認されたバージョンのみがあるプライベートのnpmリポジトリを使用することもできます。

オンプレミス(EOP)版：オンプレミス版を利用しているお客様の多くが、Contrastで新しいソフトウェアがリリースされても、コアソフトウェアやエージェントをすぐには更新しません。通常、パブリックリポジトリ(npmなど)は、新しいバージョンのエージェントを提供しますが、新しいバージョンのエージェントは、古いバージョンのContrastで動作するように設計やテストされていません。オンプレミス版をご利用の場合は、インストールしたオンプレミス版のContrastと一致するエージェントのバージョンのみを保存するプライベートnpmリポジトリから、エージェントの更新を取得してください。

package.jsonを使う：このファイルには、npm(パブリックまたはプライベート)からのアーティファクトを使用して、Node.jsアプリケーションをビルドするたびに自動的に解決する依存関係を指定します。ここにContrastのNode.jsエージェントを含めることで、アプリケーションの新しいビルドを常に最新バージョンのエージェントに合わせることが簡単にできます。例：

{
  "name": "sample_application",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start": "nodemon",
    "contrast": "node --import @contrast/agent index.js"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.17.1",
    "@contrast/agent": "latest",
  },
  "devDependencies": {
    "nodemon": "^1.19.2"
  }
}

そして、アプリケーションをビルドする際には常に$ npm updateコマンドを使用します。これにより、Node.jsエージェントがnpmからNode.jsアプリケーションに自動的にダウンロードされ、追加または更新されます。

コマンドラインによる手動インストールおよび更新：組織によっては、package.jsonファイルが環境間で一貫している必要がある場合や、すべての環境にContrastのNode.jsエージェントをインストールする予定がない場合があります。このような場合、手動でエージェントをインストールします。Node.jsのビルドプロセスの一部として手動でエージェントを更新できます。

次のコマンドを使用して、ContrastのNode.jsエージェントを手動で取得し、npm(パブリックまたはプライベート)からNode.jsアプリケーションに追加または更新します。

$ npm install @contrast/agent