Publikowanie z wiersza polecenia

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Aby opublikować rozszerzenie w witrynie Visual Studio Marketplace, możesz użyć międzyplatformowego interfejsu wiersza polecenia dla usługi Azure DevOps (tfx-cli).

Aby uzyskać więcej informacji, zobacz omówienie publikowania , instalowania i udostępniania.

Wymagania wstępne

Pobierz interfejs wiersza polecenia TFX z witryny Node Menedżer pakietów i wygeneruj osobisty token dostępu (PAT). Ponadto jeśli jeszcze tego nie zrobiono, skonfiguruj program Publisher w galerii.

Uzyskiwanie międzyplatformowego interfejsu wiersza polecenia dla usługi Azure DevOps

1. Jeśli go nie masz, pobierz i zainstaluj środowisko NodeJS. Podczas konfigurowania upewnij się, że pozostaw wybraną opcję Dodaj do ścieżki .

2. Otwórz wiersz polecenia i wprowadź polecenie npm i -g tfx-cli.

Jeśli masz już zainstalowany interfejs wiersza polecenia TFX, możesz przeprowadzić aktualizację do najnowszej wersji, uruchamiając polecenie npm up -g tfx-cli.

Tworzenie osobistego tokenu dostępu

1. Zaloguj się do organizacji (https:dev.azure.com/{organization}).

2. Na stronie głównej otwórz ikonę ustawień użytkownika, a następnie wybierz pozycję Profil.

   

3. W obszarze Zabezpieczenia wybierz pozycję Osobiste tokeny dostępu, a następnie wybierz pozycję Nowy token.

   

4. Wypełnij formularz:

   • Nadaj tokenowi nazwę
   • Wybierz pozycję Wszystkie dostępne organizacje, która jest jedyną wartością, która działa podczas publikowania za pośrednictwem interfejsu wiersza polecenia. Jeśli wybierzesz tylko jedną organizację, wystąpi błąd, nawet jeśli token dostępu jest prawidłowy
   • Wybierz przedział czasu wygaśnięcia tokenu. Jest to wymagane, ponieważ interfejsy API publikowania witryny Marketplace programu Visual Studio działają poza kontekstem organizacji
   • Ustaw zakres dostępu skojarzony z tym tokenem. Pamiętaj, aby wybrać zakres Witryny Marketplace (publikowanie). Ten zakres ogranicza token tylko do możliwości publikowania rozszerzeń w witrynie Marketplace.
   • Wybierz pozycję Utwórz

   

5. Skopiuj wygenerowany osobisty token dostępu. Pamiętaj, aby zachować go w tajemnicy.

   

Publikowanie z wiersza polecenia

Po zainstalowaniu interfejsu wiersza polecenia TFX i utworzeniu własnego tokenu dostępu możesz użyć narzędzia do spakowania i publikowania rozszerzenia.

1. Otwórz wiersz polecenia do katalogu głównego rozszerzenia.
2. Uruchom następujące polecenie, aby opublikować rozszerzenie. Po wyświetleniu monitu wprowadź osobisty token dostępu w celu uwierzytelnienia.

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

Jeśli rozszerzenie zostało już opublikowane, może zostać wyświetlony następujący błąd:

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

Możesz dodać flagę, --rev-version aby automatycznie zwiększyć wersję poprawki rozszerzenia. Spowoduje to również zapisanie nowej wersji w manifeście.

Uwaga

Wszystkie dostępne create opcje są dostępne dla publish polecenia .

Przykład

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