Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Узнайте, как устанавливать, назначать, отключать и удалять расширения для Azure DevOps. Расширения добавляют новые функции и возможности в вашу организацию.
Дополнительную информацию о создании собственных компонентов можно найти в обзорах разработки и публикации.
Предварительные условия
| Категория | Требования |
|---|---|
| Разрешения | Член группы Администраторы коллекции проекта. Владельцы организации автоматически входят в эту группу. Если у вас нет разрешений, вместо этого можно запросить расширения . |
| Частные расширения | Расширение должно быть предоставлено вашей организации. |
| Категория | Требования |
|---|---|
| Разрешения | Член группы Администраторы коллекции проектов или должен иметь разрешения Редактирование информации на уровне коллекции. Владельцы организации автоматически входят в эту группу. Если у вас нет разрешений, вместо этого можно запросить расширения . |
| Частные расширения | Расширение должно быть предоставлено вашей организации. |
| Выставление счетов | Чтобы использовать существующую подписку Azure для выставления счетов, вам потребуется по крайней мере разрешения соадминистратора для этой подписки. Если у вас нет разрешений, администратор учетной записи Azure или администратор службы может добавить вас в качестве коадминистратора на портале Azure. Коллекция проектов повторно использует подписку Azure для будущих покупок Marketplace. |
Установка расширения
Войдите в свою организацию (
https://dev.azure.com/{Your_Organization}).Щелкните значок сумки для покупок, затем выберите Обзор рынка.
Найдите расширение, которое вы хотите установить, и выберите " Получить его бесплатно".
Выберите организацию в раскрывающемся меню и нажмите кнопку "Установить".
Подсказка
Если вы не видите вашей организации или не можете установить расширение, ознакомьтесь с часто задаваемыми вопросами.
После завершения установки перейдите в организацию, чтобы начать использование расширения.
Высокие привилегии, декораторы конвейеров и неопубликованные расширения
Расширения с высокими привилегиями, декораторы конвейеров или неопубликованный статус могут представлять потенциальные риски безопасности, если они не прошли должную проверку. Области с высокими привилегиями предоставляют широкий доступ к ресурсам вашей организации, а декораторы конвейеров могут модифицировать все конвейеры в вашей организации. Издатели больше не могут поддерживать неопубликованные расширения. Дополнительные сведения об управлении этими типами расширений см. в статье "Управление областями высокой привилегии", декораторами конвейеров и неопубликованными расширениями.
Удаление или отключение расширения
Войдите в свою организацию (
https://dev.azure.com/{Your_Organization}).Выберите
Параметры организации.
Выберите расширения и выберите расширение, которое требуется удалить или отключить.
Выберите "Удалить " или выберите многоточие (...), а затем нажмите кнопку "Отключить".
Чтобы удалить расширения в коллекции, выполните следующие действия.
Перейдите на портал управления локальной коллекцией (
http://{server}:8080/tfs/_gallery/manage).Для нужного расширения выберите многоточие (...), а затем нажмите кнопку "Удалить".
Включение или перечисление расширений с помощью командной строки
Включите расширение с помощью команды 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, выполните следующие действия.
- Проверьте удостоверение, используемое для входа в Visual Studio Marketplace. В правом верхнем углу выберите имя пользователя для просмотра профиля.
- Убедитесь, что адрес электронной почты и каталог верны.
- Закройте все открытые окна браузера.
- Откройте частный или инкогнито сеанс просмотра.
- Войдите в Visual Studio Marketplace. Используйте удостоверение пользователя в нужной организации.
Подсказка
Azure DevOps может попросить вас выбрать между рабочей или учебной учетной записью или "личной учетной записью". Если это так, вы использовали адрес электронной почты, который совпадает с учетная запись Майкрософт и рабочей или учебной учетной записью, которыми управляет ваша организация в Microsoft Entra ID. Хотя эти личности имеют один и тот же адрес электронной почты, они по-прежнему являются отдельными учетными записями с разными профилями, параметрами безопасности и разрешениями. Выберите удостоверение пользователя в нужной организации.
Вопрос. Почему не удается установить расширение?
Ответ. Вы не можете установить расширения по одной из следующих причин.
- Вы должны быть членом группы Администраторы коллекции проектов или владельцем организации. Если у вас нет разрешений, вместо этого можно запросить расширения .
- Если возникает ошибка "уже установлено или запрошено", обратитесь к вашему администратору коллекции проектов и попросите его назначить вам это расширение.
Вопрос. Почему пользователи не могут получать доступ к функциям расширения?
Ответ. Пользователи не могут получить доступ к расширению по одной из следующих причин:
Большинство расширений требует как минимум базового доступа, а не доступа стейкхолдера. Дополнительные сведения см. в описании расширения на вкладке Visual Studio Marketplace Azure DevOps.
Возможно, истек срок действия бесплатной пробной версии расширения. Чтобы проверить, выполните следующие действия:
- На панели инструментов организации выберите "Пользователи".
- Перейдите в область расширения.
- Проверьте сообщение об истечении срока действия.
Расширение может не быть назначено пользователю. Чтобы проверить, выполните следующие действия:
- На панели инструментов организации выберите "Пользователи".
- Перейдите в область расширения.
- Проверьте, назначено ли расширение. Если это не так, назначьте его.
Вопрос. Что случилось с моим расширением предварительного просмотра?
A: Возможно, ваше расширение вышло из предварительной версии. После периода предварительной версии расширение больше не является бесплатным и становится платным расширением. Льготный период может быть предложен, прежде чем вы должны купить его. Все расширения предварительной версии автоматически преобразуются в бесплатную пробную версию перед покупкой.
Вопрос. Почему не удается установить расширения для Azure DevOps Server?
Ответ. Вы не можете установить расширения для Azure DevOps Server по одной из следующих причин:
- Вы должны быть членом группы Администраторы коллекции проектов или иметь разрешение Редактирование информации на уровне коллекции, установленное на Разрешить в сборке проектов, где вы хотите установить расширения. Если у вас нет разрешений, вместо этого можно запросить расширения .
- Вы можете получить сообщение об ошибке, в котором говорится, что расширение уже установлено или запрошено. В этом случае обратитесь к члену группы Администраторы коллекции проектов и попросите назначить вам расширение. Дополнительные сведения см. в статье "Запрос на увеличение уровней разрешений".
Вопрос. Почему не отображается коллекция проектов, которую я хочу (локальная)?
Ответ. Вы должны быть членом коллекции проектов. Выполните следующие действия, чтобы проверить удостоверение, используемое для входа в Marketplace.
- На домашней странице веб-портала Azure DevOps Server (
https://{server}:8080/tfs/), перейдите в правый верхний угол страницы и выберите имя пользователя для просмотра профиля. - В левой части профиля убедитесь, что адрес электронной почты и каталог верны.
- Закройте все открытые окна браузера.
- Откройте частный или инкогнито сеанс просмотра.
- Войдите на домашнюю страницу Azure DevOps Server (
https://{server}:8080/tfs/) с учетными данными, которые имеют права пользователя в коллекции проектов, где вы хотите установить расширение. Azure DevOps может попросить вас выбрать между «рабочей или учебной организацией» и «личной учетной записью». Если это так, учетные записи используют один и тот же адрес электронной почты, но имеют разные профили, параметры безопасности и разрешения. Выберите идентичность, которая является пользователем в коллекции ваших проектов. - Из вашей коллекции проектов перейдите в 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, где вы хотите загрузить расширения.