Uw eerste installatiekopieën naar uw Azure-containerregister pushen met behulp van de Docker CLI
Een Azure-containerregister slaat privécontainerinstallatiekopieën en andere artefacten op, vergelijkbaar met de manier waarop Docker Hub openbare Docker-containerinstallatiekopieën opslaat. U kunt de Docker-opdrachtregelinterface (Docker CLI) gebruiken voor aanmeldings-, push-, pull- en andere bewerkingen voor containerinstallatiekopieën in uw containerregister.
In de volgende stappen downloadt u een openbare Nginx-installatiekopie, tagt u deze voor uw persoonlijke Azure-containerregister, pusht u deze naar uw register en haalt u deze vervolgens op uit het register.
Vereisten
- Azure-containerregister: maak een containerregister in uw Azure-abonnement. Gebruik bijvoorbeeld de Azure Portal, de Azure CLI of Azure PowerShell.
- Docker CLI : Docker moet ook lokaal zijn geïnstalleerd. Docker biedt pakketten die eenvoudig Docker configureren op elk macOS-, Windows- of Linux-systeem.
Aanmelden bij een register
Er zijn verschillende manieren om te verifiëren bij uw persoonlijke containerregister.
De aanbevolen methode bij het werken in een opdrachtregel is met de Azure CLI-opdracht az acr login. Als u bijvoorbeeld toegang wilt krijgen tot een register met de naam myregistry, meldt u zich aan bij de Azure CLI en verifieert u zich vervolgens bij uw register:
az login
az acr login --name myregistry
U kunt zich ook aanmelden met docker-aanmelding. U hebt bijvoorbeeld mogelijk een service-principal aan uw register toegewezen voor een automatiseringsscenario. Wanneer u de volgende opdracht uitvoert, geeft u interactief de appID (gebruikersnaam) en het wachtwoord van de service-principal op wanneer u hierom wordt gevraagd. Zie de naslaginformatie over docker-aanmeldingsopdrachten voor aanbevolen procedures voor het beheren van aanmeldingsreferenties:
docker login myregistry.azurecr.io
Beide opdrachten worden geretourneerd Login Succeeded zodra ze zijn voltooid.
Notitie
- U kunt Visual Studio Code gebruiken met de Docker-extensie voor een snellere en eenvoudigere aanmelding.
Tip
Geef altijd de volledig gekwalificeerde registernaam (allemaal kleine letters) op wanneer u installatiekopieën gebruikt docker login en tagt voor het pushen naar het register. In de voorbeelden in dit artikel is de volledig gekwalificeerde naam myregistry.azurecr.io.
Een openbare Nginx-installatiekopie ophalen
Haal eerst een openbare Nginx-installatiekopie naar uw lokale computer. In dit voorbeeld wordt de officiële Nginx-installatiekopie opgehaald.
docker pull nginx
De container lokaal uitvoeren
Voer de volgende docker run-opdracht uit om een lokaal exemplaar van de Nginx-container interactief (-it) te starten op poort 8080. Het --rm argument geeft aan dat de container moet worden verwijderd wanneer u deze stopt.
docker run -it --rm -p 8080:80 nginx
Blader naar http://localhost:8080 om de standaardwebpagina weer te geven die wordt geleverd door Nginx in de actieve container. Als het goed is, ziet u een pagina die er ongeveer als volgt uitziet:
Omdat u de container interactief hebt gestart met -it, kunt u de uitvoer van de Nginx-server zien op de opdrachtregel nadat u ernaartoe in uw browser hebt gena navigeerd.
Als u de container wilt stoppen en verwijderen, drukt u op Control+C.
Een alias van de afbeelding maken
Gebruik docker-tag om een alias van de installatiekopieën te maken met het volledig gekwalificeerde pad naar uw register. In dit voorbeeld wordt de naamruimte samples gespecificeerd om overbodige items in de hoofdmap van het register te voorkomen.
docker tag nginx myregistry.azurecr.io/samples/nginx
Zie de sectie Opslagplaatsnaamruimten van Best practices voor Azure Container Registry voor meer informatie over taggen met naamruimten.
De installatiekopie naar uw register pushen
Nu u de installatiekopieën hebt getagd met het volledig gekwalificeerde pad naar uw privéregister, kunt u deze naar het register pushen met docker-push:
docker push myregistry.azurecr.io/samples/nginx
De installatiekopie vanuit uw register ophalen
Gebruik de opdracht docker pull om de installatiekopie op te halen uit het register:
docker pull myregistry.azurecr.io/samples/nginx
De Nginx-container starten
Gebruik de opdracht docker run om de installatiekopie uit te voeren die u uit het register hebt opgehaald:
docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx
Blader naar http://localhost:8080 om de actieve container weer te geven.
Als u de container wilt stoppen en verwijderen, drukt u op Control+C.
De installatiekopieën verwijderen (optioneel)
Als u de Nginx-installatiekopieën niet meer nodig hebt, kunt u deze lokaal verwijderen met de opdracht docker rmi .
docker rmi myregistry.azurecr.io/samples/nginx
Als u installatiekopieën wilt verwijderen uit uw Azure-containerregister, kunt u de Azure CLI-opdracht az acr repository delete gebruiken. Met de volgende opdracht verwijdert u bijvoorbeeld het manifest waarnaar wordt verwezen door de samples/nginx:latest tag, eventuele unieke laaggegevens en alle andere tags die naar het manifest verwijzen.
az acr repository delete --name myregistry --image samples/nginx:latest
Aanbevelingen
Hier vindt u meer informatie over de verificatieopties.
Volgende stappen
Nu u de basisbeginselen kent, kunt u uw register gaan gebruiken. Implementeer bijvoorbeeld containerinstallatiekopieën vanuit uw register naar:
Installeer eventueel de Docker-extensie voor Visual Studio-code en de Azure-accountextensie om te werken met uw Azure-containerregisters. Pull en push installatiekopieën naar een Azure-containerregister of voer ACR-taken uit, allemaal in Visual Studio-code.