Поделиться через

Быстрый старт: Создание и развертывание из локального исходного кода в Azure Container Apps

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

На следующем снимке экрана показаны выходные данные развернутой службы API альбомов.

Скриншот ответа с конечной точки API альбомов.

Предварительные условия

Чтобы завершить этот проект, вам потребуется следующее:

Требование Инструкции
Учетная запись Azure Если у вас нет учетной записи, создайте бесплатную учетную запись. Чтобы продолжить, вам потребуется разрешение участника или владельца подписки Azure.

Дополнительные сведения см. в статье "Назначение ролей Azure с помощью портала Azure ".
Git Установка Git.
Azure CLI Установите интерфейс командной строки Azure.

Настройка

Чтобы войти в Azure из ИНТЕРФЕЙСА командной строки, выполните следующую команду и следуйте инструкциям, чтобы завершить процесс проверки подлинности.

az login

Чтобы убедиться, что вы используете последнюю версию интерфейса командной строки, выполните команду обновления:

az upgrade

Затем установите или обновите расширение "Приложения контейнеров" для интерфейса командной строки:

az extension add --name containerapp --upgrade --allow-preview true

Теперь, когда установлено текущее расширение, зарегистрируйте пространства имен Microsoft.App и Microsoft.OperationalInsights.

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

Создание переменной среды

После завершения настройки ИНТЕРФЕЙСА командной строки можно определить переменные среды, которые используются в этой статье.

Определите следующие переменные в оболочке Bash:

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"

Получите пример кода

Выполните следующую команду, чтобы клонировать пример приложения на выбранном языке и переключиться в папку источника проекта:

git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src

Создание и развертывание приложения-контейнера

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

az group create --name $RESOURCE_GROUP --location $LOCATION

Создайте и разверните ваше первое контейнерное приложение с помощью команды containerapp up. Эта команда:

  • Создает группу ресурсов.
  • Создает ресурс реестра контейнеров.
  • Создает образ контейнера и отправляет его в реестр.
  • Создает среду "Приложения контейнеров" с рабочей областью Log Analytics.
  • Создает и развертывает приложение-контейнер с помощью созданного образа контейнера.

Команда up использует Dockerfile в папке проекта для создания образа контейнера. Инструкция EXPOSE в Dockerfile определяет целевой порт, который используется для отправки трафика входящего трафика в контейнер.

В следующем примере кода . (точка) указывает containerapp up запустить в текущем каталоге проекта, который также содержит Dockerfile.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --source .

Примечание.

Если команда возвращает ошибку с сообщением "AADSTS50158: внешняя проверка безопасности не удовлетворена", выполните вход с необходимыми разрешениями, используя az login --scope https://graph.microsoft.com//.default, а затем снова выполните команду az containerapp up.

Проверка развертывания

Найдите URL-адрес контейнерного приложения в результате команды az containerapp up. Перейдите по URL-адресу в браузере. Добавьте /albums в конец URL-адреса, чтобы просмотреть ответ из API.

Скриншот ответа с API альбомов.

Ограничения

Максимальный размер отправки исходного кода составляет 200 МБ. Если отправка слишком велика, возвращается ошибка 413.

Очистка ресурсов

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

Внимание

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

az group delete --name $RESOURCE_GROUP

Совет

Возникли проблемы? Сообщите нам на GitHub, открыв запрос в репозитории Azure Container Apps.

Следующий шаг

Завершив работу с этим кратким руководством, вы можете продолжить работу с учебником. Обмен данными между микрослужбами в приложениях контейнеров Azure , чтобы узнать, как развернуть интерфейсное приложение, которое вызывает API.

Руководство по обмену данными между микрослужбами

  • Last updated on