Непрерывное развертывание документации DocFx с использованием локальной TFS

Question

Я изо всех сил пытаюсь настроить процесс непрерывного развертывания для проекта DocFX, используя локальную TFS.

Процесс описан здесь, однако пример пошагового руководства для VSTS, и у меня есть локальная TFS (версия 2013). Основная идея заключается в создании и развертывании веб-сайта документации при каждой регистрации. Расширение DocFx Build Tasks, которое использует процесс, похоже, поддерживает локальную TFS ... Я просто не понимаю, как это работает!

У меня есть решение VS, содержащее один проект C#, который имеет ссылку Nuget на docfx.console версии 2.38.1 (последняя). Когда я собираю VS на моем локальном ПК, папка _sites корректно заполняется HTML. Однако при сборке на сервере сборки сборка завершается с ошибкой "Предупреждение MSB4078: файл проекта"DocFx.csproj"не поддерживается MSBuild и не может быть собран".

Итак, я обнаружил расширение DocFx Build Tasks, и похоже, что оно может решить мою проблему.

Я скачал.VSIX, но не могу понять, где и как его установить.

Если я запускаю его непосредственно на сервере сборки (или на моем локальном ПК), появляется ошибка "Это расширение невозможно установить ни на один из установленных в настоящее время продуктов". появляется. Это из журнала установки:

31/08/2018 14:31:54 - Supported Products : 
31/08/2018 14:31:54 - Microsoft.VisualStudio.Services
31/08/2018 14:31:54 - Version : 
31/08/2018 14:31:54 - 
31/08/2018 14:31:54 - References : 
31/08/2018 14:31:54 - Signature Details...
31/08/2018 14:31:54 - Extension is not signed.
31/08/2018 14:31:54 - 
31/08/2018 14:31:54 - Searching for applicable products...
31/08/2018 14:31:54 - Found installed product - Microsoft Visual Studio 2012 Shell (Integrated)
31/08/2018 14:31:54 - Found installed product - Global Location
31/08/2018 14:31:54 - Found installed product - ssms
31/08/2018 14:31:54 - Found installed product - Visual Studio Community 2017
31/08/2018 14:31:54 - Found installed product - Visual Studio Build Tools 2017 (2)
31/08/2018 14:31:54 - VSIXInstaller.NoApplicableSKUsException: This extension is not installable on any currently installed products.

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

Что мне нужно сделать?

Answer 1

На основании сообщения об ошибке ""warning MSB4078: The project file "DocFx.csproj" is not supported by MSBuild and cannot be built."Похоже, что вы используете неверную версию MSBuild для сборки проекта. Ссылка на аналогичную ветку: Сборка выполнена успешно с проектами Ctrl + Shift + B, которые MSBuild не может собрать"

Для комбинации TFS 2013 + VS 2017 может потребоваться изменить ToolPath на полный путь MSBuild:"C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\MSBuild\15.0\Bin", Ссылка на эту тему: TFS 2013 и синтаксис Visual Studio 2017

Кроме того, вы также можете попробовать указать MSBuild arguments в определении сборки. такие как: /tv:15.0 /p:VisualStudioVersion=15.0 построить с VS2017.

Расширение DocFx Build Tasks не поддерживается в TFS 2013. Чтобы использовать это расширение, необходимо выполнить переход на сборку vNext (TFS 2015 и более поздние версии). Чтобы установить расширение, см. Установка расширений для Team Foundation Server (TFS).

Предлагаем перейти на современную версию TFS (система сборки vNext). Узнайте, почему вы должны перейти на сборку VNext