Menyimpan paket Node.js di Artifact Registry
Panduan memulai ini menunjukkan cara menyiapkan repositori paket Node.js Artifact Registry pribadi dan mengupload paket ke dalamnya.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Artifact Registry.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Artifact Registry.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
- Instal PowerShell, jika Anda ingin terhubung ke repositori paket Node.js dari Windows.
Meluncurkan Cloud Shell
Dalam panduan memulai ini, Anda akan menggunakan Cloud Shell, yang merupakan lingkungan shell untuk mengelola resource yang dihosting di Google Cloud.
Cloud Shell dilengkapi dengan Google Cloud CLI. Gcloud CLI menyediakan antarmuka command line utama untuk Google Cloud.
Meluncurkan Cloud Shell:
Buka Konsol Google Cloud.
Di toolbar Konsol Google Cloud, klik Activate Cloud Shell:
Sesi Cloud Shell akan terbuka di dalam frame yang lebih rendah di konsol.
Anda menggunakan shell ini untuk menjalankan perintah gcloud
.
Membuat repositori paket Node.js
Buat repositori untuk artefak Node.js Anda.
Membuat repositori.
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Klik Create Repository.
Tentukan
quickstart-nodejs-repo
sebagai nama repositori.Pilih npm sebagai format dan Standard sebagai modenya.
Di bawah Jenis Lokasi, pilih Region dan kemudian pilih lokasi
us-central1
.Klik Create.
Repositori ditambahkan ke daftar repositori
gcloud
Jalankan perintah berikut untuk membuat repositori paket Node.js baru bernama
quickstart-nodejs-repo
di lokasius-central1
dengan deskripsi "Repositori Node.js".gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \ --location=us-central1 --description="Node.js package repository"
Jalankan perintah berikut untuk memverifikasi bahwa repositori Anda telah dibuat.
gcloud artifacts repositories list
Untuk mengetahui informasi selengkapnya tentang perintah Artifact Registry, jalankan perintah
gcloud artifacts
.Untuk menyederhanakan perintah
gcloud
, tetapkan repositori default kequickstart-nodejs-repo
dan lokasi default keus-central1
. Setelah nilai ditetapkan, Anda tidak perlu menentukannya dalam perintahgcloud
yang memerlukan repositori atau lokasi.Untuk menetapkan repositori, jalankan perintah:
gcloud config set artifacts/repository quickstart-nodejs-repo
Untuk menetapkan lokasi, jalankan perintah:
gcloud config set artifacts/location us-central1
Untuk mengetahui informasi lebih lanjut tentang perintah ini, baca dokumentasi gcloud config set.
Konfigurasi npm
Untuk mengupload dan mendownload paket, Anda harus mengonfigurasi project npm dengan setelan untuk mengautentikasi dengan repositori yang Anda buat. Untuk panduan memulai ini, Anda akan mengupload paket sederhana, lalu menginstalnya dalam paket kedua sebagai dependensi.
Download paket emoji-regex, paket sederhana yang menyediakan ekspresi reguler untuk mencocokkan semua simbol dan urutan emoji.
npm pack emoji-regex
Perintah ini akan mendownload arsip paket.
Ekstrak arsip ke direktori
emoji-regex
. Perintah berikut ditujukan untuk arsipemoji-regex
versi 10.1.0:mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
Buat paket npm kedua yang akan Anda gunakan untuk menginstal paket
emoji-regex
dari Artifact Registry. Untuk paket ini, gunakan perintahnpm init
untuk membuat paket dasar.mkdir npm-package2 cd npm-package2 npm init -y
Saat diminta, terima nilai default.
Konfigurasikan project
emoji-regex
dannpm-package2
untuk melakukan autentikasi dengan repositori Artifact Registry yang Anda buat.Jalankan perintah berikut. Perintah tersebut menampilkan setelan konfigurasi yang akan ditambahkan ke file konfigurasi npm Anda.
gcloud artifacts print-settings npm --scope=@quickstart
Cakupan
quickstart
dikaitkan dengan repositori Anda. Jika Anda menyertakan cakupan dalam perintah untuk memublikasikan atau menginstal paket, npm akan menggunakan repositori Anda. Jika Anda memublikasikan atau menginstal paket tanpa cakupan, repositori default yang dikonfigurasi Anda akan digunakan. Untuk informasi lebih lanjut, baca ringkasan Node.js.Output perintah
gcloud
terlihat seperti contoh berikut. PROJECT adalah project ID Google Cloud Anda.@quickstart:registry=https://us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/ //us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/:always-auth=true
Tambahkan setelan konfigurasi dari langkah sebelumnya ke file
.npmrc
project di setiap project npm. File di direktori yang sama dengan filepackage.json
.Untuk mempelajari file
.npmrc
lebih lanjut, lihat ringkasan Node.js.Setiap repositori paket Node.js Artifact Registry dikaitkan dengan
https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY
endpoint registry npm. Jika Anda membuat repositori paket Node.js Artifact Registry lain, npm akan berinteraksi dengan repositori tersebut sebagai registry terpisah dengan cakupannya sendiri.
Edit
package.json
di projectemoji-regex
dannpm-package2
.Pastikan nilai untuk
name
menyertakan cakupanquickstart
.- Untuk
emoji-regex
:
"name": "@quickstart/emoji-regex"
- Untuk
npm-package2
:
"name": "@quickstart/npm-package2"
- Untuk
Di bagian
scripts
, tambahkan skrip untuk google-artifactregistry-auth, library klien yang memperbarui kredensial untuk repositori Artifact Registry."scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }
Mengupload paket ke repositori
Muat ulang token akses untuk terhubung ke repositori.
npm run artifactregistry-login
Tambahkan paket Anda ke repositori. Anda dapat menggunakan perintah
npm
atauyarn
.npm publish
yarn publish
Melihat paket di repositori
Untuk memastikan bahwa paket Anda telah ditambahkan ke repositori:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Dalam daftar repositori, klik repositori
quickstart-nodejs-repo
.Halaman Packages mencantumkan paket dalam repositori.
Klik paket untuk melihat versi paket.
gcloud
Untuk menampilkan daftar gambar dalam repositori quickstart-nodejs-repo
default, jalankan perintah berikut:
gcloud artifacts packages list
Untuk melihat versi paket, jalankan perintah berikut:
gcloud artifacts versions list --package=PACKAGE
Dengan PACKAGE adalah ID paket.
Menginstal paket
Instal paket emoji-regex
dari repositori Artifact Registry Anda di npm-package2
.
Dalam direktori npm-package2
, jalankan perintah npm install
atau yarn add
:
npm install @quickstart/emoji-regex
yarn add @quickstart/emoji-regex
Perintah ini menginstal paket emoji-regex
dalam project npm-package2
.
Kode ini juga mengupdate package.json
untuk menetapkan emoji-regex
sebagai dependensi.
"dependencies": {
"@quickstart/emoji-regex": "^10.1.0"
}
Pembersihan
Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
Sebelum menghapus repositori, pastikan paket apa pun yang ingin Anda simpan tersedia di lokasi lain.
Untuk menghapus repositori:
Konsol
Buka halaman Repositories di Konsol Google Cloud.
Dalam daftar repositori, pilih repositori
quickstart-nodejs-repo
.Klik Delete.
gcloud
Untuk menghapus repositori
quickstart-nodejs-repo
, jalankan perintah berikut:gcloud artifacts repositories delete quickstart-nodejs-repo
Jika Anda ingin menghapus repositori default dan setelan lokasi yang Anda konfigurasikan untuk konfigurasi
gcloud
aktif, jalankan perintah berikut:gcloud config unset artifacts/repository gcloud config unset artifacts/location
Langkah selanjutnya
- Pelajari lebih lanjut cara mengonfigurasi autentikasi
- Pelajari cara mengelola repositori
- Pelajari cara mengelola paket
- Baca sumber daya kami tentang DevOps dan jelajahi program penelitian kami.