Swagger в функциях Azure V2

Question

Я создаю приложение функций V2 и хочу использовать Swagger / Open API для документов, однако он еще не поддерживается в портале Azure для функций V2.

Любые предложения о том, как я могу использовать Swagger с функциями V2 в VSTS для создания документов для каждой сборки?

Answer 1

TL; DR - используйте пакет NuGet для визуализации документа Open API и Swagger UI через функции Azure.

—-

Microsoft официально не начала поддерживать Open API (или Swagger)еще.Но в настоящее время существует пакет NuGet, управляемый сообществом:

https://www.nuget.org/packages/Aliencube.AzureFunctions.Extensions.OpenApi/

И вот блог для него:

https://devkimchi.com/2019/02/02/introducing-swagger-ui-on-azure-functions/

В основном его использование аналогично Swashbuckle - использование декораторов.И он поддерживает обе функции Azure V1 и V2.

Подтверждение : я являюсь владельцем пакета NuGet.

Answer 2

Вы можете ознакомиться с фреймворком Функция Monkey Функция домашней страницы Monkey

Она имеет множество функций, включая определения swagger / OpenAPI. Функция Monkey Swagger

Answer 3

Можете ли вы оставить свою функцию V2 для запуска на v1 среды выполнения, начав сначала с пустого приложения функции?

Документы MSDN для Создать определение OpenAPI для функции (с датой 11/2018 (что интересно) пример показывает:

По умолчанию создаваемое приложение-функция использует версию 2.x среды выполнения.Вы должны установить версию среды выполнения обратно на 1.x, прежде чем создавать свою функцию.

Но нельзя просто переместить настройку на 1:

Чтобы закрепитьФункция приложения до версии 1.x, выберите ~ 1 в разделе Runtime version.Этот переключатель отключается, когда у вас есть функции в вашем приложении.

Это означает, что необходимо создать приложение Function, опубликовать / создать его, установить его на V1 и затем добавить функцию перед добавлением приложения функции.

Answer 4

На портале, если вы перейдете в Приложение функций> Функции платформы> Определение API и нажмете кнопку «Функция (предварительный просмотр)» в разделе «Источник определения API», вы можете поэкспериментировать с написанием Swagger.