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

Статья
03/09/2023

Контейнеры приложений Azure предоставляют каждое приложение-контейнер посредством доменного имени, если включен входящий трафик. Конечные точки входящего трафика для приложений-контейнеров во внешней среде могут быть общедоступными или доступными только для других приложений-контейнеров в той же среде.

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

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

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

Снимок экрана: микрослужба пользовательского интерфейса пользовательского интерфейса альбома.

Из этого руководства вы узнаете, как:

Развертывание интерфейсного приложения в приложениях контейнеров Azure
Связывание интерфейсного приложения с конечной точкой API, развернутой в предыдущем кратком руководстве
Убедитесь, что интерфейсное приложение может взаимодействовать с СЕРВЕРНЫМ API

Необходимые компоненты

В кратком руководстве по коду в облаке серверный веб-API развертывается для возврата списка музыкальных альбомов. Если вы не развернули микрослужбу API альбомов, вернитесь к краткому руководству. Разверните код в приложениях контейнеров Azure для продолжения.

Настройка

Если вы в настоящее время проходите проверку подлинности в Azure и имеете переменные среды, определенные в кратком руководстве, пропустите следующие действия и перейдите непосредственно к подготовке репозитория GitHub.

Bash
Azure PowerShell

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

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
FRONTEND_NAME="album-ui"
GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

Перед выполнением этой команды обязательно замените <YOUR_GITHUB_USERNAME> имя пользователя GitHub.

Затем определите уникальное имя реестра контейнеров.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Определите следующие переменные в консоли PowerShell.

$ResourceGroup = "album-containerapps"
$Location = "canadacentral"
$Environment = "env-album-containerapps"
$APIName="album-api"
$FrontendName="album-ui"
$GITHUB_USERNAME = "<YOUR_GITHUB_USERNAME>"

Перед выполнением этой команды обязательно замените <YOUR_GITHUB_USERNAME> имя пользователя GitHub.

Затем определите уникальное имя реестра контейнеров.

$ACRName = "acaalbums"+$GITHUB_USERNAME

Войдите в Azure CLI.

Bash
Azure PowerShell

az login

Connect-AzAccount

Bash
Azure PowerShell

az acr login --name $ACR_NAME

az acr login --name $ACRName

Подготовка репозитория GitHub

На новой вкладке браузера перейдите в репозиторий для приложения пользовательского интерфейса и нажмите кнопку "Вилку" в верхней части страницы, чтобы вставить репозиторий в учетную запись.

Следуйте инструкциям из GitHub, чтобы закрепить репозиторий и вернуться сюда после завершения операции.
Перейдите к родительскому элементу папки code-to-cloud . Если вы все еще находитесь в каталоге code-to-cloud/src , можно использовать следующую команду, чтобы вернуться в родительскую папку.
```
cd ../..
```
Используйте следующую команду Git, чтобы клонировать вилку репозитория в папку кода в облако:
```
git clone https://github.com/$GITHUB_USERNAME/containerapps-albumui.git code-to-cloud-ui
```
Примечание.

Если команда завершается clone ошибкой, проверка успешно вилку репозитория.
Затем измените каталог в папку src клонированного репозитория.
```
cd code-to-cloud-ui/src
```

az acr build --registry $ACR_NAME --image albumapp-ui .

az acr build --registry $ACRName --image albumapp-ui .

az acr build Выходные данные команды показывают ход отправки исходного кода в Azure и сведения об docker build операции.

Следующая команда создает образ контейнера для пользовательского интерфейса альбома и тегирует его полным именем сервера входа ACR. В . конце команды представляет контекст сборки Docker, то есть эта команда должна выполняться в папке src , в которой находится Dockerfile.
- Bash
- Azure PowerShell
```
docker build --tag "$ACR_NAME.azurecr.io/albumapp-ui" . 
```
```
docker build --tag "$ACRName.azurecr.io/albumapp-ui" . 
```

Отправка образа в реестр ACR

Сначала войдите в Реестр контейнеров Azure.
- Bash
- Azure PowerShell
```
az acr login --name $ACR_NAME
```
```
az acr login --name $ACRName
```

Теперь отправьте образ в реестр.

Bash
Azure PowerShell


 docker push "$ACR_NAME.azurecr.io/albumapp-ui"


docker push "$ACRName.azurecr.io/albumapp-ui"

Обмен данными между приложениями-контейнерами

В предыдущем кратком руководстве API альбомов был развернут путем создания приложения-контейнера и включения внешнего входящего трафика. Установка входящего трафика приложения контейнера на внешний url-адрес конечной точки HTTP общедоступным.

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

Запросите приложение API для полного доменного имени (FQDN).
Передайте полное доменное имя az containerapp create API в качестве переменной среды, чтобы приложение пользовательского интерфейса может задать базовый URL-адрес для вызова API альбома в коде.

Приложение пользовательского интерфейса использует конечную точку, предоставленную для вызова API альбомов. Следующий код представляет собой фрагмент кода, используемого в файле маршрутов > index.js .

const api = axios.create({
  baseURL: process.env.API_BASE_URL,
  params: {},
  timeout: process.env.TIMEOUT || 5000,
});

Обратите внимание, как baseURL свойство получает значение из переменной API_BASE_URL среды.

Выполните следующую команду, чтобы запросить адрес конечной точки API.

Bash
Azure PowerShell

API_BASE_URL=$(az containerapp show --resource-group $RESOURCE_GROUP --name $API_NAME --query properties.configuration.ingress.fqdn -o tsv)

$APIBaseURL = (Get-AzContainerApp -Name $APIName -ResourceGroupName $ResourceGroup).IngressFqdn

Теперь, когда вы задаете API_BASE_URL переменную с полным доменным именем API альбома, ее можно предоставить в качестве переменной среды для приложения внешнего контейнера.

Развертывание интерфейсного приложения

Создайте и разверните приложение-контейнер с помощью следующей команды.

Bash
Azure PowerShell

az containerapp create \
  --name $FRONTEND_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/albumapp-ui  \
  --target-port 3000 \
  --env-vars API_BASE_URL=https://$API_BASE_URL \
  --ingress external \
  --registry-server $ACR_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

Добавив аргумент --env-vars "API_BASE_URL=https://$API_ENDPOINT" az containerapp createв , вы определяете переменную среды для внешнего приложения. В этом синтаксисе для переменной среды задано полное доменное имя API_BASE_URL API.

Выходные данные команды az containerapp create показывают URL-адрес внешнего приложения.

Чтобы создать приложение-контейнер, создайте объекты шаблона, которые передаются в качестве аргументов в New-AzContainerApp команду.

Создайте объект шаблона для определения параметров образа контейнера. Для переменной среды задано полное доменное имя API_BASE_URL API.


$EnvVars = New-AzContainerAppEnvironmentVarObject -Name API_BASE_URL -Value https://$APIBaseURL

$ContainerArgs = @{
  Name = $FrontendName
  Image = $ACRName + '.azurecr.io/albumapp-ui'
  Env = $EnvVars
}
$ContainerObj = New-AzContainerAppTemplateObject @ContainerArgs

Выполните следующую команду, чтобы получить учетные данные реестра.

$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup

Создайте объект учетных данных реестра для определения сведений о реестре и секретного объекта для определения пароля реестра. $RegistryObj In PasswordSecretRef ссылается на Name in $SecretObj.

$RegistryArgs = @{
    Server = $ACRName + '.azurecr.io'
    PasswordSecretRef = 'registrysecret'
    Username = $RegistryCredentials.Username
}
$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password

Получите идентификатор среды.

$EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id

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

$AppArgs = @{
    Name = $FrontendName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $ContainerObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 3000
    IngressExternal = $true
}
$FrontEndApp = New-AzContainerApp @AppArgs

# show the app's FQDN

$FrontEndApp.IngressFqdn

Просмотр веб-сайта

Используйте полное доменное имя приложения контейнера для просмотра веб-сайта. Страница похожа на следующий снимок экрана.

Снимок экрана: микрослужба пользовательского интерфейса пользовательского интерфейса альбома.

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

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

Внимание

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

Bash
Azure PowerShell

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroup -Force

Совет

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

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

Среды в Azure Container Apps

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