Instalowanie rozszerzeń
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.
Zaloguj się do swojej organizacji (
https://dev.azure.com/{Your_Organization}
).Wybierz ikonę torby na zakupy, a następnie wybierz pozycję Przeglądaj witrynę Marketplace.
Znajdź rozszerzenie, które chcesz zainstalować, i wybierz pozycję Pobierz bezpłatnie.
Wybierz organizację z menu rozwijanego, a następnie wybierz pozycję Zainstaluj , aby zainstalować rozszerzenie.
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.
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
Zaloguj się do swojej organizacji (
https://dev.azure.com/{Your_Organization}
).Wybierz
ustawienia organizacji.
Wybierz pozycję Rozszerzenia, a następnie wybierz rozszerzenie, które chcesz odinstalować lub wyłączyć.
Wybierz pozycję Odinstaluj lub wybierz wielokropek (...), a następnie wybierz pozycję Wyłącz.
Aby odinstalować rozszerzenia w kolekcji, wykonaj następujące kroki:
Przejdź do lokalnego portalu zarządzania galerii (
http://{server}:8080/tfs/_gallery/manage
).W przypadku żądanego rozszerzenia wybierz wielokropek (...), a następnie wybierz pozycję Usuń.
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 poleceniagit 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 poleceniagit 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życiugit 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:
- 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.
- Upewnij się, że twój adres e-mail i katalog są poprawne.
- Zamknij wszystkie otwarte okna w przeglądarce.
- Otwórz prywatną lub incognito sesję przeglądania.
- 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.
- Na pasku narzędzi organizacji wybierz pozycję Użytkownicy.
- Przejdź do okienka rozszerzenia.
- 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.
- Na pasku narzędzi organizacji przejdź do pozycji Użytkownicy.
- Przejdź do okienka rozszerzenia.
- 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.
- 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. - Po lewej stronie profilu upewnij się, że twój adres e-mail i katalog są poprawne.
- Zamknij wszystkie otwarte okna w przeglądarce.
- Otwórz prywatną lub incognito sesję przeglądania.
- 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. - 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ć