Configuration de l'exécution des commandes dans AWS CLI - AWS Command Line Interface
Comment ça marcheConfiguration de l'exécution des commandes sous Linux ou macOSConfiguration de l'exécution des commandes sous Windows

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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.

Configuration de l'exécution des commandes dans AWS CLI

Le AWS Command Line Interface (AWS CLI) inclut une fonction de complétion de commande compatible avec bash qui vous permet d'utiliser la touche Tab pour terminer une commande partiellement saisie. Sur la plupart des systèmes, vous devez le configurer manuellement.

Comment ça marche

Lorsque vous saisissez partiellement une commande, un paramètre ou une option, la fonction de complétion de commande complète automatiquement votre commande ou affiche une liste de commandes suggérées. Pour demander la fin d'une commande, vous entrez partiellement une commande et vous appuyez sur la touche de fin, qui est généralement Tab dans la plupart des coques.

Les exemples suivants montrent différentes façons d'utiliser la complétion d’une commande :

  • Entrez partiellement une commande et appuyez sur Tab pour afficher une liste de commandes suggérées.

    $ aws dynamodb dTAB
delete-backup                        describe-global-table
delete-item                          describe-global-table-settings
delete-table                         describe-limits
describe-backup                      describe-table
describe-continuous-backups          describe-table-replica-auto-scaling
describe-contributor-insights        describe-time-to-live
describe-endpoints

  • Entrez partiellement un paramètre et appuyez sur Tab pour afficher une liste de paramètres suggérés.

    $ aws dynamodb delete-table --TAB
--ca-bundle              --endpoint-url           --profile              
--cli-connect-timeout    --generate-cli-skeleton  --query                
--cli-input-json         --no-paginate            --region               
--cli-read-timeout       --no-sign-request        --table-name           
--color                  --no-verify-ssl          --version              
--debug                  --output

  • Entrez un paramètre et appuyez sur Tab pour afficher une liste suggérée de valeurs de ressources. Cette fonctionnalité n'est disponible que dans la AWS CLI version 2.

    $ aws dynamodb db delete-table --table-name TAB
Table 1                  Table 2                  Table 3

Configuration de l'exécution des commandes sous Linux ou macOS

Pour configurer l'exécution des commandes sous Linux ou macOS, vous devez connaître le nom du shell que vous utilisez et l'emplacement du aws_completer script.

Note

L'exécution des commandes est automatiquement configurée et activée par défaut sur les EC2 instances Amazon qui exécutent Amazon Linux.

Vérifiez que le dossier du compléteur se trouve dans votre chemin

Pour que le AWS completer fonctionne correctement, il aws_completer doit se trouver sur le chemin de votre shell. La which commande peut vérifier si le compléteur se trouve sur votre chemin.

$ which aws_completer
/usr/local/bin/aws_completer

Si la commande which ne trouve pas le compléteur, suivez les étapes ci-dessous pour ajouter le dossier du compléteur à votre chemin.

Étape 1 : Localiser le AWS compléteur

L'emplacement du AWS compléteur peut varier en fonction de la méthode d'installation utilisée.

  • Gestionnaire de packages : les programmes tels que pip yumbrew, et apt-get installent généralement le AWS compléteur (ou un lien symbolique vers celui-ci) sur un emplacement de chemin standard.

    • Si vous l'avez utilisé pip sans le --user paramètre, le chemin par défaut est/usr/local/bin/aws_completer.

    • Si vous l'avez utilisé pip avec le --user paramètre, le chemin par défaut est/home/username/.local/bin/aws_completer.

  • Programme d'installation groupé : si vous avez utilisé le programme d'installation groupé, le chemin par défaut est. /usr/local/bin/aws_completer

Si tout échoue, vous pouvez utiliser la find commande pour rechercher le AWS compléteur dans votre système de fichiers. 

$ find / -name aws_completer
/usr/local/bin/aws_completer

Étape 2 : Identifiez votre coque

Pour identifier le shell que vous utilisez, vous pouvez utiliser l'une des commandes suivantes.

  • echo $ SHELL — Affiche le nom du fichier programme du shell. Il correspond généralement au nom du shell que vous utilisez, sauf si vous avez lancé un autre shell après la connexion.

    $ echo $SHELL
/bin/bash

  • ps — Affiche les processus en cours pour l'utilisateur actuel. L'un d'eux est la coquille.

    $ ps
  PID TTY          TIME CMD
 2148 pts/1    00:00:00 bash
 8756 pts/1    00:00:00 ps

Étape 3 : Ajoutez le compléteur à votre parcours

  1. Recherchez le script de profil de votre shell dans votre dossier utilisateur.

    $ ls -a ~/
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads

    • Bash — .bash_profile.profile, ou .bash_login

    • Zash — .zshrc

    • Tcsh— .tcshrc.cshrc, ou .login

  2. Ajoutez une commande d'exportation à la fin de votre script de profil similaire à l'exemple suivant. Remplacez /usr/local/bin/ par le nom du dossier que vous avez découvert dans la section précédente.

    export PATH=/usr/local/bin/:$PATH

  3. Rechargez le profil dans la session en cours pour appliquer ces modifications. Remplacez .bash_profile par le nom du script de shell que vous avez découvert dans la première section.

    $ source ~/.bash_profile

Activer la saisie automatique de commandes

Après avoir confirmé que le compléteur se trouve sur votre chemin, activez l'exécution des commandes en exécutant la commande appropriée pour le shell que vous utilisez. Vous pouvez ajouter la commande au profil de votre shell pour l'exécuter chaque fois que vous ouvrez un nouveau shell. Dans chaque commande, remplacez /usr/local/bin/ chemin avec celui trouvé sur votre système dansVérifiez que le dossier du compléteur se trouve dans votre chemin.

  • bash— Utilisez la commande intégréecomplete.

    $ complete -C '/usr/local/bin/aws_completer' aws

    Ajoutez la commande précédente ~/.bashrc pour l'exécuter chaque fois que vous ouvrez un nouveau shell. Votre ~/.bash_profile doit avoir pour source ~/.bashrc pour garantir que la commande est également exécutée dans les shells de connexion.

  • zsh— Pour exécuter l'exécution de la commande, vous devez l'exécuter bashcompinit en ajoutant la ligne de chargement automatique suivante à la fin de votre script de ~/.zshrc profil.

    $ autoload bashcompinit && bashcompinit
$ autoload -Uz compinit && compinit

    Pour activer la complétion d’une commande, utilisez la commande intégrée complete.

    $ complete -C '/usr/local/bin/aws_completer' aws

    Ajoutez les commandes précédentes ~/.zshrc pour l'exécuter chaque fois que vous ouvrez un nouveau shell.

  • tcsh— Complète pour tcsh prend un type de mot et un modèle pour définir le comportement de complétion. 

    > complete aws 'p/*/`aws_completer`/'

    Ajoutez la commande précédente ~/.tschrc pour l'exécuter chaque fois que vous ouvrez un nouveau shell.

Une fois que vous avez activé l'exécution des commandes, cela Vérifier l'exécution de la commande fonctionne.

Vérifier l'exécution de la commande

Après avoir activé l'exécution des commandes, rechargez votre shell, entrez une commande partielle et appuyez sur Tab pour voir les commandes disponibles.

$ aws sTAB
s3              ses             sqs             sts             swf
s3api           sns             storagegateway  support

Configuration de l'exécution des commandes sous Windows

Note

Pour plus d'informations sur la façon dont PowerShell ils sont complétés, y compris leurs différentes clés d'achèvement, voir about_TAB_Expansion dans les Microsoft Docs. PowerShell

Pour activer l'exécution PowerShell des commandes sous Windows, procédez comme suit dans PowerShell.

  1. Ouvrez votre fichier $PROFILE à l'aide de la commande suivante.

    PS C:\> Notepad $PROFILE

    Si vous n'en avez pas$PROFILE, créez un profil utilisateur à l'aide de la commande suivante.

    PS C:\> if (!(Test-Path -Path $PROFILE ))
{ New-Item -Type File -Path $PROFILE -Force }

    Pour plus d'informations sur PowerShell les profils, consultez Comment utiliser les profils sous Windows PowerShell ISE sur le site Web de Microsoft Docs.

  2. Pour activer l'exécution des commandes, ajoutez le bloc de code suivant à votre profil, enregistrez puis fermez le fichier.

    Register-ArgumentCompleter -Native -CommandName aws -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
        $env:COMP_LINE=$wordToComplete
        if ($env:COMP_LINE.Length -lt $cursorPosition){
            $env:COMP_LINE=$env:COMP_LINE + " "
        }
        $env:COMP_POINT=$cursorPosition
        aws_completer.exe | ForEach-Object {
            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
        }
        Remove-Item Env:\COMP_LINE     
        Remove-Item Env:\COMP_POINT  
}

  3. Après avoir activé l'exécution des commandes, rechargez votre shell, entrez une commande partielle et appuyez sur Tab pour parcourir les commandes disponibles.

    $ aws sTab
    $ aws s3

    Pour voir toutes les commandes disponibles disponibles jusqu'à ce que vous ayez terminé, entrez une commande partielle et appuyez sur Ctrl + Espace.

    $ aws sCtrl + Space
s3              ses             sqs             sts             swf
s3api           sns             storagegateway  support