Dela via

Publicera från kommandoraden

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

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 Microsoft Entra-token eller en personlig åtkomsttoken (PAT). Om du inte redan har gjort det, konfigurera 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.

Publicera med en Microsoft Entra-token som tjänstens huvudnamn

Det går också att publicera ett tillägg som tjänstens huvudnamn.

  1. Lägg till tjänstens huvudnamn som medlem i ett utgivarkonto. Du kan hämta tjänstehuvudmannens ID via REST-API:et genom att logga in via az cli och utföra en fråga på tjänstehuvudmannens profil. Detta kan göras med följande kommandon:
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

Sedan kan du lägga till service principal som medlem i utgivaren med hjälp av ID:t från föregående steg.

  1. Publicera ett tillägg via TFX CLI med hjälp av ett tjänsthuvudkonto. Kör följande TFX CLI-kommando för att använda dess åtkomsttoken:
tfx extension publish --publisher my-publisher --vsix my-publisher.my-extension-1.0.0.vsix --auth-type pat -t <ENTRA_TOKEN>

Publicera med 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

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

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

Potentiella fel

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.

Anmärkning

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