Menerbitkan dari baris perintah

Artikel
03/24/2025

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Anda dapat menggunakan CLI Lintas platform untuk Azure DevOps (tfx-cli) untuk menerbitkan ekstensi Anda ke Visual Studio Marketplace.

Untuk informasi selengkapnya, lihat gambaran umum menerbitkan, menginstal, dan berbagi.

Prasyarat

Dapatkan TFX CLI dari Node Package Manager dan hasilkan token Microsoft Entra atau token akses pribadi (PAT). Selain itu, jika Anda belum melakukannya, siapkan Publisher di Galeri.

Dapatkan CLI Lintas-Platform untuk Azure DevOps

Jika Anda tidak memilikinya, unduh dan instal NodeJS. Selama penyiapan, pastikan Anda meninggalkan Tambahkan ke PATH dipilih.
Buka Prompt Perintah dan masukkan npm i -g tfx-cli.

Jika Anda sudah menginstal TFX CLI, Anda dapat memperbarui ke rilis terbaru dengan menjalankan npm up -g tfx-cli.

Menerbitkan dengan token Microsoft Entra sebagai prinsipal layanan

Dimungkinkan juga untuk menerbitkan ekstensi sebagai prinsipal layanan .

Tambahkan perwakilan layanan sebagai anggota ke akun penerbit. Anda bisa mendapatkan ID perwakilan layanan dari profilnya menggunakan Profil - Dapatkan. Kemudian, Anda dapat menambahkan perwakilan layanan sebagai anggota ke penerbit menggunakan ID dari langkah sebelumnya.
Publikasikan ekstensi melalui TFX CLI menggunakan prinsipal layanan. Jalankan perintah TFX CLI berikut untuk menggunakan token aksesnya:

tfx extension publish --publisher my-publisher --vsix my-publisher.my-extension-1.0.0.vsix --auth-type pat -t <ENTRA_TOKEN>

Menerbitkan dengan token akses pribadi

Masuk ke organisasi Anda (https:dev.azure.com/{organization}).
Dari beranda Anda, buka ikon pengaturan pengguna, lalu pilih profil .
Di bawahKeamanan , pilih Token akses pribadi, lalu pilih Token Baru.
Lengkapi formulir:
- Beri nama token Anda
- Pilih Semua organisasi yang dapat diakses, yang merupakan satu-satunya nilai yang berfungsi saat menerbitkan melalui CLI. Jika Anda hanya memilih satu organisasi, itu menghasilkan kesalahan, meskipun PAT valid
- Pilih kerangka waktu kedaluwarsa untuk token Anda. Ini diperlukan karena API penerbitan Visual Studio Marketplace berfungsi di luar konteks organisasi
- Atur cakupan akses yang terkait dengan token ini. Pastikan untuk memilih cakupan Marketplace (publish). Cakupan ini membatasi token untuk hanya dapat menerbitkan ekstensi ke Marketplace.
- Pilih Buat
Salin token akses pribadi yang anda buat. Pastikan untuk merahasiakannya.

Setelah TFX CLI diinstal dan Anda memiliki token, Anda dapat menggunakan alat untuk mengemas dan menerbitkan ekstensi Anda.

Buka perintah ke direktori akar ekstensi Anda.
Jalankan perintah berikut untuk menerbitkan ekstensi Anda. Saat diminta, masukkan token Anda untuk mengautentikasi.

tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Potensi Kesalahan

Anda mungkin menerima kesalahan berikut jika ekstensi Anda telah diterbitkan:

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

Anda dapat menambahkan penanda --rev-version untuk secara otomatis meningkatkan patch versi dari ekstensi Anda. Ini juga menyimpan versi baru ke manifes Anda.

Nota

Semua opsi yang tersedia untuk create tersedia untuk perintah publish.

Contoh

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam

Bagikan melalui