教學課程：部署您的第一個容器應用程式

Azure 容器應用程式服務讓您在無伺服器平台上執行微服務和容器化應用程式。 使用容器應用程式，您會享受執行容器的優點，同時無須顧慮手動設定雲端基礎結構和複雜容器協調器的問題。

在本教學課程中，您會建立安全的 Container Apps 環境，並部署您的第一個容器應用程式。

注意

您也可以遵循快速入門：使用 containerapp up 部署您的第一個容器應用程式與 containerapp up一文中的指示，來部署此應用程式。 此命令 az containerapp up 是使用單一命令建置應用程式並將其部署至 Azure Container Apps 的快速且方便的方式。 不過，它不會為容器應用程式提供相同的自訂層級。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。
  • 如果您沒有存放庫，您可以免費建立一個。
• 安裝 Azure CLI。

安裝程式

若要開始，請登入 Azure。 執行下列命令，並遵循提示來完成驗證流程。

Bash

az login

Azure PowerShell

Connect-AzAccount

Bash

接下來，安裝 CLI 的 Azure 容器應用程式擴充功能。

az extension add --name containerapp --upgrade

Azure PowerShell

您必須安裝最新的 Az 模組。 請忽略目前使用中模組的所有警告。

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

現在請安裝 Az.App 模組。

Install-Module -Name Az.App

現在已安裝最新的延伸模組或模組，請註冊 Microsoft.App 命名空間。

注意

Azure 容器應用程式資源已從 Microsoft.Web 命名空間移轉至 Microsoft.App 命名空間。 如需詳細資訊，請參閱 2022 年 3 月將命名空間從 Microsoft.Web 移轉至 Microsoft.App。

Bash

az provider register --namespace Microsoft.App

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

如果您之前未曾使用過，請註冊 Azure 監視器 Log Analytics 工作區的 Microsoft.OperationalInsights 提供者。

Bash

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

接下來，請設定下列環境變數：

Bash

RESOURCE_GROUP="my-container-apps"
LOCATION="canadacentral"
CONTAINERAPPS_ENVIRONMENT="my-environment"

Azure PowerShell

$ResourceGroupName = 'my-container-apps'
$Location = 'canadacentral'
$ContainerAppsEnvironment = 'my-environment'

定義這些變數後，您可以建立資源群組來組織與新容器應用程式相關的服務。

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

透過 CLI 升級和可用的新資源群組，您可以建立容器應用程式環境並部署容器應用程式。

建立環境

Azure 容器應用程式中的環境會在容器應用程式群組周圍建立安全界限。 部署至相同環境的容器應用程式會部署在相同的虛擬網路中，並將記錄寫入相同的 Log Analytics 工作區。

Bash

若要建立環境，請執行下列命令：

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

Azure PowerShell

容器應用程式環境需要 Log Analytics 工作區。 下列命令會建立 Log Analytics 工作區，並將工作區識別碼和主要共用金鑰儲存至變數。

$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

建立容器應用程式

現在您已建立環境，您可以部署第一個容器應用程式。 使用 containerapp create 命令，將容器映射部署至 Azure 容器應用程式。

Bash

az containerapp create \
  --name my-container-app \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --target-port 80 \
  --ingress 'external' \
  --query properties.configuration.ingress.fqdn

注意

請確定 --image 參數的值是小寫。

將 --ingress 設定為 external，即可讓容器應用程式可供公用要求使用。

Azure PowerShell

$ImageParams = @{
    Name = 'my-container-app'
    Image = 'mcr.microsoft.com/k8se/quickstart:latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams
$EnvId = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).Id

$AppArgs = @{
    Name = 'my-container-app'
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    ManagedEnvironmentId = $EnvId
    IdentityType = 'SystemAssigned'
    TemplateContainer = $TemplateObj
    IngressTargetPort = 80
    IngressExternal = $true

}
New-AzContainerApp @AppArgs

注意

請確定 Image 參數的值是小寫。

將 IngressExternal 設定為 $true，即可讓容器應用程式可供公用要求使用。

驗證部署

Bash

create此命令會傳回容器應用程式的完整功能變數名稱。 將此位置複製到網頁瀏覽器。

Azure PowerShell

取得容器應用程式的完整功能變數名稱。

(Get-AzContainerApp -Name $AppArgs.Name -ResourceGroupName $ResourceGroupName).IngressFqdn

將此位置複製到網頁瀏覽器。

部署容器應用程式時會顯示下列訊息：

清除資源

如果您不打算繼續使用此應用程式，請執行下列命令來刪除資源群組，以及本教學課程中建立的所有資源。

警告

下列命令會刪除指定的資源群組和其中包含的所有資源。 如果本教學課程範圍以外的資源存在於指定的資源群組中，則也會一併刪除。

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -Force

提示

有問題嗎？ 在 Azure 容器應用程式存放庫中提出問題，讓我們在 GitHub 上了解該問題。

後續步驟

微服務之間的通訊