Uw eerste installatiekopieën naar uw Azure-containerregister pushen met behulp van de Docker CLI
In een Azure-containerregister worden privécontainerinstallatiekopieën en andere artefacten opgeslagen en beheerd, vergelijkbaar met de manier waarop Docker Hub openbare Docker-containerinstallatiekopieën opslaat en beheert. U kunt de Docker-opdrachtregelinterface (Docker CLI) gebruiken voor aanmeldings-, push-, pull- en andere containerinstallatiekopiebewerkingen 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 het register en haalt u deze vervolgens op uit het register.
Vereisten
- Azure-containerregister: maak een containerregister in uw Azure-abonnement. Gebruik bijvoorbeeld Azure Portal, De Azure CLI of 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 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 een service-principal aan uw register toegewezen voor een automatiseringsscenario. Wanneer u de volgende opdracht uitvoert, geeft u interactief de app-id (gebruikersnaam) en het wachtwoord van de service-principal op wanneer u hierom wordt gevraagd. Zie de referentie voor de docker-aanmeldingsopdracht 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 docker-extensie voor een snellere en handigere aanmelding.
Tip
Geef altijd de volledig gekwalificeerde registernaam (alle kleine letters) op wanneer u deze gebruikt docker login en wanneer u installatiekopieën tagt om naar uw register te pushen. 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 op uw lokale computer. In dit voorbeeld wordt de officiële Nginx-installatiekopie opgehaald.
docker pull nginx
De container lokaal uitvoeren
Voer de volgende docker-opdracht 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 nginx
Blader om de standaardwebpagina weer te http://localhost:8080 geven die door Nginx wordt geleverd in de actieve container. Er moet een pagina worden weergegeven die vergelijkbaar is met de volgende:
Omdat u de container interactief hebt gestart, -itziet u de uitvoer van de Nginx-server op de opdrachtregel nadat u ernaartoe navigeert in uw browser.
Als u de container wilt stoppen en verwijderen, drukt u op Control+C.
Een alias van de installatiekopieën 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 Naamruimten van de opslagplaats van aanbevolen procedures voor Azure Container Registry voor meer informatie over taggen met naamruimten.
De installatiekopie naar uw register pushen
Nu u de installatiekopieën hebt gelabeld met het volledig gekwalificeerde pad naar uw privéregister, kunt u deze pushen naar het register met docker-push:
docker push myregistry.azurecr.io/samples/nginx
De installatiekopie vanuit uw register ophalen
Gebruik de opdracht docker pull om de installatiekopie uit het register op te halen:
docker pull myregistry.azurecr.io/samples/nginx
De Nginx-container starten
Gebruik de opdracht docker run om de installatiekopie uit te voeren die u hebt opgehaald uit het register:
docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx
Blader naar http://localhost:8080 de actieve container.
Als u de container wilt stoppen en verwijderen, drukt u op Control+C.
De afbeelding verwijderen (optioneel)
Als u de Nginx-installatiekopieën niet meer nodig hebt, kunt u deze lokaal verwijderen met de docker-opdracht .
docker rmi myregistry.azurecr.io/samples/nginx
Als u installatiekopieën uit uw Azure-containerregister wilt verwijderen, kunt u de Azure CLI-opdracht az acr repository delete gebruiken. Met de volgende opdracht wordt bijvoorbeeld het manifest verwijderd 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, bent u klaar om uw register te gaan gebruiken. Implementeer bijvoorbeeld containerinstallatiekopieën uit 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.