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

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

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

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

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

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

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

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

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

Настройка

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

az login

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

az upgrade

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

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. Эта команда:

  • Создание группы ресурсов
  • Создать Реестр контейнеров Azure
  • Создание образа контейнера и отправка его в реестр
  • Создание среды "Приложения-контейнеры" с помощью рабочей области 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 снова.

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

Найдите 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