Virtuális hálózat biztosítása Azure Container Apps környezet számára

Az alábbi példa bemutatja, hogyan hozhat létre Container Apps-környezetet egy meglévő virtuális hálózaton (VNet).

Először jelentkezzen be a Azure portálra.

Tárolóalkalmazás létrehozása

A tárolóalkalmazás létrehozásához kezdje a Azure portál kezdőlapján.

1. Keresse meg a Container Apps alkalmazást a felső keresősávon.
2. Válassza a Container Apps lehetőséget a keresési eredmények között.
3. Válassza a Létrehozás gombot.

Alapvető beállítások lap

Az Alapismeretek lapon hajtsa végre az alábbi műveleteket.

1. Adja meg a következő értékeket a Project részletek szakaszban.

   Beállítás	Művelet
   Előfizetés	Válassza ki Azure előfizetését.
   Erőforráscsoport	Válassza az Új létrehozása lehetőséget, és adja meg a saját tárolóalkalmazásokat.
   Tárolóalkalmazás neve	Lépjen be a my-container-app alkalmazásba.
   Telepítési forrás	Válassza a konténerkép lehetőséget.

Környezet létrehozása

Ezután hozzon létre egy környezetet a tárolóalkalmazáshoz.

1. Válassza ki a megfelelő régiót.

   Beállítás	Érték
   Régió	Válassza az USA középső régiója lehetőséget.

2. A Container Apps környezet mezőjében válassza az Új környezet létrehozása hivatkozást.

3. Az Alapok lap Container Apps-környezet létrehozása lapján adja meg a következő értékeket:

   Beállítás	Érték
   Környezet neve	Írja be a saját környezetemet.
   Zóna-redundancia	Válassza a Letiltva lehetőséget

4. Válassza a Monitoring lapot Log Analytics munkaterület létrehozásához.

5. Válassza a Azure Log Analytics mint a Naplók célállomása lehetőséget.

6. Válassza a Új létrehozása hivatkozást a Log Analytics munkaterület mezőben, és adja meg a következő értékeket.

   Beállítás	Érték
   Név	Adja meg a saját tároló-alkalmazások naplóit.

   A Hely mező előre ki van töltve a Közép-USA értékkel.

7. Kattintson az OK gombra.

Emellett privát DNS-t is üzembe helyezhet a Container Apps-környezetben. További információ: A Azure saját DNS zóna létrehozása és konfigurálása.

Virtuális hálózat létrehozása

Megjegyzés

A Tárolóalkalmazásokkal rendelkező virtuális hálózat használatához a virtuális hálózatnak rendelkeznie kell egy dedikált alhálózattal, amelynek CIDR-tartománya /27 vagy nagyobb az alapértelmezett számítási profilok környezetének használatakor, vagy egy CIDR-tartománnyal /23 vagy nagyobbal az örökölt használatalapú környezet használatakor. Az alhálózat-méretezéssel kapcsolatos további információkért tekintse meg a hálózati architektúra áttekintését.

1. Válassza a Hálózatkezelés lapot.

2. Válassza az Igen lehetőséget a saját virtuális hálózat használata mellett.

3. A Virtuális hálózat mező mellett válassza az Új hivatkozás létrehozása lehetőséget, és adja meg a következő értéket:

   Beállítás	Érték
   Név	Adja meg my-custom-vnet.

4. Válassza az OK gombot.

5. Az Alhálózat mező mellett válassza az Új hivatkozás létrehozása lehetőséget, és adja meg a következő értékeket:

   Beállítás	Érték
   Alhálózat neve	Adja meg az infrastruktúra-alhálózatot.
   Virtual Network címblokk	Tartsa meg az alapértelmezett értékeket.
   Alhálózati címblokk	Tartsa meg az alapértelmezett értékeket.

6. Válassza az OK gombot.

7. A Virtuális IP-cím alatt válassza a Külső lehetőséget külső környezethez, vagy a Belső lehetőséget belső környezethez.

8. Válassza a Létrehozás lehetőséget.

A tárolóapp üzembe helyezése

1. A lap alján válassza a Véleményezés + létrehozás lehetőséget.

   • Ha nem található hiba, a Létrehozás gomb elérhető.
   • Ha vannak hibák, a hibát tartalmazó lapok piros ponttal vannak megjelölve. Nyissa meg az egyes lapokat. A hibát tartalmazó mezők piros színnel vannak kiemelve, vagy piros X-el vannak jelölve. Javítsa ki az összes hibát, majd válassza a Véleményezés + létrehozás lehetőséget.

2. Válassza a Létrehozás lehetőséget.

   Megjelenik egy lap, amelyen a telepítés folyamatban van. Miután az üzembe helyezés sikeresen befejeződött, megjelenik az üzenet, A telepítés befejeződött.

Az alkalmazás telepítésének ellenőrzése

1. Válassza az Ugrás az erőforrásra lehetőséget az új tárolóalkalmazás megtekintéséhez.

2. Az alkalmazás URL-címe mellett válassza a hivatkozást az alkalmazás megtekintéséhez.

Előfeltételek

• Azure aktív előfizetéssel rendelkező fiók.
  • Ha még nem rendelkezik fiókkal, ingyen létrehozhat egyet.
• Telepítse a Azure CLI 2.28.0-s vagy újabb verzióját.

Beállítás

Ha Azure szeretne bejelentkezni a parancssori felületről, futtassa a következő parancsot, és kövesse az utasításokat a hitelesítési folyamat befejezéséhez.

Bash

az login

PowerShell

Connect-AzAccount

A parancssori felület legújabb verziójának futtatásához futtassa a frissítési parancsot.

Bash

az upgrade

PowerShell

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

A jelenleg használt modulokra vonatkozó figyelmeztetések figyelmen kívül hagyása.

Ezután telepítse vagy frissítse a parancssori felület Azure Container Apps bővítményét.

Ha a az containerapp parancsok Azure CLI vagy a PowerShell Az.App moduljának parancsmagjaiban való futtatásakor hibaüzenetet kap a hiányzó paraméterekről, győződjön meg arról, hogy a Azure Container Apps bővítmény legújabb verziója van telepítve.

Bash

az extension add --name containerapp --upgrade

Megjegyzés

2024 májusától kezdődően Azure CLI bővítmények alapértelmezés szerint nem engedélyezik az előzetes verziójú funkciókat. A Container Apps előzetes verziójú funkcióinak eléréséhez telepítse a Container Apps bővítményt a következővel --allow-preview true: .

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

PowerShell

Install-Module -Name Az.App

Frissítse a modult a Az.App legújabb verzióra.

Update-Module -Name Az.App

Az aktuális bővítmény vagy modul telepítése után regisztrálja a Microsoft.App és Microsoft.OperationalInsights névtereket.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Környezeti változók beállítása

Állítsa be a következő környezeti változókat. Cserélje le a <placeholders> karakterláncot a saját értékeivel.

Bash

RESOURCE_GROUP="<new-resource-group>"
LOCATION="<location>"
CONTAINERAPPS_ENVIRONMENT="<containerapps-environment>"

PowerShell

$ResourceGroupName = '<new-resource-group>'
$Location = '<location>'
$ContainerAppsEnvironment = '<containerapps-environment>'

Azure erőforráscsoport létrehozása

Hozzon létre egy erőforráscsoportot a tárolóalkalmazás üzembe helyezéséhez kapcsolódó szolgáltatások rendszerezéséhez.

Bash

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

PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Környezet létrehozása

A Azure Container Apps környezete biztonságos határt hoz létre a tárolóalkalmazások egy csoportja körül. Az ugyanabban a környezetben üzembe helyezett Tárolóalkalmazások ugyanabban a virtuális hálózaton vannak üzembe helyezve, és naplókat írnak ugyanarra a Log Analytics munkaterületre.

Regisztrálja a Microsoft.ContainerService szolgáltatót.

Bash

az provider register --namespace Microsoft.ContainerService

PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.ContainerService

Deklaráljon egy változót a virtuális hálózat nevének tárolásához.

Bash

VNET_NAME="my-custom-vnet"

PowerShell

$VnetName = 'my-custom-vnet'

Most hozzon létre egy virtuális hálózatot a Container Apps-környezethez való társításához. A virtuális hálózatnak rendelkeznie kell egy elérhető alhálózattal a környezet üzembe helyezéséhez.

Bash

az network vnet create \
  --resource-group $RESOURCE_GROUP \
  --name $VNET_NAME \
  --location $LOCATION \
  --address-prefix 10.0.0.0/16

az network vnet subnet create \
  --resource-group $RESOURCE_GROUP \
  --vnet-name $VNET_NAME \
  --name infrastructure-subnet \
  --address-prefixes 10.0.0.0/23

PowerShell

$SubnetArgs = @{
    Name = 'infrastructure-subnet'
    AddressPrefix = '10.0.0.0/23'
}
$subnet = New-AzVirtualNetworkSubnetConfig @SubnetArgs

$VnetArgs = @{
    Name = $VnetName
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    AddressPrefix = '10.0.0.0/16'
    Subnet = $subnet
}
$vnet = New-AzVirtualNetwork @VnetArgs

A Workload profilok környezet használatakor frissítenie kell a virtuális hálózatot, hogy az alhálózatot átruházza Microsoft.App/environments. Ne delegálja az alhálózatot a csak használatalapú környezet használatakor.

Bash

az network vnet subnet update \
  --resource-group $RESOURCE_GROUP \
  --vnet-name $VNET_NAME \
  --name infrastructure-subnet \
  --delegations Microsoft.App/environments

PowerShell

$delegation = New-AzDelegation -Name 'containerApp' -ServiceName 'Microsoft.App/environments'
$vnet = Set-AzVirtualNetworkSubnetConfig -Name $SubnetArgs.Name -VirtualNetwork $vnet -AddressPrefix $SubnetArgs.AddressPrefix -Delegation $delegation
$vnet | Set-AzVirtualNetwork

A virtuális hálózat létrehozása után lekérdezheti az infrastruktúra alhálózat-azonosítóját.

Bash

INFRASTRUCTURE_SUBNET=`az network vnet subnet show --resource-group ${RESOURCE_GROUP} --vnet-name $VNET_NAME --name infrastructure-subnet --query "id" -o tsv | tr -d '[:space:]'`

PowerShell

$InfrastructureSubnet=(Get-AzVirtualNetworkSubnetConfig -Name $SubnetArgs.Name -VirtualNetwork $vnet).Id

Végül hozza létre a Container Apps-környezetet az egyéni virtuális hálózat használatával.

Bash

A környezet létrehozásához futtassa a következő parancsot. Belső környezet létrehozásához adja hozzá a következőt --internal-only: .

az containerapp env create \
  --name $CONTAINERAPPS_ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION" \
  --infrastructure-subnet-resource-id $INFRASTRUCTURE_SUBNET

Az alábbi táblázat a használt containerapp env createparamétereket ismerteti.

Paraméter	Leírás
name	A Container Apps-környezet neve.
resource-group	Az erőforráscsoport neve.
logs-workspace-id	(Nem kötelező) Meglévő Log Analytics munkaterület azonosítója. Ha nincs megadva, létrejön egy munkaterület az Ön számára.
logs-workspace-key	A Log Analytics titkos ügyfélkód. Meglévő munkaterület használata esetén kötelező.
location	A Azure hely, ahol a környezet üzembe helyezhető.
infrastructure-subnet-resource-id	Az infrastruktúra-összetevők és a felhasználói alkalmazástárolók alhálózatának erőforrás-azonosítója.
internal-only	(Nem kötelező) A környezet nem használ nyilvános statikus IP-címet, csak az egyéni virtuális hálózaton elérhető belső IP-címeket. (Infrastruktúra-alhálózati erőforrás-azonosítót igényel.)

PowerShell

A Container Apps-környezethez Log Analytics munkaterület szükséges. Az alábbi parancsok létrehoznak egy Log Analytics munkaterületet, és mentik a munkaterület azonosítóját és az elsődleges megosztott kulcsot a környezeti változókba.

$WorkspaceArgs = @{
    Name = 'myworkspace'
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroupName -Name $WorkspaceArgs.Name).PrimarySharedKey

A környezet létrehozásához futtassa a következő parancsot. Cserélje le <INTERNAL> vagy $true$false attól függően, hogy belső környezetet szeretne-e.

$EnvArgs = @{
    EnvName = $ContainerAppsEnvironment
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    AppLogConfigurationDestination = "log-analytics"
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
    VnetConfigurationInfrastructureSubnetId = $InfrastructureSubnet
    VnetConfigurationInternal = <INTERNAL>
}
New-AzContainerAppManagedEnv @EnvArgs

Az alábbi táblázat azokat a paramétereket ismerteti, amelyeket a következőben használnak New-AzContainerAppManagedEnv: .

Paraméter	Leírás
EnvName	A Container Apps-környezet neve.
ResourceGroupName	Az erőforráscsoport neve.
LogAnalyticConfigurationCustomerId	Meglévő Log Analytics munkaterület azonosítója.
LogAnalyticConfigurationSharedKey	A Log Analytics titkos ügyfélkód.
Location	A Azure hely, ahol a környezet üzembe helyezhető.
VnetConfigurationInfrastructureSubnetId	Az infrastruktúra-összetevők és a felhasználói alkalmazástárolók alhálózatának erőforrás-azonosítója.
VnetConfigurationInternal	(Nem kötelező) Ha a $true környezet nem használ nyilvános statikus IP-címet, csak az egyéni virtuális hálózatban elérhető belső IP-címeket használja. (Infrastruktúra-alhálózati erőforrás-azonosítót igényel.)

Választható konfiguráció

Lehetősége van privát DNS üzembe helyezésére és egyéni hálózati IP-tartományok meghatározására a Container Apps-környezethez.

Üzembe helyezés privát DNS-lel

Ha privát DNS-lel szeretné üzembe helyezni a tárolóalkalmazást, futtassa az alábbi parancsokat.

Először nyerje ki az azonosítható információkat a környezetből.

Bash

ENVIRONMENT_DEFAULT_DOMAIN=`az containerapp env show --name ${CONTAINERAPPS_ENVIRONMENT} --resource-group ${RESOURCE_GROUP} --query properties.defaultDomain --out json | tr -d '"'`

ENVIRONMENT_STATIC_IP=`az containerapp env show --name ${CONTAINERAPPS_ENVIRONMENT} --resource-group ${RESOURCE_GROUP} --query properties.staticIp --out json | tr -d '"'`

VNET_ID=`az network vnet show --resource-group ${RESOURCE_GROUP} --name ${VNET_NAME} --query id --out json | tr -d '"'`

PowerShell

$EnvironmentDefaultDomain = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).DefaultDomain

$EnvironmentStaticIp = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).StaticIp

Ezután állítsa be a privát DNS-t.

Bash

az network private-dns zone create \
  --resource-group $RESOURCE_GROUP \
  --name $ENVIRONMENT_DEFAULT_DOMAIN

az network private-dns link vnet create \
  --resource-group $RESOURCE_GROUP \
  --name $VNET_NAME \
  --virtual-network $VNET_ID \
  --zone-name $ENVIRONMENT_DEFAULT_DOMAIN -e true

az network private-dns record-set a add-record \
  --resource-group $RESOURCE_GROUP \
  --record-set-name "*" \
  --ipv4-address $ENVIRONMENT_STATIC_IP \
  --zone-name $ENVIRONMENT_DEFAULT_DOMAIN

PowerShell

New-AzPrivateDnsZone -ResourceGroupName $ResourceGroupName -Name $EnvironmentDefaultDomain

New-AzPrivateDnsVirtualNetworkLink -ResourceGroupName $ResourceGroupName -Name $VnetName -VirtualNetwork $Vnet -ZoneName $EnvironmentDefaultDomain -EnableRegistration

$DnsRecords = @()
$DnsRecords += New-AzPrivateDnsRecordConfig -Ipv4Address $EnvironmentStaticIp

$DnsRecordArgs = @{
    ResourceGroupName = $ResourceGroupName
    ZoneName = $EnvironmentDefaultDomain
    Name = '*'
    RecordType = 'A'
    Ttl = 3600
    PrivateDnsRecords = $DnsRecords
}
New-AzPrivateDnsRecordSet @DnsRecordArgs

Hálózati paraméterek

Az öröklött fogyasztásalapú környezet használata esetén három opcionális hálózati paramétert definiálhat híváskor containerapp env create. Ezeket a beállításokat akkor használja, ha különálló címterületekkel rendelkező összekapcsolt VNet áll rendelkezésére. A tartományok explicit konfigurálása biztosítja, hogy a Container Apps-környezet által használt címek ne ütköznek a hálózati infrastruktúra más tartományaival.

Megjegyzés

Ezek a paraméterek csak az örökölt csak használatalapú környezettípusra vonatkoznak. Az alapértelmezett számításiprofil-profilok környezettípusa nem igényli ezeket a paramétereket.

Meg kell adnia mind a három tulajdonság értékét, vagy egyiket sem. Ha nincsenek megadva, a rendszer létrehozza az értékeket.

Bash

Paraméter	Leírás
platform-reserved-cidr	A környezetinfrastruktúra-szolgáltatásokhoz belsőleg használt címtartomány. A méretnek /23 és /12 közöttinek kell lennie, amikor a csak fogyasztási környezetet használja.
platform-reserved-dns-ip	A belső DNS-kiszolgálóhoz használt tartomány ip-címe platform-reserved-cidr . A cím nem lehet a tartomány első címe vagy a hálózati cím. Ha például platform-reserved-cidr be van állítva 10.2.0.0/16-re, akkor platform-reserved-dns-ip nem lehet 10.2.0.0 (a hálózati cím) vagy 10.2.0.1 (mivel az infrastruktúra lefoglalja ezt az IP-címet használatra). Ebben az esetben a DNS első használható IP-címe a következő.10.2.0.2
docker-bridge-cidr	A Docker-híd hálózatához rendelt címtartomány. Ennek a tartománynak a mérete /28 és /12 között kell lennie.

• A platform-reserved-cidr címtartományok és docker-bridge-cidr a címtartományok nem ütközhetnek egymással vagy a megadott alhálózat tartományaival. Emellett győződjön meg arról, hogy ezek a tartományok nem ütköznek a virtuális hálózat más címtartományaival.

• Ha ezek a tulajdonságok nincsenek megadva, a parancssori felület automatikusan létrehozza a tartományértékeket a virtuális hálózat címtartománya alapján a tartományütközések elkerülése érdekében.

PowerShell

Paraméter	Leírás
VnetConfigurationPlatformReservedCidr	A környezetinfrastruktúra-szolgáltatásokhoz belsőleg használt címtartomány. A méretnek /23 és /12 közöttinek kell lennie, amikor a csak fogyasztási környezetet használja.
VnetConfigurationPlatformReservedDnsIP	A belső DNS-kiszolgálóhoz használt tartomány ip-címe VnetConfigurationPlatformReservedCidr . A cím nem lehet a tartomány első címe vagy a hálózati cím. Ha például VnetConfigurationPlatformReservedCidr be van állítva 10.2.0.0/16-re, akkor VnetConfigurationPlatformReservedDnsIP nem lehet 10.2.0.0 (a hálózati cím) vagy 10.2.0.1 (mivel az infrastruktúra lefoglalja ezt az IP-címet használatra). Ebben az esetben a DNS első használható IP-címe a következő.10.2.0.2
VnetConfigurationDockerBridgeCidr	A Docker-híd hálózatához rendelt címtartomány. Ennek a tartománynak a mérete /28 és /12 között kell lennie.

• A VnetConfigurationPlatformReservedCidr címtartományok és VnetConfigurationDockerBridgeCidr a címtartományok nem ütközhetnek egymással, sem a megadott alhálózat tartományaival. Emellett győződjön meg arról, hogy ezek a tartományok nem ütköznek a virtuális hálózat más címtartományaival.

• Ha ezek a tulajdonságok nincsenek megadva, a tartományértékek automatikusan létrejönnek a virtuális hálózat címtartománya alapján a tartományütközések elkerülése érdekében.

Erőforrások takarítása

Ha nem folytatja az alkalmazás használatát, törölheti a saját tárolóalkalmazások erőforráscsoportját. Ez törli a Azure Container Apps példányt és az összes társított szolgáltatást. Törli azt az erőforráscsoportot is, amelyet a Container Apps szolgáltatás automatikusan létrehozott, és amely tartalmazza az egyéni hálózati összetevőket.

Figyelemfelhívás

Az alábbi parancs törli a megadott erőforráscsoportot és a benne lévő összes erőforrást. Ha az útmutató 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

PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -Force

További erőforrások

• A VNet hatókörű bejövő forgalom használatához be kell állítania a DNS-t.

Következő lépések

Automatikus skálázási viselkedés kezelése