Installation de Docker pour une utilisation avec la CLI  AWS SAM - AWS Serverless Application Model
Installation deDockerÉtapes suivantes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installation de Docker pour une utilisation avec la CLI  AWS SAM

Docker est une application qui exécute des conteneurs sur votre machine. AvecDocker, AWS SAM peut fournir un environnement local similaire à AWS Lambda un conteneur pour créer, tester et déboguer vos applications sans serveur.

Note

Docker n'est requis que pour tester vos applications localement et pour créer des packages de déploiement à l'aide de l'option --use-container.

Installation deDocker

Pour installer Docker sur votre système d'exploitation, suivez ces instructions.

Docker est disponible sur de nombreux systèmes d'exploitation différents, y compris les distributions Linux les plus modernes, telles que CentOS, Debian et Ubuntu. Pour plus d'informations sur l'installation de Docker sur votre système d'exploitation particulier, veuillez consulter la section Obtenir Docker sur le site web Docker Docs (langue française non garantie).

Pour installer Docker sur Amazon Linux 2 ou Amazon Linux 2023

  1. Mettez à jour les packages installés et le cache du package sur votre instance.

    $ sudo yum update -y

  2. Installez la version la plus récente du package Docker Community Edition.

    • Pour Amazon Linux 2, exécutez la commande suivante :

      $ sudo amazon-linux-extras install docker

    • Pour Amazon Linux 2023, exécutez la commande suivante :

      $ sudo yum install -y docker

  3. Lancez le service Docker.

    $ sudo service docker start

  4. Ajoutez ec2-user au groupe docker afin de pouvoir exécuter les commandes Docker sans utiliser sudo.

    $ sudo usermod -a -G docker ec2-user

  5. Déconnectez-vous et reconnectez-vous pour récupérer les nouvelles autorisations de groupe docker. Pour cela, fermez votre fenêtre de terminal SSH actuelle et en vous reconnectant à votre instance dans une nouvelle fenêtre. Votre nouvelle session SSH devrait disposer des autorisations de groupe docker appropriées.

  6. Vérifiez que ec2-user puisse exécuter les commandes Docker sans utiliser sudo.

    $ docker ps

    La sortie suivante doit s'afficher. Elle confirme que Docker est installé et en cours d'exécution :

     CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
Note

Sous Linux, pour créer et exécuter des fonctions Lambda avec une architecture de jeu d'instructions différente de celle de votre machine hôte, la configuration de Docker nécessite quelques étapes supplémentaires. Par exemple, pour exécuter des fonctions arm64 sur une machine x86_64, vous pouvez exécuter la commande suivante afin de configurer le démon Docker : docker run --rm --privileged multiarch/qemu-user-static --reset -p yes.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section Résolution des erreurs d'installation. Ou, consultez la section Dépannage de Étapes de post-installation pour Linux sur le site web Docker Docs.

Note

Docker Desktop est officiellement pris en charge, mais à partir de la version 1.47.0 de la CLI  AWS SAM, vous pouvez utiliser des alternatives tant qu'elles utilisent le moteur d'exécution Docker.

  1. Installer Docker

    La CLI  AWS SAM prend en charge Docker s'exécutant sur macOS Sierra 10.12 ou version ultérieure. Pour découvrir comment installer Docker, veuillez consulter la section Installer Docker Desktop pour Mac sur le site web Docker Docs (langue française non garantie).

  2. Configurer vos lecteurs partagés

    Le AWS SAMCLI nécessite que le répertoire du projet, ou tout répertoire parent, soit répertorié sur un lecteur partagé. Cela peut nécessiter le partage de fichiers. Pour plus d'informations, consultez la rubrique de résolution des problèmes liés au montage de volumes nécessitant le partage de fichiers dans la section Documents Docker.

  3. Vérifier l'installation

    Une fois Docker installé, vérifiez qu'il fonctionne. Confirmez également que vous pouvez exécuter des commandes Docker à partir de la ligne de commande (par exemple, docker ps). Vous n'avez pas besoin d'installer, de récupérer ou de tirer un conteneur, la CLI  AWS SAM le fait automatiquement selon les besoins.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section Dépannage et diagnostic du site web Docker Docs afin d'obtenir davantage de conseils de dépannage (langue française non garantie).

Note

AWS SAM prend officiellement en charge Docker Desktop. Toutefois, à partir de la version 1.47.0 de la CLI  AWS SAM, vous pouvez utiliser des alternatives tant qu'elles utilisent le moteur d'exécution Docker.

  1. Installer Docker.

    Docker Desktop prend en charge la version la plus récente du système d'exploitation Windows. Pour les versions héritées de Windows, la boîte à outils Docker est disponible. Choisissez votre version de Windows pour les étapes d'installation correctes de Docker :

    • Pour installer Docker sous Windows 10, veuillez consulter la section Installer Docker Desktop pour Windows sur le site web Docker Docs (langue française non garantie).

    • Pour effectuer l'installation Docker pour les versions antérieures de Windows, voir The Docker Toolbox dans le référentiel Docker Toolbox. GitHub

  2. Configurez vos lecteurs partagés.

    Le AWS SAMCLI nécessite que le répertoire du projet, ou tout répertoire parent, soit répertorié sur un lecteur partagé. Dans certains cas, vous devez partager votre disque pour que Docker fonctionne correctement.

  3. Vérifiez l’installation.

    Une fois Docker installé, vérifiez qu'il fonctionne. Confirmez également que vous pouvez exécuter des commandes Docker à partir de la ligne de commande (par exemple, docker ps). Vous n'avez pas besoin d'installer, de récupérer ou de tirer un conteneur, la CLI  AWS SAM le fait automatiquement selon les besoins.

Si vous rencontrez des problèmes lors de l'installation de Docker, veuillez consulter la section Dépannage et diagnostic du site web Docker Docs afin d'obtenir davantage de conseils de dépannage (langue française non garantie).

Étapes suivantes

Pour savoir comment installer le AWS SAMCLI, voirInstaller la CLI  AWS SAM.