快速入門：從本機原始程式碼建置和部署至 Azure Container Apps

發行項
05/07/2024

本文示範如何使用您選擇的程式設計語言，從本機原始程式碼建置微服務並將其部署至 Azure Container Apps。在本快速入門中，您會建立後端Web API服務，以傳回靜態的音樂專輯集合。

注意

此範例應用程式可在兩個版本中使用。來源包含 Dockerfile 的其中一個版本。另一個版本沒有 Dockerfile。選取最能反映原始程式碼的版本。如果您不熟悉容器，請選取頂端的 [無 Dockerfile ] 選項。

下列螢幕快照顯示您部署之專輯 API 服務的輸出。

來自專輯 API 端點的回應螢幕快照。

必要條件

若要完成此專案，您需要下列專案：

需求	指示
Azure 帳戶	如果您沒有帳戶，可免費建立帳戶。您需要 Azure 訂用帳戶的參與者或擁有者許可權才能繼續。如需詳細資訊，請參閱使用 Azure 入口網站指派 Azure 角色。
Azure CLI	安裝 Azure CLI。

設定

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

Bash
Azure PowerShell

az login

Connect-AzAccount

若要確保您執行最新版的 CLI，請執行升級命令。

Bash
Azure PowerShell

az upgrade

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

忽略目前使用中模組的任何警告。

接下來，安裝或更新 CLI 的 Azure Container Apps 擴充功能。

Bash
Azure PowerShell

az extension add --name containerapp --upgrade

Install-Module -Name Az.App

如果您已安裝舊版的 Az.App 模組，請加以更新。

Update-Module -Name Az.App

現在已安裝目前的擴充功能或模組，請註冊 Microsoft.App 和 Microsoft.OperationalInsights 命名空間。

注意

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

Bash
Azure PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

建立環境變數

現在，您的 Azure CLI 設定已完成，您可以定義本文中使用的環境變數。

Bash
Azure PowerShell

在您的 Bash 殼層中定義下列變數。

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"

在您的PowerShell控制台中定義下列變數。

$RESOURCE_GROUP="album-containerapps"
$LOCATION="canadacentral"
$ENVIRONMENT="env-album-containerapps"
$API_NAME="album-api"

取得範例程式碼

以您選擇的語言下載並擷取 API 範例應用程式。

將原始碼下載到您的電腦。

將下載解壓縮並變更至 containerapps-albumapi-csharp-main/src 資料夾。

將原始碼下載到您的電腦。

將下載並變更解壓縮至 containerapps-albumapi-csharp-buildpack/src 資料夾。

建置和部署容器應用程式

使用 containerapp up 命令建置並部署您的第一個容器應用程式。這個指令會：

建立資源群組
建立 Azure Container Registry
建置容器映像並將它推送至登錄
使用 Log Analytics 工作區建立 Container Apps 環境
使用建置的容器映像建立及部署容器應用程式

建立資源群組
在您的環境中建立預設登錄
使用適當的 Buildpack 來偵測應用程式的語言和運行時間，並建置映像
將映像推送至 Azure Container Apps 預設登錄
使用 Log Analytics 工作區建立 Container Apps 環境
使用建置的容器映像建立及部署容器應用程式

up命令會使用存放庫根目錄中的 Dockerfile 來建置容器映射。 EXPOSE Dockerfile 中的指示定義了目標埠，這是用來將輸入流量傳送至容器的埠。

up如果命令找不到 Dockerfile，它會自動使用 Buildpacks 將應用程式來源轉換成可執行的容器。由於 Buildpack 正嘗試代表您執行組建，因此您必須告訴 up 命令要傳送輸入流量的埠。

在下列程式代碼範例中 . ，（dot）會指示 containerapp up 在 src 擷取的範例 API 應用程式的目錄中執行。

Bash
Azure PowerShell

az containerapp up \
  --name $API_NAME \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --source .

az containerapp up \
  --name $API_NAME \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --ingress external \
  --target-port 8080 \
  --source .

重要

若要將容器應用程式部署至現有的資源群組，請將包含 --resource-group yourResourceGroup 至 containerapp up 命令。

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --source .

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --ingress external `
    --target-port 8080 `
    --source .

驗證部署

將 FQDN 複製到網頁瀏覽器。從網頁瀏覽器，移至 /albums FQDN 的端點。

來自專輯 API 端點的回應螢幕快照。

限制

上傳原始程式碼的大小上限為 200MB。如果上傳超過限制，則會傳回錯誤 413。

清除資源

如果您不打算繼續部署前端教學課程，您可以使用下列命令來移除本快速入門期間建立的 Azure 資源。

警告

下列命令會刪除指定的資源群組和其中包含的所有資源。如果群組包含本快速入門範圍以外的資源，也會加以刪除。

Bash
Azure PowerShell

az group delete --name $RESOURCE_GROUP

az group delete --name $RESOURCE_GROUP

提示

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

下一步

完成本快速入門之後，您可以繼續進行教學課程：Azure Container Apps 中的微服務之間的通訊，以瞭解如何部署呼叫 API 的前端應用程式。

教學課程：微服務之間的通訊

Share via