Compartir a través de


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.

    Captura de pantalla de Windows Admin Center. En la extensión Contenedores, en la pestaña Imágenes se muestra información sobre las imágenes, como el repositorio y el identificador de imagen.

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.

    Captura de pantalla del cuadro de diálogo Extraer imagen de contenedor, con campos para el repositorio y la etiqueta. Hay varias imágenes comunes de Windows disponibles para su selección.

  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 .

    Captura de pantalla del cuadro de diálogo Ejecutar imagen, con campos para el nombre del contenedor y otra información. Hay un botón Agregar disponible para configurar las opciones.

  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.

    Captura de pantalla de Windows Admin Center. En la extensión Contenedores, en la pestaña Contenedores se muestra información sobre un contenedor, como el identificador y el estado.

Paso siguiente