ホームページ >ウェブフロントエンド >jsチュートリアル >プライベート npm リポジトリ

プライベート npm リポジトリ

Patricia Arquetteオリジナル: 2025-01-05 09:43:40351ブラウズ

Private npm Repositories

以下は、プライベート npm リポジトリを設定する方法に関する詳細なガイドです。これには、開始に役立つさまざまな代替案や実用的なコードスニペットが含まれています。あなたが個人の開発者であっても、大規模なチームの一員であっても、独自の npm パッケージを非公開でホストすることで、制御性、柔軟性、セキュリティの向上を実現できます。

プライベート npm リポジトリを使用する理由

セキュリティとコントロール: パッケージとコードを内部に保持します。
ビルドの高速化: 外部依存関係とネットワーク遅延を削減します。
アクセス管理: 特定のパッケージにアクセスまたは公開できるユーザーを制御します。
バージョン管理とアーカイブ: 混乱や外部の混乱を招くことなく、内部パッケージの複数のバージョンを維持します。

プライベート npm リポジトリをホストするための一般的なアプローチ

セルフホスト型ソリューション
- Verdaccio: 人気のあるオープンソースの軽量 npm プロキシレジストリ。
- Sonatype Nexus: 複数のリポジトリ形式 (npm、Maven など) をホストするための包括的なプラットフォーム。
- JFrog Artifactory: 広く使用されているバイナリリポジトリマネージャー。
Git ホストによって管理
- GitHub パッケージ: GitHub 組織内でプライベート npm パッケージをホストします。
- GitLab パッケージ: GitLab の DevOps プラットフォームの一部として組み込みの npm レジストリを提供します。
- Bitbucket (サードパーティ統合またはカスタムソリューション経由)。
npm エンタープライズ
- 大規模なチームがあり、エンタープライズレベルの機能 (高度なアクセス制御、セキュリティ監査など) が必要な場合は、npm Enterprise が選択肢になる可能性があります。

1. Verdaccio を使用したプライベート npm レジストリのセットアップ

Verdaccio は、セットアップと使用が簡単なオープンソースの npm レジストリプロキシです。これにより、プライベートパッケージをホストしたり、公式の npm レジストリからパブリックパッケージをキャッシュしたりすることができます。

1.1 Verdaccioのインストール

Node.js がすでにマシンにインストールされていると仮定します:

# Install Verdaccio globally
npm install --global verdaccio

1.2 ヴェルダッチョを開始する

verdaccio

デフォルトでは、Verdaccio はポート 4873 で起動します。ブラウザを開いて http://localhost:4873 にアクセスすると、Verdaccio UI が表示されます。

1.3 Verdaccio の構成

Verdaccio は、最初の実行時にデフォルトの構成ファイルを作成します。編集してカスタマイズできます (ファイルパスはシステムによって異なる場合があります)。一般的な構成 (~/.config/verdaccio/config.yaml) は次のようになります:

# Install Verdaccio globally
npm install --global verdaccio

storage: Verdaccio がパッケージを保存するディレクトリ。
uplinks: 公式 npm レジストリを指します。
packages: アクセス、公開、およびプロキシのルールを定義します。

1.4 ユーザーの作成とログイン

verdaccio

これにより、ユーザー名、パスワード、電子メールの入力が求められます。完了すると、プライベートレジストリにログインします。

1.5 パッケージの公開

有効な package.json を含むパッケージディレクトリ内:

storage: ./storage
auth:
  htpasswd:
    file: ./htpasswd
    max_users: 100

uplinks:
  npmjs:
    url: https://registry.npmjs.org/

packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs

  '**':
    access: $all
    publish: $authenticated
    proxy: npmjs

middlewares:
  audit:
    enabled: true

logs:
  - { type: stdout, format: pretty, level: http }

それだけです！これで、パッケージがローカルの Verdaccio レジストリに公開されました。

1.6 プライベートレジストリからのインストール

このレジストリからパッケージをインストールするには、次のいずれかを実行できます:

--registry フラグを使用します。

npm adduser --registry http://localhost:4873

または、グローバルまたは特定のプロジェクト内でこのレジストリを指すように .npmrc を設定します。

npm publish --registry http://localhost:4873

2. GitHub パッケージの使用

すでにコードを GitHub でホストしている場合は、GitHub パッケージ を使用すると、すべてを 1 つ屋根の下に保管できる便利な方法となります。

2.1 リポジトリの GitHub パッケージを有効にする

GitHub 上のリポジトリに移動します。
設定をクリックします。 パッケージ。
組織/アカウントで GitHub パッケージが有効になっていることを確認してください。

2.2 GitHub パッケージに対する認証

read:packages スコープと write:packages スコープを使用してパーソナルアクセストークン (PAT) を作成します。このトークンは、開発者設定 の GitHub 設定から生成できます。 個人アクセストークン.

トークンを .npmrc に追加します:

  npm install <package-name> --registry http://localhost:4873

YOUR_GITHUB_USERNAME を実際のユーザー名または GitHub 組織名に置き換えます。

2.3 GitHub パッケージへのパッケージの公開

GitHub ユーザー名または組織と一致するスコープで package.json を更新します。

  registry=http://localhost:4873

次に公開します:

//npm.pkg.github.com/:_authToken=YOUR_PERSONAL_ACCESS_TOKEN
@YOUR_GITHUB_USERNAME:registry=https://npm.pkg.github.com

2.4 GitHub パッケージからのインストール

.npmrc が GitHub パッケージを指していることを確認してから、次のようにします。

{
  "name": "@YOUR_GITHUB_USERNAME/my-private-package",
  "version": "1.0.0",
  "publishConfig": {
    "registry": "https://npm.pkg.github.com"
  }
}

3. GitLab パッケージの使用

GitLab は、組み込みのパッケージレジストリも提供します。

3.1 GitLab パッケージレジストリのセットアップ

GitLab プロジェクトに移動します。
設定に移動します -> パッケージとレジストリ -> パッケージレジストリ。

3.2 .npmrcの設定

GitLab 認証情報を使用してローカル/グローバル .npmrc ファイルを作成または更新します。

npm publish

3.3 GitLab への公開

GitLab グループまたはユーザー名前空間と一致するように package.json スコープを更新します。

npm install @YOUR_GITHUB_USERNAME/my-private-package

次に公開します:

# Install Verdaccio globally
npm install --global verdaccio

3.4 GitLab パッケージからのインストール

verdaccio

4. Sonatype Nexus または JFrog Artifactory による自己ホスト

複数のリポジトリタイプをサポートする堅牢なオンプレミスソリューションをお探しの場合は、Sonatype Nexus または JFrog Artifactory が最適かもしれません。

4.1 Nexus リポジトリ

サーバーまたは開発マシンに Nexus Repository Manager をインストールします。
http://your-nexus-server:8081 で Nexus UI にログインします。
リポジトリ設定から新しいnpm (ホスト型)リポジトリを作成します。
認証を設定し (必要な場合)、URL をメモします。

同様の .npmrc セットアップを使用して、npm クライアントが新しい Nexus npm リポジトリを指すようにします。

storage: ./storage
auth:
  htpasswd:
    file: ./htpasswd
    max_users: 100

uplinks:
  npmjs:
    url: https://registry.npmjs.org/

packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs

  '**':
    access: $all
    publish: $authenticated
    proxy: npmjs

middlewares:
  audit:
    enabled: true

logs:
  - { type: stdout, format: pretty, level: http }

通常どおりパッケージを公開します:

npm adduser --registry http://localhost:4873

4.2 JFrog Artifactory

Artifactory をインストールして起動します。
Artifactory UI で、npm の ローカルリポジトリ を作成します。
同様に .npmrc を設定します。

npm publish --registry http://localhost:4873

次を使用して公開します:

  npm install <package-name> --registry http://localhost:4873

5.npmエンタープライズ

完全な制御、監査、高度なセキュリティを必要とする大規模組織の場合、npm Enterprise がオプションです。それは以下を提供します:

シングルサインオン (SSO) の統合。
強化されたセキュリティスキャン と監査。
きめ細かいアクセス制御。

セットアップ手順については、npm Enterprise のドキュメントを参照してください。

ベストプラクティスとヒント

スコープを使用する: プライベートパッケージ (@company/your-package) をスコープすると、パブリックパッケージと区別するのに役立ちます。
.npmrc 管理:
- 混乱を避けるために、プロジェクトごと .npmrc ファイルを使用してください。
- 資格情報をバージョン管理の対象外にします。
CI/CD による自動化: 一貫性を保つために、公開手順を CI/CD パイプラインに統合します。
プロキシのセットアップ: ほとんどの自己ホスト型レジストリはパブリック npm レジストリをプロキシできるため、共通の依存関係をインストールするためにレジストリを切り替える必要はありません。
監視と監査: レジストリ内のダウンロード、バージョン、アクティビティを追跡します。

結論

プライベート npm リポジトリをセットアップすると、独自のパッケージを安全に管理およびホストできるようになります。 Verdaccio のようなセルフホスト型ソリューションを使用している場合でも、GitHub パッケージや GitLab パッケージなどのマネージドソリューションを活用している場合でも、Nexus、Artifactory、npm Enterprise などのエンタープライズソリューションを選択している場合でも、基本は同じです。

レジストリを設定します。
認証を設定します。
パッケージを公開して使用します。

セキュリティ、スケーラビリティ、メンテナンスに関する組織の要件に最も適したアプローチを選択してください。上記の例とコードスニペットを使用すると、独自のプライベート npm パッケージのホストを開始するための強固な基盤が得られるはずです。コーディングを楽しんでください!

以上がプライベート npm リポジトリの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

json npm maven if switch for Directory Token using public private internal Namespace JS default this github git gitlab devops http ui everything Access Foundation

声明：

この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

前の記事：Vue 開発者のための JavaScript の基礎次の記事：Vue 開発者のための JavaScript の基礎

続きを見る