Rövid útmutató: Privát tárolóregisztrációs adatbázis létrehozása az Azure CLI használatával

A Azure Container Registry egy privát beállításjegyzék-szolgáltatás tárolórendszerképek és kapcsolódó összetevők létrehozásához, tárolásához és kezeléséhez. Ebben a rövid útmutatóban létrehoz egy Azure Container Registry-példányt az Azure CLI-vel. Ezután a Docker-parancsokkal leküldhet egy tárolórendszerképet a beállításjegyzékbe, majd 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

Tárolóregisztrációs adatbázis 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, amely Azure Container Registry tanul. Az elérhető szolgáltatási szintek részleteiért lásd: Tárolóregisztrációs adatbázis szolgáltatási szintjei.

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 kimenetben, amely a teljes beállításjegyzék neve (mind kisbetűs). A rövid útmutató <registry-name> hátralévő részében 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 létrehoz egy Alapszintű beállításjegyzéket, amely egy költségoptimalizált lehetőség a fejlesztők számára, amelyek a Azure Container Registry ismerkednek meg. A tárterület és a kép átviteli sebességének növeléséhez válasszon más szinteket, valamint olyan képességeket, mint a privát végpontot használó kapcsolat. Az elérhető szolgáltatási szintek (SKU-k) részleteiért lásd: Tárolóregisztrációs adatbázis szolgáltatási szintjei.

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. Az Azure CLI-vel való bejelentkezéskor csak a beállításjegyzék-erőforrás nevét adja meg. Ne használja a teljes bejelentkezési kiszolgáló nevét.

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 pull 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üldne egy lemezké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 beállításjegyzék-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 lemezképet a beállításjegyzék-példányra. Cserélje le <login-server> a elemet 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 lemezképet az Azure Container Registry 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

Kimenet:

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

Kimenet:

Result
--------
v1

Lemezkép futtatása a beállításjegyzékből

Most lekérheti és futtathatja a tárolórendszerképet a hello-world:v1 tárolóregisztrációs adatbázisból a Docker-futtatás használatával:

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órendszerképeket.

az group delete --name myResourceGroup

Következő lépések

Ebben a rövid útmutatóban létrehozott egy Azure Container Registry az Azure CLI-vel, leküldte a tárolórendszerképet a beállításjegyzékbe, majd lekérte és futtatta a lemezképet a beállításjegyzékből. Folytassa az Azure Container Registry oktatóanyagokkal az ACR részletesebb megtekintéséhez.