Wypychanie pierwszego obrazu do rejestru kontenerów platformy Azure przy użyciu interfejsu wiersza polecenia platformy Docker
Rejestr kontenerów platformy Azure przechowuje prywatne obrazy kontenerów i inne artefakty oraz zarządza nimi, podobnie jak w przypadku Docker Hub przechowywania publicznych obrazów kontenerów platformy Docker. Do logowania, wypychania, ściągania i innych operacji obrazu kontenera w rejestrze kontenerów można użyć interfejsu wiersza polecenia platformy Docker (Interfejs wiersza polecenia platformy Docker).
W poniższych krokach pobierzesz publiczny obraz Nginx, oznaczysz go jako prywatny rejestr kontenerów platformy Azure, wypchniesz go do rejestru, a następnie ściągniesz go z rejestru.
Wymagania wstępne
- Usługa Azure Container Registry — Tworzy rejestr kontenera w subskrypcji platformy Azure. Na przykład użyj Azure Portal, interfejsu wiersza polecenia platformy Azure lub Azure PowerShell.
- Interfejs wiersza polecenia platformy Docker — musisz również mieć zainstalowaną lokalnie platformę Docker. Środowisko Docker zawiera pakiety, które umożliwiają łatwe konfigurowanie platformy Docker w systemie macOS, Windows lub Linux.
Zaloguj się do rejestru
Istnieje kilka sposobów uwierzytelniania w prywatnym rejestrze kontenerów.
Zalecaną metodą podczas pracy w wierszu polecenia jest polecenie interfejsu wiersza polecenia platformy Azure az acr login. Aby na przykład uzyskać dostęp do rejestru o nazwie myregistry, zaloguj się do interfejsu wiersza polecenia platformy Azure, a następnie uwierzytelnij się w rejestrze:
az login
az acr login --name myregistry
Możesz również zalogować się przy użyciu identyfikatora logowania platformy Docker. Na przykład możesz przypisać jednostkę usługi do rejestru na potrzeby scenariusza automatyzacji. Po uruchomieniu następującego polecenia interaktywnie podaj identyfikator appID (nazwa użytkownika) i hasło jednostki usługi po wyświetleniu monitu. Aby uzyskać najlepsze rozwiązania dotyczące zarządzania poświadczeniami logowania, zobacz dokumentację poleceń logowania platformy Docker :
docker login myregistry.azurecr.io
Oba polecenia są zwracane Login Succeeded po zakończeniu.
Uwaga
- Możesz chcieć użyć Visual Studio Code z rozszerzeniem platformy Docker w celu szybszego i wygodniejszego logowania.
Porada
Zawsze określa w pełni kwalifikowaną nazwę rejestru (wszystkie małe litery) podczas używania docker login funkcji i tagowania obrazów do wypychania do rejestru. W przykładach w tym artykule w pełni kwalifikowana nazwa jest myregistry.azurecr.io.
Ściąganie publicznego obrazu Nginx
Najpierw należy ściągnąć publiczny obraz serwera Nginx na komputer lokalny. Ten przykład ściąga oficjalny obraz Nginx.
docker pull nginx
Uruchamianie kontenera w środowisku lokalnym
Wykonaj następujące polecenie docker run , aby uruchomić lokalne wystąpienie kontenera Nginx interaktywnie (-it) na porcie 8080. Argument --rm określa, że kontener powinien zostać usunięty po jego zatrzymaniu.
docker run -it --rm -p 8080:80 nginx
Przejdź do , aby http://localhost:8080 wyświetlić domyślną stronę internetową obsługiwaną przez serwer Nginx w uruchomionym kontenerze. Powinna zostać wyświetlona strona podobna do następującej:
Ponieważ kontener został uruchomiony interaktywnie za pomocą -itpolecenia , dane wyjściowe serwera Nginx są widoczne w wierszu polecenia po przejściu do niego w przeglądarce.
Aby zatrzymać i usunąć kontener, naciśnij klawisz Control+C.
Tworzenie aliasu obrazu
Użyj tagu platformy Docker , aby utworzyć alias obrazu z w pełni kwalifikowaną ścieżką do rejestru. W tym przykładzie jest określana przestrzeń nazw samples, aby uniknąć zaśmiecania katalogu głównego rejestru.
docker tag nginx myregistry.azurecr.io/samples/nginx
Aby uzyskać więcej informacji na temat tagowania za pomocą przestrzeni nazw, zobacz sekcję Przestrzenie nazw repozytorium w temacieNajlepsze rozwiązania dotyczące Azure Container Registry.
Wypchnięcie obrazu do rejestru
Teraz, gdy obraz został otagowany przy użyciu w pełni kwalifikowanej ścieżki do rejestru prywatnego, możesz wypchnąć go do rejestru za pomocą wypchnięcia platformy Docker:
docker push myregistry.azurecr.io/samples/nginx
Ściągnięcie obrazu z rejestru
Użyj polecenia docker pull , aby ściągnąć obraz z rejestru:
docker pull myregistry.azurecr.io/samples/nginx
Uruchamianie kontenera Nginx
Użyj polecenia docker run , aby uruchomić obraz, który został ściągnięty z rejestru:
docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx
Przejdź do, http://localhost:8080 aby wyświetlić uruchomiony kontener.
Aby zatrzymać i usunąć kontener, naciśnij klawisz Control+C.
Usuń obraz (opcjonalnie)
Jeśli obraz Nginx nie jest już potrzebny, możesz usunąć go lokalnie za pomocą polecenia docker rmi .
docker rmi myregistry.azurecr.io/samples/nginx
Aby usunąć obrazy z rejestru kontenerów platformy Azure, możesz użyć polecenia interfejsu wiersza polecenia platformy Azure az acr repository delete. Na przykład następujące polecenie usuwa manifest, do którego odwołuje się samples/nginx:latest tag, wszystkie unikatowe dane warstwy i wszystkie inne tagi odwołujące się do manifestu.
az acr repository delete --name myregistry --image samples/nginx:latest
Zalecenia
Tutaj można znaleźć więcej informacji na temat opcji uwierzytelniania.
Następne kroki
Teraz, gdy znasz już podstawy, możesz rozpocząć korzystanie z rejestru. Na przykład wdróż obrazy kontenerów z rejestru w następujących celach:
Opcjonalnie zainstaluj rozszerzenie platformy Docker dla Visual Studio Code i rozszerzenie konta platformy Azure, aby pracować z rejestrami kontenerów platformy Azure. Ściąganie i wypychanie obrazów do rejestru kontenerów platformy Azure lub uruchamianie usługi ACR Tasks w Visual Studio Code.