Introducción: Ejecución del primer contenedor de Windows

Se aplica a: Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows Server 2016

En este artículo se muestra cómo ejecutar el primer contenedor de Windows, después de configurar el entorno como se describe en Introducción: Preparación de Windows para contenedores. La ejecución de un contenedor implica dos pasos generales:

• Descargar una imagen base. Con los contenedores, el proceso de descarga de una imagen base se conoce como una operación de extracción. La imagen base proporciona una capa fundamental de servicios de sistema operativo al contenedor.
• Crear y ejecutar una imagen de contenedor basada en la imagen base.

Extracción de una imagen base de contenedor

Todos los contenedores se crean a partir de imágenes de contenedor. Microsoft ofrece varias imágenes de inicio, llamadas imágenes base, entre las que elegir. Para obtener más información, consulte Imágenes base de contenedor.

Puede usar el siguiente procedimiento para extraer la imagen base ligera de Nano Server o, en otras palabras, para descargar e instalar esa imagen.

1. Abra una ventana de consola, como el Símbolo del sistema integrado, PowerShell o Windows Terminal.

2. Ejecute el siguiente comando para descargar e instalar la imagen base:

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

   Mientras espera, lea los términos de la licencia complementaria para la imagen.

   Si Docker no se inicia al intentar descargar la imagen, es posible que no se pueda acceder al demonio de Docker. Para resolver este problema, reinicie el servicio Docker.

   Sugerencia

   Si ve el mensaje de error "No hay manifiesto coincidente para linux/amd64 en las entradas de la lista de manifiestos", Docker podría configurarse para ejecutar contenedores de Linux en lugar de contenedores de Windows. Para cambiar a contenedores de Windows en Docker, siga uno de los pasos siguientes:

   • En la bandeja del sistema de Windows, haga clic con el botón derecho en el icono de Docker y seleccione Cambiar a contenedores de Windows.
   • En un intérprete de comandos, ejecute & $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchDaemon.

3. Compruebe la existencia de la imagen en el sistema consultando el repositorio de imágenes de Docker local. Para realizar esta comprobación, ejecute el docker images comando , que devuelve una lista de imágenes instaladas.

   Este es un ejemplo de salida de ese comando, que muestra la imagen de Nano Server.

   REPOSITORY                             TAG        IMAGE ID       CREATED      SIZE
   mcr.microsoft.com/windows/nanoserver   ltsc2022   4f0ead5b1b67   6 days ago   296MB
   

Ejecución de un contenedor de Windows

En este ejemplo básico, crea e implementa una imagen de contenedor de Hola Mundo. Para obtener la mejor experiencia, ejecute los comandos de esta sección en una terminal con privilegios elevados. Pero no use el entorno de scripting integrado (ISE) de Windows PowerShell. No es adecuado para sesiones interactivas con contenedores; los contenedores parecen dejar de responder.

1. Inicie un contenedor con una sesión interactiva a partir de la imagen nanoserver ingresando el siguiente comando en el terminal:

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

   Cuando el contenedor se inicia, la ventana de la consola cambia de contexto al contenedor.

2. Dentro del contenedor, ejecute los siguientes comandos. El primer comando crea un archivo de texto que contiene la frase "Hello World!" El segundo comando sale del contenedor.

   echo "Hello World!" > Hello.txt
   exit
   

3. Ejecute el docker ps comando para obtener el identificador de contenedor del contenedor que acaba de salir:

   docker ps -a
   

4. Cree una nueva imagen helloworld que incluya los cambios realizados en el primer contenedor que ejecutó. Para ello, ejecute el docker commit comando y reemplace <container-ID> por el identificador del contenedor:

   docker commit <container-ID> helloworld
   

   Ahora tiene una imagen personalizada que contiene el archivo Hello.txt. Puede usar el docker images comando para ver la nueva imagen.

   docker images
   

   Este es un ejemplo de la salida:

   REPOSITORY                             TAG        IMAGE ID       CREATED          SIZE
   helloworld                             latest     81013d6b73ae   25 seconds ago   299MB
   mcr.microsoft.com/windows/nanoserver   ltsc2022   4f0ead5b1b67   6 days ago       296MB
   

5. Ejecute el nuevo contenedor mediante el docker run comando con la --rm opción . Cuando se usa esta opción, Docker quita automáticamente el contenedor cuando el comando, cmd.exe en este caso, se detiene.

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

   Docker crea un contenedor a partir de la helloworld imagen e inicia una instancia de cmd.exe en el contenedor. El cmd.exe proceso lee el archivo Hello.txt y escribe el contenido en la ventana de la consola. Como último paso, Docker detiene y quita el contenedor.

Ejecución de un contenedor de Windows mediante Windows Admin Center

Puedes usar Windows Admin Center para ejecutar los contenedores localmente. En concreto, puedes usar la extensión Containers de Windows Admin Center para este propósito.

Visualización de imágenes de contenedor

1. Abra el host de contenedor que desea administrar.

2. En el panel Herramientas , seleccione Contenedores para abrir la extensión Containers.

3. En el panel principal, en Host de contenedor, seleccione Imágenes.

   

Descargar una imagen de contenedor

1. Si el host no tiene una imagen de contenedor base, seleccione Descargar para abrir el cuadro de diálogo Descargar imagen de contenedor.

   

2. En el cuadro de diálogo Obtener imagen de contenedor, escriba la dirección URL de la imagen y la etiqueta.

   • Si no está seguro de qué imagen se va a extraer, expanda Imágenes comunes de Windows para ver una lista de imágenes comunes de Microsoft.
   • Si desea extraer una imagen de un repositorio privado, expanda Autenticación del Registro para escribir las credenciales.

3. Seleccione Extraer. Windows Admin Center inicia el proceso de extracción en el host del contenedor. Una vez completada la descarga, verá la nueva imagen en la pestaña Imágenes .

Ejecutar una imagen

1. Seleccione la imagen que desea ejecutar y, a continuación, seleccione Ejecutar. Se abre el cuadro de diálogo Ejecutar imagen .

   

2. En el cuadro de diálogo Ejecutar imagen , escriba información para configurar el contenedor, como el nombre del contenedor, el tipo de aislamiento, los puertos que se van a publicar y la asignación de memoria y CPU. También puede agregar opciones para anexar al docker run comando, como -v para especificar un volumen persistente. Para obtener más información sobre los parámetros disponibles docker run , vea docker container run.

3. Seleccione Ejecutar. La pestaña Contenedores muestra el estado de los contenedores en ejecución.

   

Paso siguiente

Vea cómo incluir en contenedores una aplicación de ejemplo