Udostępnij za pośrednictwem

Instalowanie rozszerzeń

  • Artykuł

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

Instalowanie, przypisywanie, wyłączanie i odinstalowywanie rozszerzeń, które dodają nowe funkcje i możliwości usługi Azure DevOps.

Aby uzyskać więcej informacji na temat rozszerzeń, zobacz omówienie tworzenia i publikowania .

Wymagania wstępne

Kategoria Wymagania
uprawnienia Członek grupy Administratorzy kolekcji projektów. Właściciele organizacji są automatycznie członkami tej grupy. Jeśli nie masz uprawnień, możesz zażądać rozszerzeń lub odszukać administratora kolekcji projektów.
udostępnianie rozszerzeń Rozszerzenia prywatne udostępnione twojej organizacji.
Kategoria Wymagania
uprawnienia Członek grupy Administratorzy kolekcji projektów lub posiada uprawnienia do edytowania informacji na poziomie kolekcji. Właściciele organizacji są automatycznie członkami tej grupy. Jeśli nie masz uprawnień, możesz zażądać rozszerzeń lub odszukać administratora kolekcji projektów.
udostępnianie rozszerzeń Rozszerzenia prywatne udostępnione twojej organizacji.

Uwaga

Aby użyć istniejącej subskrypcji platformy Azure do rozliczeń, mają co najmniej uprawnienia współadministratora dla tej subskrypcji. Jeśli nie masz uprawnień, administrator konta platformy Azure lub administrator usługi może dodać Cię jako współadministratora do subskrypcji platformy Azure w witrynie Azure Portal.

Kolekcja projektów ponownie wykorzystuje Twoją subskrypcję platformy Azure na potrzeby przyszłych zakupów w witrynie Marketplace. Gdzie można znaleźć więcej informacji na temat rozliczeń platformy Azure?

Instalowanie rozszerzenia

Zainstaluj rozszerzenie w organizacji, wykonując następujące kroki.

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

  2. Wybierz ikonę torby na zakupy, a następnie wybierz pozycję Przeglądaj witrynę Marketplace.

    Zrzut ekranu przedstawiający wyróżnioną ikonę torby na zakupy i wybór przycisku Przeglądaj w witrynie Marketplace.

  3. Znajdź rozszerzenie, które chcesz zainstalować, i wybierz pozycję Pobierz bezpłatnie.

    Zrzut ekranu przedstawiający czerwone kwadraty z wyróżnionym przyciskiem Pobierz bezpłatnie.

  4. Wybierz organizację z menu rozwijanego, a następnie wybierz pozycję Zainstaluj , aby zainstalować rozszerzenie.

    Wybierz organizację dla tego rozszerzenia

Rozszerzenie jest teraz zainstalowane! Teraz możesz przejść do swojej organizacji, aby użyć rozszerzenia. Poinformuj również zespół o tym rozszerzeniu, aby mógł zacząć korzystać z jego możliwości.

Zainstalowane rozszerzenie

Rozszerzenia wysokiego ryzyka

Niektóre rozszerzenia są oznaczone jako wysokiego ryzyka. Aby uzyskać więcej informacji i poznać powody tej klasyfikacji, zobacz rozszerzenia wysokiego ryzyka.

Odinstalowywanie lub wyłączanie rozszerzenia

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

  2. Wybierz ikonę koła zębategoustawienia organizacji.

    Zrzut ekranu przedstawiający ustawienia Open Organization.

  3. Wybierz pozycję Rozszerzenia, a następnie wybierz rozszerzenie, które chcesz odinstalować lub wyłączyć.

    Zrzut ekranu przedstawiający opcję Select uninstall or disable for extension (Wybierz odinstalowywanie lub wyłączanie rozszerzenia).

  4. Wybierz pozycję Odinstaluj lub wybierz wielokropek (...), a następnie wybierz pozycję Wyłącz.

    Zrzut ekranu przedstawiający akcje wyłączania lub odinstalowywania rozszerzeń.

Aby odinstalować rozszerzenia w kolekcji, wykonaj następujące kroki:

  1. Przejdź do lokalnego portalu zarządzania galerii (http://{server}:8080/tfs/_gallery/manage).

  2. W przypadku żądanego rozszerzenia wybierz wielokropek (...), a następnie wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający akcję Usuń rozszerzenie.

Włączanie rozszerzeń lub wyświetlanie listy za pośrednictwem wiersza polecenia

Włącz rozszerzenie poleceniem az devops extension enable. Aby rozpocząć, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parametry — włączanie rozszerzenia

  • extension-name: nazwa rozszerzenia, które ma być włączone.
  • publisher-name: nazwa wydawcy rozszerzenia.
  • org: Adres URL organizacji usługi Azure DevOps. Skonfiguruj domyślną organizację za pomocą polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli wartość domyślna nie jest skonfigurowana lub została wybrana przy użyciu polecenia git config. Przykład: --org https://dev.azure.com/MyOrganizationName/.

Przykład — włączanie rozszerzenia

Następujące polecenie włącza rozszerzenie Timetracker i wyświetla wynik w formacie tabeli.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Lista rozszerzeń

Możesz wyświetlić listę rozszerzeń zainstalowanych w organizacji za pomocą polecenia az devops extension list . Aby rozpocząć, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Parametry opcjonalne — rozszerzenia listy

  • include-built-in: uwzględnij wbudowane rozszerzenia. Akceptowane wartości to true (wartość domyślna) i false.
  • include-disabled: uwzględnij wyłączone rozszerzenia. Akceptowane wartości to true (wartość domyślna) i false.
  • org: Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli wartość domyślna nie jest skonfigurowana lub została wybrana przy użyciu polecenia git config. Przykład: --org https://dev.azure.com/MyOrganizationName/.

Przykład — rozszerzenia listy

Następujące polecenie wyświetla listę rozszerzeń w organizacji. Wyklucza wyłączone i wbudowane rozszerzenia oraz pokazuje wyniki w formacie tabeli.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Lista informacji dotyczących rozszerzeń

Możesz wyświetlić szczegółowe informacje o rozszerzeniu za pomocą polecenia az devops extension show. Aby rozpocząć, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parametry — informacje o rozszerzeniu listy

  • extension-name: nazwa rozszerzenia.
  • publisher-name: nazwa wydawcy rozszerzenia.
  • org: Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie skonfigurowano jako domyślne albo nie zostało wybrane przy użyciu git config. Przykład: --org https://dev.azure.com/MyOrganizationName/.

Przykład — informacje o rozszerzeniu listy

Poniższe polecenie pokazuje informacje o rozszerzeniu Timetracker w formie tabeli.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Rozwiązywanie problemów z instalacją rozszerzenia

Aby rozwiązać typowe problemy, wykonaj następujące kroki rozwiązywania problemów:

  • Nie można zainstalować rozszerzenia :

    • Sprawdź uprawnienia: Aby zainstalować rozszerzenia, upewnij się, że jesteś administratorem kolekcji projektów lub masz niezbędne uprawnienia przyznane przez administratora.
    • Sprawdź zgodność rozszerzenia: Upewnij się, że rozszerzenie jest zgodne z twoją wersją usługi Azure DevOps. Sprawdź stronę szczegółów rozszerzenia, aby uzyskać informacje o zgodności.
    • Problemy z siecią: Sprawdź, czy połączenie sieciowe jest stabilne i czy nie ma żadnych ustawień zapory ani serwera proxy blokujących proces instalacji.

  • rozszerzenie ulega awarii lub powoduje błędy:

    • Zbieranie informacji diagnostycznych: Jeśli rozszerzenie ulega awarii lub powoduje błędy, zbierz informacje diagnostyczne, aby pomóc w zidentyfikowaniu problemu. Te informacje obejmują komunikaty o błędach, dzienniki i zrzuty ekranu problemu.
    • Sprawdź dzienniki rozszerzeń: Niektóre rozszerzenia udostępniają dzienniki, które mogą pomóc w diagnozowaniu problemów. Zapoznaj się z dokumentacją rozszerzenia, aby uzyskać informacje na temat uzyskiwania dostępu do tych dzienników i interpretowania ich.
    • Skontaktuj się z pomocą techniczną: Jeśli nie możesz rozwiązać problemu, skontaktuj się z zespołem pomocy technicznej rozszerzenia, aby uzyskać zebrane informacje diagnostyczne. Podaj jak najwięcej szczegółów, aby pomóc im rozwiązać problem.

  • rozszerzenie nie jest widoczne po instalacji:

    • Odśwież stronę: Czasami rozszerzenie może nie pojawić się natychmiast po instalacji.
    • Sprawdź uprawnienia: Upewnij się, że masz uprawnienia niezbędne do wyświetlania i używania rozszerzenia. Niektóre rozszerzenia mogą wymagać określonych uprawnień, aby były widoczne.
    • zainstaluj ponownie rozszerzenie: Jeśli rozszerzenie nadal nie jest widoczne, spróbuj odinstalować i ponownie zainstalować rozszerzenie.

Często zadawane pytania (FAQ)

.: Dlaczego moja organizacja nie jest widoczna na stronie instalacji witryny Marketplace?

1: Jeśli nie widzisz swojej organizacji podczas zakupu w witrynie Azure DevOps Marketplace, spróbuj wykonać następujące czynności:

  1. Sprawdź tożsamość używaną do logowania się do witryny Visual Studio Marketplace. W prawym górnym rogu wybierz swoją nazwę użytkownika, aby wyświetlić swój profil.
  2. Upewnij się, że twój adres e-mail i katalog są poprawne.
  3. Zamknij wszystkie otwarte okna w przeglądarce.
  4. Otwórz prywatną lub incognito sesję przeglądania.
  5. Zaloguj się do witryny Visual Studio Marketplace. Użyj tożsamości użytkownika w żądanej organizacji.

Napiwek

Usługa Azure DevOps może poprosić Cię o wybranie między "kontem służbowym" lub "kontem osobistym". Jeśli tak, użyto adresu e-mail, który jest taki sam dla konta Microsoft i "konta służbowego", którym zarządza Organizacja w usłudze Microsoft Entra ID. Mimo że te tożsamości mają ten sam adres e-mail, nadal są oddzielnymi tożsamościami z różnymi profilami, ustawieniami zabezpieczeń i uprawnieniami. Wybierz tożsamość użytkownika w organizacji, którą chcesz wybrać.

.: Dlaczego nie mogę zainstalować rozszerzenia?

1: Nie można zainstalować rozszerzeń z jednego z następujących powodów.

  • Być członkiem grupy Administratorów Kolekcji Projektów lub właścicielem organizacji . Jeśli nie masz uprawnień, ale jesteś członkiem projektu, możesz zażądać rozszerzeń .
  • W przypadku błędu "już zainstalowany lub zamówiony", skontaktuj się z administratorem kolekcji projektów i poproś go o przypisanie Ci tego rozszerzenia.

.: Dlaczego użytkownicy nie mogą uzyskiwać dostępu do funkcji rozszerzenia?

1: Użytkownicy nie mogą uzyskać dostępu do rozszerzenia z jednego z następujących powodów.

  • Większość rozszerzeń wymaga, aby użytkownicy mieli co najmniej dostęp podstawowy, a nie dostęp Stakeholder. Można na przykład zainstalować bezpłatne rozszerzenie wyszukiwania kodu, ale każdy użytkownik musi mieć co najmniej podstawowy dostęp do wyszukiwania kodu. Aby pomóc zespołowi poprawić jakość aplikacji, możesz zainstalować bezpłatne rozszerzenie Test & Feedback. Możesz korzystać z różnych możliwości na podstawie poziomu dostępu oraz tego, czy pracujesz w trybie offline, czy nawiązasz połączenie z usługą Azure DevOps Services, czy lokalnym serwerem Azure DevOps Server. Aby uzyskać więcej informacji, zobacz opis rozszerzenia na karcie Visual Studio Marketplace, Azure DevOps.

  • Jeśli korzystasz z organizacji i rozpocząłeś bezpłatną wersję próbną rozszerzenia, Twoja wersja próbna mogła wygasnąć. Sprawdź, czy wersja próbna wygasła.

    1. Na pasku narzędzi organizacji wybierz pozycję Użytkownicy.
    2. Przejdź do okienka rozszerzenia.
    3. Sprawdź komunikat o wygaśnięciu, aby sprawdzić, czy lub kiedy rozszerzenie wygasło.

  • Jeśli używasz organizacji i zapłaciłeś za to rozszerzenie, upewnij się, że przypisałeś je użytkownikom.

    1. Na pasku narzędzi organizacji przejdź do pozycji Użytkownicy.
    2. Przejdź do okienka rozszerzenia.
    3. Sprawdź, czy rozszerzenie jest przypisane do użytkownika. Jeśli tak nie jest, przypisz rozszerzenie do użytkownika.

Aby uzyskać więcej informacji, zobacz Przypisywanie rozszerzeń do użytkowników.

Co się stało z moim rozszerzeniem podglądowym?

1: Rozszerzenie może nie być dostępne w wersji zapoznawczej. Po okresie obowiązywania wersji zapoznawczej dłuższe rozszerzenie jest zazwyczaj dostępne jako płatne rozszerzenie. Może być zaoferowany okres karencji, zanim trzeba będzie kupić rozszerzenie. Wszystkie rozszerzenia w wersji zapoznawczej są automatycznie konwertowane na bezpłatną wersję próbną przed zakupem rozszerzenia.

.: Dlaczego nie mogę zainstalować rozszerzeń dla usługi Azure DevOps Server?

1: Nie można zainstalować rozszerzeń dla usługi Azure DevOps Server z jednego z następujących powodów:

  • Być członkiem grupy administratorów kolekcji projektów projektu lub mieć uprawnienie do edytowania informacji na poziomie kolekcji ustawione na Zezwalaj w kolekcji projektów, w której chcesz zainstalować rozszerzenia. Jeśli nie masz uprawnień, możesz zamiast tego poprosić o rozszerzenia.
  • Może wystąpić błąd, który mówi, że rozszerzenie jest już zainstalowane lub złożono wniosek o jego instalację. Jeśli tak, skontaktuj się z członkiem grupy Administratorów kolekcji projektów i poproś go o przypisanie Ci rozszerzenia. Aby uzyskać więcej informacji, zobacz Żądanie zwiększenia poziomów uprawnień.

Dlaczego nie widzę kolekcji projektów, której chcę (w środowisku lokalnym)?

Bądź członkiem swojej kolekcji projektów. Wykonaj następujące kroki, aby sprawdzić tożsamość, której używasz do logowania się w witrynie Marketplace.

  1. Na stronie głównej portalu internetowego usługi Azure DevOps Server (https://{server}:8080/tfs/) przejdź do prawego górnego rogu strony i wybierz swoją nazwę użytkownika, aby wyświetlić swój profil.
  2. Po lewej stronie profilu upewnij się, że twój adres e-mail i katalog są poprawne.
  3. Zamknij wszystkie otwarte okna w przeglądarce.
  4. Otwórz prywatną lub incognito sesję przeglądania.
  5. Zaloguj się do strony głównej usługi Azure DevOps Server (https://{server}:8080/tfs/) przy użyciu tożsamości użytkownika w kolekcji projektów, w której chcesz zainstalować rozszerzenie.
    Usługa Azure DevOps może poprosić Cię o wybranie między "organizacją służbową" lub "kontem osobistym". Ta wiadomość oznacza, że użyto adresu e-mail, który jest taki sam dla konta Microsoft i "konta służbowego" zarządzanego przez organizację w usłudze Microsoft Entra ID. Mimo że te tożsamości mają ten sam adres e-mail, nadal są oddzielnymi tożsamościami z różnymi profilami, ustawieniami zabezpieczeń i uprawnieniami. Wybierz tożsamość użytkownika w swojej kolekcji projektów.
  6. Z kolekcji projektów przejdź do sekcji Marketplace.

Dlaczego rozszerzenie, które chcę, nie pokazuje przycisku pobierania (w wersji lokalnej)?

1: Niektóre rozszerzenia działają tylko z usługą Azure DevOps Services z jednego z następujących powodów:

  • Rozszerzenie korzysta z funkcji usługi Azure DevOps, które nie zostały jeszcze wydane dla usługi Azure DevOps Server.
  • Manifest rozszerzenia wskazuje, że rozszerzenie jest dostępne tylko dla usług Azure DevOps Services (targets = Microsoft.Visualstudio.Services.Cloud).
  • Manifest rozszerzenia wskazuje, że rozszerzenie jest integracją (targets = Microsoft.Visualstudio.Services.Integration).

Dlaczego nie mogę przekazać rozszerzeń do usługi Azure DevOps Server?

Zostań członkiem grupy administratorów Team Foundation. Musisz również mieć uprawnienia do edytowania informacji na poziomie instancji dla serwera Azure DevOps Server, w którym chcesz przesłać rozszerzenia.

Następne kroki

Zarzadzanie uprawnieniami do rozszerzeń