このトピックでは、NPM プライベートリポジトリでパッケージを管理する方法について説明します。
前提条件
NPM プライベートリポジトリでパッケージを管理する前に、NPM リポジトリを作成する必要があります。詳細については、「Create an NPM repository」をご参照ください。
NPM リポジトリの使用
NPM リポジトリで、[ユーザーガイド] をクリックします。 [ダウンロードリンク] から .npmrc ファイルをダウンロードするか、指示に従ってプッシュおよびプル設定を構成できます。 また、アカウントエリアの目のアイコンをクリックして、NPM のユーザー名とパスワードを表示することもできます。
[NPM Configuration] タブで [Push] を選択します。ステップ 1:リポジトリの認証情報を設定します。npm config set registry=<repository_url> を実行してレジストリを指定し、続いて npm login を実行して、ユーザー名とパスワードを入力しログインします。ステップ 2:パッケージをプッシュします。npm publish を実行します。
NPM パッケージの表示と管理
リポジトリのホームページで、パッケージ一覧に移動して、リポジトリ内のすべてのパッケージを表示します。検索アイコンをクリックすると、名前でパッケージを検索できます。
パッケージ一覧ページには、[Package Name]、[Latest Version]、[Last Updated]、[Storage Size]、[Versions]、[Downloads]、[Last Downloaded]、[Actions] (削除) などの列を含むテーブル形式でパッケージ情報が表示されます。
パッケージバージョンの詳細
[パッケージ名] をクリックすると、アーティファクト詳細ページが開きます。このページでは、デフォルトでアーティファクトの最新バージョンの [詳細情報] が表示され、クリックして他のバージョンに切り替えることができます。
パッケージの詳細ページの右側パネルには、パッケージ情報 (合計バージョン数、ストレージサイズ、パッケージタグ)、バージョン情報 (プッシュしたユーザー、プッシュ時刻)、依存関係、および [File Information] と [Metadata] の 2 つのタブが表示されます。下部には、NPM のインストールコマンド (例:npm install expressjs-hello)、[Delete This Version] ボタン、および [Disable Artifact] スイッチがあります。
パッケージバージョンの無効化
パッケージ詳細ページで、[アーティファクトを無効化] をクリックし、パッケージバージョンを無効化する理由を入力します。
無効化はパッケージ全体ではなく、特定のバージョンに適用される点に注意してください。たとえば、web-server-demo の詳細ページでバージョン 1.0.0 を無効化すると、バージョン 1.0.0 はダウンロードできなくなります。一方で、1.0.1 などの他のバージョンは引き続きダウンロードして使用できます。
パッケージメタデータの管理
パッケージ詳細ページで、目的のバージョンに切り替えて、[メタデータ] タブをクリックします。ここで、パッケージバージョンのメタデータを管理できます。メタデータは、指定されたバージョンにのみ適用されます。
カスタムメタデータは、owner=demo や release=v1 などのキーと値のペアとして表示されます。既存のエントリを編集または削除するか、[Add Metadata] をクリックして新しいエントリを追加できます。
パッケージバージョンの削除
パッケージ一覧ページで [Package Name] をクリックして詳細ページを開きます。[Delete This Version] をクリックして該当バージョンを削除します。
削除後は、リポジトリのホームページで [Recycle Bin] をクリックし、復元アイコン
をクリックしてバージョンを復元できます。
または、[Permanently Delete] アイコンをクリックして、バージョンを完全に削除できます。