Поделиться через

Установка расширений

  • Статья

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

Установите, назначьте, отключите и удалите расширения, которые добавляют новые функции и возможности для Azure DevOps.

Дополнительные сведения о расширениях см. в обзоре разработки и публикации .

Предварительные условия

Категория Требования
Разрешения Член группы администраторов коллекции проектов. Владельцы организации автоматически входят в эту группу. Если у вас нет разрешений, вы можете запросить их или найти администратора коллекции проектов.
совместное использование расширений Расширения , доступные только вашей организации.
Категория Требования
Разрешения Член группы "Администраторы коллекции проектов" или разрешения на изменение информации на уровне коллекции. Владельцы организации автоматически входят в эту группу. Если у вас нет разрешений, вы можете запросить их или найти администратора коллекции проектов.
совместное использование расширений Расширения , доступные только вашей организации.

Примечание.

Чтобы использовать существующую подписку Azure для выставления счетов, вам необходимо иметь по крайней мере разрешения соадминистратора для этой подписки. Если у вас нет разрешений, администратор учетной записи Azure или администратор службы может добавить вас в качестве соадминистратора в подписку Azure на портале Azure.

Коллекция ваших проектов повторно использует вашу подписку Azure для совершения будущих покупок в Marketplace. Где можно найти дополнительные сведения о выставлении счетов в Azure?

Установка расширения

Установите расширение в организации, выполнив следующие действия.

  1. Войдите в свою организацию (https://dev.azure.com/{Your_Organization}).

  2. Щелкните значок сумки для покупок, затем выберите Обзор рынка.

    Снимок экрана: выделенный значок корзины и выбор кнопки

  3. Найдите расширение, которое вы хотите установить, и выберите " Получить его бесплатно".

    Снимок экрана: красная квадратная кнопка

  4. Выберите организацию в раскрывающемся меню, а затем выберите "Установить ", чтобы установить расширение.

    Выберите организацию для этого расширения

Теперь расширение установлено! Теперь вы можете отправиться в свою организацию, чтобы использовать расширение. Кроме того, сообщите вашей команде об этом расширении, чтобы они могли начать использовать свои возможности.

Установленное расширение

Расширения с высоким риском

Некоторые расширения помечены как высокий риск. Дополнительные сведения и сведения о причинах этой классификации см. в разделе расширения высокого риска.

Удаление или отключение расширения

  1. Войдите в свою организацию (https://dev.azure.com/{Your_Organization}).

  2. Выберите значок настроекПараметры организации.

    Снимок экрана: параметры Open Organization.

  3. Выберите расширения и выберите расширение, которое требуется удалить или отключить.

    Снимок экрана: выбор удаления или отключения расширения.

  4. Выберите "Удалить " или выберите многоточие (...), а затем нажмите кнопку "Отключить".

    Снимок экрана: действия по отключению или удалению расширений.

Чтобы удалить расширения в коллекции, выполните следующие действия.

  1. Перейдите на портал управления локальной коллекцией (http://{server}:8080/tfs/_gallery/manage).

  2. Для нужного расширения выберите многоточие (...), а затем нажмите кнопку "Удалить".

    Снимок экрана: действие

Включение или перечисление расширений с помощью командной строки

Включите расширение с помощью команды az devops extension enable . Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

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

Параметры — включение расширения

  • имя расширения: имя расширения для включения.
  • publisher-name: имя издателя расширения.
  • org: URL-адрес организации Azure DevOps. Настройте организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью git config. Пример: --org https://dev.azure.com/MyOrganizationName/.

Пример. Включение расширения

Следующая команда включает расширение Timetracker и показывает результат в формате таблицы.

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

Список расширений

Вы можете перечислить расширения, установленные в вашей организации, используя команду az devops extension list. Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

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

Необязательные параметры — расширения списка

  • include-built-in: Включите встроенные расширения. Допустимые значения: true (по умолчанию) и false.
  • include-disabled: включить отключенные расширения. Допустимые значения: true (по умолчанию) и false.
  • org: URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью git config. Пример: --org https://dev.azure.com/MyOrganizationName/.

Пример — расширения списка

В следующей команде перечислены все расширения в вашей организации. Он исключает отключенные и встроенные расширения и отображает результаты в формате таблицы.

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

Список сведений о расширении

Вы можете указать сведения о расширении с помощью команды az devops extension show . Сведения о начале работы см. в статье "Начало работы с Azure DevOps CLI".

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

Параметры — сведения о расширении списка

  • имя расширения: имя расширения.
  • publisher-name: имя издателя расширения.
  • org: URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено по умолчанию или выбрано с помощью git config. Пример: --org https://dev.azure.com/MyOrganizationName/.

Пример — сведения о расширении списка

Следующая команда содержит сведения о расширении Timetracker в формате таблицы.

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

Устранение неполадок при установке расширений

Чтобы устранить распространенные проблемы, выполните следующие действия по устранению неполадок.

  • Не удается установить расширение :

    • Проверьте разрешения: Чтобы установить расширения, убедитесь, что вы администратор коллекции проектов или имеете необходимые разрешения, предоставленные администратором.
    • Проверить совместимость расширений: убедитесь, что расширение совместимо с версией Azure DevOps. Проверьте страницу сведений о расширении для получения сведений о совместимости.
    • проблемы с сетью: убедитесь, что сетевое подключение стабильно, а параметры брандмауэра или прокси-сервера не блокируют процесс установки.

  • расширение завершает работу или вызывает ошибки:

    • Сбор диагностических сведений: Если расширение завершает работу или вызывает ошибки, соберите диагностические сведения, чтобы помочь определить проблему. Эти сведения включают сообщения об ошибках, журналы и снимки экрана проблемы.
    • проверьте журналы расширений: некоторые расширения предоставляют журналы, которые помогут диагностировать проблемы. Ознакомьтесь с документацией по расширению, чтобы узнать, как получить доступ к этим журналам и интерпретировать их.
    • Обратитесь в службу поддержки: Если не удается устранить проблему, предоставьте в службу поддержки расширения собранные диагностические сведения. Предоставьте максимально подробную информацию, чтобы помочь им устранить проблему.

  • расширение не отображается после установки:

    • обновить страницу: Иногда расширение может не отображаться сразу после установки.
    • Проверьте разрешения: убедитесь, что у вас есть необходимые разрешения для просмотра и использования расширения. Для отображения некоторых расширений могут требоваться определенные разрешения.
    • переустановите расширение: Если расширение по-прежнему не отображается, попробуйте удалить и переустановить его.

Часто задаваемые вопросы

Вопрос. Почему моя организация не отображается на странице установки Marketplace?

Ответ. Если вы не видите свою организацию при покупке из Azure DevOps Marketplace, выполните следующие действия.

  1. Проверьте удостоверение, которое вы используете для входа в Visual Studio Marketplace. В правом верхнем углу выберите имя пользователя для просмотра профиля.
  2. Убедитесь, что адрес электронной почты и каталог верны.
  3. Закройте все открытые окна браузера.
  4. Откройте частный или инкогнито сеанс просмотра.
  5. Войдите в Visual Studio Marketplace. Используйте удостоверение пользователя в нужной организации.

Совет

Azure DevOps может попросить выбрать между рабочей или учебной учетной записью или личной учетной записью. В этом случае вы использовали адрес электронной почты, который совпадает с учетной записью Майкрософт и рабочей или учебной учетной записью, которыми управляет ваша организация в идентификаторе Microsoft Entra. Хотя эти личности имеют один и тот же адрес электронной почты, они по-прежнему являются отдельными учетными записями с разными профилями, параметрами безопасности и разрешениями. Выберите удостоверение пользователя в организации, которую вы хотите выбрать.

Вопрос. Почему не удается установить расширение?

Ответ. Вы не можете установить расширения по одной из следующих причин.

Вопрос. Почему пользователи не могут получать доступ к функциям расширения?

Ответ. Пользователи не могут получить доступ к расширению по одной из следующих причин.

  • Большинство расширений требуют, чтобы пользователи имели по крайней мере базовый доступ, а не заинтересованные лица. Например, можно установить бесплатное расширение поиска кода, но у каждого пользователя должен быть по крайней мере базовый доступ для поиска кода. Чтобы помочь вашей команде улучшить качество приложений, можно установить бесплатное расширение Test и Feedback. Вы работаете с разными возможностями на основе уровня доступа и независимо от того, работаете ли вы в автономном режиме или подключены к Azure DevOps Services или локальному серверу Azure DevOps Server. Дополнительные сведения см. в описании расширения на вкладке Visual Studio Marketplace Azure DevOps.

  • Если вы используете организацию и запустили бесплатную пробную версию расширения, срок действия пробной версии может быть истек. Проверьте, истек ли срок действия пробной версии.

    1. На панели инструментов организации выберите "Пользователи".
    2. Перейдите в область расширения.
    3. Проверьте наличие сообщения об истечении срока действия, чтобы найти, если или когда истек срок действия расширения.

  • Если вы используете организацию и заплатили за это расширение, убедитесь, что вы назначили это расширение пользователям.

    1. На панели инструментов организации перейдите на страницу "Пользователи".
    2. Перейдите в область расширения.
    3. Проверьте, назначено ли расширение пользователю. Если это не так, назначьте пользователю расширение.

Дополнительные сведения см. в разделе "Назначение расширений пользователям".

Вопрос. Что случилось с моим расширением предварительного просмотра?

A: Возможно, ваше расширение вышло из предварительной версии. После периода предварительного просмотра расширение обычно становится доступным как платное расширение. Вам могут предоставить льготный период перед тем, как вам нужно будет приобрести продление. Все расширения предварительной версии автоматически преобразуются в бесплатную пробную версию перед покупкой расширения.

Вопрос. Почему не удается установить расширения для Azure DevOps Server?

Ответ. Вы не можете установить расширения для Azure DevOps Server по одной из следующих причин:

  • Являйтесь членом группы администраторов коллекции ,, или имейте разрешение Изменение информации на уровне коллекции,, установлено в Разрешить в коллекции проектов, куда вы хотите установить расширения. Если у вас нет разрешений, вместо этого можно запросить расширения .
  • Вы можете получить сообщение об ошибке, в котором говорится, что расширение уже установлено или запрошено. В этом случае обратитесь к участнику группы администраторов коллекции проектов и попросите их назначить расширение вам. Дополнительные сведения см. в статье "Запрос на увеличение уровней разрешений".

Вопрос. Почему не отображается коллекция проектов, которую я хочу (локальная)?

А: Станьте участником собрания проектов. Выполните следующие действия, чтобы проверить удостоверение, используемое для входа в Marketplace.

  1. На домашней страницеhttps://{server}:8080/tfs/ веб-портала Azure DevOps Server перейдите в правый верхний угол страницы и выберите имя пользователя для просмотра профиля.
  2. В левой части профиля убедитесь, что адрес электронной почты и каталог верны.
  3. Закройте все открытые окна браузера.
  4. Откройте частный или инкогнито сеанс просмотра.
  5. Войдите на домашнюю страницу Azure DevOps Server (https://{server}:8080/tfs/) с учетной записью, являющейся пользователем в коллекции проектов, в которой вы хотите установить расширение.
    Azure DevOps может попросить выбрать между "рабочей или учебной организацией" или "личная учетная запись". Это означает, что вы использовали адрес электронной почты, который совпадает с учетной записью Майкрософт и рабочей или учебной учетной записью, управляемой организацией в идентификаторе Microsoft Entra. Хотя эти удостоверения имеют один и тот же адрес электронной почты, они по-прежнему остаются отдельными сущностями с различными профилями, параметрами безопасности и разрешениями. Выберите учетную запись, которая является пользователем в вашей коллекции проектов.
  6. Из вашей коллекции проектов перейдите в Marketplace.

Вопрос. Почему расширение, которое я хочу, не отображает кнопку скачивания (локальная среда)?

Ответ. Некоторые расширения работают только с Azure DevOps Services по одной из следующих причин:

  • Расширение использует функции Azure DevOps, которые еще не выпущены для Azure DevOps Server.
  • Манифест расширения указывает, что расширение доступно только для Azure DevOps Services (целевые объекты = Microsoft.Visualstudio.Services.Cloud).
  • Манифест расширения указывает, что расширение является интеграцией (целевые объекты = Microsoft.Visualstudio.Services.Integration).

Вопрос. Почему я не могу отправлять расширения в Azure DevOps Server?

Вступите в группу администраторов Team Foundation . Кроме того, необходимо иметь разрешения на редактирование сведений на уровне экземпляра для сервера Azure DevOps, куда вы хотите загрузить расширения.

Следующие шаги

Управление разрешениями расширения