Poskytnutí virtuální sítě prostředí Azure Container Apps

Následující příklad ukazuje, jak vytvořit prostředí Container Apps v existující virtuální síti (VNet).

Začněte přihlášením k webu Azure Portal.

Vytvoření aplikace typu kontejner

Pokud chcete vytvořit aplikaci kontejneru, začněte na domovské stránce webu Azure Portal.

1. Na horním panelu hledání vyhledejte Container Apps .
2. Ve výsledcích hledání vyberte KontejnerOvé aplikace .
3. Vyberte tlačítko Vytvořit.

Karta Základní informace

Na kartě Základy proveďte následující akce.

1. Do části Podrobnosti projektu zadejte následující hodnoty.

   Nastavení	Akce
   Předplatné	Vyberte své předplatné Azure.
   Skupina zdrojů	Vyberte Vytvořit nový a zadejte my-container-apps.
   Název kontejnerové aplikace	Zadejte my-container-app.
   Zdroj nasazení	Vyberte image kontejneru.

Vytvořit prostředí

Dále vytvořte prostředí pro vaši aplikaci kontejneru.

1. Vyberte příslušnou oblast.

   Nastavení	Hodnota
   Oblast	Vyberte USA – střed.

2. V poli Vytvořit prostředí Container Apps vyberte odkaz Vytvořit nový.

3. Na stránce Vytvořit prostředí Container Apps na kartě Základy zadejte následující hodnoty:

   Nastavení	Hodnota
   Název prostředí	Zadejte moje prostředí.
   Typ prostředí	Vyberte profily úloh.
   Zónová redundance	Vyberte Zakázáno.

4. Vyberte kartu Monitorování a vytvořte pracovní prostor služby Log Analytics.

5. Jako cíl protokolů vyberte Azure Log Analytics.

6. V poli Pracovního prostoru služby Log Analytics vyberte odkaz Vytvořit nový a zadejte následující hodnoty.

   Nastavení	Hodnota
   Name	Zadejte my-container-apps-logs.

   Pole Umístění je předem vyplněné střední USA .

7. Vyberte OK.

Máte také možnost nasadit privátní DNS pro vaše prostředí Container Apps. Další informace najdete v tématu Vytvoření a konfigurace zóny Azure Privátní DNS.

Vytvoření virtuální sítě

Poznámka:

Pokud chcete použít virtuální síť s kontejnerovými aplikacemi, musí mít virtuální síť vyhrazenou podsíť s rozsahem /23 CIDR nebo větší, pokud používáte pouze prostředí Consumption, nebo rozsah /27 CIDR nebo větší při použití prostředí profilů úloh. Další informace o nastavení velikosti podsítě najdete v přehledu síťové architektury.

1. Vyberte kartu Sítě.

2. Vyberte Ano vedle možnosti Použít vlastní virtuální síť.

3. Vedle pole Virtuální síť vyberte vytvořit nový odkaz a zadejte následující hodnotu.

   Nastavení	Hodnota
   Name	Zadejte my-custom-vnet.

4. Vyberte tlačítko OK.

5. Vedle pole Podsíť Infrastruktury vyberte vytvořit nový odkaz a zadejte následující hodnoty:

   Nastavení	Hodnota
   Název podsítě	Zadejte podsíť infrastruktury.
   Blok adres virtuální sítě	Ponechte výchozí hodnoty.
   Blok adresy podsítě	Ponechte výchozí hodnoty.

6. Vyberte tlačítko OK.

7. V části Virtuální IP adresa vyberte Externí pro externí prostředí nebo Interní pro interní prostředí.

8. Vyberte Vytvořit.

Nasazení aplikace typu kontejner

1. Vyberte Zkontrolovat a vytvořte v dolní části stránky.

   Pokud se nenašly žádné chyby, tlačítko Vytvořit je povolené.

   Pokud dojde k chybám, označí se všechny karty obsahující chyby červenou tečkou. Přejděte na příslušnou kartu. Pole obsahující chybu jsou červeně zvýrazněná. Po opravení všech chyb vyberte Zkontrolovat a vytvořit znovu.

2. Vyberte Vytvořit.

   Zobrazí se stránka se zprávou Probíhá nasazení . Po úspěšném dokončení nasazení se zobrazí zpráva: Vaše nasazení je dokončené.

Požadavky

• Účet Azure s aktivním předplatným.
  • Pokud jej nemáte, můžete si jej zdarma vytvořit.
• Nainstalujte Azure CLI verze 2.28.0 nebo vyšší.

Nastavení

Pokud se chcete přihlásit k Azure z rozhraní příkazového řádku, spusťte následující příkaz a podle pokynů dokončete proces ověřování.

Udeřit

az login

Azure PowerShell

Connect-AzAccount

Pokud chcete zajistit, že používáte nejnovější verzi rozhraní příkazového řádku, spusťte příkaz upgrade.

Udeřit

az upgrade

Azure PowerShell

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

Ignorujte všechna upozornění na aktuálně používané moduly.

Dále nainstalujte nebo aktualizujte rozšíření Azure Container Apps pro rozhraní příkazového řádku.

Pokud se při spouštění az containerapp příkazů v Azure CLI nebo rutinách Az.App z modulu v Azure PowerShellu zobrazí chyby týkající se chybějících parametrů, ujistěte se, že máte nainstalovanou nejnovější verzi rozšíření Azure Container Apps.

Udeřit

az extension add --name containerapp --upgrade

Poznámka:

Od května 2024 už rozšíření Azure CLI ve výchozím nastavení nepovolují funkce ve verzi Preview. Pokud chcete získat přístup k funkcím Container Apps ve verzi Preview, nainstalujte rozšíření Container Apps pomocí --allow-preview truenástroje .

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

Azure PowerShell

Install-Module -Name Az.App

Nezapomeňte aktualizovat Az.App modul na nejnovější verzi.

Update-Module -Name Az.App

Teď, když je nainstalované aktuální rozšíření nebo modul, zaregistrujte obory Microsoft.App názvů a Microsoft.OperationalInsights obory názvů.

Udeřit

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Nastavení proměnných prostředí

Nastavte následující proměnné prostředí. <PLACEHOLDERS> Nahraďte hodnotami:

Udeřit

RESOURCE_GROUP="<RESOURCE_GROUP>"
LOCATION="<LOCATION>"
CONTAINERAPPS_ENVIRONMENT="<CONTAINERAPPS_ENVIRONMENT>"

Azure PowerShell

$ResourceGroupName = '<RESOURCE_GROUP>'
$Location = '<LOCATION>'
$ContainerAppsEnvironment = '<CONTAINERAPPS_ENVIRONMENT>'

Vytvoření skupiny prostředků Azure

Vytvořte skupinu prostředků pro uspořádání služeb souvisejících s nasazením aplikace kontejneru.

Udeřit

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Vytvořit prostředí

Prostředí v Azure Container Apps vytvoří zabezpečenou hranici kolem skupiny kontejnerových aplikací. KontejnerOvé aplikace nasazené do stejného prostředí se nasazují ve stejné virtuální síti a zapisují protokoly do stejného pracovního prostoru služby Log Analytics.

Zaregistrujte Microsoft.ContainerService poskytovatele.

Udeřit

az provider register --namespace Microsoft.ContainerService

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.ContainerService

Deklarujte proměnnou, která bude obsahovat název virtuální sítě.

Udeřit

VNET_NAME="my-custom-vnet"

Azure PowerShell

$VnetName = 'my-custom-vnet'

Teď vytvořte virtuální síť, která se přidruží k prostředí Container Apps. Virtuální síť musí mít k dispozici podsíť pro nasazení prostředí.

Udeřit

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

Azure 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

Při použití prostředí profilů úloh je potřeba aktualizovat virtuální síť tak, aby delegování podsítě na Microsoft.App/environments. Toto delegování není potřeba pro prostředí jen pro spotřebu.

Udeřit

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

Azure 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

Po vytvoření virtuální sítě teď můžete zadat dotaz na ID podsítě infrastruktury.

Udeřit

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:]'`

Azure PowerShell

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

Nakonec vytvořte prostředí Container Apps pomocí vlastní virtuální sítě.

Udeřit

Pokud chcete vytvořit prostředí, spusťte následující příkaz. Chcete-li vytvořit interní prostředí, přidejte --internal-only.

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

Následující tabulka popisuje parametry použité s containerapp env create.

Parametr	Popis
name	Název prostředí Container Apps.
resource-group	Název skupiny prostředků.
logs-workspace-id	(Volitelné) ID existujícího pracovního prostoru služby Log Analytics. Pokud tento parametr vynecháte, vytvoří se pro vás pracovní prostor.
logs-workspace-key	Tajný klíč klienta Log Analytics. Vyžaduje se, pokud používáte existující pracovní prostor.
location	Umístění Azure, ve kterém se prostředí nasazuje.
infrastructure-subnet-resource-id	ID prostředku podsítě pro komponenty infrastruktury a kontejnery uživatelských aplikací
internal-only	(Volitelné) Prostředí nepoužívá veřejnou statickou IP adresu, pouze interní IP adresy dostupné ve vlastní virtuální síti. (Vyžaduje ID prostředku podsítě infrastruktury.)

Azure PowerShell

Pro prostředí Container Apps se vyžaduje pracovní prostor služby Log Analytics. Následující příkazy vytvoří pracovní prostor služby Log Analytics a uloží ID pracovního prostoru a primární sdílený klíč do proměnných prostředí.

$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

Pokud chcete vytvořit prostředí, spusťte následující příkaz. Nahraďte <INTERNAL> interním prostředím $true nebo $false v závislosti na tom, jestli chcete použít interní prostředí.

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

Následující tabulka popisuje parametry použité pro New-AzContainerAppManagedEnv.

Parametr	Popis
EnvName	Název prostředí Container Apps.
ResourceGroupName	Název skupiny prostředků.
LogAnalyticConfigurationCustomerId	ID existujícího pracovního prostoru služby Log Analytics.
LogAnalyticConfigurationSharedKey	Tajný klíč klienta Log Analytics.
Location	Umístění Azure, ve kterém se prostředí nasazuje.
VnetConfigurationInfrastructureSubnetId	ID prostředku podsítě pro komponenty infrastruktury a kontejnery uživatelských aplikací
VnetConfigurationInternal	(Volitelné) Pokud $trueprostředí nepoužívá veřejnou statickou IP adresu, budou ve vlastní virtuální síti dostupné jenom interní IP adresy. (Vyžaduje ID prostředku podsítě infrastruktury.)

Volitelná konfigurace

Máte možnost nasadit privátní DNS a definovat vlastní rozsahy síťových IP adres pro vaše prostředí Container Apps.

Nasazení s využitím privátního DNS

Pokud chcete nasadit aplikaci kontejneru s privátním DNS, spusťte následující příkazy.

Nejprve extrahujte identifikovatelné informace z prostředí.

Udeřit

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 '"'`

Azure PowerShell

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

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

Dále nastavte privátní DNS.

Udeřit

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

Azure 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

Síťové parametry

Existují tři volitelné síťové parametry, které můžete definovat při volání containerapp env create. Tyto možnosti použijte, pokud máte partnerský virtuální síť s samostatnými rozsahy adres. Explicitní konfigurace těchto rozsahů zajišťuje, že adresy používané prostředím Container Apps nejsou v konfliktu s jinými rozsahy v síťové infrastruktuře.

Je nutné zadat hodnoty pro všechny tři z těchto vlastností, nebo žádné z nich. Pokud nejsou zadané, vygenerují se vám hodnoty.

Udeřit

Parametr	Popis
platform-reserved-cidr	Rozsah adres používaný interně pro služby infrastruktury prostředí. Musí mít velikost mezi /23 a /12 při použití jediného prostředí Consumption.
platform-reserved-dns-ip	IP adresa z rozsahu platform-reserved-cidr , který se používá pro interní server DNS. Adresa nemůže být první adresou v rozsahu ani síťová adresa. Pokud platform-reserved-cidr je například nastavená hodnota 10.2.0.0/16, platform-reserved-dns-ip nemůže být 10.2.0.0 (síťová adresa) nebo 10.2.0.1 (infrastruktura si vyhrazuje použití této IP adresy). V tomto případě by první použitelná IP adresa pro DNS byla 10.2.0.2.
docker-bridge-cidr	Rozsah adres přiřazený k síti mostu Docker. Tento rozsah musí mít velikost mezi /28 a /12.

• Rozsahy platform-reserved-cidr adres docker-bridge-cidr spolu nemůžou být v konfliktu ani s rozsahy poskytnuté podsítě. Dále se ujistěte, že tyto rozsahy nejsou v konfliktu s žádným jiným rozsahem adres ve virtuální síti.

• Pokud tyto vlastnosti nejsou zadané, rozhraní příkazového řádku automaticky vygeneruje hodnoty rozsahu na základě rozsahu adres virtuální sítě, aby nedocházelo ke konfliktům rozsahu.

Azure PowerShell

Parametr	Popis
VnetConfigurationPlatformReservedCidr	Rozsah adres používaný interně pro služby infrastruktury prostředí. Musí mít velikost mezi /23 a /12 při použití jediného prostředí Consumption.
VnetConfigurationPlatformReservedDnsIP	IP adresa z rozsahu VnetConfigurationPlatformReservedCidr , který se používá pro interní server DNS. Adresa nemůže být první adresou v rozsahu ani síťová adresa. Pokud VnetConfigurationPlatformReservedCidr je například nastavená hodnota 10.2.0.0/16, VnetConfigurationPlatformReservedDnsIP nemůže být 10.2.0.0 (síťová adresa) nebo 10.2.0.1 (infrastruktura si vyhrazuje použití této IP adresy). V tomto případě by první použitelná IP adresa pro DNS byla 10.2.0.2.
VnetConfigurationDockerBridgeCidr	Rozsah adres přiřazený k síti mostu Docker. Tento rozsah musí mít velikost mezi /28 a /12.

• Rozsahy VnetConfigurationPlatformReservedCidr adres VnetConfigurationDockerBridgeCidr spolu nemůžou být v konfliktu ani s rozsahy poskytnuté podsítě. Dále se ujistěte, že tyto rozsahy nejsou v konfliktu s žádným jiným rozsahem adres ve virtuální síti.

• Pokud tyto vlastnosti nejsou zadané, hodnoty rozsahu se automaticky vygenerují na základě rozsahu adres virtuální sítě, aby nedocházelo ke konfliktům rozsahu.

Vyčištění prostředků

Pokud tuto aplikaci nebudete dál používat, můžete odstranit skupinu prostředků my-container-apps . Tím se odstraní instance Azure Container Apps a všechny přidružené služby. Odstraní také skupinu prostředků, kterou služba Container Apps automaticky vytvořila a která obsahuje vlastní síťové komponenty.

Upozornění

Následující příkaz odstraní zadanou skupinu prostředků a všechny prostředky obsažené v ní. Pokud prostředky mimo rozsah tohoto průvodce existují v zadané skupině prostředků, odstraní se také.

Udeřit

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Další materiály

• Pokud chcete použít příchozí přenos dat v oboru virtuální sítě, musíte nastavit DNS.

Další kroky

Správa chování automatického škálování