Npm@1 - tugas npm v1

Gunakan tugas ini untuk menginstal dan menerbitkan paket npm atau untuk menjalankan perintah npm. Mendukung npmjs.com dan registri terautentikasi seperti Azure Artifacts.

Nota

Untuk mengautentikasi dengan umpan Azure Artifacts, gunakan tugas Autentikasi npm . Tugas Npm@1 ini tidak lagi dalam pengembangan aktif, hanya bug penting yang ditangani.

Sintaksis

# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Azure Artifacts.
- task: Npm@1
  inputs:
    command: 'install' # 'ci' | 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder that contains package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = ci || command = publish. Verbose logging. 
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && publishRegistry = useFeed. Publish pipeline metadata. Default: true.
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = ci || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when (command = install || command = ci || command = custom) && customRegistry = useFeed. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when (command = install || command = ci || command = custom) && customRegistry = useNpmrc. Credentials for registries outside this organization/collection. 
  # Destination registry and authentication
    #publishRegistry: 'useExternalRegistry' # 'useExternalRegistry' | 'useFeed'. Optional. Use when command = publish. Registry location. Default: useExternalRegistry.
    #publishFeed: # string. Required when publishRegistry = useFeed && command = publish. Target registry. 
    #publishEndpoint: # string. Required when publishRegistry = useExternalRegistry && command = publish. External Registry.

Masukan

Perintah
string. Dibutuhkan. Nilai yang diizinkan: ci, install, publish, custom. Nilai default: install.

Menentukan perintah dan argumen, yang diteruskan ke npm untuk eksekusi.

Jika argumen Anda berisi tanda kutip ganda ("), keluarkan dengan garis miring (\), dan kelilingi string yang diloloskan dengan tanda kutip ganda (").

Secara default, paket diinstal secara lokal. Untuk menginstal paket secara global, tentukan install -g sebagai perintah . Untuk informasi selengkapnya, lihat Mengunduh dan menginstal paket secara global dan Mengunduh dan menginstal paket secara lokal.

workingDir - Folder kerja yang berisi package.json
string.

Menentukan jalur ke folder yang berisi package.json target dan file .npmrc. Pilih folder , bukan file . Contoh: /packages/mypackage.

verbose - pengelogan Verbose
boolean. Fakultatif. Gunakan saat command = install || command = ci || command = publish.

Mencetak informasi lebih lanjut ke konsol saat tugas berjalan.

Perintah dan argumen
string. Diperlukan saat command = custom.

Menjalankan perintah kustom. Contoh: dist-tag ls mypackage.

customRegistry - Registri untuk menggunakan
string. Fakultatif. Gunakan saat command = install || command = ci || command = custom. Nilai yang diizinkan: useNpmrc (Registri di .npmrc saya), useFeed (Registri yang saya pilih di sini). Nilai default: useNpmrc.

Menentukan registri yang akan digunakan. Terapkan file .npmrc ke repositori kode sumber Anda dan atur jalurnya sebagai nilai, atau tentukan registri dari Azure Artifacts sebagai nilainya.

customFeed - Menggunakan paket dari registri Azure Artifacts/TFS ini
string. Diperlukan saat (command = install || command = ci || command = custom) && customRegistry = useFeed.

Menyertakan umpan yang dipilih dalam .npmrcyang dihasilkan. Untuk umpan cakupan proyek, gunakan ProjectName/FeedName atau ProjectID/FeedID. Untuk umpan yang dilingkup organisasi, nilainya harus berupa nama umpan.

customEndpoint - Kredensial untuk registri di luar organisasi/kumpulan ini
string. Fakultatif. Gunakan saat (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Kredensial yang digunakan untuk registri eksternal yang terletak di .npmrcproyek . Biarkan ini kosong untuk registri di akun/koleksi ini; tugas menggunakan kredensial build secara otomatis.

lokasi publishRegistry - Registri
string. Fakultatif. Gunakan saat command = publish. Nilai yang diizinkan: useExternalRegistry (Registri npm eksternal (termasuk akun/koleksi lain)), useFeed (Registri yang saya pilih di sini). Nilai default: useExternalRegistry.

Menentukan registri yang akan ditargetkan perintah.

Registri target publishFeed -
string. Diperlukan saat publishRegistry = useFeed && command = publish.

Menentukan registri yang dihosting di akun. Anda harus menginstal Manajemen Paket dan berlisensi untuk memilih registri di sini.

publishPackageMetadata - Menerbitkan metadata alur
boolean. Fakultatif. Gunakan saat command = publish && publishRegistry = useFeed. Nilai default: true.

Mengaitkan metadata alur build/rilis (informasi kode eksekusi # dan sumber) dengan paket.

publishEndpoint - External Registry
string. Diperlukan saat publishRegistry = useExternalRegistry && command = publish.

Menentukan kredensial yang akan digunakan untuk penerbitan ke registri eksternal.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Komentar

Nota

Project Collection Build Service dan identitas Build Service proyek Anda harus diatur ke Kontributor untuk menerbitkan paket Anda ke umpan menggunakan Azure Pipelines. Lihat Menambahkan pengguna/grup baru untuk detail selengkapnya.

Di mana saya dapat mempelajari selengkapnya tentang perintah npm yang tercantum?

• npm ci

• penginstalan npm

• Publikasikan npm

Contoh

• Menggunakan tugas JavaScript

• Membuat dan menerbitkan paket Node.js

• Menyebarkan aplikasi ke VM Linux

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan berikut menuntut untuk menjalankan pekerjaan yang menggunakan tugas ini: npm
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah	Apapun
variabel yang Dapat Diatur	Apapun
Versi agen	2.115.0 atau lebih tinggi
Kategori tugas	Paket