Rövid útmutató: Privát tárolóregisztrációs adatbázis létrehozása az Azure CLI használatával
Az Azure Container Registry egy privát beállításjegyzék-szolgáltatás a tárolólemezképek és a kapcsolódó összetevők létrehozásához, tárolásához és kezeléséhez. Ebben a rövid útmutatóban egy Azure Container Registry-példányt hoz létre az Azure CLI-vel. Ezután a Docker-parancsokkal leküldhet egy tárolólemezképet a beállításjegyzékbe, és végül lekérheti és futtathatja a lemezképet a beállításjegyzékből.
Ehhez a rövid útmutatóhoz az Azure CLI-t kell futtatnia (a 2.0.55-ös vagy újabb verzió ajánlott). A verzió azonosításához futtassa a következőt: az --version. Ha telepíteni vagy frissíteni szeretne: Az Azure CLI telepítése.
A Dockert is telepítenie kell helyileg. A Docker csomagokat biztosít, amelyekkel a Docker egyszerűen konfigurálható bármely macOS, Windows vagy Linux rendszeren.
Mivel az Azure Cloud Shell nem tartalmazza az összes szükséges Docker-összetevőt (a dockerd-démont), ehhez a rövid útmutatóhoz nem használható a Cloud Shell.
Erőforráscsoport létrehozása
Hozzon létre egy erőforráscsoportot az az group create paranccsal. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat.
A következő példában létrehozunk egy myResourceGroup nevű erőforráscsoportot az eastus helyen.
az group create --name myResourceGroup --location eastus
Container Registry létrehozása
Ebben a rövid útmutatóban létrehoz egy alapszintű beállításjegyzéket, amely egy költségoptimalizált lehetőség a fejlesztők számára az Azure Container Registry megismeréséhez. Az elérhető szolgáltatási szintekről további információt a Tárolóregisztrációs adatbázis szolgáltatási szintjei című témakörben talál.
Hozzon létre egy ACR-példányt az az acr create paranccsal. A beállításjegyzék nevének egyedinek kell lennie az Azure-ban, és 5–50 kisbetűs alfanumerikus karaktert kell tartalmaznia. Az alábbi példában a mycontainerregistryt használjuk. Ezt cserélje le egy egyedi értékre.
az acr create --resource-group myResourceGroup \
--name mycontainerregistry --sku Basic
A tárolóregisztrációs adatbázis létrehozásakor a kimenet a következő példához hasonló:
{
"adminUserEnabled": false,
"creationDate": "2019-01-08T22:32:13.175925+00:00",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/mycontainerregistry",
"location": "eastus",
"loginServer": "mycontainerregistry.azurecr.io",
"name": "mycontainerregistry",
"provisioningState": "Succeeded",
"resourceGroup": "myResourceGroup",
"sku": {
"name": "Basic",
"tier": "Basic"
},
"status": null,
"storageAccount": null,
"tags": {},
"type": "Microsoft.ContainerRegistry/registries"
}
Jegyezze fel loginServer a kimenetet, amely a teljes beállításjegyzék neve (mind kisbetűs). A rövid útmutató <registry-name> többi része a tárolóregisztrációs adatbázis nevének helyőrzője, és <login-server> a beállításjegyzék bejelentkezési kiszolgálójának nevének helyőrzője.
Tipp.
Ebben a rövid útmutatóban egy alapszintű beállításjegyzéket hoz létre, amely egy költségoptimalizált lehetőség a fejlesztők számára az Azure Container Registry megismeréséhez. Válasszon más szinteket a nagyobb tárterület- és képteljesítményhez, valamint olyan képességeket, mint a privát végpontot használó kapcsolat. Az elérhető szolgáltatási szintekről (SKU-król) további információt a Tárolóregisztrációs adatbázis szolgáltatási szintjei című témakörben talál.
Bejelentkezés a beállításjegyzékbe
A tárolórendszerképek leküldése és lekérése előtt be kell jelentkeznie a beállításjegyzékbe. Ehhez használja az az acr login parancsot. Csak a beállításjegyzék-erőforrás nevét adja meg az Azure CLI-vel való bejelentkezéskor. Ne használja a teljes bejelentkezési kiszolgálónevet.
az acr login --name <registry-name>
Példa:
az acr login --name mycontainerregistry
A parancs a Login Succeeded üzenetet adja vissza, ha befejeződött.
Rendszerkép leküldése a beállításjegyzékbe
Ahhoz, hogy rendszerképet tudjon küldeni egy Azure Container Registry tárolóregisztrációs adatbázisba, először szüksége van egy rendszerképre. Ha még nincs helyi tárolórendszerképe, futtassa az alábbi Docker lekérési parancsot egy meglévő nyilvános lemezkép lekéréséhez. Ebben a példában kérje le a rendszerképet a hello-world Microsoft Container Registryből.
docker pull mcr.microsoft.com/hello-world
Mielőtt leküldené a rendszerképet a beállításjegyzékbe, címkéznie kell azt a regisztrációs adatbázis bejelentkezési kiszolgálójának teljes nevével. A bejelentkezési kiszolgáló neve a registry-name.azurecr.io> formátumban <van (kisbetűsnek kell lennie), például mycontainerregistry.azurecr.io.
Címkézze fel a rendszerképet a docker tag parancs használatával. Helyettesítse be az <login-server> helyére az ACR-példány bejelentkezési kiszolgálójának nevét.
docker tag mcr.microsoft.com/hello-world <login-server>/hello-world:v1
Példa:
docker tag mcr.microsoft.com/hello-world mycontainerregistry.azurecr.io/hello-world:v1
Végül a docker push használatával küldje le a rendszerképet a beállításjegyzék-példányra. Cserélje le <login-server> a regisztrációs adatbázispéldány bejelentkezési kiszolgálójának nevére. Ez a példa létrehozza a rendszerképet tartalmazó hello-world adattárat hello-world:v1 .
docker push <login-server>/hello-world:v1
Miután lekérte a lemezképet a tárolóregisztrációs adatbázisba, távolítsa el a lemezképet a hello-world:v1 helyi Docker-környezetből. (Vegye figyelembe, hogy ez a Docker RMI-parancs nem távolítja el a rendszerképet az Azure-tárolóregisztrációs adatbázis hello-world adattárából.)
docker rmi <login-server>/hello-world:v1
Tárolórendszerképek listázása
Az alábbi példa a beállításjegyzékben található adattárakat sorolja fel:
az acr repository list --name <registry-name> --output table
Hozam:
Result
----------------
hello-world
Az alábbi példa a hello-world adattár címkéit sorolja fel.
az acr repository show-tags --name <registry-name> --repository hello-world --output table
Hozam:
Result
--------
v1
Rendszerkép futtatása a beállításjegyzékből
Most lekérheti és futtathatja a hello-world:v1 tárolórendszerképet a tárolóregisztrációs adatbázisból a Docker-futtatással:
docker run <login-server>/hello-world:v1
Példa a kimenetre:
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.
[...]
Az erőforrások eltávolítása
Ha már nincs rá szükség, az az group delete paranccsal eltávolíthatja az erőforráscsoportot, a tárolóregisztrációs adatbázist és az ott tárolt tárolólemezképeket.
az group delete --name myResourceGroup
Következő lépések
Ebben a rövid útmutatóban létrehozott egy Azure Container Registryt az Azure CLI-vel, leküldött egy tárolórendszerképet a beállításjegyzékbe, majd lekérte és futtatta a rendszerképet a beállításjegyzékből. Az ACR részletesebb megismeréséhez folytassa az Azure Container Registry-oktatóanyagokkal.