Utilisation de l'image Docker officielle de l’AWS CLI version 2

Cette rubrique décrit comment exécuter, contrôler la version et configurer l'AWS CLI version 2 sur Docker. Pour de plus amples informations sur l'utilisation de Docker, veuillez consulter la Documentation de Docker.

Les images Docker officielles fournissent l'isolation, la portabilité et la sécurité qu'AWS prend en charge et gère directement. Cela vous permet d'utiliser l'AWS CLI version 2 dans un environnement à base de conteneur sans avoir à gérer l'installation vous-même.

Note

L'AWS CLI version 2 est le seul outil qui est pris en charge sur l'image Docker officielle d’AWS

Prerequisites

Docker doit être installé. Pour obtenir les instructions d'installation, consultez le site web Docker.

Pour vérifier votre installation de Docker, exécutez la commande suivante et vérifiez qu'il existe une sortie.

$ docker --version
Docker version 19.03.1

Exécuter l'image Docker officielle de l’AWS CLI version 2

L'image AWS CLI version 2 Docker officielle est hébergée sur DockerHub dans le amazon/aws-cli référentiel . La première fois que vous utilisez la commande docker run, l'image Docker la plus récente est téléchargée sur votre ordinateur. Chaque utilisation ultérieure de la commande docker run s'exécute à partir de votre copie locale.

Pour exécuter l'image Docker de l'AWS CLI version 2 Docker, utilisez la commande docker run

$ docker run --rm -it amazon/aws-cli command

La commande fonctionne de la manière suivante :

• docker run --rm -it amazon/aws-cli – Équivalent de l'exécutable aws Chaque fois que vous exécutez cette commande, Docker lance un conteneur de votre image amazon/aws-cli téléchargée et exécute votre commande aws Par défaut, l'image Docker utilise la dernière version de l’AWS CLI version 2.

  Par exemple, pour appeler la commande aws --version dans Docker, vous exécutez ce qui suit.

  $ docker run --rm -it amazon/aws-cli --version
  aws-cli/2.1.24 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.0.0dev10

• --rm – Spécifie de nettoyer le conteneur après la fin de la commande.

• -it – Spécifie d'ouvrir un pseudo TTY avec stdin. Cela vous permet de fournir une entrée à l' AWS CLI version 2 pendant qu'il s'exécute dans un conteneur, par exemple, en utilisant les aws configure commandes aws help et . -it n'est pas nécessaire si vous exécutez des scripts. Si vous rencontrez des erreurs avec vos scripts, omettez -it de votre appel Docker.

Pour de plus amples informations sur la commande docker run, veuillez consulter le guide de référence Docker.

Utiliser des versions et des balises spécifiques

L'image Docker officielle de l'AWS CLI version 2 a plusieurs versions que vous pouvez utiliser, en commençant par la version 2.0.6. Pour exécuter une version spécifique de l'AWS CLI version 2, ajoutez la balise appropriée à votre commande docker run La première fois que vous utilisez la commande docker run avec une balise, la dernière image Docker de cette balise est téléchargée sur votre ordinateur. Chaque utilisation ultérieure de la commande docker run avec cette balise s'exécute à partir de votre copie locale.

Vous pouvez utiliser deux types de balises :

• latest – Définit la dernière version de l'AWS CLI version 2 pour l'image Docker. Nous vous recommandons d'utiliser la balise latest lorsque vous souhaitez obtenir la dernière version de l’AWS CLI version 2. Cependant, il n'y a aucune garantie de compatibilité descendante lorsque vous utilisez cette balise. La balise latest est utilisée par défaut dans la commande docker run Pour utiliser explicitement la balise latest, ajoutez la balise au nom de l'image du conteneur.

  $ docker run --rm -it amazon/aws-cli:latest command

• <major.minor.patch> – Définit une version spécifique de l'AWS CLI version 2 pour l'image Docker. Si vous envisagez d'utiliser l'image Docker en production, nous vous recommandons d'utiliser une version spécifique de l'AWS CLI version 2 pour garantir la compatibilité descendante. Par exemple, pour exécuter la version 2.0.6, ajoutez la version au nom de l'image du conteneur.

  $ docker run --rm -it amazon/aws-cli:2.0.6 command

Mettre à jour vers la dernière image Docker

Étant donné que la dernière image Docker n'est téléchargée sur votre ordinateur que la première fois que vous utilisez la commande docker run, vous devez extraire manuellement une image mise à jour. Pour mettre à jour manuellement vers la dernière version, nous vous recommandons d'extraire l'image balisée latest L'extraction de l'image Docker télécharge la dernière version sur votre ordinateur.

$ docker pull amazon/aws-cli:latest

Partage des fichiers hôtes, des informations d'identification, des variables d'environnement et de la configuration

Étant donné que l'AWS CLI version 2 est exécutée dans un conteneur, par défaut l'interface de ligne de commande ne peut pas accéder au système de fichiers hôte, qui inclut la configuration et les informations d'identification. Pour partager le système de fichiers hôte, les informations d'identification et la configuration avec le conteneur, montez le répertoire ~/.aws du système hôte sur le conteneur à l'adresse /root/.aws avec l'indicateur -v défini sur la commande docker run Cela permet à l'AWS CLI version 2 s'exécutant dans le conteneur de localiser les informations du fichier hôte.

Linux and macOS

$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli command

Windows

$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli command

Pour de plus amples informations sur l'indicateur -v et le montage, veuillez consulter le guide de référence Docker.

Exemple 1 : Fourniture d'informations d'identification et configuration

Dans cet exemple, nous fournissons les informations d'identification de l'hôte et la configuration lors de l'exécution de la commande s3 ls pour répertorier vos compartiments dans Amazon Simple Storage Service (Amazon S3). Les exemples ci-dessous utilisent l'emplacement par défaut pour les AWS CLI informations d'identification et les fichiers de configuration. Pour utiliser un autre emplacement, modifiez le chemin d'accès au fichier.

Linux and macOS

$ docker run --rm -it -v ~/.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Windows

$ docker run --rm -it -v %userprofile%\.aws:/root/.aws amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Vous pouvez appeler des variables d'environnement spécifiques du système à l'aide de -e l'indicateur . Pour utiliser une variable d'environnement, appelez-la par son nom.

Linux and macOS

$ docker run --rm -it -v ~/.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Windows

$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Exemple 2 : Téléchargement d'un fichier Amazon S3 sur votre système hôte

Pour certaines commandes AWS CLI v2, vous pouvez lire les fichiers du système hôte dans le conteneur ou écrire des fichiers du conteneur sur le système hôte.

Dans cet exemple, nous téléchargeons l'objet S3 s3://aws-cli-docker-demo/hello sur votre système de fichiers local en installant le répertoire de travail actuel dans le répertoire /aws du conteneur. En téléchargeant l'objet hello dans le répertoire /aws du conteneur, le fichier est également enregistré dans le répertoire de travail actuel du système hôte.

Linux and macOS

$ docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello

Windows

$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
download: s3://aws-cli-docker-demo/hello to ./hello

Pour confirmer que le fichier téléchargé existe dans le système de fichiers local, exécutez la procédure suivante.

Linux and macOS

$ cat hello
Hello from Docker!

Windows

$ type hello
Hello from Docker!

Exemple 3 : Utilisation de votre variable d'environnement AWS_PROFILE

Vous pouvez appeler les variables d'environnement du système spécifique à l'aide de -e l'indicateur . Appelez chaque variable d'environnement que vous souhaitez utiliser. Dans cet exemple, nous fournissons les informations d'identification de l'hôte, la configuration et AWS_PROFILE variable d'environnement lors de l'exécution de la s3 ls commande pour répertorier vos compartiments dans Amazon Simple Storage Service ().Amazon S3

Linux and macOS

$ docker run --rm -it -v ~/.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Windows

$ docker run --rm -it -v %userprofile%\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls
2020-03-25 00:30:48 aws-cli-docker-demo

Abréger la commande Docker

Pour abréger la aws commande Docker , nous vous suggérons d'utiliser la capacité de votre système d'exploitation pour créer un symbolic link (symlink) ou alias sous Linux et macOS, ou doskey sous Windows. Pour définir l'alias aws, vous pouvez exécuter l'une des commandes suivantes.

• Pour un accès de base aux commandes aws, exécutez la procédure suivante.

  Linux and macOS

  $ alias aws='docker run --rm -it amazon/aws-cli'

  Windows

  C:\> doskey aws=docker run --rm -it amazon/aws-cli $*

• Pour accéder au système de fichiers hôte et aux paramètres de configuration lors de l'utilisation des commandes aws, exécutez la procédure suivante.

  Linux and macOS

  $ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli'

  Windows

  C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli $*

• Pour affecter une version spécifique à utiliser dans votre alias aws, ajoutez votre balise de version.

  Linux and macOS

  $ alias aws='docker run --rm -it -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli:2.0.6'

  Windows

  C:\> doskey aws=docker run --rm -it -v %userprofile%\.aws:/root/.aws -v %cd%:/aws amazon/aws-cli:2.0.6 $*

Après avoir défini votre alias, vous pouvez exécuter l'AWS CLI version 2 depuis un conteneur Docker comme si elle était installée sur votre système hôte.

$ aws --version
aws-cli/2.1.24 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.0.0dev10