Swashbuckle + XmlComments работают локально, но не генерируют чванство на сервере

У меня есть проект webapi, и я использую структуру swashbuckle для очистки документации API.

Я следовал указаниям по созданию XML-файла документации с моим контроллером и DTO, и все это отлично работает локально.

Однако при создании документа чванства возникает ошибка 500. Я подтвердил, что если я удалю строку регистрации xml, документ swagger будет сгенерирован и успешно возвращен.

вот моя строка регистрации:

GlobalConfiguration.Configuration.EnableSwagger(c =>
                    { 
...
    c.IncludeXmlComments($"{System.AppDomain.CurrentDomain.BaseDirectory}bin\\Company.MyApp.xml");
...

Обновление: я выполнил дополнительное ведение журнала, и хотя этот файл для IncludeXmlComments успешно выполняется при запуске, когда я запрашиваю файл swagger.json с сервера, я получаю исключение System.IO.FileNotFoundException: Could not find file 'D:\home\site\wwwroot\bin\Monetary.Scheduling.xml'. когда я использую инструменты Kudu для просмотра этого каталога, я не могу найти этот файл.

TL;DR: Почему этот файл нормально отображается локально, но при развертывании в Azure с помощью Kudu или пакета слепков Octopus этого файла там нет?


person Nathan Tregillus    schedule 02.08.2017    source источник


Ответы (1)


Проблема в том, что файл XML каким-то образом не попадает на ваш сервер... У меня была точно такая же проблема с развертыванием Azure, она отлично работала на моем локальном компьютере, но не в Azure.

... и это было потому, что мне не хватало XML-документа в конфигурации выпуска

Отладка

Выпуск

person Helder Sepulveda    schedule 04.08.2017