在 Azure 中建置容器化的 Python Web 應用程式

本文是關於容器化與部署 Python 網頁應用程式到 Azure App 服務的五部分教學系列的第三部分。在第 2 部分中，你在本機上建置並執行了容器映像。本文中，你可以直接在 Azure Container Registry 建立同一個Python網頁應用程式，無需在本地安裝 Docker。在 Azure 建置映像通常比本地建置再推送到登錄檔更快更簡單。雲端映像建置也消除了開發環境中必須執行 Docker 的需求。

Azure App 服務可讓您使用 Docker Hub、Azure Container Registry 和 Azure DevOps 等平台的 CI/CD 管線來部署和執行容器化 Web 應用程式。當 Docker 映像檔進入 Azure Container Registry 後，你可以部署到 Azure App 服務。

先決條件

在開始之前，請確保你已完成這個教學系列的第二部分，內容涵蓋：

複製樣本庫（Django 或 Flask）。
建立 Azure 資源的資源群組。
在本地執行容器化應用程式以確認其運作。

您也會需要：

有效的 Azure 訂用帳戶。如果您還沒有帳戶，請建立免費帳戶。
Azure CLI 本地安裝（用於 Azure CLI 步驟）或存取 Azure Cloud Shell。
Visual Studio Code，並安裝了 Docker 擴充（用於 VS Code 步驟）。

這很重要

範例 Dockerfile 使用 python:3.8-slim 作為基礎映像。 Python 3.8 於 2024 年 10 月終止支援， 不再接收安全更新。更新你的 Dockerfile 以使用 python:3.12-slim 或 python:3.13-slim 用於生產部署。

此服務圖表會醒目提示本文所涵蓋的元件。

Azure CLI
VS代碼

建立 Azure Container Registry

如果你已經有 Azure Container Registry，可以跳過這個步驟，直接進入下一步。否則，請使用 Azure CLI 建立新的 Azure Container Registry。

你可以在 Azure Cloud Shell 執行Azure CLI指令，或在本地開發環境中安裝 Azure CLI。

注意

使用與本教學課程系列第 2 部分相同的名稱。

使用 az acr create 指令建立 Azure 容器登錄檔。

Bash
PowerShell

#!/bin/bash
# Use the resource group that you created in part 2 of this tutorial series.
RESOURCE_GROUP_NAME='msdocs-web-app-rg'
# REGISTRY_NAME must be unique within Azure and contain 5-50 alphanumeric characters.
# If the name is already taken, you'll receive an error. Choose a different name and retry.
REGISTRY_NAME='msdocscontainerregistryname'

echo "Creating Azure Container Registry $REGISTRY_NAME..."
az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Standard

# PowerShell syntax
# Use the resource group that you created in part 2 of this tutorial series.
$RESOURCE_GROUP_NAME='msdocs-web-app-rg'
# REGISTRY_NAME must be unique within Azure and contain 5-50 alphanumeric characters.
# If the name is already taken, you'll receive an error. Choose a different name and retry.
$REGISTRY_NAME='msdocscontainerregistryname'

Write-Output "Creating Azure Container Registry $REGISTRY_NAME..."
az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Standard

在命令的 JSON 輸出中，找出 loginServer 值。這個值代表完整登錄名稱（全部小寫），並包含登錄名稱。

範例輸出：

{
  "loginServer": "msdocscontainerregistryname.azurecr.io",
  "name": "msdocscontainerregistryname",
  ...
}

如果你是在本地機器上使用 Azure CLI，請執行 az acr login 指令登入容器登錄檔。
```
az acr login -n $REGISTRY_NAME
```
參數 -n 接受簡短登錄檔名稱（例如 msdocscontainerregistryname），或完全限定登錄檔名稱（msdocscontainerregistryname.azurecr.io）。此命令會使用您的 Azure CLI 憑證，讓 Docker 通過 Azure Container Registry 驗證。

預期產出：
```
Login Succeeded
```
注意

如果你用的是 Azure Cloud Shell，就不需要執行 az acr login 指令，因為你的 Cloud Shell 會話會自動處理認證。

在 Azure Container Registry 中建置映像檔

您可以透過各種方法直接在 Azure 中產生容器映像：

Azure Cloud Shell 讓你能完全在雲端建構映像檔，獨立於你的本地環境。
或者，你也可以用 VS Code 或 Azure CLI 從本地設定建立 Azure 映像檔，不需要本地執行 Docker。

你可以在本地開發環境中執行Azure CLI指令，方法是使用 Azure CLI 安裝或在 Azure Cloud Shell。

在主控台裡，前往你本教學系列第二部分複製的資料庫根目錄。

使用 az acr build 指令來建立容器映像檔。

地方發展：

az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest .

Azure Cloud Shell：

如果你用的是 Azure Cloud Shell，請指定 GitHub 儲存庫的 URL，而不是本地路徑（.）：

# For Django sample:
az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git

# For Flask sample:
az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git

最後一個參數（. 或 Git URL）是 Docker 建置上下文——包含 Docker 用來建置映像的 Dockerfile 與應用程式檔案的目錄。

請確認容器映像是用 az acr repository list 指令建立的。
```
az acr repository list -n $REGISTRY_NAME
```
預期產出：
```
[
  "msdocspythoncontainerwebapp"
]
```

建立 Azure Container Registry

如果你已經有 Azure Container Registry，可以跳過這個步驟。否則，請使用 VS Code 建立新的 Azure Container Registry。

這很重要

本節中的步驟假設您先前已完成本教學課程系列第 2 部分的 VS Code 區段。

在 VS Code 的 Docker 擴充功能中，前往 REGISTRIES，選擇 Azure 連接該Azure Container Registry。
在 VS Code 中，選擇 F1 或 CTRL+SHIFT+P 以開啟指令面板。然後輸入「registry」，接著選取 Azure Container Registry：建立登錄庫 工作。

或者，在 [Docker 擴充功能 REGISTRIES] 區段中，以滑鼠右鍵點擊您的訂閱，然後選取 [建立登錄]。此動作會啟動相同的建立登錄工作。
遵循提示並輸入下列值：
- 登錄檔名稱：輸入唯一名稱，例如 msdocscontainerregistryname。登錄檔名稱必須在 Azure 內全域唯一，且包含 5-50 個字母數字。如果名字已經有人用了，請選擇其他名字。
- SKU：選取 Standard。
- 資源群組：使用現有的資源群組。
在 Docker 延伸模組的 [REGISTRIES] 區段中，尋找您建立的登錄、單擊滑鼠右鍵，然後選取 [檢視屬性]。

在輸出中，找到 loginServer 該值——完全限定的登錄檔名稱（例如， msdocscontainerregistryname.azurecr.io）。

範例輸出：
```
{
  "loginServer": "msdocscontainerregistryname.azurecr.io",
  "name": "msdocscontainerregistryname",
  ...
}
```

在 Azure Container Registry 中建置映像檔

您可以透過各種方法直接在 Azure 中產生容器映像：

Azure Cloud Shell 讓你能完全在雲端建構映像檔，獨立於你的本地環境。
或者，你也可以用 VS Code 或 Azure CLI 從本地設定建立 Azure 映像檔，不需要本地執行 Docker。

這些步驟會要求 VS Code 在 Web 應用程式的工作資料夾中開啟。

在 Docker 擴充功能中，按兩下 [登錄] ，然後按兩下 [Azure ] 以連線到 Azure Container Registry。
選取 F1 或 CTRL+SHIFT+P 以開啟命令面板，輸入 “registry”，然後選取 Azure Container Registry：在 Azure 工作中建置映像檔。

如果您沒有看到這個工作，請確定 Azure 在 Docker 擴充功能的 REGISTRIES 底下出現。您也可以按滑鼠右鍵 Dockerfile，然後選取在 Azure 中的 [建置映像] 來執行此工作。
輸入下列值，並遵循提示來建立映像。
- 標記圖像：使用映像名稱「msdocspythoncontainerwebapp:latest」。
- 登錄提供者：選取 [Azure]。
- 訂用帳戶：選取您用來建立 Azure Container Registry 的訂用帳戶。
- 登錄：選取您所建立的登錄或您有權存取的登錄。
- 基底OS映像：選取 [Linux]。
檢查 [OUTPUT] 視窗，以取得組建的進度和資訊。如果您收到認證錯誤，請在 Docker 擴充功能的 [REGISTRIES] 區段中，右鍵點擊登錄，然後選取 [重新整理]。
確認 Azure Container Registry 中的映像。
1. 在 Docker 延伸模組的 [REGISTRIES] 區段中，尋找已建立的容器映像。你可能需要關閉再重新開啟 VS Code 才能看到圖片。
2. 確認名稱和標記最新。
CLI 驗證（可選）：

請使用 Azure CLI 驗證映像：
```
az acr repository list -n $REGISTRY_NAME
```
預期產出：
```
[
  "msdocspythoncontainerwebapp"
]
```

下一步

部署 Web 應用程式

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-06-01

在 Azure 中建置容器化的 Python Web 應用程式

先決條件

建立 Azure Container Registry

在 Azure Container Registry 中建置映像檔

下一步

意見反應

其他資源