Краткое руководство. Создание и развертывание из локального исходного кода в приложениях контейнеров Azure
В этой статье показано, как создать и развернуть микрослужбу в приложениях контейнеров Azure из локального исходного кода с помощью выбранного языка программирования. В этом кратком руководстве вы создадите серверную веб-службу API, которая возвращает статическую коллекцию музыкальных альбомов.
На следующем снимке экрана показаны выходные данные развернутой службы API альбомов.
Необходимые компоненты
Чтобы завершить этот проект, вам потребуется следующее:
| Требование | Instructions |
|---|---|
| Учетная запись 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 вход с необходимыми разрешениями и снова запустите az containerapp up команду.
Проверка развертывания
Найдите URL-адрес приложения контейнера в выходных az containerapp up данных команды. Перейдите по URL-адресу в браузере. Добавьте /albums в конец URL-адреса, чтобы просмотреть ответ из API.
Ограничения
Максимальный размер для отправки исходного кода составляет 200 МБ. Если отправка выходит за предел, возвращается ошибка 413.
Очистка ресурсов
Если вы не собираетесь продолжать работу с руководством по развертыванию внешнего интерфейса , вы можете удалить ресурсы Azure, созданные в рамках этого краткого руководства, с помощью следующей команды.
Внимание
Следующая команда удаляет указанную группу ресурсов и все ресурсы, содержащиеся в ней. Если группа содержит ресурсы вне области этого краткого руководства, они также удаляются.
az group delete --name $RESOURCE_GROUP
Совет
Возникли проблемы? Сообщите о них в репозитории Azure Container Apps на GitHub.
Следующие шаги
Завершив работу с этим кратким руководством, вы можете продолжить работу с руководством по обмену данными между микрослужбами в приложениях контейнеров Azure, чтобы узнать, как развернуть интерфейсное приложение, которое вызывает API.