Exécution des images officielles d'Amazon ECR Public ou de Docker pour le AWS CLI - AWS Command Line Interface
PrérequisChoisir entre Amazon ECR Public et Docker HubExécutez les images officiellesRemarques sur les interfaces et la rétrocompatibilité des images officiellesUtiliser des versions et des balises spécifiquesMise à jour vers la dernière image officiellePartage de fichiers hôtes, d'informations d'identification, de variables d'environnement et de configurationRaccourcir la commande docker run

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.

Exécution des images officielles d'Amazon ECR Public ou de Docker pour le AWS CLI

Cette rubrique décrit comment exécuter, contrôler les versions et configurer la AWS CLI version 2 sur Docker à l'aide de l'image officielle Amazon Elastic Container Registry Public (Amazon ECR Public) ou de Docker Hub. Pour de plus amples informations sur l'utilisation de Docker, veuillez consulter la Documentation de Docker.

Les images officielles offrent une isolation, une portabilité et une sécurité qui les soutiennent et les maintiennent AWS directement. Cela vous permet d'utiliser la AWS CLI version 2 dans un environnement basé sur des conteneurs sans avoir à gérer vous-même l'installation.

Prérequis

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

Choisir entre Amazon ECR Public et Docker Hub

Nous vous recommandons d'utiliser Amazon ECR Public via Docker Hub pour les AWS CLI images. Docker Hub impose des limites de débit plus strictes pour les consommateurs publics, ce qui peut entraîner des problèmes de régulation. En outre, Amazon ECR Public réplique les images dans plusieurs régions afin de garantir une disponibilité optimale et de gérer les problèmes de panne régionaux.

Pour plus d'informations sur la limitation du débit de Docker Hub, voir Comprendre la limitation du débit de Docker Hub sur le site Web de Docker.

Exécutez les images de AWS CLI la version officielle 2

La première fois que vous utilisez la docker run commande, la dernière image 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 les images Docker AWS CLI version 2, utilisez la docker run commande.

Amazon ECR Public

L'image officielle d'Amazon ECR Public AWS CLI version 2 est hébergée sur Amazon ECR Public dans le aws-cli/aws-cliréférentiel.

$ docker run --rm -it public.ecr.aws/aws-cli/aws-cli command
Docker Hub

L'image Docker officielle de la AWS CLI version 2 est hébergée sur Docker Hub dans le amazon/aws-cli référentiel.

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

La commande fonctionne de la manière suivante :

  • docker run --rm -it repository/name— L'équivalent de l'awsexécutable. Chaque fois que vous exécutez cette commande, Docker lance un conteneur contenant l'image que vous avez téléchargée et exécute votre aws commande. Par défaut, l'image utilise la dernière version de la AWS CLI version 2.

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

    Amazon ECR Public
    $ docker run --rm -it public.ecr.aws/aws-cli/aws-cli --version
aws-cli/2.17.20 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10
    Docker Hub
    $ docker run --rm -it amazon/aws-cli --version
aws-cli/2.17.20 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10

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

  • -it— Spécifie l'ouverture d'un pseudo- TTY avecstdin. Cela vous permet de fournir des entrées à la AWS CLI version 2 lorsqu'elle s'exécute dans un conteneur, par exemple en utilisant les aws help commandes aws configure et. Lorsque vous choisissez d'omettre ou non-it, tenez compte des points suivants :

    • Si vous exécutez des scripts, ce n'-itest pas nécessaire.

    • Si vous rencontrez des erreurs avec vos scripts, le fait de ne pas participer -it à votre appel Docker peut résoudre le problème.

    • Si vous essayez de rediriger la sortie, -it cela peut provoquer des erreurs et le fait -it de ne pas participer à votre appel Docker peut résoudre ce problème. Si vous souhaitez conserver l'-itindicateur, mais que vous souhaitez tout de même rediriger la sortie, la désactivation du pager côté client AWS CLI utilisé par défaut devrait résoudre le problème.

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

Remarques sur les interfaces et la rétrocompatibilité des images officielles

  • Le seul outil pris en charge sur l'image est le AWS CLI. Seul l'awsexécutable doit être exécuté directement. Par exemple, même si less et groff sont explicitement installés sur l'image, ils ne doivent pas être exécutés directement en dehors d'une AWS CLI commande.

  • Le répertoire /aws de travail est contrôlé par l'utilisateur. L'image n'écrira pas dans ce répertoire, sauf indication contraire de l'utilisateur lors de l'exécution d'une AWS CLI commande.

  • Il n'y a aucune garantie de rétrocompatibilité en s'appuyant sur la dernière balise. Pour garantir la rétrocompatibilité, vous devez épingler une <major.minor.patch> balise spécifique car ces balises sont immuables ; elles ne seront reportées qu'une seule fois.

Utiliser des versions et des balises spécifiques

L'image officielle de la AWS CLI version 2 comporte plusieurs versions que vous pouvez utiliser, à commencer par la version2.0.6. Pour exécuter une version spécifique de la AWS CLI version 2, ajoutez la balise appropriée à votre docker run commande. La première fois que vous utilisez la docker run commande avec une balise, la dernière image 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 la AWS CLI version 2 pour l'image. Nous vous recommandons d'utiliser le latest tag lorsque vous souhaitez obtenir la dernière version de la 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.

    Amazon ECR Public
    $ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:latest command
    Docker Hub
    $ docker run --rm -it amazon/aws-cli:latest command

  • <major.minor.patch>— Définit une version spécifique de la AWS CLI version 2 pour l'image. Si vous envisagez d'utiliser une image officielle en production, nous vous recommandons d'utiliser une version spécifique de la AWS CLI version 2 pour garantir la rétrocompatibilité. Par exemple, pour exécuter la version2.0.6, ajoutez la version au nom de l'image du conteneur.

    Amazon ECR Public
    $ docker run --rm -it public.ecr.aws/aws-cli/aws-cli:2.0.6 command
    Docker Hub
    $ docker run --rm -it amazon/aws-cli:2.0.6 command

Mise à jour vers la dernière image officielle

Comme la dernière image n'est téléchargée sur votre ordinateur que la première fois que vous utilisez la docker run commande, 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 permet de télécharger la dernière version sur votre ordinateur.

Amazon ECR Public
$ docker pull public.ecr.aws/aws-cli/aws-cli:latest
Docker Hub
$ docker pull amazon/aws-cli:latest

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

Comme la AWS CLI version 2 est exécutée dans un conteneur, elle ne CLI peut pas accéder par défaut 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 à la AWS CLI version 2 exécutée dans le conteneur de localiser les informations du fichier hôte.

Amazon ECR Public

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws  public.ecr.aws/aws-cli/aws-cli command
Docker Hub

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env: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.

Note

Pour plus d'informations sur credentials les fichiers config et, voirParamètres des fichiers de configuration et d'identification dans le AWS CLI.

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

Dans cet exemple, nous fournissons les informations d'identification et la configuration de l'hôte lors de l'exécution de la s3 ls commande pour répertorier vos buckets 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 du fichier.

Amazon ECR Public

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws public.ecr.aws/aws-cli/aws-cli s3 ls
Docker Hub

Linux et macOS

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

Invite de commande 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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws amazon/aws-cli s3 ls

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

Amazon ECR Public

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME public.ecr.aws/aws-cli/aws-cli s3 ls
Docker Hub

Linux et 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

Invite de commande 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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e ENVVAR_NAME amazon/aws-cli s3 ls

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

Pour certaines commandes de AWS CLI la version 2, vous pouvez lire des fichiers depuis le système hôte dans le conteneur ou écrire des fichiers depuis le conteneur vers 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.

Amazon ECR Public

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli s3 cp s3://aws-cli-docker-demo/hello .
Docker Hub

Linux et 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

Invite de commande 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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .

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

Linux et macOS

$ cat hello
Hello from Docker!

Fenêtres PowerShell

$ type hello
Hello from Docker!

Exemple 3 : Utilisation de votre variable d'AWS_PROFILEenvironnement

Vous pouvez appeler des variables d'environnement spécifiques à un système à l'aide de l'-eindicateur. 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 le 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).

Amazon ECR Public

Linux et macOS

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

Invite de commande Windows

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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE public.ecr.aws/aws-cli/aws-cli s3 ls
Docker Hub

Linux et 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

Invite de commande 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

Fenêtres PowerShell

C:\> docker run --rm -it -v $env:userprofile\.aws:/root/.aws -e AWS_PROFILE amazon/aws-cli s3 ls

Raccourcir la commande docker run

Pour raccourcir la docker run commande, nous vous suggérons d'utiliser la capacité de votre système d'exploitation pour créer un symbolic link(lien symbolique) ou aliassous Linux et macOS, ou doskeysous 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.

    Amazon ECR Public

    Linux et macOS

    $ alias aws='docker run --rm -it public.ecr.aws/aws-cli/aws-cli'

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
    Docker Hub

    Linux et macOS

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

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI

  • 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.

    Amazon ECR Public

    Linux et macOS

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

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI
    Docker Hub

    Linux et macOS

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

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli $args}
Set-Alias -Name aws -Value AWSCLI

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

    Amazon ECR Public

    Linux et macOS

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

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws public.ecr.aws/aws-cli/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI
    Docker Hub

    Linux et macOS

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

    Invite de commande Windows

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

    Fenêtres PowerShell

    C:\> Function AWSCLI {docker run --rm -it -v $env:userprofile\.aws:/root/.aws -v $pwd\aws:/aws amazon/aws-cli:2.0.6 $args}
Set-Alias -Name aws -Value AWSCLI

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

$ aws --version
aws-cli/2.17.20 Python/3.7.3 Linux/4.9.184-linuxkit botocore/2.4.5dev10