npm の設定と使用

npm で を使用するには CodeCatalyst、パッケージリポジトリnpmに接続し、認証用の個人用アクセストークン (PAT) を提供する必要があります。パッケージリポジトリnpmへの接続手順は、 CodeCatalyst コンソールで確認できます。

目次

• での npm の設定 CodeCatalyst
• パッケージリポジトリからの npm CodeCatalyst パッケージのインストール
• npmjs から への npm パッケージのインストール CodeCatalyst
• パッケージリポジトリへの npm CodeCatalyst パッケージの発行
• npm コマンドサポート
  • パッケージリポジトリとやり取りするサポートされているコマンド
  • サポートされているクライアント側コマンド
  • サポートされていないコマンド

での npm の設定 CodeCatalyst

次の手順では、 CodeCatalyst パッケージリポジトリnpmを認証して接続する方法について説明します。npm の詳細については、npm の公式ドキュメント を参照してください。

CodeCatalyst パッケージリポジトリnpmに接続するには

1. https://codecatalyst.aws/ で CodeCatalyst コンソールを開きます。

2. プロジェクトに移動します。

3. ナビゲーションペインで、[Packages (パッケージ)] を選択します。

4. リストからパッケージリポジトリを選択します。

5. リポジトリに接続 を選択します。

6. 設定の詳細 で、パッケージマネージャークライアント で npm クライアント を選択します。

7. オペレーティングシステムを選択して、対応する設定ステップを表示します。

8. で npm を認証するには、個人用アクセストークン (PAT) が必要です CodeCatalyst。トークンが既にある場合は、それを使用できます。そうでない場合は、次のステップを使用して作成できます。

   1. （オプション): PAT名前と有効期限を更新します。

   2. トークンの作成 を選択します。

   3. をコピーしてPAT安全な場所に保存します。

      警告

      ダイアログボックスを閉じた後、 PATを再度表示またはコピーすることはできません。認証情報は、攻撃者が不正使用した後に認証情報を使用できる時間を最小限に抑えるために、有効期間を短くする必要があります。

9. プロジェクトのルートディレクトリから次のコマンドを実行して、パッケージリポジトリで npm を設定します。コマンドは以下を実行します。

   • プロジェクトにプロジェクトレベルの.npmrcファイルがない場合は、作成します。

   • パッケージリポジトリのエンドポイント情報をプロジェクトレベルの.npmrcファイルに追加します。

   • 認証情報 (PAT) をユーザーレベルの.npmrcファイルに追加します。

   次の値を置き換えます。

   注記

   コンソールの手順からコピーする場合、次のコマンドの値が更新され、変更する必要はありません。

   • 置換 username CodeCatalyst ユーザー名を入力します。

   • 置換 PAT を で使用します CodeCatalyst PAT。

   • 置換 space_name CodeCatalyst スペース名を入力します。

   • 置換 proj_name CodeCatalyst プロジェクト名を入力します。

   • 置換 repo_name CodeCatalyst パッケージリポジトリ名を入力します。

   npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project
   npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

   npm 6 以下の場合： npm が常に認証トークンを に渡すようにするには CodeCatalyst、GETリクエストに対しても、npm config set次のように always-auth 設定変数を に設定します。

   npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

パッケージリポジトリからの npm CodeCatalyst パッケージのインストール

「」の手順に従って npm をリポジトリに接続するとでの npm の設定 CodeCatalyst、リポジトリでnpmコマンドを実行できます。

npm install コマンドを使用して、パッケージリポジトリまたはそのアップストリームリポジトリの 1 つにある npm CodeCatalyst パッケージをインストールできます。

npm install lodash

npmjs から への npm パッケージのインストール CodeCatalyst

npmjs.com に接続するゲートウェイ CodeCatalyst リポジトリへのアップストリーム接続を使用してリポジトリを設定することで、リポジトリを介して npmjs.com から npm パッケージをインストールできますnpm-public-registry-gateway。npmjs からインストールされたパッケージは、ゲートウェイリポジトリと最も遠いダウンストリームパッケージリポジトリに取り込まれて保存されます。

npmjs からパッケージをインストールするには

1. まだ設定していない場合は、「」の手順に従ってパッケージリポジトリnpmで CodeCatalyst を設定しますでの npm の設定 CodeCatalyst。

2. リポジトリがゲートウェイリポジトリ をアップストリーム接続npm-public-registry-gatewayとして追加していることを確認します。「」の手順に従ってnpm-public-registry-gatewayリポジトリアップストリームリポジトリの追加を選択すると、追加またはアップストリームソースnpm-public-registry-gatewayとして追加するアップストリームソースを確認できます。

3. npm install コマンドを使用してパッケージをインストールします。

   npm install package_name

アップストリームリポジトリからのパッケージのリクエストの詳細については、「」を参照してくださいアップストリームリポジトリを持つパッケージバージョンのリクエスト。

パッケージリポジトリへの npm CodeCatalyst パッケージの発行

を完了したらでの npm の設定 CodeCatalyst、npmコマンドを実行できます。

npm publish コマンドを使用して、npm パッケージを CodeCatalyst パッケージリポジトリに発行できます。

npm publish

npm パッケージを作成する方法については、「npm Docs での Node.js モジュールの作成」を参照してください。

npm コマンドサポート

以下のセクションでは、サポートされていない特定のnpmコマンドを一覧表示するだけでなく、パッケージリポジトリで CodeCatalystサポートされているコマンドを要約します。

トピック

• パッケージリポジトリとやり取りするサポートされているコマンド
• サポートされているクライアント側コマンド
• サポートされていないコマンド

パッケージリポジトリとやり取りするサポートされているコマンド

このセクションでは、npmクライアントが設定されたレジストリに対して 1 つ以上のリクエストを行うnpmコマンドを一覧表示します (例: npm config set registry）。これらのコマンドは、 CodeCatalyst パッケージリポジトリに対して呼び出されたときに正しく機能することが検証されています。

コマンド	説明
bugs (バグ)	パッケージのバグトラッカー の場所を推測しURL、開こうとします。
ci (クリーンスレートインストール)	クリーンスレートでプロジェクトをインストールします。
deprecate (非推奨)	パッケージのバージョンを非推奨にします。
dist-tag (配布タグ)	パッケージ配布タグを変更します。
docs (ドキュメンテーション)	パッケージのドキュメント の場所を推測しURL、config --browser パラメータを使用してパッケージを開くようにします。
doctor (ドクター)	一連のチェックを実行して、npm インストールが JavaScript パッケージを管理できることを検証します。
install (インストール)	パッケージをインストールします。
install-ci-test	クリーンスレートでプロジェクトをインストールし、テストを実行します。エイリアス: npm cit このコマンドは を実行しnpm ci、その後に が続きますnpm test。
install-test (インストールテスト)	パッケージをインストールしてテストを実行します。を実行しnpm install、その後すぐに を実行しますnpm test。
outdated (旧式)	設定されたレジストリをチェックして、インストールされているパッケージが古くなっているかどうかを確認します。
ping (旧式)	設定または指定された npm レジストリに ping を実行し、認証を検証します。
publish (出力)	パッケージバージョンをレジストリに出力します。
update (アップデート)	パッケージのリポジトリ の場所を推測しURL、config --browser パラメータを使用してそのリポジトリ を開きようとします。
view (表示)	パッケージメタデータの表示 メタデータプロパティの印刷にも使用できます。

サポートされているクライアント側コマンド

これらのコマンドは、パッケージリポジトリと直接やり取りする必要がないため CodeCatalyst、それらをサポートするものは必要ありません。

コマンド	説明
bin (レガシー）	npm bin ディレクトリを表示します。
buid (構築)	パッケージを構築します。
cache (キャッシュ)	パッケージキャッシュを操作します。
completion (完成)	すべての npm コマンドでタブ補完を有効にします。
config (設定)	ユーザーとグローバル npmrc ファイルのコンテンツを更新します。
depute (代理)	ローカルパッケージツリーを検索し、依存関係をさらにツリー上に移動して、複数の依存パッケージでより効果的に共有できるようにすることで、構造を簡素化しようとします。
edit (編集)	インストールされたパッケージを編集します。現在の作業ディレクトリの依存関係を選択し、デフォルトのエディタでパッケージディレクトリを開きます。
explore (調査)	インストールされているパッケージを参照します。指定されたインストール済みパッケージの ディレクトリにサブシェルをスポーンします。コマンドが指定されている場合、そのコマンドはサブシェルで実行され、すぐにシャットダウンされます。
help (ヘルプ)	npm に関するヘルプを取得します。
help-search (ヘルプ検索)	npm ヘルプドキュメントを検索します。
init (初期)	package.json ファイルを作成します。
link (リンク)	パッケージディレクトリをシンボリックリンクします。
ls (リスト)	インストールされているパッケージを一覧表示します。
pack (パッケージ)	パッケージから tarball を作成します。
prefix (プレフィックス)	プレフィックスを表示します。も指定されていない限り、これはpackage.jsonファイルを含む最も近い親ディレクトリ-gです。
prune (削除)	親パッケージの依存関係リストに一覧表示されていないパッケージを削除します。
rebuild (再構築)	一致したフォルダに対して npm build コマンドを実行します。
restart (再起動)	パッケージの停止、再起動、開始スクリプト、および関連するプリスクリプトとポストスクリプトを実行します。
root (ルート)	有効なnode_modulesディレクトリを標準出力に出力します。
run-script (スクリプト実行)	任意のパッケージスクリプトを実行します。
shrinkwrap (収縮包装)	パブリケーションの依存関係バージョンをロックダウンします。
uninstall (アンインストール)	パッケージをアンインストールします。

サポートされていないコマンド

これらのnpmコマンドは CodeCatalyst パッケージリポジトリではサポートされていません。

コマンド	説明	メモ
access (アクセス)	公開パッケージのアクセスレベルを設定します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるアクセス許可モデルを使用します。
adduser	レジストリユーザーアカウントを追加します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるユーザーモデルを使用します。
audit (監査)	セキュリティ監査を実行します。	CodeCatalyst は現在、セキュリティ脆弱性データを提供していません。
hook (フック)	追加、削除、リスト、更新など、npm フックを管理します。	CodeCatalyst は現在、変更通知メカニズムをサポートしていません。
login (ログイン)	ユーザーを認証します。これは npm adduser のエイリアスです。	CodeCatalyst は、パブリック npmjs リポジトリとは異なる認証モデルを使用します。詳細については、「での npm の設定 CodeCatalyst」を参照してください。
logout (サインアウト)	レジストリからサインアウトします。	CodeCatalyst は、パブリック npmjs リポジトリとは異なる認証モデルを使用します。 CodeCatalyst リポジトリからサインアウトする方法はありませんが、認証トークンは設定可能な有効期限後に期限切れになります。デフォルトのトークンの期間は 12 時間です。
owner (オーナー)	パッケージの所有者を管理します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるアクセス許可モデルを使用します。
profile (プロファイル)	レジストリプロファイルの設定を変更します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるユーザーモデルを使用します。
search (検索)	検索語に一致するパッケージをレジストリで検索します。	CodeCatalyst は search コマンドをサポートしていません。
star (星)	お気に入りのパッケージをマークします。	CodeCatalyst は現在、お気に入りメカニズムをサポートしていません。
stars (星)	お気に入りとしてマークされたパッケージを表示します。	CodeCatalyst は現在、お気に入りメカニズムをサポートしていません。
team (チーム)	チームおよびチームメンバーシップを管理します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるユーザーおよびグループメンバーシップモデルを使用します。
token (トークン)	認証トークンを管理します。	CodeCatalyst は、認証トークンを取得するために別のモデルを使用します。詳細については、「での npm の設定 CodeCatalyst」を参照してください。
unpublished	レジストリからパッケージを削除します。	CodeCatalyst では、npm クライアントを使用したリポジトリからのパッケージバージョンの削除はサポートされていません。コンソールでパッケージを削除できます。
whoami (私は誰)	npm ユーザー名を表示します。	CodeCatalyst は、パブリック npmjs リポジトリとは異なるユーザーモデルを使用します。