Introdução: execute seu primeiro contêiner do Windows

Aplica-se a: Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows Server 2016

Este tópico descreve como executar seu primeiro contêiner do Windows, depois de configurar seu ambiente, conforme descrito em Introdução: Preparar o Windows para contêineres. Para executar um contentor, primeiro descarregue (no contexto de contentores, também denominado uma operação de pull) uma imagem de base, que fornece uma camada fundamental de serviços do sistema operativo para o seu contentor. Em seguida, você cria e executa uma imagem de contêiner, que é baseada na imagem base. Para mais detalhes, continue a ler.

Puxar uma imagem base de contêiner

Todos os contêineres são criados a partir de imagens de contêiner. A Microsoft oferece várias imagens iniciais, chamadas imagens base, para escolher (para obter mais detalhes, consulte Imagens de base de contêiner). Este procedimento extrai (baixa e instala) a imagem base leve do Nano Server.

1. Abra uma janela de prompt de comando (como o prompt de comando interno, PowerShell ou Windows Terminal) e execute o seguinte comando para baixar e instalar a imagem base:

   docker pull mcr.microsoft.com/windows/nanoserver:ltsc2022
   

   Se o Docker falhar ao iniciar ao tentar extrair a imagem, o daemon do Docker pode estar inacessível. Para resolver esse problema, tente reiniciar o serviço Docker.

   Dica

   Se você vir uma mensagem de erro dizendo no matching manifest for linux/amd64 in the manifest list entries, verifique se o Docker não está configurado para executar contêineres do Linux. Para alternar para contêineres do Windows no Docker, clique com o botão direito do mouse no ícone do Docker e selecione Alternar para contêineres do Windows. Para usar a linha de comando para alternar entre contêineres, execute & $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchDaemon.

2. Depois que o download da imagem for concluído, leia o do EULA enquanto aguarda e verifique a sua existência no seu sistema consultando o repositório local de imagens do Docker. A execução do comando docker images retorna uma lista de imagens instaladas.

   Aqui está um exemplo da saída mostrando a imagem do Nano Server.

   REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
   microsoft/nanoserver   latest              105d76d0f40e        4 days ago          652 MB
   

Executar um contêiner do Windows

Para este exemplo simples, uma imagem de contêiner 'Hello World' será criada e implantada. Para obter a melhor experiência, execute esses comandos em uma janela de prompt de comando elevada (mas não use o ISE do Windows PowerShell — ele não funciona para sessões interativas com contêineres, pois os contêineres parecem travar).

1. Inicie um contêiner com uma sessão interativa a partir da imagem nanoserver inserindo o seguinte comando na janela do prompt de comando:

   docker run -it mcr.microsoft.com/windows/nanoserver:ltsc2022 cmd.exe
   

2. Depois que o contêiner é iniciado, a janela do prompt de comando muda o contexto para o contêiner. Dentro do contêiner, criaremos um arquivo de texto 'Hello World' simples e, em seguida, sairemos do contêiner inserindo os seguintes comandos:

   echo "Hello World!" > Hello.txt
   exit
   

3. Obtenha o ID do contenedor do qual acabou de sair ao executar o comando docker ps:

   docker ps -a
   

4. Crie uma nova imagem 'HelloWorld' que inclua as alterações no primeiro contêiner que você executou. Para fazer isso, execute o comando docker commit, substituindo-<containerid> pelo ID do seu contêiner:

   docker commit <containerid> helloworld
   

   Agora você tem uma imagem personalizada que contém o script hello world. Pode ver-se isso com o comando docker images.

   docker images
   

   Aqui está um exemplo da saída:

   REPOSITORY                             TAG                 IMAGE ID            CREATED             SIZE
   helloworld                             latest              a1064f2ec798        10 seconds ago      258MB
   mcr.microsoft.com/windows/nanoserver   2022                2b9c381d0911        3 weeks ago         256MB
   

5. Finalmente, execute o novo contêiner usando o comando docker run com o parâmetro --rm que remove automaticamente o contêiner assim que a linha de comando (cmd.exe) para.

   docker run --rm helloworld cmd.exe /s /c type Hello.txt
   

   O resultado é que o Docker criou um contêiner a partir da imagem 'HelloWorld', o Docker iniciou uma instância de cmd.exe no contêiner e o cmd.exe ler nosso arquivo e enviar o conteúdo para o shell. Como etapa final, o Docker parou e removeu o contêiner.

Executar um contêiner do Windows usando o Windows Admin Center

Use o Windows Admin Center para executar seus contêineres localmente. Especificamente, use a extensão Containers da instância do Windows Admin Center para executar os contêineres. Primeiro, abra o host de contêiner que você deseja gerenciar e, no painel Ferramentas, selecione a extensão Contêineres. Em seguida, selecione o separador Imagens dentro da extensão Container sobre o Container Host.

Extensão de Contêiner

Se o seu anfitrião não tiver uma imagem base do contentor, selecione a opção Pull para abrir as definições de Pull Container Image:

Nas configurações do Pull Container Image, forneça o URL da imagem e a tag. Se você não tiver certeza de qual imagem extrair, o Windows Admin Center fornece uma lista de imagens comuns da Microsoft. Você também pode fornecer as credenciais para extrair uma imagem de um repositório privado. Depois de preencher os dados necessários, selecione Pull. O Windows Admin Center inicia o processo de pull no host do contêiner. Após a conclusão do download, verá a nova imagem no separador Imagens.

Selecione a imagem que deseja executar e selecione Executar.

No menu Executar, configure a configuração para o contêiner, como o nome do contêiner, o tipo de isolamento, quais portas publicar e a alocação de memória e CPU. Além disso, você pode acrescentar comandos de execução do Docker que não estão na interface do usuário, como -v para volume persistente. Para obter mais informações sobre os parâmetros de execução do Docker disponíveis, consulte a documentação do .

Depois de concluir a configuração do contêiner, clique em Executar. Pode ver o estado dos contêineres em execução no separador Contêineres.

Próximos passos

Saiba como colocar em contêineres um aplicativo de exemplo