教學課程：為Arc啟用的 AKS 建立 Azure Container Registry
適用於：Azure Stack HCI 22H2 上的 AKS、Windows Server 上的 AKS
Azure Container Registry 是容器映像的私人登錄。 私人容器登錄可讓您安全地建置及部署應用程式和自訂程式碼。
在本教學課程中，您會部署 Azure Container Registry 實例，並將容器映射推送至該實例，以用於 AKS。 您將學習如何：
- 建立 Azure Container Registry 執行個體
- 標記容器映像以進行 Azure Container Registry
- 將影像上傳至 Azure Container Registry
- 檢視登錄中的映像
在稍後的教學課程中，此 Azure Container Registry 實例會與 Kubernetes 叢集整合，並從映射部署應用程式。
開始之前
上一個教學課程說明如何為簡單的 Azure 投票應用程式建立容器映像。 如果您尚未建立 Azure Voting 應用程式映像，請回到教學課程 1 – 建立容器映像。
在本教學課程中，您必須執行 Azure CLI 2.0.53 版或更新版本。 執行 az --version 以尋找版本。 如果您需要安裝或升級，請參閱安裝 Azure CLI。
建立 Azure Container Registry
若要建立 Azure Container Registry 實例，您必須先有資源群組。 Azure 資源群組是在其中部署與管理 Azure 資源的邏輯容器。
使用 az group create 命令來建立資源群組。 在下列範例中，會在 eastus 區域中建立名為 myResourceGroup 的資源群組：
az group create --name myResourceGroup --location eastus
使用 az acr create 命令建立 Azure Container Registry 執行個體，並提供您自己的登錄名稱。 登錄名稱在 Azure 內必須是唯一的，且包含 5-50 個英數字元。 在本教程的后续部分，會使用 <acrName> 作為容器登錄名稱的預留位置。 提供您自己唯一的登錄名稱。
基本 SKU 對開發用途而言是最符合成本效益的進入點，可在儲存體和輸送量之間取得平衡。
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic
登入容器登錄
若要使用 ACR 執行個體，您必須先登入。 使用 az acr login 命令，並在上一個步驟中提供提供給容器登錄的唯一名稱：
az acr login --name <acrName>
此命令會在完成時 傳回登入成功 訊息。
標記容器映像
若要查看目前的本機映像清單，請使用 docker images 命令：
docker images
這個指令的輸出會顯示您目前本機映像的清單：
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 7 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
若要搭配使用 azure-vote-front 容器映射與 Azure Container Registry，請確定您已使用登錄的登入伺服器地址標記映像。 將容器映像推送到映像登錄時，此標籤可用於路由傳送。
若要取得登入伺服器位址，請使用 az acr list 命令並查詢 loginServer，如下所示：
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
現在，請以容器登錄的 acrLoginServer 位址標記您的本機 azure-vote-front 映像。 若要指出映像版本，請在映像名稱結尾處加上 :v1：
docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1
若要確認已套用標籤，請再次執行 Docker 映射 ：
docker images
映射會以 Azure Container Registry 實體位址和版本號碼標記：
REPOSITORY TAG IMAGE ID CREATED SIZE
mcr.microsoft.com/azuredocs/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mycontainerregistry.azurecr.io/azure-vote-front v1 84b41c268ad9 16 minutes ago 944MB
mcr.microsoft.com/oss/bitnami/redis 6.0.8 3a54a920bb6c 2 days ago 103MB
tiangolo/uwsgi-nginx-flask python3.6 a16ce562e863 6 weeks ago 944MB
將映像推送到登錄
建置並標記映射后，將 azure-vote-front 映射推送至您的 Azure Container Registry 實例。 使用 docker push 並提供您自己的 acrLoginServer 映像名稱位址，如下所示：
docker push <acrLoginServer>/azure-vote-front:v1
可能需要幾分鐘的時間才能完成影像推送至 Azure Container Registry。
列出登錄中的映像
若要傳回推送至 Azure Container Registry 實例的映射清單，請使用 az acr repository list 命令。 請提供您自己的 <acrName>，如下所示：
az acr repository list --name <acrName> --output table
下列範例輸出會將 azure-vote-front 映像列為登錄中的可用映像：
Result
----------------
azure-vote-front
若要查看特定映射的標記，請使用 az acr repository show-tags 命令：
az acr repository show-tags --name <acrName> --repository azure-vote-front --output table
下列範例輸出會顯示在先前的步驟中標記的 v1 映像：
Result
--------
v1
現在，您已有儲存在私人 Azure Container Registry 執行個體中的容器映像。 此映像會在下一個教學課程中從 Azure Container Registry 部署到 Kubernetes 叢集。
下一步
在本教學課程中，您已建立 Azure Container Registry 並推送映射，以用於 Kubernetes 叢集。 您已了解如何︰
- 建立 Azure Container Registry (ACR) 執行個體
- 標記 ACR 的容器映像
- 將映像上傳至 ACR
- 檢視登錄中的映像
請繼續進行下一個教學課程，了解如何在 Azure 中部署 Kubernetes 叢集。