快速入门：使用命令行部署现有容器映像

借助 Azure 容器应用服务，可以在无服务器平台上运行微服务和容器化应用程序。使用容器应用，你可以享受运行容器的好处，同时无需手动配置云基础结构和复杂容器业务流程协调程序。

本文演示如何将现有容器部署到 Azure 容器应用。

注意

通过注册表用户名和密码支持专用注册表授权。

先决条件

具有活动订阅的 Azure 帐户。
- 如果没有帐户，可以免费创建一个帐户。
安装 Azure CLI。
访问公共或专用容器注册表，例如 Azure 容器注册表。

安装

若要从 CLI 登录到 Azure，请运行以下命令，然后按照提示完成身份验证过程。

Bash
PowerShell

az cloud set -n AzureChinaCloud
az login
# az cloud set -n AzureCloud   //means return to Public Azure.

Connect-AzAccount -Environment AzureChinaCloud

为了确保运行最新版本的 CLI，请运行升级命令。

Bash
PowerShell

az upgrade

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

忽略有关当前正在使用的模块的任何警告。

接下来，安装或更新适用于 CLI 的 Azure 容器应用扩展。

如果在 Azure CLI 中运行 az containerapp 命令，或在 PowerShell 中运行 Az.App 模块中的 cmdlet 时收到有关缺少参数的错误，请确保已安装最新版本的 Azure 容器应用扩展。

Bash
PowerShell

az extension add --name containerapp --upgrade

注意

从 2024 年 5 月开始，Azure CLI 扩展不再默认启用预览功能。要访问容器应用预览功能，请使用 --allow-preview true 安装容器应用扩展。

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

Install-Module -Name Az.App

请确保将 Az.App 模块更新到最新版本。

Update-Module -Name Az.App

现在已安装当前扩展或模块，接下来请注册 Microsoft.App 和 Microsoft.OperationalInsights 命名空间。

Bash
PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

设置环境变量。

设置以下环境变量。将 <PLACEHOLDERS> 替换为你自己的值：

Bash
PowerShell

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

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

创建 Azure 资源组

创建一个资源组来组织与你的容器应用部署相关的服务。

Bash
PowerShell

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

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

创建环境

Azure 容器应用中的环境围绕一组容器应用创建安全边界。部署到相同环境的容器应用部署在同一虚拟网络中，并将日志写入同一个 Log Analytics 工作区。

若要创建环境，请运行以下命令：

Bash
PowerShell

az containerapp env create \
  --name $CONTAINERAPPS_ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION"

容器应用环境需要 Log Analytics 工作区。以下命令创建 Log Analytics 工作区，并将工作区 ID 和主共享密钥保存到环境变量中。

$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

若要创建环境，请运行以下命令：

$EnvArgs = @{
    EnvName = $ContainerAppsEnvironment
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

创建容器应用

创建环境后，可以部署第一个容器应用。

设置环境变量。

将 <PLACEHOLDERS> 替换为你自己的值。你的用户主体名称通常采用电子邮件地址格式（例如 username@domain.com）。

Bash
PowerShell

CONTAINER_APP_NAME=my-container-app
KEY_VAULT_NAME=my-key-vault
USER_PRINCIPAL_NAME=<USER_PRINCIPAL_NAME>
SECRET_NAME=my-secret-name
CONTAINER_IMAGE_NAME=<CONTAINER_IMAGE_NAME>
REGISTRY_SERVER=<REGISTRY_SERVER>
REGISTRY_USERNAME=<REGISTRY_USERNAME>

$ContainerAppName = "my-container-app"
$KeyVaultName = "my-key-vault"
$UserPrincipalName = "<USER_PRINCIPAL_NAME>"
$SecretName = "my-secret-name"
$ContainerImageName = "<CONTAINER_IMAGE_NAME>"
$RegistryServer = "<REGISTRY_SERVER>"
$RegistryUsername = "<REGISTRY_USERNAME>"

创建密钥保管库。

使用 Azure 密钥保管库等服务存储容器注册表密码可始终保证这些值的安全。本部分中的步骤演示如何创建密钥保管库、将容器注册表密码存储到密钥保管库，然后检索密码以在代码中使用。
- Bash
- PowerShell
```
az keyvault create --name $KEY_VAULT_NAME --resource-group $RESOURCE_GROUP
```
安装密钥保管库模块。
```
Install-Module Az.KeyVault -Repository PSGallery -Force
```
```
New-AzKeyVault -Name "$KeyVaultName" -ResourceGroupName "$ResourceGroupName" -Location "$Location"
```

向用户帐户授予管理密钥保管库中的机密的权限。

Bash
PowerShell

KEY_VAULT_ID=$(az keyvault show --name $KEY_VAULT_NAME --query id --output tsv)
az role assignment create --role "Key Vault Secrets Officer" --assignee "$USER_PRINCIPAL_NAME" --scope "$KEY_VAULT_ID"

$KeyVault=Get-AzKeyVault -VaultName $KeyVaultName
New-AzRoleAssignment -SignInName "$UserPrincipalName" -RoleDefinitionName "Key Vault Secrets Officer" -Scope $KeyVault.ResourceID

将容器注册表密码存储在密钥保管库中。

将 <REGISTRY_PASSWORD> 替换为自己的值。

Bash
PowerShell

az keyvault secret set --vault-name $KEY_VAULT_NAME --name $SECRET_NAME --value "<REGISTRY_PASSWORD>"

$Secret = ConvertTo-SecureString -String "<REGISTRY_PASSWORD>" -AsPlainText -Force
Set-AzKeyVaultSecret -VaultName "$KeyVaultName" -Name "$SecretName" -SecretValue "$Secret"

从密钥保管库检索容器注册表密码。

Bash
PowerShell

REGISTRY_PASSWORD=$(az keyvault secret show --name $SECRET_NAME --vault-name $KEY_VAULT_NAME --query value --output tsv)

$RegistryPassword = Get-AzKeyVaultSecret -VaultName "$KeyVaultName" -Name "$SecretName" -AsPlainText

将容器映像部署到 Azure 容器应用。

Bash
PowerShell

az containerapp create \
  --name $CONTAINER_APP_NAME \
  --location $LOCATION \
  --resource-group $RESOURCE_GROUP \
  --image $CONTAINER_IMAGE_NAME \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --registry-server $REGISTRY_SERVER \
  --registry-username $REGISTRY_USERNAME \
  --registry-password $REGISTRY_PASSWORD

如果已在容器应用上启用了入口，可以将 --query properties.configuration.ingress.fqdn 添加到 create 命令以返回应用程序的公共 URL。

$EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).Id

$TemplateObj = New-AzContainerAppTemplateObject -Name $ContainerAppName -Image $ContainerImageName

$RegistrySecretObj = New-AzContainerAppSecretObject -Name $SecretName -Value $RegistryPassword

$RegistryArgs = @{
    PasswordSecretRef = $SecretName
    Server = $RegistryServer
    Username = $RegistryUsername
}

$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

$ContainerAppArgs = @{
    Name = $ContainerAppName
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $RegistrySecretObj
}

New-AzContainerApp @ContainerAppArgs

设置环境变量。

Bash
PowerShell

CONTAINER_APP_NAME=my-container-app
CONTAINER_IMAGE_NAME=mcr.microsoft.com/k8se/quickstart:latest

$ContainerAppName = "my-container-app"
$ContainerImageName = "mcr.microsoft.com/k8se/quickstart:latest"

将容器映像部署到 Azure 容器应用。

Bash
PowerShell

az containerapp create \
  --image $CONTAINER_IMAGE_NAME \
  --name $CONTAINER_APP_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT

如果已在容器应用上启用了入口，可以将 --query properties.configuration.ingress.fqdn 添加到 create 命令以返回应用程序的公共 URL。

$TemplateObj = New-AzContainerAppTemplateObject -Name $ContainerAppName  -Image $ContainerImageName

$EnvId = (Get-AzContainerAppManagedEnv -ResourceGroupName $ResourceGroupName -EnvName $ContainerAppsEnvironment).Id

$ContainerAppArgs = @{
    Name = $ContainerAppName
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
}

New-AzContainerApp @ContainerAppArgs

验证部署

若要验证部署是否成功，可以查询 Log Analytics 工作区。在部署后，分析结果第一次到达可能需要等待几分钟，然后你才能查询日志。这取决于容器应用中实现的控制台日志记录。

使用以下命令查看控制台日志消息。

Bash
PowerShell

LOG_ANALYTICS_WORKSPACE_CLIENT_ID=`az containerapp env show --name $CONTAINERAPPS_ENVIRONMENT --resource-group $RESOURCE_GROUP --query properties.appLogsConfiguration.logAnalyticsConfiguration.customerId --out tsv`

az monitor log-analytics query \
  --workspace $LOG_ANALYTICS_WORKSPACE_CLIENT_ID \
  --analytics-query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == $CONTAINER_APP_NAME | project ContainerAppName_s, Log_s, TimeGenerated" \
  --out table

$queryResults = Invoke-AzOperationalInsightsQuery -WorkspaceId $WorkspaceId -Query "ContainerAppConsoleLogs_CL | where ContainerAppName_s == $ContainerAppName | project ContainerAppName_s, Log_s, TimeGenerated"
$queryResults.Results

清理资源

如果你不打算继续使用此应用程序，请运行以下命令以删除资源组以及本快速入门中创建的所有资源。

注意

以下命令删除指定的资源组及其包含的所有资源。如果指定的资源组中存在本快速入门范围外的资源，这些资源也会被删除。

Bash
PowerShell

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroupName -Force

提示

遇到问题？在 Azure 容器应用存储库中提交问题，告知我们有关 GitHub 的信息。

后续步骤

微服务之间的通信

Last updated on 2025-10-24

次の方法で共有

快速入门：使用命令行部署现有容器映像

先决条件

安装

设置环境变量。

创建 Azure 资源组

创建环境

创建容器应用

验证部署

清理资源

后续步骤

その他のリソース