Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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 fog létrehozni az Azure PowerShell helyi használatával. Ezután a Docker parancssori felületével lekéri a hello-world tárolórendszerképet, megjelöli a hello-world tárolórendszerképet egy új tárolórendszerkép létrehozásához, leküldi az új tárolórendszerképet a tárolóregisztrációs adatbázisba, törli a helyi tárolórendszerképet, majd végül lekéri és futtatja a lemezképet a beállításjegyzékből.
Előfeltételek
Feljegyzés
Javasoljuk, hogy az Azure Az PowerShell modult használja az Azure-ral való interakcióhoz. Az első lépésekhez tekintse meg Az Azure PowerShell telepítése témakört. Az Az PowerShell-modulra történő migrálás részleteiről lásd: Az Azure PowerShell migrálása az AzureRM modulból az Az modulba.
Az Azure PowerShell modul szükséges ehhez a gyorsútmutatóhoz. Futtassa a Get-Module -ListAvailable Az parancsot a telepített verzió meghatározásához. Ha telepíteni vagy frissíteni szeretne, olvassa el az Azure PowerShell-modul telepítését ismertető cikket.
A Dockert is telepítenie kell helyileg. A Docker macOS, Windows és Linux operációs rendszerekhez biztosít csomagokat.
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.
Bejelentkezés az Azure-ba
Jelentkezzen be az Azure-előfizetésbe a Connect-AzAccount paranccsal, és kövesse a képernyőn megjelenő utasításokat.
Connect-AzAccount
Erőforráscsoport létrehozása
Az Azure-ral való hitelesítés után hozzon létre egy erőforráscsoportot a New-AzResourceGroup használatával. Az erőforráscsoport egy olyan logikai tároló, amelyben üzembe helyezheti és kezelheti az Azure-erőforrásokat.
New-AzResourceGroup -Name myResourceGroup -Location EastUS
Tárolóregisztrációs adatbázis létrehozása
Ezután hozzon létre egy tárolóregisztrációs adatbázist az új erőforráscsoportban a New-AzContainerRegistry paranccsal.
A beállításjegyzék nevének egyedinek kell lennie az Azure rendszerben, és 5–50 alfanumerikus karaktert kell tartalmaznia. Az alábbi példa létrehoz egy "mycontainerregistry" nevű beállításjegyzéket. Cserélje le a mycontainerregistry parancsot a következő parancsra, majd futtassa a beállításjegyzék létrehozásához:
$registry = New-AzContainerRegistry -ResourceGroupName "myResourceGroup" -Name "mycontainerregistry" -EnableAdminUser -Sku Standard -Location EastUS
Tipp.
Ebben a rövid útmutatóban létrehoz egy Standard beállításjegyzéket, amely elegendő a legtöbb Azure Container Registry-munkafolyamathoz. A nagyobb tárhely- és képteljesítmény, valamint az olyan képességek, mint a privát végponttal való kapcsolat, a Prémium díjszabási csomag (SKU) elérhető. A szolgáltatási szintek (SKU-k) részleteiért lásd az Azure Container Registry termékváltozatának funkcióit és korlátait.
Bejelentkezés a rendszerleíró adatbázisba
A tárolólemezképek leküldése és lekérése előtt be kell jelentkeznie a beállításjegyzékbe a Connect-AzContainerRegistry parancsmaggal. Az alábbi példa ugyanazokat a hitelesítő adatokat használja, mint amellyel bejelentkezett az Azure-ba való hitelesítéskor a Connect-AzAccount parancsmaggal.
Feljegyzés
Az alábbi példában a $registry.Name érték az erőforrás neve, nem pedig a teljes beállításjegyzék neve.
Connect-AzContainerRegistry -Name $registry.Name
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. A hello-world rendszerképet töltse le a Microsoft Container Registryből ebben a példában.
docker pull mcr.microsoft.com/hello-world
Mielőtt feltölti a rendszerképet a regisztrárba, címkéznie kell azt a docker tag parancs segítségével, a regisztráció tároló bejelentkezési kiszolgálójának teljes nevével.
- A tartománynévcímke (DNL) által védett, egyedi DNS-névkivonattal rendelkező regisztrációs adatbázisok bejelentkezési kiszolgálójának névformátuma a következő
mycontainerregistry-abc123.azurecr.io. - A DNL beállítással
Unsecurelétrehozott regisztrációs adatbázisok bejelentkezési kiszolgálójának névformátuma a következőmycontainerregistry.azurecr.io.
Ha például létrehoz egy regisztert a Tenant Reuse DNL-hatókörrel, a bejelentkezési kiszolgáló mycontainerregistry-abc123.azurecr.io-hez hasonlíthat olyan módon, hogy a DNS-név tartalmazza a kivonatot. Ha a DNL beállítással hoz létre egy beállításjegyzéket Unsecure, a bejelentkezési kiszolgáló kivonat nélkül így néz ki: mycontainerregistry.azurecr.io.
Címkézze fel a rendszerképet a docker tag paranccsal a regiszter bejelentkezési kiszolgálójával. Ebben a gyorsindítóban címkézze fel a hello-world képet a v1 következővel.
Példaparancs egy DNL által védett beállításjegyzék képének címkézéséhez:
docker tag mcr.microsoft.com/hello-world mycontainerregistry-abc123.azurecr.io/hello-world:v1
Példaparancs egy nem DNL-alapú beállításjegyzék képének címkézéséhez:
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 feltöltötte a képet a konténer-regisztrárba, távolítsa el a hello-world:v1 képet a helyi Docker-környezetből a docker rmi paranccsal. Ez a parancs nem távolítja el a rendszerképet az Azure tárolóregiszter hello-world adattárából.
docker rmi <login-server>/hello-world: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 kimenet:
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 tisztítása
Ha végzett az ebben a rövid útmutatóban létrehozott erőforrásokkal, a Remove-AzResourceGroup paranccsal távolítsa el az erőforráscsoportot, a tárolóregisztrációs adatbázist és az ott tárolt tárolólemezképeket:
Remove-AzResourceGroup -Name myResourceGroup
Következő lépések
Ebben a rövid útmutatóban létrehozott egy Azure Container Registry-példányt az Azure PowerShell helyi használatával, lekért egy hello-world tárolórendszerképet, felcímkézte a hello-world rendszerképet egy új tárolórendszerkép létrehozásához, leküldte az új tárolórendszerképet a tárolóregisztrációs adatbázisba, törölte a helyi tárolórendszerképet, végül 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.