プライベートレジストリーから npm パッケージをインストールする ServiceNow IDE

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：4分

    • プライベートレジストリからノードパッケージマネージャー (npm) パッケージを依存関係としてアプリケーションにインストールし、サードパーティライブラリとして使用します。

    始める前に

    必要なロール：admin

    このタスクについて

    プライベートレジストリからパッケージをインストールするには、 ServiceNow IDEでパッケージマネージャーのユーザー設定を構成する必要があります。次に、パッケージをインストールするアプリケーションを選択できます。

    ServiceNow IDE は、デフォルトのパッケージソースとしてパブリック npm レジストリ (https://registry.npmjs.org) を使用します。ネットワークがこのレジストリへのアクセスをブロックしている場合、パッケージをダウンロードして ServiceNow IDEでアプリケーションをビルドするには、代替レジストリにアクセスできる必要があります。システムでパブリック npm レジストリへのアクセスがブロックされている場合は、 ServiceNow IDE のパッケージマネージャーユーザー設定でプライベート npm レジストリを構成する必要があります。

    注:
    プライベートレジストリからパッケージをインストールするには、レジストリが HTTP Access-Control-Allow-Origin ヘッダーで応答する必要があります。

    手順

    1. 移動先 すべて > アプリ開発 > ServiceNow IDE.
    2. ワークスペースを開きます。
    3. コマンドパレットを開くには、次のいずれかのキーボードショートカットを使用します。
      • Windows：Ctrl-Shift-P
      • Mac：Cmd-Shift-P
    4. 設定を入力: ユーザー設定 (JSON) を開き、Enter キーを押します。
    5. プライベートレジストリをデフォルトのレジストリとして指定するか、パッケージをインストールできるス コープ付きレジストリ を指定します。
      オプション例
      デフォルトレジストリ 
      "package-manager.defaultRegistry": "<private-registry-url>",
      スコープ対象レジストリ 
      "package-manager.scopedRegistries": [
        {
            "scope": "@<scope>",
            "registry": "<private-registry-url>"
        },
        ...
]
      注:
      パブリックレジストリからパッケージをインストールするには、パブリックレジストリーをデフォルトのレジストリーとして指定するか、プライベートレジストリーに加えてスコープ付きレジストリを指定できます。
    6. プライベートレジストリーにアクセスするための認証情報を入力します。
      オプション説明
      基本認証 指定したデフォルトのレジストリにアクセスするためのユーザー名とパスワードを入力します。
      "package-manager.basicAuth": [
    {
        "registry": "<private-registry-url>",
        "user": "<user-name>",
        "pass": "<password>"
    },
    ...
]
      従来の認証 指定したデフォルトのレジストリにアクセスするための従来のトークンを指定します。従来のトークンは、Base64 形式でエンコードされたベーシック認証情報です。
      "package-manager.legacyAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<legacy-token>"
    },
    ...
]
      トークン認証 指定したデフォルトのレジストリにアクセスするためのベアラートークンを指定します。
      "package-manager.tokenAuth": [
    {
        "registry": "<private-registry-url>",
        "token": "<token>"
    },
    ...
]
    7. 変更内容を settings.json ファイルに保存します。
    8. 構成されたレジストリからパッケージをインストールします。
      1. コマンドパレットを開くには、次のいずれかのキーボードショートカットを使用します。
        • Windows：Ctrl-Shift-P
        • Mac：Cmd-Shift-P
      2. 「パッケージマネージャー:依存関係のインストール」と入力し、Enter キーを押します。
      3. パッケージを依存関係としてインストールするアプリケーションを選択します。
      パッケージは node_modules ディレクトリにインストールされます。

    プライベートレジストリーアクセスのユーザー設定

    次の例では、ユーザーはベーシック認証を使用してプライベートレジストリーへのアクセスを構成しました。ユーザーは、 @example スコープのパブリックレジストリからパッケージをインストールするように設定も構成しました。

    {
    "files.autoSave": "off",
    "package-manager.defaultRegistry": "<private-registry-url>",
    "package-manager.basicAuth": [
        {
        "registry": "<private-registry-url>",
            "user": "<user-name>",
            "pass": "<password>"
        }
    ],
    "package-manager.scopedRegistries": [
        {
            "scope": "@example",
            "registry": "<public-registry-url>"
        }
    ]
}

    次のタスク

    インストールしたパッケージをサードパーティライブラリとしてアプリケーションに使用します。詳細については、「ServiceNow IDE のアプリケーションでサードパーティライブラリを使用する」を参照してください。