教程：生成应用并将其部署到 Azure 容器应用

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

Connect-AzAccount -Environment AzureChinaCloud

az upgrade

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

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

az extension add --name containerapp --upgrade

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

Install-Module -Name Az.App

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

Update-Module -Name Az.App

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

在 bash shell 中定义以下变量。

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

选择专辑 API 存储库顶部的“创建分支”按钮，以在你的帐户中创建该存储库的分支。

现在可以克隆示例存储库的分支。

使用以下 git 命令将分支存储库克隆到 code-to-cloud 文件夹：

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-csharp.git code-to-cloud

选择专辑 API 存储库顶部的“创建分支”按钮，以在你的帐户中创建该存储库的分支。

现在可以克隆示例存储库的分支。

使用以下 git 命令将分支存储库克隆到 code-to-cloud 文件夹：

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-go.git code-to-cloud

选择专辑 API 存储库顶部的“创建分支”按钮，以在你的帐户中创建该存储库的分支。

现在可以克隆示例存储库的分支。

使用以下 git 命令将分支存储库克隆到 code-to-cloud 文件夹：

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-java.git code-to-cloud

选择专辑 API 存储库顶部的“创建分支”按钮，以在你的帐户中创建该存储库的分支。

现在可以克隆示例存储库的分支。

使用以下 git 命令将分支存储库克隆到 code-to-cloud 文件夹：

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-javascript.git code-to-cloud

选择专辑 API 存储库顶部的“创建分支”按钮，以在你的帐户中创建该存储库的分支。

现在可以克隆示例存储库的分支。

使用以下 git 命令将分支存储库克隆到 code-to-cloud 文件夹：

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-python.git code-to-cloud

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

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

az acr create \
  --resource-group $RESOURCE_GROUP \
  --name $ACR_NAME \
  --sku Basic \
  --admin-enabled true

$acr = New-AzContainerRegistry -ResourceGroupName $ResourceGroup -Name $ACRName -Sku Basic -EnableAdminUser

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

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

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

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

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

New-AzContainerAppManagedEnv @EnvArgs

az containerapp create \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.cn/$API_NAME \
  --target-port 8080 \
  --ingress external \
  --registry-server $ACR_NAME.azurecr.cn \
  --query properties.configuration.ingress.fqdn

• 通过将 --ingress 设置为 external，可以从公共 Internet 访问你的容器应用。

• target-port 设置为 8080，以匹配容器正在为请求侦听的端口。

• 如果未指定 query 属性，对 az containerapp create 的调用会返回一条 JSON 响应，其中包含丰富的有关应用程序的详细信息。 添加查询参数可将输出筛选成应用的完全限定的域名 (FQDN)。

若要创建容器应用，请创建模板对象，这些对象将作为参数传递到 New-AzContainerApp 命令。

创建模板对象以定义容器映像参数。

$ImageParams = @{
    Name = $APIName
    Image = $ACRName + '.azurecr.cn/' + $APIName + ':latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

运行以下命令以获取注册表凭据。

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

创建注册表凭据对象来定义注册表信息，并创建机密对象来定义注册表密码。 PasswordSecretRef 是指机密对象中的 Name。

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

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

获取环境 ID。

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

创建容器应用。

$AppArgs = @{
    Name = $APIName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 8080
    IngressExternal = $true
}
$MyApp = New-AzContainerApp @AppArgs

# show the app's fully qualified domain name (FQDN).
$MyApp.IngressFqdn

• 通过将 IngressExternal 设置为 external，可以从公共 Internet 访问你的容器应用。
• IngressTargetPort 参数设置为 8080，以匹配容器正在为请求侦听的端口。

az group delete --name $RESOURCE_GROUP

Remove-AzResourceGroup -Name $ResourceGroup -Force