AWS Command Line Interface
Guia do usuário

Conclusão de comando

Em sistemas semelhantes ao Unix, a AWS CLI inclui um recurso de conclusão de comando que permite que você use a tecla Tab para concluir um comando digitado parcialmente. Na maioria dos sistemas, esse recurso não é instalado automaticamente, portanto, você precisa configurá-lo manualmente.

Para configurar a conclusão do comando, você deve ter duas informações: o nome do shell que você está usando e a localização do script aws_completer.

Amazon Linux

A conclusão do comando é automaticamente configurada e ativada por padrão nas instâncias do Amazon EC2 que executam o Amazon Linux.

Identifique o Shell

Se você não tiver certeza de qual shell está usando, poderá identificá-lo com um dos seguintes comandos:

echo $ SHELL – Mostra o nome do arquivo de programa do shell. Isso geralmente corresponde ao nome do shell em uso, a menos que você tenha iniciado um shell diferente após fazer o login.

$ echo $SHELL /bin/bash

ps – Mostra os processos em execução para o usuário atual. O shell será um deles.

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

Localize o Completer da AWS

A localização do completer da AWS pode variar, dependendo do método de instalação usado.

Gerenciador de pacotes – Programas como pip, yum, brew e apt-get normalmente instalam o completer da AWS (ou um symlink) em um local de caminho padrão. Neste caso, o comando which pode localizar o completer para você.

Se você usou o pip sem o comando --user, poderá ver o caminho a seguir.

$ which aws_completer /usr/local/aws/bin/aws_completer

Se você usou o parâmetro --user no comando de instalação do pip, o completer normalmente será encontrado na pasta local/bin sob a pasta $HOME.

$ which aws_completer /home/username/.local/bin/aws_completer

Bundled Installer – Se você usou o instalador de acordo com as instruções fornecidas na seção anterior, o completer da AWS estará localizado na subpasta bin do diretório de instalação.

$ ls /usr/local/aws/bin activate activate.csh activate.fish activate_this.py aws aws.cmd aws_completer ...

Se tudo falhar, use find para pesquisar o completer da AWS em todo o seu sistema de arquivos.

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

Adicionar a pasta do Completer ao seu caminho

Para o AWS Completer funcionar corretamente, primeiro adicione-o ao caminho do seu computador.

  1. Encontre o script de perfil do shell em sua pasta de usuário. Se não tiver certeza de qual shell você tem, execute echo $SHELL.

    $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
    • Bash.bash_profile, .profile ou .bash_login

    • Zsh.zshrc

    • Tcsh.tcshrc, .cshrc ou .login

  2. Adicione um comando de exportação ao final do script de perfil que é semelhante ao exemplo a seguir. Substitua /usr/local/aws/bin pela pasta que você descobriu na seção anterior.

    export PATH=/usr/local/aws/bin:$PATH
  3. Recarregue o perfil na sessão atual para colocar essas alterações em vigor. Substitua .bash_profile pelo nome do script de shell que você descobriu na primeira seção.

    $ source ~/.bash_profile

Habilitar conclusão de comando

Execute um comando para habilitar a conclusão de comando. O comando usado para habilitar a conclusão depende do shell usado. Você pode adicionar o comando ao arquivo RC do shell para executá-lo cada vez que você abrir um novo shell. Em cada comando, substitua o caminho /usr/local/aws/bin pelo encontrado no seu sistema na seção anterior.

  • bash – Usa o comando interno complete.

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

    Adicione o comando ao ~/.bashrc para executá-lo cada vez que você abrir um novo shell. Seu ~/.bash_profile deve se basear em ~/.bashrc para garantir que o comando seja executado também em shells de login.

  • tcsh – Concluído para tcsh leva um tipo de palavra e padrão para definir o comportamento de conclusão.

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

    Adicione o comando ao ~/.tschrc para executá-lo cada vez que você abrir um novo shell.

  • zshbin/aws_zsh_completer.sh de origem.

    % source /usr/local/aws/bin/aws_zsh_completer.sh

    A AWS CLI usa a conclusão automática de compatibilidade do bash (bashcompinit) para suporte ao zsh. Para obter mais detalhes, consulte a parte superior do aws_zsh_completer.sh.

    Adicione o comando ao ~/.zshrc para executá-lo cada vez que você abrir um novo shell.

Conclusão do comando de teste

Após ativar a conclusão de comando, insira um comando parcial e pressione Tab para ver os comandos disponíveis.

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