Предыдущий

Следующая

Упражнение. Создание шлюза API

Завершено

В этом упражнении вы развертываете пример веб-API и настраиваете шлюз API. В следующем уроке вы публикуете веб-API в шлюзе.

В рассматриваемом примере компания-производитель обуви NorthWind Shoes приняла решение предоставить партнерам общий доступ к API Inventory. С помощью этого API партнеры получают доступ к данным по запасам и продуктам.

Важно!

Для выполнения этого упражнения вам нужна собственная подписка Azure. При этом с вас может взиматься плата. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу.

Развертывание веб-API ShoeCompany

Вы разработали приложение .NET Core, которое создает сведения о инвентаризации и продукте. Это приложение включает пакет Swashbuckle, который создает документацию OpenAPI Swagger.

Чтобы сэкономить время, мы выполним скрипт для размещения нашего API RESTful в Azure. Скрипт выполняет следующие задачи.

• создает план службы приложений Azure с ценовой категорией "Бесплатный";
• Создает веб-API в службе приложение Azure, настроенную для развертывания Git из локального репозитория.
• Задает учетные данные развертывания на уровне учетной записи для нашего приложения.
• настраивает локальный репозиторий Git;
• Развертывает веб-API в нашем экземпляре Служба приложений.

1. Войдите на портал Azure.

2. На панели задач Azure щелкните значок Cloud Shell, чтобы открыть Azure Cloud Shell.

   

3. Выполните следующую git команду в Cloud Shell, чтобы клонировать репозиторий GitHub и скачать исходный код для нашего приложения.

   git clone https://github.com/MicrosoftDocs/mslearn-publish-manage-apis-with-azure-api-management.git
   

4. После завершения операции откройте папку локального репозитория и выведите список ее содержимого с помощью следующих команд.

   cd mslearn-publish-manage-apis-with-azure-api-management
   ls -l
   

   Один из файлов — setup.sh. Как предполагает его имя, это скрипт, который мы запускаем для настройки тестового API.

5. Введите следующую команду, чтобы запустить скрипт. Он создает общедоступное веб-приложение, которое предоставляет интерфейс OpenAPI.

   bash setup.sh
   

   Выполнение скрипта занимает около одной минуты. Во время развертывания все зависимости, необходимые для запуска приложения, автоматически устанавливаются на удаленные Служба приложений. В выходных данных перечислены все операции. По завершении скрипта последние две строки — это URL-адреса, используемые для тестирования развертывания приложения.

6. Чтобы проверить, правильно ли развернуто приложение, скопируйте первый URL-адрес (URL-адрес Swagger) из Cloud Shell и вставьте его в новую вкладку в браузере.

   В браузере должен открыться пользовательский интерфейс Swagger нашего приложения с объявлением следующих конечных точек RESTful:

   • API/inventory создает список продуктов и количество в запасе.
   • api/inventory/{productid} возвращает номер в запасе для указанного идентификатора продукта (целое число).
   • API/Products создает список продуктов.
   • api/Products/{productid} возвращает сведения для указанного идентификатора продукта.

   

7. Наконец, скопируйте второй URL-адрес (URL-адрес JSON Swagger) из выходных данных Cloud Shell и сохраните его, например в Блокноте. Этот URL-адрес необходим в следующем упражнении.

Развертывание шлюза API

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

1. Войдите на портал Azure.

2. В службах Azure или на домашней странице выберите Создать ресурс. Откроется панель Создание ресурса.

3. В меню ресурсов выберите "Интеграция" и в результатах выберите Управление API. Откроется панель "Создание Управление API службы".

4. На вкладке Основные сведения введите указанные ниже значения для каждого параметра.

   Параметр	Значение
   Сведения о проекте
   Отток подписок	Выберите свою подписку.
   Группа ресурсов	Выберите новую или существующую группу ресурсов. Группа ресурсов — это логический контейнер, содержащий связанные ресурсы для решения Azure.
   Сведения об экземпляре
   Регион	Выберите доступный регион.
   Имя ресурса	apim-NorthWindShoes<random number>, замените random number собственным набором цифр, чтобы сделать имя глобально уникальным.
   Название организации	NorthWindShoes. Имя вашей организации для использования на портале разработчика и Уведомления по электронной почте. (Портал разработчика и уведомления недоступны во всех уровнях служб.)
   Адрес электронной почты администратора	Адрес электронной почты для получения всех системных уведомлений.
   Ценовая категория	Consumption

   Примечание.

   Уровень потребления обеспечивает быстрое развертывание для тестирования и имеет модель ценообразования на оплату за использование. Общий интерфейс управления API похож на другие ценовые категории.

5. Чтобы проверить параметры, выберите Просмотр и создание.

6. После прохождения проверки нажмите кнопку Создать. Развертывание может занять несколько минут.

7. После завершения развертывания экземпляр Управление API отображается в ресурсах Azure. Выберите "Перейти к ресурсу", чтобы просмотреть область для службы Управление API.

Продолжить