Prise en main : exécuter votre premier conteneur WindowsGet started: Run your first Windows container

Cette rubrique décrit comment exécuter votre premier conteneur Windows, après la configuration de votre environnement, comme décrit dans prise en main : préparer Windows pour les conteneurs.This topic describes how to run your first Windows container, after setting up your environment as described in Get started: Prep Windows for containers. Pour exécuter un conteneur, vous devez d’abord installer une image de base qui fournit à votre conteneur une couche fondamentale de services de système d’exploitation.To run a container, you first install a base image, which provides a foundational layer of operating system services to your container. Ensuite, vous créez et exécutez une image de conteneur, qui est basée sur l’image de base.Then you create and run a container image, which is based upon the base image. Pour plus d’informations, consultez.For details, read on.

Installer une image de base de conteneurInstall a container base image

Tous les conteneurs sont créés à partir d’images de conteneur.All containers are created from container images. Microsoft propose plusieurs images de démarrage, appelées images de base, à choisir. pour en savoir plus, consultez images de base du conteneur.Microsoft offers several starter images, called base images, to choose from (for more details, see Container base images). Cette procédure extrait (télécharge et installe) l’image de base nano Server légère.This procedures pulls (downloads and installs) the lightweight Nano Server base image.

  1. Ouvrez une fenêtre d’invite de commandes (telle que l’invite de commandes intégrée, PowerShell ou Windows Terminal), puis exécutez la commande suivante pour télécharger et installer l’image de base :Open a command prompt window (such as the built-in command prompt, PowerShell, or Windows Terminal), and then run the following command to download and install the base image:

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

    Conseil

    Si vous voyez s’afficher un message d’erreur no matching manifest for unknown in the manifest list entries, assurez-vous que la station d’accueil n’est pas configurée pour exécuter des conteneurs Linux.If you see an error message that says no matching manifest for unknown in the manifest list entries, make sure Docker isn't configured to run Linux containers.

  2. Une fois le téléchargement de l’image terminé, lisez le CLUF en cours d’attente. Vérifiez qu’il existe sur votre système en interrogeant votre référentiel d’images de l’arrimeur local.After the image is finished downloading—read the EULA while you wait—verify it's existence on your system by querying your local docker image repository. L’exécution de la commande docker images retourne une liste d’images installées.Running the command docker images returns a list of installed images.

    Voici un exemple de la sortie qui affiche l’image nano Server.Here's an example of the output showing the Nano Server image.

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

Exécuter un conteneur WindowsRun a Windows container

Pour cet exemple simple, une image de conteneur « Hello World » est créée et déployée.For this simple example, a ‘Hello World’ container image will be created and deployed. Pour une expérience optimale, exécutez ces commandes dans une fenêtre d’invite de commandes avec élévation de privilèges (mais n’utilisez pas la Windows PowerShell ISE, elle ne fonctionne pas pour les sessions interactives avec des conteneurs, car les conteneurs semblent se bloquer).For the best experience, run these commands in an elevated command prompt window (but don't use the Windows PowerShell ISE—it doesn't work for interactive sessions with containers, as the containers appear to hang).

  1. Démarrez un conteneur avec une session interactive à partir de l’image nanoserver en entrant la commande suivante dans la fenêtre d’invite de commandes :Start a container with an interactive session from the nanoserver image by entering the following command in your command prompt window:

    docker run -it mcr.microsoft.com/windows/nanoserver:1903 cmd.exe
    
  2. Une fois le conteneur démarré, la fenêtre d’invite de commandes change de contexte dans le conteneur.After the container is started, the command prompt window changes context to the container. À l’intérieur du conteneur, nous allons créer un fichier texte « Hello World » simple, puis quitter le conteneur en entrant les commandes suivantes :Inside the container, we'll create a simple ‘Hello World’ text file and then exit the container by entering the following commands:

    echo "Hello World!" > Hello.txt
    exit
    
  3. Récupérez l’ID de conteneur pour le conteneur que vous venez de quitter en exécutant la commande dockr PS :Get the container ID for the container you just exited by running the docker ps command:

    docker ps -a
    
  4. Créez une nouvelle image « HelloWorld » qui comprend les modifications apportées au premier conteneur que vous avez exécuté.Create a new ‘HelloWorld’ image that includes the changes in the first container you ran. Pour ce faire, exécutez la commande dockr commit , en remplaçant <containerid> par l’ID de votre conteneur :To do so, run the docker commit command, replacing <containerid> with the ID of your container:

    docker commit <containerid> helloworld
    

    Quand vous avez terminé, vous disposez d’une image personnalisée qui contient le script « Hello World ».When completed, you now have a custom image that contains the hello world script. Vous pouvez le voir avec la commande dockers images .This can be seen with the docker images command.

    docker images
    

    Voici un exemple de sortie :Here's an example of the output:

    REPOSITORY                             TAG                 IMAGE ID            CREATED             SIZE
    helloworld                             latest              a1064f2ec798        10 seconds ago      258MB
    mcr.microsoft.com/windows/nanoserver   1903                2b9c381d0911        3 weeks ago         256MB
    
  5. Enfin, exécutez le nouveau conteneur à l’aide de la commande dockr Run avec le paramètre --rm qui supprime automatiquement le conteneur une fois que la ligne de commande (cmd. exe) s’arrête.Finally, run the new container by using the docker run command with the --rm parameter that automatically removes the container once the command line (cmd.exe) stops.

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

    Le résultat est qu’un conteneur a été créé à partir de l’image « HelloWorld », une instance de cmd. exe a été démarrée dans le conteneur qui lit notre fichier et génère le contenu du fichier dans le shell, puis le conteneur s’est arrêté et a été supprimé.The result is that a container was created from the 'HelloWorld' image, an instance of cmd.exe was started in the container that read our file and output the file contents to the shell, and then the container stopped and was removed.

Étapes suivantesNext steps