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


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

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

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

Дополнительную информацию о создании собственных компонентов можно найти в обзорах разработки и публикации.

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

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

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

  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 . Чтобы начать, смотрите Get started with 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 , чтобы получить список сведений о расширении. Чтобы начать, смотрите Get started with 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

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

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

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

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

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

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

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

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

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

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

Подсказка

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

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

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

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

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

  • Большинство расширений требует как минимум базового доступа, а не доступа стейкхолдера. Дополнительные сведения см. в описании расширения на вкладке Visual Studio Marketplace Azure DevOps.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Необходимо: быть членом группы администраторов Team Foundation Administrators и иметь разрешения Изменение данных уровня экземпляра для Azure DevOps Server, где вы хотите загрузить расширения.

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