快速入門：在 Azure 容器應用程式中使用 Azure 應用程式組態

在本快速入門中，您會對 Azure 容器應用程式中執行的應用程式使用 Azure 應用程式組態。 如此一來，您就能在容器應用程式中集中儲存和管理您的應用程式設定。 本快速入門會利用快速入門：使用應用程式組態建立 ASP.NET 核心應用程式所建立的 ASP.NET Core 應用程式。 您將容器化應用程式並將其部署至 Azure 容器應用程式。 請先完成快速入門再繼續。

提示

遵循本快速入門時，最佳方式是在單一資源群組內註冊所有新資源，以便您在不需要新資源時可以集中一處將所有資源重新分組，並在稍後更快將其刪除。

必要條件

• 使用應用程式組態存放區的應用程式。 如果您沒有執行個體，請使用快速入門：使用應用程式組態建立 ASP.NET Core 應用程式建立執行個體。
• Azure 容器應用程式執行個體。 如果您沒有執行個體，請使用 Azure 入口網站 或 CLI 建立執行個體。
• Docker Desktop
• Azure CLI

---

將 Azure 應用程式組態連線至容器應用程式

在 Azure 入口網站中，導覽至您的容器應用程式執行個體。 請遵循適用於 Azure 容器應用程式的服務連接器快速入門，以使用下列設定來建立與應用程式組態存放區的服務連線。

• 在 [基本] 索引標籤中：

  • [服務類型] 請選取 [應用程式組態]

  • 挑選「應用程式設定」的應用程式組態

    

• 在 [驗證] 索引標籤中：

  • 針對 [連接字串的權限] 選擇 [連接字串] 驗證類型和 [唯讀]
  • 展開 [進階] 功能表。 在組態資訊中，應該已建立名為「AZURE_APPCONFIGURATION_CONNECTIONSTRING」的環境變數。 選取右側的圖示並將名稱變更為 ConnectionStrings__AppConfig，以編輯環境變數。 我們需要進行這項變更，因為 ConnectionStrings__AppConfig 是 ASP.NET Core 快速入門中所建置應用程式將會尋找的環境變數名稱。 這是環境變數，其中包含應用程式組態的連接字串。 如果您已使用另一個應用程式來遵循本快速入門，請使用對應的環境變數名稱。 然後，選取完成。

• 其他所有項目請使用預設值。

完成後，名為 ConnectionStrings__AppConfig 的環境變數會新增至您容器應用程式中的容器。 其值是容器應用程式秘密的參考，這是您應用程式組態存放區的連接字串。

建置容器

1. 執行 dotnet publish 命令，以發行模式建置應用程式，並在已發佈的資料夾建立資產。

   dotnet publish -c Release -o published
   

2. 在包含 .csproj 檔案的目錄中建立名為 Dockerfile 的檔案，然後在文字編輯器中講其開啟並輸入下列內容。 Dockerfile 是沒有副檔名文字檔，目的是用於建立容器映像。

   FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
   WORKDIR /app
   COPY published/ ./
   ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
   

3. 執行下列命令來建置容器。

   docker build --tag aspnetapp .
   

建立 Azure Container Registry 執行個體

建立 Azure Container Registry (ACR)。 ACR 可讓您建置、儲存及管理容器映像。

入口網站

1. 若要建立容器登錄，請遵循 Azure Container Registry 快速入門。
2. 部署完成後，請開啟您的 ACR 執行個體，然後從左側功能表中選取 [設定] > [存取金鑰]。
3. 記下此頁面所列的「登入伺服器」值。 您會在稍後的步驟中用到這項資訊。
4. 將 [管理使用者] 切換為 [已啟用]。 此選項可讓您使用系統管理使用者認證將 ACR 連線至 Azure 容器應用程式。 或者，您可以將其保持為停用狀態，並將容器應用程式設定為使用受控識別從登錄提取映像。

Azure CLI

1. 使用下列命令建立 ACR 執行個體。 其會建立名為「myregistry」的基本層登錄並啟用管理使用者，讓容器應用程式能夠使用系統管理員使用認證連線到登錄。 如需詳細資訊，請參閱 Azure Container Registry 快速入門。

   az acr create 
   --resource-group AppConfigTestResources \
   --name myregistry \
   --admin-enabled true \
   --sku Basic
   

2. 在命令輸出中，請記下 loginServer 之後所列的 ACR 登入伺服器值。

3. 執行 az acr credential show --name myregistry 以擷取 ACR 使用者名稱和密碼。 您稍後將需要這些值。

將映像推送至 Azure Container Registry

將 Docker 映像推送到之前建立的 ACR。

1. 執行 az acr login 命令以登入登錄。

   az acr login --name myregistry
   

   登入成功後，命令就會傳回 Login Succeeded。

2. 使用 docker 標籤 來標記適當的映像詳細資料。

   docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
   

   提示

   若要檢閱現有 Docker 映像和標籤清單，請執行 docker image ls。 在此案例中，您應該會看到至少兩個映像：aspnetapp 和 myregistry.azurecr.io/aspnetapp。

3. 使用 docker push 將映像推送至容器登錄。 此範例會在包含 aspnetapp 映像的 ACR 中建立 aspnetapp 存放庫。 在下列範例中，請使用 ACR 的登入伺服器值、映像名稱和映像標籤取代預留位置 <login-server、<image-name> 及 <tag>。

   方法:

   docker push <login-server>/<image-name>:<tag>
   

   範例：

   docker push myregistry.azurecr.io/aspnetapp:v1
   

4. 在 Azure 入口網站中開啟您的 Azure Container Registry，並確認在 [存放庫] 底下可以看到您的新存放庫。

   

將您容器映像新增至 Azure 容器應用程式

更新您的容器應用程式以從 ACR 載入容器映像。

1. 在 Azure 入口網站中，開啟您的 Azure 容器應用程式執行個體。

2. 在左側功能表的 [應用程式] 底下，選取 [容器]。

3. 選取 [編輯並部署]。

4. 在 [容器映像] 底下，按一下現有容器映像的名稱。

5. 更新下列設定：

   設定	建議的值	描述
   影像來源	Azure Container Registry	選取 [Azure Container Registry] 作為映像來源。
   驗證	管理員認證	使用先前在容器登錄中啟用的管理使用者認證選項。 如果您未啟用管理使用者，但已設定使用受控識別，則必須以手動方式輸入映像和標籤。
   登錄	myregistry.azurecr.io	選取您稍早建立的 Azure Container Registry。
   映像	aspnetapp	選取您稍早建立並推送至 ACR 的 Docker 映像。
   映像標籤	v1	從清單中選取您的映像標籤。

6. 選取 [儲存]，然後選取 [建立] 以將更新部署至 Azure 容器應用程式。

瀏覽至 Azure 容器應用程式的 URL

在 Azure 入口網站的 Azure 容器應用程式執行個體中，前往 [概觀] 索引標籤，然後開啟 [應用程式 URL]。

網頁如下所示：

清除資源

如果您不想繼續使用本文中建立的資源，請刪除在此處建立的資源群組，以避免產生費用。

重要

刪除資源群組是無法回復的動作。 資源群組和其中的所有資源都將被永久刪除。 請確定您不會誤刪錯誤的資源群組或資源。 如果您是在包含需保留其他資源的資源群組內部，建立本文的資源，則可以從每個資源各自的窗格中個別刪除每個資源，而不必刪除整個資源群組。

1. 登入 Azure 入口網站，然後選取 [資源群組]。
2. 在 [依名稱篩選] 方塊中，輸入您資源群組的名稱。
3. 在結果清單中，選取資源群組名稱以查看概觀。
4. 選取 [刪除資源群組]。
5. 系統將會要求您確認是否刪除資源群組。 輸入您資源群組的名稱以進行確認，然後選取 [刪除]。

不久後，系統便會刪除該資源群組及其所有的資源。

下一步

在本快速入門中，您將：

• 將 Azure 應用程式組態連線至 Azure 容器應用程式
• 使用 Docker 從具有應用程式組態設定的 ASP.NET Core 應用程式建置容器映像
• 建立 Azure Container Registry 執行個體
• 將映像推送至 Azure Container Registry 執行個體
• 將容器映像新增至 Azure 容器應用程式
• 瀏覽至 Azure 容器應用程式執行個體的 URL，其中已更新為您在應用程式組態存放區中所設定的設定。

受控識別可讓一個 Azure 資源存取另一個資源，並且不需要維護秘密。 您可以簡化從容器應用程式到其他 Azure 資源的存取。 如需詳細資訊，請參閱如何使用受控識別存取應用程式組態，以及如何 [使用受控識別存取 Container Registry]。

若要了解如何將 ASP.NET Core Web 應用程式設定為以動態方式重新整理設定設定，請繼續進行下一個教學課程。

啟用動態組態