快速入門:使用 Azure 入口網站建立 Azure Container Registry

Azure Container Registry 是私人登錄服務,用於建置、儲存和管理容器映像和相關成品。 在本快速入門中,您會使用 Azure 入口網站建立 Azure 容器登錄執行個體。 然後,使用 Docker 命令將容器映像推送到登錄中,最後從您的登錄中提取映像並加以執行。

若要登入登錄以使用容器映像,您在進行此快速入門時必須執行 Azure CLI (建議使用 2.0.55 版或更新版本)。 執行 az --version 以尋找版本。 如果您需要安裝或升級,請參閱安裝 Azure CLI

您也必須在本機安裝 Docker,並執行精靈。 Docker 提供可在任何 MacWindowsLinux 系統上輕鬆設定 Docker 的套件。

登入 Azure

登入 Azure 入口網站

建立容器登錄

選取 [建立資源]>[容器]>[容器登錄]

Navigate to container registry in portal

在 [基本] 索引標籤中,輸入 [資源群組] 和 [登錄名稱] 的值。 登錄名稱在 Azure 內必須是唯一的,且包含 5-50 個英數字元。 在此快速入門中,請在 West US 位置中建立名為 myResourceGroup 的新資源群組,並選取 [基本] 作為 [SKU]

Create container registry in the portal

接受其餘設定的預設值。 然後,選取 [檢閱 + 建立]。 在檢閱設定之後,請選取 [建立]

提示

您在本快速入門中會建立「基本」登錄,這是正在學習 Azure Container Registry 的開發人員所適用的成本最佳化選項。 選擇其他層級來增加儲存體和映像輸送量,以及使用私人端點進行連線等功能。 如需可用服務層級 (SKU) 的詳細資訊,請參閱容器登錄服務層

當 [部署成功] 訊息出現時,請在入口網站中選取容器登錄。

Container registry Overview in the portal

記下登錄名稱和登入伺服器的值,這是在 Azure 雲端以 azurecr.io 結尾的完整名稱。 使用 Docker 推送和提取映像時,您會在下列步驟中使用這些值。

登入登錄

推送和提取容器映像之前,您必須先登入至登錄執行個體。 登入本機電腦上的 Azure CLI,然後執行 az sign-in 命令。 使用 Azure CLI 登入時,請只指定登錄資源名稱。 請勿使用完整登入伺服器名稱。

az acr login --name <registry-name>

範例:

az acr login --name mycontainerregistry

完成後,此命令會傳回 Login Succeeded

將映像推送至登錄

若要推送映像到 Azure Container Registry,您必須先有映像。 如果您還沒有任何本機容器映像,請執行下列 docker pull 命令提取現有的公用映像。 針對此範例,從 Microsoft Container Registry 提取 hello-world 映像。

docker pull mcr.microsoft.com/hello-world

您必須使用登錄登入伺服器的完整名稱來標記映像,才能將映像推送至您的容器登錄。 登入伺服器名稱的格式為 <registry-name>.azurecr.io (必須全部小寫),例如 mycontainerregistry.azurecr.io

使用 docker tag 命令來標記映像。 以 ACR 執行個體的登入伺服器名稱取代 <login-server>

docker tag mcr.microsoft.com/hello-world <login-server>/hello-world:v1

範例:

docker tag mcr.microsoft.com/hello-world mycontainerregistry.azurecr.io/hello-world:v1

最後,使用 docker push 將映像推送到登錄執行個體。 將 <login-server> 取代為登錄執行個體的登入伺服器名稱。 此範例會建立 hello-world 存放庫,其中包含 hello-world:v1 映像。

docker push <login-server>/hello-world:v1

將映像推送到您的容器登錄之後,請從您的本機 Docker 環境中移除 hello-world:v1 映像。 (請注意,此 docker rmi 命令並不會從 Azure 容器登錄中的 hello-world 存放區移除映像。)

docker rmi <login-server>/hello-world:v1

列出容器映像

若要列出您登錄中的映像,請瀏覽至入口網站中的登錄並選取 [存放庫],然後選取您使用 docker push 建立的 hello-world存放庫。

List container images in the portal

選取 hello-world 存放庫,您會在 [標記] 之下看到標記 v1 的映像。

從登錄執行映像

現在,您可以使用 docker run 從您的容器登錄中提取 hello-world:v1 容器映像並加以執行:

docker run <login-server>/hello-world:v1  

範例輸出︰

Unable to find image 'mycontainerregistry.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry.azurecr.io/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.

[...]

清除資源

若要清除資源,請在入口網站中瀏覽至 myResourceGroup 資源群組。 載入資源群組後,按一下 [刪除資源群組] 以移除資源群組、容器登錄,以及儲存於該處的容器映像。

Delete resource group in the portal

下一步

在本快速入門中,您已使用 Azure 入口網站建立 Azure Container Registry、推送容器映像,以及從登錄中提取映像並加以執行。 請繼續進行 Azure 容器登錄教學課程,以深入了解 ACR。