日本語

NPM & PNPM - プライベートパッケージ

プライベートパッケージを使用しているリポジトリで Aikido が依存関係を更新する場合、ロックファイルを正しく更新するためにそれらのパッケージへのアクセスが必要です。プライベート NPM レジストリで認証するように Aikido を設定することで、これらの更新を実行できます。

前提条件

NPM または PNPM を使用しているリポジトリでは、プライベートパッケージへのアクセスは .npmrc ファイルで管理されます。パッケージマネージャーは .npmrc ファイルを使用して、どのレジストリを使用し、どのように認証するかを判断します。

次のいずれかの方法を選択できます:

  • トークンに環境変数を参照する .npmrc ファイルをリポジトリに含める。
  • .npmrc の設定を Aikido のインターフェースで直接指定する(こちら)。

プライベートパッケージ名が @pied-piper/*** のような形式で、GitHub の npm レジストリでホストされている場合、ファイルは次のようになります:

@pied-piper:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<YOUR_GITHUB_TOKEN>

Aikido で .npmrc ファイルが設定されている場合、依存関係を更新する前に .npmrc ファイルを書き込みます。リポジトリに .npmrc ファイルが存在する場合は、Aikido で設定された .npmrc ファイルによって上書きされます。

.npmrc についての詳細は、NPM のドキュメント(こちら)をご覧ください。

Aikido での設定

プライベートパッケージを使用するリポジトリの更新を可能にするには、Aikido の UI でプライベートレジストリの設定を指定します。Aikido は認証情報を暗号化して保存し、認証情報を Aikido の UI や API から取得することはできません。

  1. Aikido で Autofix > Settings に移動します(こちら)。
  2. 「Connect Registry」をクリックすると、選択モーダルが表示されます。
  1. NPM を選択して、.npmrc ファイルを入力します。
  1. .npmrc ファイルの内容を入力します。この例は、GitHub Packages でホストされているスコープ付きパッケージ(@pied-piper)の設定を示しています。
  2. 「Connect Registry」をクリックして設定を保存します。