Npm@1 - tugas npm v1

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

Catatan

Tugas autentikasi npm adalah cara yang disarankan untuk mengautentikasi dengan Artefak Azure. Tugas ini tidak lagi mengambil fitur baru dan hanya bug penting yang ditangani.

Sintaks

# 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 && command = install || command = ci || command = publish. 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 customRegistry = useFeed && command = install || command = ci || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = ci || command = custom. 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.

Input

command - Perintah
string. Wajib diisi. 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 escaped dengan tanda kutip ganda (").

workingDir - Folder kerja yang berisi package.json
string.

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

verbose - Pengelogan verbose
boolean. Opsional. Gunakan saat command = install || command = ci || command = publish.

Mencetak informasi lebih lanjut ke konsol saat tugas berjalan.

customCommand - Perintah dan argumen
string. Diperlukan saat command = custom.

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

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

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

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

Menyertakan umpan yang dipilih dalam yang dihasilkan .npmrc. 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/koleksi ini
string. Pilihan. Gunakan saat customRegistry = useNpmrc && command = install || command = ci || command = custom.

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

publishRegistry - Lokasi registri
string. Opsional. 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.

publishFeed - Registri target
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. Pilihan. Gunakan saat command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Nilai default: true.

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

publishEndpoint - Registri Eksternal
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 tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Catatan

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 perintah dan argumen npm?

• dokumen npm

Contoh

• Membangun aplikasi Node.js Anda dengan gulp

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 tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: npm
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.115.0 atau lebih tinggi
Kategori tugas	Paket