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

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

  • Статья

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/{yourorganization}).

  2. Щелкните значок сумки для покупок и нажмите кнопку "Обзор Marketplace".

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

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

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

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

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

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

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

  1. Перейдите к Marketplace.visualstudio.com.

  2. Войдите с помощью учетных данных Azure DevOps.

  3. Найдите расширение, которое требуется установить. Используйте поле поиска для фильтрации списка расширений.

    Снимок экрана: выбор расширения.

  4. Выберите расширение и выберите "Получить " или "Получить" бесплатно. Кроме того, для некоторых расширений от сторонних производителей выберите Начать работу, чтобы отобразить сведения о ценах и инструкции по установке для конкретного расширения.

    Снимок экрана: получение расширений.

    Если у вас нет разрешения на установку расширения, вы можете запросить администратора установить его для вас. Ваш запрос хранится в Azure DevOps Server и готов к работе с администратором.

  5. Выберите "Скачать ", чтобы скачать vsix-файл.

  6. Отправьте vsix в локальную локальную платформу Marketplace. Откройте домашнюю страницу Azure DevOps Server (https://{server}:DefaultCollection).

  7. Перейдите в раздел "Параметры>коллекции" Обзор локальных расширений.

    Снимок экрана: выбор, кнопка

  8. Выберите "Управление расширениями" и отправьте vsix-файл.

    Снимок экрана: выбор, управление расширениями.

  9. Установите расширение в коллекции проектов на странице "Управление расширениями ". Выберите коллекцию проектов, в которой нужно установить расширение, и нажмите кнопку "Установить".

Снимок экрана: выбор коллекции проектов и выбор установки.

  1. После завершения установки перейдите в коллекцию проектов или вернитесь в Marketplace, чтобы найти другие расширения.

Снимок экрана: завершенная установка расширения.

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

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

  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: Include the встроенные расширения. Допустимые значения: true (по умолчанию) и false.
  • include-disabled: include the disabled extensions. Допустимые значения: 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. Проверьте, назначено ли расширение пользователю. Если это не так, назначьте пользователю расширение.

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

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

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

Вопрос. Почему не удается установить расширения для 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. Хотя эти удостоверения имеют один и тот же адрес электронной почты, они по-прежнему разделены удостоверениями с различными профилями, параметрами безопасности и разрешениями. Выберите удостоверение, которое является пользователем в коллекции проектов.

  1. В коллекции проектов перейдите в 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, где требуется отправить расширения.

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

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