Nahrání první image do soukromého registru kontejnerů Dockeru pomocí rozhraní příkazového řádku DockeruPush your first image to a private Docker container registry using the Docker CLI

Registr kontejnerů Azure uchovává a spravuje privátní image kontejnerů Dockeru podobným způsobem, jakým Docker Hub uchovává veřejné image Dockeru.An Azure container registry stores and manages private Docker container images, similar to the way Docker Hub stores public Docker images. Můžete použít rozhraní příkazového řádku Dockeru (Docker CLI) pro přihlášení, nabízených, o přijetí změna další operace na kontejnerech registru.You can use the Docker command-line interface (Docker CLI) for login, push, pull, and other operations on your container registry.

V následujících krocích stažení oficiální image serveru Nginx z veřejného registru Docker Hub, označte ji pro váš privátní registr kontejnerů Azure, nahrajte ho do vašeho registru a pak přetahování z registru.In the following steps, you download an official Nginx image from the public Docker Hub registry, tag it for your private Azure container registry, push it to your registry, and then pull it from the registry.

PožadavkyPrerequisites

  • Registr kontejnerů Azure – Vytvořte registr kontejnerů ve svém předplatném Azure.Azure container registry - Create a container registry in your Azure subscription. Například použít webu Azure portal nebo rozhraní příkazového řádku Azure.For example, use the Azure portal or the Azure CLI.
  • Rozhraní příkazového řádku dockeru – je také nutné mít Docker nainstalovaný místně.Docker CLI - You must also have Docker installed locally. Docker nabízí balíčky pro snadnou konfiguraci Dockeru v libovolném systému macOS, Windows nebo Linux.Docker provides packages that easily configure Docker on any macOS, Windows, or Linux system.

Přihlášení k registruLog in to a registry

Existují několik způsobů, jak ověřit pro váš privátní registr kontejnerů.There are several ways to authenticate to your private container registry. Je doporučeným způsobem při práci v příkazovém řádku pomocí příkazu Azure CLI az acr login.The recommended method when working in a command line is with the Azure CLI command az acr login. Například pro přihlášení k registru s názvem myregistry:For example, to log in to a registry named myregistry:

az acr login --name myregistry

Také se můžete přihlásit pomocí docker login.You can also log in with docker login. Například můžete mít přiřadit instanční objekt služby do vašeho registru pro účely scénáře automatizace.For example, you might have assigned a service principal to your registry for an automation scenario. Když spustíte následující příkaz, interaktivně zadejte ID aplikace instančního objektu služby (uživatelské jméno) a heslo po zobrazení výzvy.When you run the following command, interactively provide the service principal appID (username) and password when prompted. Osvědčené postupy pro správu přihlašovací údaje, najdete v článku docker login referenčních příkazu:For best practices to manage login credentials, see the docker login command reference:

docker login myregistry.azurecr.io

Vrátí oba příkazy Login Succeeded po dokončení.Both commands return Login Succeeded once completed.

Tip

Vždy plně kvalifikovaný název registru (malými písmeny) zadejte při použití docker login a kdy označit Image pro doručením (push) do svého registru.Always specify the fully qualified registry name (all lowercase) when you use docker login and when you tag images for pushing to your registry. V příkladech v tomto článku, je plně kvalifikovaný název myregistry.azurecr.io.In the examples in this article, the fully qualified name is myregistry.azurecr.io.

Stáhněte si oficiální image serveru NginxPull the official Nginx image

Nejprve si stáhněte veřejnou image serveru Nginx do místního počítače.First, pull the public Nginx image to your local computer.

docker pull nginx

Místní spuštění kontejneruRun the container locally

Spusťte následující dockeru spustit příkaz spustit místní instanci kontejneru Nginx interaktivně (-it) na portu 8080.Execute following docker run command to start a local instance of the Nginx container interactively (-it) on port 8080. --rm Argument určuje, že má být odebrána kontejneru při jeho zastavení.The --rm argument specifies that the container should be removed when you stop it.

docker run -it --rm -p 8080:80 nginx

Přejděte do http://localhost:8080 Chcete-li zobrazit výchozí webová stránka obsluhuje Nginx v spuštěný kontejner.Browse to http://localhost:8080 to view the default web page served by Nginx in the running container. Zobrazí se stránka podobná následujícímu:You should see a page similar to the following:

Server Nginx na místním počítači

Protože jste spustili kontejner interaktivně s -it, můžete zobrazit výstup serveru Nginx na příkazovém řádku po přechodu na něj v prohlížeči.Because you started the container interactively with -it, you can see the Nginx server's output on the command line after navigating to it in your browser.

Chcete-li zastavit a odebrat kontejneru, stiskněte Control + C.To stop and remove the container, press Control+C.

Vytvoření aliasu ImageCreate an alias of the image

Použití docker tag vytvoření aliasu Image s plně kvalifikovanou cestou k vašemu registru.Use docker tag to create an alias of the image with the fully qualified path to your registry. V tomto příkladu se určí obor názvů samples, aby se zabránilo nepořádku v kořenovém adresáři registru.This example specifies the samples namespace to avoid clutter in the root of the registry.

docker tag nginx myregistry.azurecr.io/samples/nginx

Další informace o značkách s obory názvů najdete v tématu obory názvů úložiště část osvědčené postupy pro službu Azure Container Registry.For more information about tagging with namespaces, see the Repository namespaces section of Best practices for Azure Container Registry.

Nahrání image do registruPush the image to your registry

Teď, když jste označili image s plně kvalifikovanou cestu do privátního registru, můžete ho odeslat do registru příkazem docker push:Now that you've tagged the image with the fully qualified path to your private registry, you can push it to the registry with docker push:

docker push myregistry.azurecr.io/samples/nginx

Stáhněte si image z registruPull the image from your registry

Použití operace docker pull příkaz a vyžádejte si image z registru:Use the docker pull command to pull the image from your registry:

docker pull myregistry.azurecr.io/samples/nginx

Spuštění kontejneru NginxStart the Nginx container

Použití dockeru spustit příkaz ke spuštění image jste stáhli ze svého registru:Use the docker run command to run the image you've pulled from your registry:

docker run -it --rm -p 8080:80 myregistry.azurecr.io/samples/nginx

Přejděte do http://localhost:8080 Chcete-li zobrazit spuštěný kontejner.Browse to http://localhost:8080 to view the running container.

Chcete-li zastavit a odebrat kontejneru, stiskněte Control + C.To stop and remove the container, press Control+C.

Odebrat obrázek (nepovinné)Remove the image (optional)

Pokud image serveru Nginx už nepotřebujete, můžete ho místně pomocí odstranit docker rmi příkazu.If you no longer need the Nginx image, you can delete it locally with the docker rmi command.

docker rmi myregistry.azurecr.io/samples/nginx

Odebrání Image ze služby Azure container registry, můžete použít příkaz rozhraní příkazového řádku Azure az acr úložiště odstranit.To remove images from your Azure container registry, you can use the Azure CLI command az acr repository delete. Například následující příkaz odstraní manifest odkazuje samples/nginx:latest značku, všechna data jedinečný vrstvy a všechny ostatní značky odkazující na manifest.For example, the following command deletes the manifest referenced by the samples/nginx:latest tag, any unique layer data, and all other tags referencing the manifest.

az acr repository delete --name myregistry --image samples/nginx:latest

Další postupNext steps

Teď, když znáte základy, jste připraveni začít používat svůj registr!Now that you know the basics, you're ready to start using your registry! Například nasaďte Image kontejneru z registru pro:For example, deploy container images from your registry to:

Volitelně můžete nainstalovat rozšíření Dockeru pro Visual Studio Code a účet Azure rozšíření pro práci s vaší registry kontejnerů Azure.Optionally install the Docker Extension for Visual Studio Code and the Azure Account extension to work with your Azure container registries. O přijetí změn a nahrávání imagí do služby Azure container registry nebo spuštění úlohy služby ACR, vše v rámci Visual Studio Code.Pull and push images to an Azure container registry, or run ACR Tasks, all within Visual Studio Code.