Komut satırından Azure DevOps uzantısı yayımlama

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Uzantınızı Visual Studio Market'te yayımlamak üzere Azure DevOps için Platformlar Arası CLI'yı (tfx-cli) kullanın. Daha fazla bilgi için bkz. Yayımlama, yükleme ve paylaşmaya genel bakış.

Önkoşullar

Kategori Gereksinimler
Tools Azure DevOps (tfx-cli) için platformlar arası CLI (komut satırı arayüzü) npm aracılığıyla yüklendi
Kimlik Doğrulaması Microsoft Entra belirteci (önerilir) veya kişisel erişim belirteci (PAT) ile Marketplace (yayınlama) kapsamı
Publisher Visual Studio Market'te ayarlanmış bir publisher hesabı

Önemli

Daha yüksek riskli personal erişim belirteçleri üzerinde daha güvenli Microsoft Entra belirteçleri kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . PAT kullanımını azaltma. İhtiyaçlarınıza uygun kimlik doğrulama mekanizmasını seçmek için kimlik doğrulama kılavuzunu gözden geçirin.

tfx-cli aracını edinin

  1. Sahip değilseniz NodeJSindirip yükleyin. Kurulum sırasında Add to PATH seçili olduğundan emin olun.

  2. Bir Komut İstemi açın ve npm i -g tfx-cligirin.

TFX CLI zaten yüklüyse, npm up -g tfx-cliçalıştırarak en son sürüme güncelleştirebilirsiniz.

tfx-cli yükleme

npm install -g tfx-cli

Microsoft Entra belirteci ile yayınlamak

Uzantıyı hizmet sorumlusu olarak yayımlayabilirsiniz.

  1. Hizmet sorumlusunu yayımcı hesabına üye olarak ekleyin. Azure CLI oturum açıp hizmet sorumlusunun profilini sorgulayarak REST API aracılığıyla hizmet sorumlusunun kimliğini alın:
az login --service-principal --username <appId> --password <password> --tenant <tenant-id>
# 499b84ac-1321-427f-aa17-267ca6975798 specifies azure devops as a resource
az rest -u https://app.vssps.visualstudio.com/_apis/profile/profiles/me --resource 499b84ac-1321-427f-aa17-267ca6975798

Ardından, hizmet sorumlusunu yayımcıya üye olarak eklemek için önceki adımdaki kimliği kullanın.

  1. Hizmet ilkesi kullanarak TFX CLI aracılığıyla uzantı yayımlama. Erişim belirtecini kullanmak için aşağıdaki TFX CLI komutunu çalıştırın:
tfx extension publish --publisher my-publisher --vsix my-publisher.my-extension-1.0.0.vsix --auth-type pat -t <ENTRA_TOKEN>

Kişisel erişim belirteci ile yayımlama

Marketplace (yayımlama) kapsamına sahip bir kişisel erişim belirteci (PAT) oluşturun.

tfx-cli'yi yükleyip PAT'nizi aldıktan sonra uzantınızı paketleyip yayımlayın.

  1. Uzantınızın kök dizinine bir komut istemi açın.
  2. Uzantınızı yayımlamak için aşağıdaki komutu çalıştırın. İstendiğinde, kimlik doğrulaması için belirtecinizi girin.
tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Olası hatalar

Uzantınız zaten yayımlanmışsa aşağıdaki hatayı alabilirsiniz:

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

Uzantınızın --rev-version sürümünü otomatik olarak artırmak için bayrağını ekleyin. Bu bayrak ayrıca yeni sürümü bildiriminize kaydeder.

Note

create için kullanılabilen tüm seçenekler publish komutu için kullanılabilir.

Örnek

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
  • Last updated on