Prise en main : Exécuter votre premier conteneur Windows

S’applique à : Windows Server 2025, Windows Server 2022, Windows Server 2019, Windows Server 2016

Cette rubrique explique comment exécuter votre premier conteneur Windows, après avoir configuré votre environnement comme décrit dans Prise en main : Préparation de Windows pour conteneurs. Pour exécuter un conteneur, vous devez d’abord télécharger (dans des conteneurs, également appelé opération d’extraction) une image de base, qui fournit à votre conteneur une couche fondamentale de services de système d’exploitation. Ensuite, vous créez et exécutez une image conteneur, basée sur l’image de base. Pour plus d’informations, lisez-le.

Extraire une image de base de conteneur

Tous les conteneurs sont créés à partir d’images de conteneur. Microsoft propose plusieurs images de démarrage, appelées images de base, à choisir (pour plus d’informations, consultez images de base conteneur). Cette procédure extrait (télécharge et installe) la légère image de base Nano Server.

1. Ouvrez une fenêtre d’invite de commandes (par exemple, l’invite de commandes intégrée, PowerShell ou Terminal Windows), puis exécutez la commande suivante pour télécharger et installer l’image de base :

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

   Si Docker ne parvient pas à démarrer lors de la tentative d’extraction de l’image, le démon Docker peut être inaccessible. Pour résoudre ce problème, essayez de redémarrer le service Docker.

   Conseil

   Si vous voyez un message d’erreur indiquant no matching manifest for linux/amd64 in the manifest list entries, vérifiez que Docker n’est pas configuré pour exécuter des conteneurs Linux. Pour basculer vers des conteneurs Windows dans Docker, cliquez avec le bouton droit sur l’icône Docker, puis sélectionnez Basculer vers des conteneurs Windows. Pour utiliser la ligne de commande pour basculer entre des conteneurs, exécutez & $Env:ProgramFiles\Docker\Docker\DockerCli.exe -SwitchDaemon.

2. Une fois l’image téléchargée, lisez la CLUF pendant que vous attendez et vérifiez son existence sur votre système en interrogeant votre référentiel d’images Docker local. L’exécution de la commande docker images retourne une liste d’images installées.

   Voici un exemple de sortie montrant l’image Nano Server.

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

Exécuter un conteneur Windows

Pour cet exemple simple, une image conteneur « Hello World » sera créée et déployée. 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 Windows PowerShell ISE, parce qu'elle ne fonctionne pas pour les sessions interactives avec des conteneurs, car les conteneurs semblent se bloquer).

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 :

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

2. Une fois le conteneur démarré, la fenêtre d’invite de commandes change le contexte du conteneur. Dans le conteneur, nous allons créer un fichier texte « Hello World » simple, puis quitter le conteneur en entrant les commandes suivantes :

   echo "Hello World!" > Hello.txt
   exit
   

3. Obtenez l’ID de conteneur pour le conteneur que vous venez de quitter en exécutant la commande docker ps :

   docker ps -a
   

4. Créez une image « HelloWorld » qui inclut les modifications apportées au premier conteneur que vous avez exécuté. Pour ce faire, exécutez la commande de validation Docker, en remplaçant <containerid> par l’ID de votre conteneur :

   docker commit <containerid> helloworld
   

   Vous disposez maintenant d’une image personnalisée qui contient le script hello world. Vous pouvez le voir avec la commande docker images.

   docker images
   

   Voici un exemple de sortie :

   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. Enfin, lancez le nouveau conteneur à l'aide de la commande docker run avec le paramètre --rm qui supprime automatiquement le conteneur une fois que la ligne de commande (cmd.exe) s'arrête.

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

   Le résultat est que Docker a créé un conteneur à partir de l’image « HelloWorld », Docker a démarré une instance de cmd.exe dans le conteneur, et cmd.exe a lu notre fichier et a sorti le contenu dans l’interpréteur de commandes. Lors de la dernière étape, Docker a arrêté et supprimé le conteneur.

Exécuter un conteneur Windows à l’aide de Windows Admin Center

Utilisez Windows Admin Center pour exécuter vos conteneurs localement. Plus précisément, utilisez l’extension Conteneurs de votre instance Windows Admin Center pour exécuter les conteneurs. Tout d’abord, ouvrez l’hôte de conteneur que vous souhaitez gérer et, dans le volet Outils, sélectionnez l’extension Conteneurs. Sélectionnez ensuite l’onglet Images à l’intérieur de l’extension Conteneur sous Hôte de Conteneur.

Si votre hôte n’a pas d’image conteneur de base, sélectionnez l’option Pull pour ouvrir les paramètres Pull Container Image :

Dans les paramètres Pull Container Image, fournissez l’URL de l’image et la balise. Si vous n’êtes pas certain de l’image à extraire, Windows Admin Center fournit une liste d’images courantes de Microsoft. Vous pouvez également fournir les informations d’identification pour extraire une image à partir d’un référentiel privé. Une fois que vous avez renseigné les informations nécessaires, sélectionnez Pull. Windows Admin Center démarre le processus d’extraction sur l’hôte du conteneur. Une fois le téléchargement terminé, vous voyez la nouvelle image sous l’onglet Images.

Sélectionnez l’image à exécuter, puis sélectionnez Exécuter.

Dans le menu Exécuter, configurez la configuration du conteneur, comme le nom du conteneur, le type d’isolation, les ports à publier, la mémoire et l’allocation du processeur. En outre, vous pouvez ajouter des commandes d’exécution Docker qui ne se trouvent pas dans l’interface utilisateur, telles que -v pour le volume persistant. Pour plus d’informations sur les paramètres d’exécution Docker disponibles, consultez la documentation .

Une fois la configuration terminée pour le conteneur, cliquez sur Exécuter. Vous pouvez voir l’état des conteneurs en cours d’exécution sous l’onglet Conteneurs :

onglet Conteneurs

Étapes suivantes

Découvrez comment conteneuriser un exemple d’application