快速入門:使用 Azure 入口網站建立 Azure Container Registry
Azure Container Registry 是私人登錄服務,用於建置、儲存和管理容器映像和相關成品。 在本快速入門中,您會使用 Azure 入口網站建立 Azure 容器登錄執行個體。 然後,使用 Docker 命令將容器映像推送到登錄中,最後從您的登錄中提取映像並加以執行。
若要登入登錄以使用容器映像,您在進行此快速入門時必須執行 Azure CLI (建議使用 2.0.55 版或更新版本)。 執行 az --version
以尋找版本。 如果您需要安裝或升級,請參閱安裝 Azure CLI。
您也必須在本機安裝 Docker,並執行精靈。 Docker 提供可在任何 Mac、Windows 或 Linux 系統上輕鬆設定 Docker 的套件。
登入 Azure
登入 Azure 入口網站。
建立容器登錄
選取 [建立資源]>[容器]>[容器登錄]。
在 [基本] 索引標籤中,輸入 [資源群組] 和 [登錄名稱] 的值。 登錄名稱在 Azure 內必須是唯一的,且包含 5-50 個英數字元。 在此快速入門中,請在 West US
位置中建立名為 myResourceGroup
的新資源群組,並選取 [基本] 作為 [SKU]。
接受其餘設定的預設值。 然後,選取 [檢閱 + 建立]。 在檢閱設定之後,請選取 [建立]。
提示
您在本快速入門中會建立「基本」登錄,這是正在學習 Azure Container Registry 的開發人員所適用的成本最佳化選項。 選擇其他層級來增加儲存體和映像輸送量,以及使用私人端點進行連線等功能。 如需可用服務層級 (SKU) 的詳細資訊,請參閱容器登錄服務層。
當 [部署成功] 訊息出現時,請在入口網站中選取容器登錄。
記下登錄名稱和登入伺服器的值,這是在 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存放庫。
選取 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 資源群組。 載入資源群組後,按一下 [刪除資源群組] 以移除資源群組、容器登錄,以及儲存於該處的容器映像。
下一步
在本快速入門中,您已使用 Azure 入口網站建立 Azure Container Registry、推送容器映像,以及從登錄中提取映像並加以執行。 請繼續進行 Azure 容器登錄教學課程,以深入了解 ACR。