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

2025-06-10

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

Este artigo mostra como executar seu primeiro contêiner do Windows depois de configurar seu ambiente, conforme descrito em Introdução: Preparar o Windows para contêineres. A execução de um contêiner envolve duas etapas gerais:

Baixando uma imagem base. Com contêineres, o processo de download de uma imagem base é conhecido como uma operação de pull. A imagem base fornece uma camada fundamental de serviços do sistema operacional para seu contêiner.
Criando e executando uma imagem de contêiner baseada na imagem base.

Efetuar pull de uma imagem base do contêiner

Todos os contêineres são criados a partir de imagens de contêiner. A Microsoft oferece várias imagens iniciais, chamadas de imagens base, para escolher. Para obter mais informações, consulte imagens base de contêiner.

Você pode usar o procedimento a seguir para baixar a imagem base leve do Nano Server ou, em outras palavras, para baixar e instalar essa imagem.

Abra uma janela do console, como o Prompt de Comando interno, o PowerShell ou o Terminal do Windows.
Execute o seguinte comando para baixar e instalar a imagem base:
```
docker pull mcr.microsoft.com/windows/nanoserver:ltsc2022
```
Enquanto aguarda, leia os termos da licença complementar da imagem.

Se o Docker não iniciar quando você tentar baixar a imagem, o daemon do Docker poderá estar inacessível. Para resolver esse problema, reinicie o serviço docker.
Dica

Se você vir a mensagem de erro"Nenhum manifesto correspondente para linux/amd64 nas entradas da lista de manifestos", o Docker poderá ser configurado para executar contêineres do Linux em vez de contêineres do Windows. Para alternar para contêineres do Windows no Docker, execute uma das seguintes etapas:
- Na bandeja do sistema Windows, clique com o botão direito do mouse no ícone do Docker e selecione Alternar para contêineres do Windows.
- Em um prompt de comando, execute & $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchDaemon.
Verifique a existência da imagem em seu sistema consultando o repositório de imagem local do Docker. Você pode executar essa verificação executando o docker images comando, que retorna uma lista de imagens instaladas.

Aqui está um exemplo de saída desse comando, que mostra a imagem do Nano Server.
```
REPOSITORY                             TAG        IMAGE ID       CREATED      SIZE
mcr.microsoft.com/windows/nanoserver   ltsc2022   4f0ead5b1b67   6 days ago   296MB
```

Executar um contêiner do Windows

Para este exemplo básico, você cria e implanta uma imagem de contêiner Hello World. Para obter a melhor experiência, execute os comandos nesta seção em um prompt de comando com privilégios elevados. Mas não use o ISE (Ambiente de Script Integrado) do Windows PowerShell. Não é adequado para sessões interativas com contêineres— os contêineres parecem parar de responder.

Inicie um contêiner com uma sessão interativa da imagem nanoserver inserindo o seguinte comando em um prompt de comando.
```
docker run -it mcr.microsoft.com/windows/nanoserver:ltsc2022 cmd.exe
```
O contêiner é iniciado e a janela do console altera o contexto para o contêiner.
Dentro do contêiner, execute os comandos a seguir. O primeiro comando cria um arquivo de texto que contém a frase "Olá, Mundo!" O segundo comando sai do contêiner.
```
echo "Hello World!" > Hello.txt
exit
```
Obtenha a ID do contêiner que você acabou de sair executando o docker ps comando:
```
docker ps -a
```
Crie uma nova helloworld imagem que inclua as alterações no primeiro contêiner que você executou. Para fazer isso, execute o docker commit comando, substituindo <container-ID> pela ID do contêiner:
```
docker commit <container-ID> helloworld
```
Agora você tem uma imagem personalizada que contém o arquivo Hello.txt. Você pode usar o docker images comando para ver a nova imagem.
```
docker images
```
Aqui está um exemplo da saída:
```
REPOSITORY                             TAG        IMAGE ID       CREATED          SIZE
helloworld                             latest     81013d6b73ae   25 seconds ago   299MB
mcr.microsoft.com/windows/nanoserver   ltsc2022   4f0ead5b1b67   6 days ago       296MB
```
Execute o novo contêiner usando o docker run comando com a opção --rm . Quando você usa essa opção, o Docker remove automaticamente o contêiner quando o comando, cmd.exe nesse caso, é interrompido.
```
docker run --rm helloworld cmd.exe /s /c type Hello.txt
```
O Docker cria um contêiner a partir da imagem helloworld e inicia uma instância de cmd.exe no contêiner. O cmd.exe processo lê o arquivo Hello.txt e grava o conteúdo na janela do console. Como a etapa final, o Docker para e remove o contêiner.

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

Você pode usar o Windows Admin Center para executar seus contêineres localmente. Especificamente, você pode usar a extensão Contêineres do Windows Admin Center para essa finalidade.

Exibir imagens de contêiner

Abra o host de contêiner que você deseja gerenciar.
No painel Ferramentas , selecione Contêineres para abrir a extensão Contêineres.
No painel principal, em Host de contêiner, selecione Imagens.

Baixar uma imagem de contêiner

Se o host não tiver uma imagem de contêiner base, selecione Pull para abrir a caixa de diálogo Pull Container Image .
Na caixa de diálogo Pull Container Image, insira a URL da imagem e a tag.
- Se você não tiver certeza de qual imagem deve ser extraída, expanda imagens comuns do Windows para ver uma lista de imagens comuns da Microsoft.
- Se você quiser extrair uma imagem de um repositório privado, expanda a autenticação do Registro para inserir as credenciais.
Selecione Pull. O Windows Admin Center inicia o processo de pull no host do contêiner. Quando o download for concluído, você verá a nova imagem na guia Imagens .

Executar uma imagem

Selecione a imagem que você deseja executar e selecione Executar. A caixa de diálogo Executar imagem é aberta.
Na caixa de diálogo Executar imagem, insira informações para configurar o contêiner, como o nome do contêiner, o tipo de isolamento, as portas a serem publicadas e a alocação de memória e CPU. Você também pode adicionar opções para acrescentar ao docker run comando, como -v especificar um volume persistente. Para obter mais informações sobre os parâmetros disponíveis docker run , consulte docker container run.
Selecione Executar. A guia Contêineres exibe o status dos contêineres em execução.

Próxima etapa

Veja como colocar um aplicativo de exemplo em contêineres