Dela via

Publicera från kommandoraden

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Du kan använda plattformsoberoende CLI för Azure DevOps (tfx-cli) för att publicera tillägget på Visual Studio Marketplace.

Mer information finns i översikten över publicera, installera och dela.

Förutsättningar

Hämta TFX CLI från Node Package Manager och generera en personlig åtkomsttoken (PAT). Om du inte redan har gjort det konfigurerar du dessutom en utgivare i galleriet.

Skaffa plattformsoberoende CLI för Azure DevOps

  1. Om du inte har den laddar du ned och installerar NodeJS. Under konfigurationen ser du till att du lämnar Lägg till i PATH valt.

  2. Öppna en kommandotolk och ange npm i -g tfx-cli.

Om du redan har INSTALLERAT TFX CLI kan du uppdatera till den senaste versionen genom att köra npm up -g tfx-cli.

Skapa en personlig åtkomsttoken

  1. Logga in på din organisation (https:dev.azure.com/{organization}).

  2. Öppna ikonen användarinställningar på startsidan och välj sedan Profil.

    Välj Profil när du har valt ikonen för användarinställningar

  3. Under Säkerhet väljer du Personliga åtkomsttoken och sedan Ny token.

    Skapa din nya personliga åtkomsttoken

  4. Fyll i formuläret:

    • Namnge din token
    • Välj Alla tillgängliga organisationer, vilket är det enda värde som fungerar vid publicering via CLI. Om du bara väljer en organisation resulterar det i ett fel, även om PAT är giltigt
    • Välj en tidsram för förfallotid för din token. Detta krävs eftersom Visual Studio Marketplace-publicerings-API:er fungerar utanför en organisations kontext
    • Ange åtkomstomfånget som är associerat med den här token. Se till att välja marketplace-omfånget (publicera). Det här omfånget begränsar token till att endast kunna publicera tillägg på Marketplace.
    • Välj Skapa

    ..

  5. Kopiera din genererade personliga åtkomsttoken. Se till att hålla det hemligt.

    Kopiera din token och behåll den som en hemlighet

Publicera från kommandoraden

När TFX CLI har installerats och du har din PAT kan du använda verktyget för att paketera och publicera tillägget.

  1. Öppna en kommandotolk till rotkatalogen för tillägget.
  2. Kör följande kommando för att publicera tillägget. När du uppmanas till det anger du din personliga åtkomsttoken för att autentisera.
tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

Du kan få följande fel om tillägget redan har publicerats:

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

Du kan lägga till --rev-version flaggan för att automatiskt öka korrigeringsversionen av tillägget. Detta sparar även den nya versionen i manifestet.

Kommentar

Alla tillgängliga alternativ för create är tillgängliga för publish kommandot.

Exempel

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