Bien démarrer : Exécuter votre premier conteneur Windows

S’applique à : 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éparer Windows pour les conteneurs. Pour exécuter un conteneur, vous devez d’abord télécharger (dans des conteneurs, également appelé opération de tirage) 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 de conteneur, qui repose sur l’image de base. Pour plus d’informations, consultez les références.

Tirer une image de base de conteneur

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

1. Ouvrez une fenêtre d’invite de commandes (telle que 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 le démarrage du Docker échoue lors de la tentative d’extraction de l’image, le démon Docker est peut être inaccessible. Pour résoudre ce problème, essayez de redémarrer le service Docker.

   Conseil

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

2. Une fois le téléchargement de l’image terminé, consultez le CLUF. Vérifiez sa présence 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 illustrant l’image Nano Server.

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

Créer un conteneur Windows

Pour ce simple exemple, une image de conteneur « Hello World » est 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 l'environnement d'écriture de scripts intégré de Windows PowerShell, celui-ci ne fonctionnant 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 de contexte dans le conteneur. À l’intérieur du 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. Récupérez l’ID correspondant au conteneur que vous venez de quitter en exécutant la commande docker ps :

   docker ps -a
   

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

   docker commit <containerid> helloworld
   

   Quand vous avez terminé, vous disposez d’une image personnalisée qui contient le script « Hello World ». Pour l’afficher, utilisez 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, exécutez le nouveau conteneur à l’aide de la commande docker run avec le paramètre --rm qui supprime automatiquement le conteneur une fois la ligne de commande (cmd. exe) arrêtée.

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

   Résultat : Docker a créé un conteneur à partir de l’image « HelloWorld », Docker a démarré une instance de cmd.exe dans le conteneur, laquelle a lu notre fichier et a généré le contenu dans le shell. Comme dernière étape, Docker a arrêté et supprimé le conteneur.

Exécuter un conteneur Windows en utilisant Windows Admin Center

Vous pouvez utiliser Windows Admin Center pour exécuter vos conteneurs localement. Plus précisément, vous 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 voulez gérer et, dans le volet Outils, sélectionnez l’extension Conteneurs. Ensuite, sélectionnez l’onglet Images à l’intérieur de l’extension Conteneurs sous Hôte de conteneur.

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

Dans les paramètres de Extraire l’image conteneur, spécifiez l’URL de l’image et la balise. Si vous n’êtes pas certain de l’image à extraire, notez que 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 dépôt privé. Une fois que vous avez renseigné les informations nécessaires, cliquez sur Extraire. Windows Admin Center va démarrer le processus d’extraction sur l’hôte de conteneur. Une fois le téléchargement terminé, la nouvelle image apparaît sous l’onglet Images.

Sélectionnez l’image que vous voulez exécuter, puis cliquez sur Suivant.

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

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

Étapes suivantes

Apprendre à conteneuriser un exemple d’application