Artifact Registry に Node.js パッケージを保存する
このクイックスタートでは、非公開の Artifact Registry Node.js パッケージ リポジトリを設定して、パッケージをアップロードする方法を説明します。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Enable the Artifact Registry API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
-
Enable the Artifact Registry API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Windows から Node.js パッケージ リポジトリに接続する場合は、PowerShell をインストールします。
Cloud Shell を起動する
このクイックスタートでは、Google Cloud でホストされているリソースを管理するためのシェル環境である Cloud Shell を使用します。
Cloud Shell には、Google Cloud CLI がプリインストールされています。gcloud CLI は、Google Cloud への主要なコマンドライン インターフェースを提供します
Cloud Shell を起動します。
Google Cloud Console に移動します。
Google Cloud コンソールのツールバーで、「Cloud Shell をアクティブにする」をクリックします:
コンソールの下部にあるフレーム内で Cloud Shell セッションが開きます。このシェルで gcloud
コマンドを実行します。
Node.js パッケージ リポジトリを作成する
Node.js アーティファクトのリポジトリを作成します。
リポジトリを作成します。
コンソール
Google Cloud コンソールで [リポジトリ] ページを開きます。
[リポジトリを作成] をクリックします。
リポジトリ名として
quickstart-nodejs-repo
を指定します。形式として npm を選択し、モードとして Standard を選択します。
[ロケーション タイプ] で、[リージョン] を選択し、ロケーション
us-central1
を選択します。[作成] をクリックします。
このリポジトリがリポジトリ リストに追加されます。
gcloud
次のコマンドを実行して、「Node.js リポジトリ」という説明の付いたロケーション
us-central1
にquickstart-nodejs-repo
という新しい Node.js パッケージ リポジトリを作成します。gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \ --location=us-central1 --description="Node.js package repository"
次のコマンドを実行して、リポジトリが作成されたことを確認します。
gcloud artifacts repositories list
Artifact Registry コマンドの詳細については、
gcloud artifacts
コマンドを実行してください。gcloud
コマンドを簡素化するには、デフォルトのリポジトリをquickstart-nodejs-repo
に、デフォルトのロケーションをus-central1
に設定します。値を設定した後は、リポジトリまたはロケーションを必要とするgcloud
コマンドでそれらを指定する必要はありません。リポジトリを設定するには、次のコマンドを実行します。
gcloud config set artifacts/repository quickstart-nodejs-repo
ロケーションを設定するには、次のコマンドを実行します。
gcloud config set artifacts/location us-central1
これらのコマンドの詳細については、gcloud config set のドキュメントをご覧ください。
npm を構成する
パッケージをアップロードしてダウンロードするには、作成したリポジトリで認証する設定を使用して npm プロジェクトを構成する必要があります。このクイックスタートでは、シンプルなパッケージをアップロードして、依存関係として 2 番目のパッケージにインストールします。
すべての絵文字記号とシーケンスに一致する正規表現を提供するシンプルなパッケージである emoji-regex パッケージをダウンロードします。
npm pack emoji-regex
このコマンドにより、パッケージのアーカイブがダウンロードされます。
アーカイブを
emoji-regex
ディレクトリに抽出します。次のコマンドは、emoji-regex
バージョン 10.1.0 のアーカイブ用です。mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
Artifact Registry から
emoji-regex
パッケージをインストールするために使用する 2 番目の npm パッケージを作成します。このパッケージの場合は、npm init
コマンドを使用して基本パッケージを作成します。mkdir npm-package2 cd npm-package2 npm init -y
プロンプトが表示されたら、デフォルト値を受け入れます。
作成した Artifact Registry リポジトリで認証するように、
emoji-regex
とnpm-package2
の両方のプロジェクトを構成します。以下のコマンドを実行します。このコマンドは、npm 構成ファイルに追加する構成設定を返します。
gcloud artifacts print-settings npm --scope=@quickstart
quickstart
スコープはリポジトリに関連付けられます。パッケージを公開またはインストールするコマンドにスコープを含めると、npm はリポジトリを使用します。スコープなしでパッケージを公開またはインストールする場合は、構成したデフォルト リポジトリが使用されます。詳しくは、Node.js の概要をご覧ください。gcloud
コマンドの出力は次のようになります。PROJECT は、Google Cloud プロジェクト ID です。@quickstart:registry=https://us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/ //us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/:always-auth=true
前のステップの構成設定を各 npm プロジェクトのプロジェクト
.npmrc
ファイルに追加します。package.json
ファイルと同じディレクトリにあるファイル。.npmrc
ファイルについて詳しくは、Node.js の概要をご覧ください。それぞれの Artifact Registry Node.js パッケージ リポジトリは、npm レジストリ エンドポイント
https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY
に関連付けられます。別の Artifact Registry Node.js パッケージ リポジトリを作成すると、npm は独自のスコープで個別のレジストリとしてリポジトリを操作します。
emoji-regex
とnpm-package2
の両方のプロジェクトでpackage.json
を編集します。name
の値にquickstart
スコープが含まれていることを確認します。emoji-regex
:
"name": "@quickstart/emoji-regex"
npm-package2
:
"name": "@quickstart/npm-package2"
scripts
に、Artifact Registry リポジトリの認証情報を更新するクライアント ライブラリである google-artifactregistry-auth のスクリプトを追加します。"scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }
パッケージをリポジトリにアップロードする
リポジトリに接続するためのアクセス トークンを更新します。
npm run artifactregistry-login
パッケージをリポジトリに追加します。
npm
コマンドまたはyarn
コマンドを使用できます。npm publish
yarn publish
リポジトリ内のパッケージを表示する
パッケージがリポジトリに追加されたことを確認するには:
コンソール
Google Cloud コンソールで [リポジトリ] ページを開きます。
リポジトリ リストで、
quickstart-nodejs-repo
リポジトリをクリックします。[パッケージ] ページには、リポジトリ内のパッケージが一覧表示されます。
パッケージをクリックしてパッケージ バージョンを表示します。
gcloud
デフォルトの quickstart-nodejs-repo
リポジトリ内のイメージを一覧表示するには、次のコマンドを実行します。
gcloud artifacts packages list
パッケージのバージョンを表示するには、次のコマンドを実行します。
gcloud artifacts versions list --package=PACKAGE
PACKAGE はパッケージ ID です。
パッケージのインストール
npm-package2
の Artifact Registry リポジトリから emoji-regex
パッケージをインストールします。
npm-package2
ディレクトリで、次の npm install
コマンドまたは yarn add
コマンドを実行します。
npm install @quickstart/emoji-regex
yarn add @quickstart/emoji-regex
このコマンドにより、npm-package2
プロジェクトに emoji-regex
パッケージがインストールされます。また、package.json
を更新して、emoji-regex
を依存関係として設定します。
"dependencies": {
"@quickstart/emoji-regex": "^10.1.0"
}
クリーンアップ
このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。
リポジトリを削除する前に、保持する必要があるパッケージが別の場所で使用可能であることを確認してください。
リポジトリを削除するには、次の手順を行います。
コンソール
Google Cloud コンソールで [リポジトリ] ページを開きます。
リポジトリ リストで、
quickstart-nodejs-repo
リポジトリを選択します。[削除] をクリックします。
gcloud
quickstart-nodejs-repo
リポジトリを削除するには、次のコマンドを実行します。gcloud artifacts repositories delete quickstart-nodejs-repo
アクティブな
gcloud
構成のデフォルトのリポジトリとロケーション設定を削除するには、次のコマンドを実行します。gcloud config unset artifacts/repository gcloud config unset artifacts/location
次のステップ
- 認証の構成の詳細を確認する
- リポジトリの管理について確認する
- パッケージの管理について確認する
- DevOps に関するリソースを読む。また、研究プログラムについて確認する。