Uw eerste afbeelding naar uw Azure-containerregister pushen met behulp van de Docker CLI
In een Azure-containerregister worden privécontainer-afbeeldingen en andere artefacten op een soortgelijke manier op de Docker Hub docker-containerafbeeldingen op slaat. U kunt de Docker-opdrachtregelinterface (Docker CLI) gebruiken voor aanmeldings-, push-, pull-en andere container-imagebewerkingen in uw containerregister.
In de volgende stappen downloadt u een openbare Nginx-afbeelding,tagt u deze voor uw persoonlijke Azure-containerregister, pusht u deze naar het 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 CLIof Azure PowerShell.
- Docker CLI: u moet Docker ook lokaal hebben 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 privécontainerregister.
De aanbevolen methode bij het werken in een opdrachtregel is met de Azure CLI-opdracht az acr login. Als u zich bijvoorbeeld wilt aanmelden bij een register met de naam myregistry, moet u zich aanmelden bij de Azure CLI en vervolgens verifiëren bij uw register:
az login
az acr login --name myregistry
U kunt zich ook aanmelden met docker-aanmelding. U hebt bijvoorbeeld een service-principal aan uw register toegewezen voor een automatiseringsscenario. Wanneer u de volgende opdracht hebt uitgevoerd, geeft u interactief de appID (gebruikersnaam) en het wachtwoord van de service-principal op wanneer u hier om wordt gevraagd. Zie de naslag voor de opdracht docker login voor best practices voor het beheren van aanmeldingsreferenties:
docker login myregistry.azurecr.io
Beide opdrachten retourneren Login Succeeded zodra ze zijn voltooid.
Notitie
- Mogelijk wilt u Visual Studio Code met Docker-extensie gebruiken voor een snellere en handigere aanmelding.
Tip
Geef altijd de volledig gekwalificeerde registernaam (in kleine letters) op wanneer u gebruikt en wanneer u afbeeldingen tagt voor docker login pushen naar het register. In de voorbeelden in dit artikel is de volledig gekwalificeerde naam myregistry.azurecr.io.
Een openbare Nginx-afbeelding pullen
Haal eerst een openbare Nginx-afbeelding op naar uw lokale computer. In dit voorbeeld wordt een afbeelding uit Microsoft Container Registry.
docker pull mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine
De container lokaal uitvoeren
Voer de volgende opdracht docker run uit om een lokaal exemplaar van de Nginx-container interactief te starten ( -it ) 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 mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine
Blader naar http://localhost:8080 om de standaardwebpagina van Nginx weer te geven in de container die wordt uitgevoerd. Als het goed is, ziet u een pagina die er ongeveer als volgt uit ziet:
Omdat u de container interactief hebt gestart met , ziet u de uitvoer van de Nginx-server op de opdrachtregel nadat u er -it in uw browser naar hebt ge navigeren.
Druk op om de container te stoppen en te Control + C verwijderen.
Een alias van de afbeelding maken
Gebruik docker tag om een alias van de -afbeelding 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 mcr.microsoft.com/oss/nginx/nginx:1.15.5-alpine 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 afbeelding 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 -afbeelding uit het register op te halen:
docker pull myregistry.azurecr.io/samples/nginx
De Nginx-container starten
Gebruik de opdracht docker run om de afbeelding uit het register uit te voeren:
docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx
Blader naar http://localhost:8080 om de container te bekijken die wordt uitgevoerd.
Druk op om de container te stoppen en te Control + C verwijderen.
De afbeelding verwijderen (optioneel)
Als u de Nginx-afbeelding niet meer nodig hebt, kunt u deze lokaal verwijderen met de opdracht docker rmi.
docker rmi myregistry.azurecr.io/samples/nginx
Als u afbeeldingen uit uw Azure-containerregister wilt verwijderen, 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 tag, unieke laaggegevens en alle andere tags die naar het samples/nginx:latest manifest verwijzen.
az acr repository delete --name myregistry --image samples/nginx:latest
Volgende stappen
Nu u de basisprincipes kent, kunt u uw register gaan gebruiken. Implementeer bijvoorbeeld containerafbeeldingen uit uw register om:
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.