Python 2.7, 3.4 et 3.5 est obsolète pour le AWS CLI version 1kit . Pour plus d'informations, consultez la AWS CLI version 1 section de À propos des AWS CLI versions.
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.
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.
L'AWS CLI version 2 est le seul outil qui est pris en charge sur l'image Docker officielle d’AWS
Rubriques
- Prerequisites
- Exécuter l'image Docker officielle de l’AWS CLI version 2
- Utiliser des versions et des balises spécifiques
- Mettre à jour vers la dernière image Docker
- Partage des fichiers hôtes, des informations d'identification, des variables d'environnement et de la configuration
- Abréger la commande Docker
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écutableaws
Chaque fois que vous exécutez cette commande, Docker lance un conteneur de votre imageamazon/aws-cli
téléchargée et exécute votre commandeaws
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 avecstdin
. 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 lesaws configure
commandesaws 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 baliselatest
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 baliselatest
est utilisée par défaut dans la commandedocker run
Pour utiliser explicitement la baliselatest
, 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.
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.
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.
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.
Pour confirmer que le fichier téléchargé existe dans le système de fichiers local, exécutez la procédure suivante.
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
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
alias
doskey
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. -
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. -
Pour affecter une version spécifique à utiliser dans votre alias
aws
, ajoutez votre balise de version.
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