在 Azure 中執行自訂容器

Linux 上的 Azure App 服務提供 Linux 上預先定義的應用程式堆疊，並支援 .NET、PHP、Node.js 等語言。您也可以使用自定義 Docker 映射，在尚未在 Azure 中定義的應用程式堆疊上執行 Web 應用程式。本快速入門說明如何將映像從 Azure Container Registry （ACR）部署至 App Service。

注意

如需在無伺服器環境中執行容器化應用程式的相關信息，請參閱 Container Apps。

若要完成本快速入門，您需要：

Azure 帳戶
Docker
Visual Studio Code
VS Code 的 Azure App 服務延伸模組。您可以使用此延伸模組，在 Azure 平臺即服務（PaaS）上建立、管理及部署 Linux Web Apps。
適用於 VS Code 的 Docker 擴充功能。您可以使用此擴充功能來簡化本機 Docker 映像和命令的管理，以及將建置的應用程式映射部署至 Azure。

1 - 建立容器登錄

本快速入門使用 Azure Container Registry 做為選擇的登錄。您可以自由使用其他登錄，但步驟可能會稍有不同。

依照快速入門中的指示建立容器登錄：使用 Azure 入口網站建立私人容器登錄。

重要

請務必在建立 Azure 容器登錄時，將 [管理員使用者] 選項設定為 [啟用]。您也可以從登錄頁面的 [存取金鑰] 區段，在 Azure 入口網站中加以設定。 App Service 存取需要此設定。如需受控識別，請參閱從 ACR 部署教學課程。

啟動 Visual Studio Code。
選取活動列中的 Azure 標誌，流覽至 APP SERVICE 總管，然後選取 [登入 Azure]，然後遵循指示。
在底部的 [ 狀態欄 ] 中，確認您的 Azure 帳戶電子郵件位址。在 APP SERVICE 總管中，應該會顯示您的訂用帳戶。
在 [活動列] 中 ，選取 Docker 標誌。在 [REGISTRIES] 總管中，確認您建立的容器登錄隨即出現。

3 - 檢查必要條件

確認您已安裝並執行 Docker。如果 Docker 版本正在執行，下列命令將會顯示它。

docker --version

4 - 建立和建置映射

在 Visual Studio Code 中，開啟空的資料夾，並新增名為 Dockerfile的檔案。在 Dockerfile 中，根據您想要的語言架構貼上內容：

FROM mcr.microsoft.com/appsvc/dotnetcore:lts

ENV PORT 8080
EXPOSE 8080

ENV ASPNETCORE_URLS "http://*:${PORT}"

ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]

在此 Dockerfile 中，父映像是 App Service 的其中一個內建 .NET 容器。您可以在 GenerateDockerFiles/dotnetcore 底下的 Azure-App-Service/ImageBuilder GitHub 存放庫中找到其來源檔案。其 Dockerfile 會將簡單的 .NET 應用程式 /defaulthome/hostingstart複製到。您的 Dockerfile 只會啟動該應用程式。

FROM mcr.microsoft.com/appsvc/node:10-lts

ENV HOST 0.0.0.0
ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["pm2", "start", "--no-daemon", "/opt/startup/default-static-site.js"]

在此 Dockerfile 中，父映像是 App Service 的內建Node.js容器之一。您可以在 GenerateDockerFiles/node/node-template 底下的 Azure-App-Service/ImageBuilder GitHub 存放庫中找到其來源檔案。其 Dockerfile 會將簡單的Node.js應用程式 /opt/startup複製到。您的 Dockerfile 只會使用已由父映像安裝的 PM2 啟動該應用程式。

FROM mcr.microsoft.com/appsvc/python:latest

ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["gunicorn", "--timeout", "600", "--access-logfile", "'-'", "--error-logfile", "'-'", "--chdir=/opt/defaultsite", "application:app"]

在此 Dockerfile 中，父映像是 App Service 的其中一個內建 Python 容器。您可以在 GenerateDockerFiles/python/template-3.9 底下的 Azure-App-Service/ImageBuilder GitHub 存放庫中找到其來源檔案。其 Dockerfile 會將簡單的 Python 應用程式 /opt/defaultsite複製到。您的 Dockerfile 只會使用已由父映像安裝的 Gunicorn 來啟動該應用程式。

FROM mcr.microsoft.com/azure-app-service/java:11-java11_stable

ENV PORT 80
EXPOSE 80

ENTRYPOINT ["java", "-Dserver.port=80", "-jar", "/tmp/appservice/parkingpage.jar"]

在此 Dockerfile 中，父映像是 App Service 的其中一個內建 Java 容器。您可以在 Azure-App-Service/java GitHub 存放庫的 java/tree/dev/java11-alpine 下找到其來源檔案。其 Dockerfile 會將簡單的 Java 應用程式 /tmp/appservice複製到。您的 Dockerfile 只會啟動該應用程式。

開啟命令選擇區，然後輸入 Docker 映射：建置映像。輸入 Enter 以執行命令。
在 [映射卷標] 方塊中，以下列格式指定您想要的標記： <acr-name>.azurecr.io/<image-name>/<tag>，其中 <acr-name> 是您所建立容器登錄的名稱。按 Enter 鍵。
映射完成建置時，按兩下 [映像總管] 頂端的 [重新整理]，並確認映像已順利建置。

5 - 部署至容器登錄

在 [活動列] 中 ，按兩下 Docker 圖示。在 [映射 總管] 中，尋找您建置的映像。
展開映像，以滑鼠右鍵按下您想要的標籤，然後按兩下 [ 推送]。
請確定影像標籤開頭為 <acr-name>.azurecr.io ，然後按 Enter 鍵。
當 Visual Studio Code 完成將映像推送至容器登錄時，請按兩下 REGISTRIES 總管頂端的 [重新整理]，並確認已成功推送映像。

6 - 部署至 App Service

在 [REGISTRIES 總管] 中，展開映像，以滑鼠右鍵按兩下卷標，然後選取 [部署映像以 Azure App 服務]。
依照提示選擇訂用帳戶、全域唯一的應用程式名稱、資源群組和 App Service 方案。 選擇 [B1 基本] 作為定價層，以及您附近的區域。

部署之後，您的應用程式可在取得 http://<app-name>.azurewebsites.net。

資源群組是 Azure 中所有應用程式資源的具名集合。例如，資源群組可以包含網站、資料庫和 Azure 函式的參考。

App Service 方案會定義將用來裝載網站的實體資源。本快速入門會在Linux基礎結構上使用基本主控方案，這表示月臺將與其他網站一起裝載於Linux電腦上。如果您從基本方案開始，您可以使用 Azure 入口網站來相應增加，讓您的是計算機上唯一執行的月臺。如需定價，請參閱 App Service定價。

7 - 瀏覽網站

[ 輸出 ] 面板會顯示部署作業的狀態。作業完成時，請在快顯通知中選取 [ 開啟網站 ]，以在瀏覽器中開啟網站。

我遇到問題

8 - 清除資源

在上述步驟中，您已建立資源群組中的 Azure 資源。如果您預期未來不需要這些資源，則可以藉由刪除資源群組予以刪除。

從 Azure 入口網站功能表或 [首頁] 頁面，選取 [資源群組]。然後，在 [資源群組] 頁面上，選取 [myResourceGroup]。

在 [myResourceGroup] 頁面上，確定所列出的資源是您想要刪除的項目。

選取 [刪除資源群組]，在文字方塊中輸入 myResourceGroup，然後選取 [刪除]。

下一步

恭喜，您已成功完成本快速入門。

每次啟動時，App Service 應用程式都會從容器登錄提取。如果您重建映像，只需要將它推送至容器登錄，應用程式會在重新啟動時提取更新的映像。若要告知您的應用程式立即提取更新的映像，請重新啟動它。

使用下列命令複製 .NET 6.0 範例應用程式：

其他 Azure 擴充功能：

Azure Cosmos DB
Azure Functions
Azure CLI 工具
Azure Resource Manager \(英文\)
Azure Tools 擴充功能套件包含上述所有擴充功能。

Linux 上的 Azure App 服務提供 Linux 上預先定義的應用程式堆疊，並支援 .NET、PHP、Node.js 等語言。您也可以使用自定義 Docker 映射，在尚未在 Azure 中定義的應用程式堆疊上執行 Web 應用程式。本快速入門說明如何將映像從 Azure Container Registry 部署至 Azure App 服務。

注意

如需在無伺服器環境中執行容器化應用程式的相關信息，請參閱 Container Apps。

若要完成本快速入門，您需要：

1 - 複製範例存放庫

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - 將映射推送至 Azure Container Registry

請確定您位於複製存放庫的根資料夾中。此存放庫包含 Dockerfile.linux 檔案。

登入 Azure CLI。
```
az login
```
登入 Azure Container Registry。
```
az acr login -n <your_registry_name>
```

建置容器映像。我們將映像 命名為 dotnetcore-docs-hello-world-linux。

docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux .

將容器映像推送至 Azure Container Registry。
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
```
注意

Dockerfile 會將埠號碼設定為內部 80。如需設定容器的詳細資訊，請參閱設定自定義容器。

3 - 部署至 Azure

登入 Azure 入口網站。

建立 Azure 資源

在搜尋中輸入應用程式服務。在 [服務] 下，選取 [App Service]。
在 [App Service] 頁面中，選取 [+ 建立]。
在 [基本] 索引標籤的 [項目詳細數據] 底下，確定已選取正確的訂用帳戶，然後選取 [建立新的資源群組]。輸入 myResourceGroup 作為名稱。
在 [實例詳細數據] 底下，輸入 Web 應用程式的全域唯一名稱，然後選取 [Docker 容器]。針對 [操作系統] 選取 [Linux]。 選取您要從中提供應用程式的區域。
在 [App Service 方案] 底下，選取 [建立新的 App Service 方案]。輸入 myAppServicePlan 以取得名稱。若要變更為免費層，請選取 [變更大小]，選取 [開發/測試 ] 索引卷標，選取 F1，然後選取頁面底部的 [ 套用 ] 按鈕。
選取頁面底部的 [ 下一步：Docker] > 按鈕。
在 [Docker] 索引卷標中，針對 [映射來源] 選取 [選項] 和 [Azure Container Registry] 底下的 [單一容器]。在 [Azure Container Registry 選項] 底下，設定下列值：
- 登錄：選取您的 Azure Container Registry。
- 映射：選取 dotnetcore-docs-hello-world-linux。
- 標籤：選取最新。
選取頁面底部的 [檢閱 + 建立] 按鈕。
執行驗證後，選取頁面底部的按鈕。
當部署完成時，選取 [前往資源]。

4 - 瀏覽至應用程式

使用網頁瀏覽器瀏覽至已部署的應用程式 (URL 為 http://<app-name>.azurewebsites.net)。

顯示已部署應用程式的螢幕擷取畫面。

5 - 清理資源

在上述步驟中，您已建立資源群組中的 Azure 資源。如果您預期未來不需要這些資源，則可以藉由刪除資源群組予以刪除。

從 Azure 入口網站功能表或 [首頁] 頁面，選取 [資源群組]。然後，在 [資源群組] 頁面上，選取 [myResourceGroup]。

在 [myResourceGroup] 頁面上，確定所列出的資源是您想要刪除的項目。

選取 [刪除資源群組]，在文字方塊中輸入 myResourceGroup，然後選取 [刪除]。

下一步

恭喜，您已成功完成本快速入門。

使用下列命令複製 .NET 6.0 範例應用程式：

Azure App 服務會在 WINDOWS 上提供預先定義的應用程式堆疊，例如在 IIS 上執行的 ASP.NET 或Node.js。不過，預先設定的應用程式堆疊會鎖定操作系統，並防止低階存取。自定義 Windows 容器沒有這些限制，讓開發人員完全自定義容器，並讓容器化應用程式完整存取 Windows 功能。

本快速入門說明如何將 Windows 映像中的 ASP.NET 應用程式從 Azure Container Registry 部署至 Azure App 服務。

若要完成本快速入門，您需要：

1 - 複製範例存放庫

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - 將映射推送至 Azure Container Registry

請確定您位於複製存放庫的根資料夾中。此存放庫包含 Dockerfile.windows 檔案。我們將使用 Windows Nano Server 長期維護通道（LTSC） 2022 作為基本操作系統，明確呼叫我們的 Windows 基底。

注意

即使這是 Windows 容器，路徑仍然需要使用正斜線。如需詳細資訊，請參閱撰寫 Dockerfile 。

登入 Azure CLI。
```
az login
```
登入 Azure Container Registry。
```
az acr login -n <your_registry_name>
```

建置容器映像。我們將映像 命名為 dotnetcore-docs-hello-world-windows。

docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows .

將容器映像推送至 Azure Container Registry。
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
```
注意

Dockerfile 會將埠號碼設定為內部 80。如需設定容器的詳細資訊，請參閱設定自定義容器。

3 - 部署至 Azure

登入 Azure 入口網站。

建立 Azure 資源

在搜尋中輸入應用程式服務。在 [服務] 下，選取 [App Service]。
在 [App Service] 頁面中，選取 [+ 建立]。
在 [基本] 索引標籤的 [項目詳細數據] 底下，確定已選取正確的訂用帳戶，然後選取 [建立新的資源群組]。輸入 myResourceGroup 作為名稱。
在 [實例詳細數據] 底下，輸入 Web 應用程式的全域唯一名稱，然後選取 [Docker 容器]。針對 [操作系統] 選取 [Windows]。 選取您要從中提供應用程式的區域。
在 [App Service 方案] 底下，選取 [建立新的 App Service 方案]。輸入 myAppServicePlan 以取得名稱。若要變更為免費層，請選取 [變更大小]，選取 [開發/測試 ] 索引卷標，選取 P1v3，然後選取頁面底部的 [ 套用 ] 按鈕。
選取頁面底部的 [ 下一步：Docker] > 按鈕。
在 [Docker] 索引卷標中，選取 [映射來源] 的 [Azure Container Registry]。 在 [Azure Container Registry 選項] 底下，設定下列值：
- 登錄：選取您的 Azure Container Registry。
- 影像：選取 dotnetcore-docs-hello-world-windows。
- 標籤：選取最新。
選取頁面底部的 [檢閱 + 建立] 按鈕。
執行驗證後，選取頁面底部的按鈕。
當部署完成時，選取 [前往資源]。

4 - 瀏覽至應用程式

使用網頁瀏覽器瀏覽至已部署的應用程式 (URL 為 http://<app-name>.azurewebsites.net)。

Windows App Service 的螢幕快照，其中傳訊顯示未公開埠的容器將會在背景模式中執行。

請注意，主機操作系統會出現在頁尾中，確認我們正在 Windows 容器中執行。

5 - 清理資源

在上述步驟中，您已建立資源群組中的 Azure 資源。如果您預期未來不需要這些資源，則可以藉由刪除資源群組予以刪除。

從 Azure 入口網站功能表或 [首頁] 頁面，選取 [資源群組]。然後，在 [資源群組] 頁面上，選取 [myResourceGroup]。

在 [myResourceGroup] 頁面上，確定所列出的資源是您想要刪除的項目。

選取 [刪除資源群組]，在文字方塊中輸入 myResourceGroup，然後選取 [刪除]。

下一步

恭喜，您已成功完成本快速入門。

Azure App 服務應用程式監視概觀

Azure App 服務會在 Windows 上提供預先定義的應用程式堆疊，例如在 IIS 上執行的 ASP.NET 或Node.js。不過，預先設定的應用程式堆疊會鎖定操作系統，並防止低階存取。自定義 Windows 容器沒有這些限制，讓開發人員完全自定義容器，並讓容器化應用程式完整存取 Windows 功能。

本快速入門說明如何將 Windows 映像中的 ASP.NET 應用程式從 Microsoft 成品登錄部署到 Azure App 服務。

若要完成本快速入門，您需要：

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
Azure PowerShell。

1 - 連線至 Azure

使用 Connect-AzAccount 命令登入您的 Azure 帳戶，並遵循下列提示：

Connect-AzAccount

2 - 建立資源群組

使用 New-AzResourceGroup 命令來建立資源群組。 Azure 資源群組是在其中部署與管理 Azure 資源的邏輯容器。

下列範例會在 eastus 位置建立名為 myResourceGroup 的資源群組。若要查看 App Service 的所有支援位置，請執行 Get-AzLocation 命令。

New-AzResourceGroup -Name myResourceGroup -Location eastus

此命令會在完成後傳 Login Succeeded 回。

3 - 建立 App Service 方案

使用 New-AzAppServicePlan 命令建立新的 App Service 方案。

下列範例會在進階版 V3 定價層中建立名為 myAppServicePlan 的 App Service 方案。-Tier PremiumV3 參數 -HyperV 會指定 Windows 容器。

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

4 - 建立 Web 應用程式

使用 New-AzWebApp 命令建立新的應用程式：

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name 參數會指定 Web 應用程式名稱。
AppServicePlan 參數會指定 App Service 方案名稱。
Location 參數會指定位置。
ResourceGroupName 參數會指定資源群組的名稱。
ContainerImageName 參數會指定容器映像名稱和選擇性標記。

此命令可能需要幾分鐘才能完成。

5 - 瀏覽至應用程式

使用網頁瀏覽器瀏覽至已部署的應用程式 (URL 為 http://<app-name>.azurewebsites.net)。

Windows App Service 的螢幕快照，其中傳訊顯示未公開埠的容器將會在背景模式中執行。

6 - 清除資源

使用 Remove-AzResourceGroup 命令移除資源群組：

Remove-AzResourceGroup myResourceGroup

下一步

恭喜，您已成功完成本快速入門。

本快速入門說明如何將 windows 映射中的 ASP.NET 應用程式從 Microsoft 成品登錄部署到 Azure App 服務。

若要完成本快速入門，您需要：

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
Azure CLI

1 - 連線至 Azure

使用 az login 命令登入您的 Azure 帳戶，並遵循下列提示：

az login

2 - 建立資源群組

使用 az group create 命令建立資源群組。 Azure 資源群組是在其中部署與管理 Azure 資源的邏輯容器。

下列範例會在 eastus 位置建立名為 myResourceGroup 的資源群組。若要查看 App Service 的所有支援位置，請執行 az appservice list-locations 命令。

az group create --name myResourceGroup --location eastus

3 - 建立 App Service 方案

使用 az appservice plan create 命令在資源群組中建立App Service方案。

下列範例會在 P1V3 定價層中建立名為 myAppServicePlan 的 App Service 方案。--sku P1V3

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

注意

如果您遇到錯誤：「 此命令的行為已由下列擴充功能改變：appservice-kube」，請移除 appservice-kube 擴充功能。

4 - 建立 Web 應用程式

使用 az webapp create 命令，在 myAppServicePlan App Service 方案中建立自定義容器 Web 應用程式。別忘了以唯一的應用程式名稱取代 myContainerApp （有效字元為 a-z、 0-9和 -）。

az webapp create --name myContainerApp --plan myAppServicePlan --location eastus --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Name 參數會指定 Web 應用程式名稱。
AppServicePlan 參數會指定 App Service 方案名稱。
Location 參數會指定位置。
ResourceGroupName 參數會指定資源群組的名稱。
deployment-container-image-name 參數會指定容器映射名稱和選擇性標記。

5 - 瀏覽至應用程式

使用網頁瀏覽器瀏覽至已部署的應用程式 (URL 為 http://<app-name>.azurewebsites.net)。

Windows App Service 的螢幕快照，其中傳訊顯示未公開埠的容器將會在背景模式中執行。

6 - 清除資源

使用 az group delete 命令移除資源群組：

az group delete --no-wait --name <resource_group>

下一步

恭喜，您已成功完成本快速入門。