Oktatóanyag: Mikroszolgáltatások közötti kommunikáció az Azure Container Appsben

Az Azure Container Apps az egyes tárolóalkalmazásokat tartománynéven keresztül teszi elérhetővé, ha a bejövő forgalom engedélyezve van. A külső környezeten belüli tárolóalkalmazások bejövő végpontjai nyilvánosan elérhetők, vagy csak az ugyanabban a környezetben lévő többi tárolóalkalmazás számára érhetők el.

Miután megismerte egy adott tárolóalkalmazás teljes tartománynevét, közvetlen hívásokat kezdeményezhet a szolgáltatáshoz a megosztott környezetben lévő többi tárolóalkalmazásból.

Ebben az oktatóanyagban üzembe helyez egy második tárolóalkalmazást, amely közvetlen szolgáltatáshívást végez a kód üzembe helyezése az Azure Container Appsben rövid útmutatóban üzembe helyezett API-hoz.

Az alábbi képernyőképen a jelen cikk végén látható, hogy a felhasználói felület mikroszolgáltatásai tárolóalkalmazásokban lesznek üzembe helyezve.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

• Előtérbeli alkalmazás üzembe helyezése az Azure Container Appsben
• Az előtéralkalmazás csatolása az előző rövid útmutatóban üzembe helyezett API-végponthoz
• Ellenőrizze, hogy az előtérbeli alkalmazás képes-e kommunikálni a háttér API-val

Előfeltételek

A kód–felhő rövid útmutatóban egy háttérbeli webes API van üzembe helyezve a zenei albumok listájának visszaadásához. Ha még nem telepítette az album API-mikroszolgáltatást, térjen vissza a rövid útmutatóhoz: A kód üzembe helyezése az Azure Container Appsben a folytatáshoz.

Telepítés

Ha továbbra is hitelesíti magát az Azure-ban, és a gyorsútmutatóban még definiálva vannak a környezeti változók, kihagyhatja az alábbi lépéseket, és közvetlenül a GitHub-adattár előkészítése szakaszra léphet.

Bash

Adja meg a következő változókat a Bash-rendszerhéjban.

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

A parancs futtatása előtt cserélje le a helyére <YOUR_GITHUB_USERNAME> a GitHub-felhasználónevét.

Ezután adjon meg egy egyedi tárolóregisztrációs adatbázisnevet.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Adja meg a következő változókat a PowerShell-konzolon.

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

A parancs futtatása előtt cserélje le a helyére <YOUR_GITHUB_USERNAME> a GitHub-felhasználónevét.

Ezután adjon meg egy egyedi tárolóregisztrációs adatbázisnevet.

$ACRName = "acaalbums"+$GITHUB_USERNAME

Jelentkezzen be az Azure CLI-be.

Bash

az login

Azure PowerShell

Connect-AzAccount

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

A GitHub-adattár előkészítése

1. Egy új böngészőlapon keresse meg a felhasználói felületi alkalmazás adattárát , majd a lap tetején található Elágazás gombra kattintva elágazhatja az adattárat a fiókjához.

   Kövesse a GitHubon megjelenő utasításokat az adattár elágaztatásához, és térjen vissza ide a művelet befejezése után.

2. Lépjen a kód–felhő mappa szülőjéhez . Ha továbbra is a code-to-cloud/src könyvtárban van, az alábbi paranccsal visszatérhet a szülőmappához.

   cd ../..
   

3. A következő Git-paranccsal klónozza az elágaztatott adattárat a code-to-cloud-ui mappába:

   git clone https://github.com/$GITHUB_USERNAME/containerapps-albumui.git code-to-cloud-ui
   

   Megjegyzés

   Ha a clone parancs sikertelen, ellenőrizze, hogy sikeresen elágazott-e az adattár.

4. Ezután módosítsa a könyvtárat a klónozott adattár src mappájára.

   cd code-to-cloud-ui/src
   

Az előtér-alkalmazás létrehozása

Bash

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

Azure PowerShell

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

A parancs kimenete a az acr build forráskód Azure-ba való feltöltésének folyamatát és a docker build művelet részleteit mutatja.

1. A következő parancs létrehoz egy tárolórendszerképet az album felhasználói felületéhez, és az ACR bejelentkezési kiszolgáló teljes nevét címkézi. A . parancs végén található a docker buildkörnyezete, ami azt jelenti, hogy ezt a parancsot a Dockerfile helyét tartalmazó src mappában kell futtatni.

   Bash

   docker build --tag "$ACR_NAME.azurecr.io/albumapp-ui" . 
   

   Azure PowerShell

   docker build --tag "$ACRName.azurecr.io/albumapp-ui" . 
   

A rendszerkép leküldése az ACR-beállításjegyzékbe

1. Először jelentkezzen be a Azure Container Registry.

   Bash

   az acr login --name $ACR_NAME
   

   Azure PowerShell

   az acr login --name $ACRName
   

2. Most küldje le a lemezképet a beállításjegyzékbe.

   Bash

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

   Azure PowerShell

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

Kommunikáció tárolóalkalmazások között

Az előző rövid útmutatóban az album API egy tárolóalkalmazás létrehozásával és a külső bejövő forgalom engedélyezésével lett üzembe helyezve. A tárolóalkalmazás külsőre való bejövő forgalmának beállítása nyilvánosan elérhetővé tette a HTTP-végpont URL-címét.

Most az alábbi lépések végrehajtásával konfigurálhatja az előtérbeli alkalmazást az API-végpont meghívására:

• Az API-alkalmazás lekérdezése a teljes tartománynévhez (FQDN).
• Adja át az API teljes tartománynevét az containerapp create környezeti változóként, hogy a felhasználói felület alkalmazás beállíthassa az album API-hívásának alap URL-címét a kódban.

A felhasználói felületi alkalmazás a megadott végpontot használja az album API meghívásához. Az alábbi kód egy részlet az útvonalak > index.js fájlban használt kódból.

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

Figyelje meg, hogy a baseURL tulajdonság hogyan kapja meg az értékét a API_BASE_URL környezeti változóból.

Futtassa a következő parancsot az API-végpont címének lekérdezéséhez.

Bash

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

Azure PowerShell

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

Most, hogy beállította a API_BASE_URL változót az album API teljes tartománynevével, környezeti változóként megadhatja azt az előtérbeli tárolóalkalmazásnak.

Előtérbeli alkalmazás üzembe helyezése

Hozza létre és telepítse a tárolóalkalmazást az alábbi paranccsal.

Bash

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

Ha hozzáadja az argumentumot --env-vars "API_BASE_URL=https://$API_ENDPOINT" a elemhez az containerapp create, meghatároz egy környezeti változót az előtér-alkalmazáshoz. Ezzel a szintaxissal a nevű API_BASE_URL környezeti változó az API teljes tartománynevére van állítva.

A parancs kimenete az containerapp create az előtér-alkalmazás URL-címét jeleníti meg.

Azure PowerShell

A tárolóalkalmazás létrehozásához hozzon létre sablonobjektumokat, amelyeket argumentumként ad át a New-AzContainerApp parancsnak.

Hozzon létre egy sablonobjektumot a tárolórendszerkép paramétereinek meghatározásához. A nevű API_BASE_URL környezeti változó az API teljes tartománynevére van állítva.

$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

A beállításjegyzék hitelesítő adatainak lekéréséhez futtassa az alábbi parancsot.

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

Hozzon létre egy regisztrációs adatbázis hitelesítőadat-objektumot a beállításjegyzék adatainak meghatározásához, valamint egy titkos objektumot a beállításjegyzék jelszavának megadásához. A PasswordSecretRef in a in $RegistryObj$SecretObjértékre Name hivatkozik.

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

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

Kérje le a környezet azonosítóját.

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

Hozza létre a tárolóalkalmazást.

$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

Webhely megtekintése

A webhely megtekintéséhez használja a tárolóalkalmazás teljes tartománynevét. A lap az alábbi képernyőképhez fog hasonlítni.

Az erőforrások eltávolítása

Ha nem folytatja az alkalmazás használatát, futtassa az alábbi parancsot az erőforráscsoport és az ebben a rövid útmutatóban létrehozott összes erőforrás törléséhez.

Figyelemfelhívás

Ez a parancs törli a megadott erőforráscsoportot és a benne található összes erőforrást. Ha az oktatóanyag hatókörén kívüli erőforrások szerepelnek a megadott erőforráscsoportban, akkor azok is törlődnek.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Tipp

Problémákat tapasztal? Tudassa velünk a GitHubon, hogy megnyit egy problémát az Azure Container Apps-adattárban.

Következő lépések

Környezetek az Azure Container Appsben