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

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

0 голосов
/ 31 августа 2018

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

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

У меня есть решение VS, содержащее один проект C #, в котором есть ссылка Nuget на версию 2.38.1 docfx.console (последняя). Когда я собираю 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 я также не вижу возможности загрузить расширение (хотя в более поздних версиях оно есть).

Что мне делать?

1 Ответ

0 голосов
/ 01 сентября 2018

Основано на сообщении об ошибке "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

...