Conclusão de comando - AWS Command Line Interface

Conclusão de comando

A AWS Command Line Interface (AWS CLI) inclui um recurso de preenchimento automático de comandos que permite usar a tecla Tab para concluir o preenchimento um comando inserido parcialmente. Na maioria dos sistemas, esse recurso deve ser configurado manualmente.

Para obter informações sobre o recurso de prompt automático da AWS CLI versão 2, consulte Fazer a AWS CLI solicitar comandos.

Como funciona

Ao inserir parcialmente um comando, um parâmetro ou uma opção, o recurso de conclusão de comando conclui automaticamente o comando ou exibe uma lista sugerida de comandos. Para solicitar a conclusão de comandos, insira parcialmente um comando e pressione a tecla de conclusão, que normalmente é Tab na maioria dos shells.

Os exemplos a seguir mostram diferentes maneiras de usar a conclusão de comando:

  • Insira parcialmente um comando e pressione Tab para exibir uma lista sugerida de comandos.

    $ 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
  • Insira parcialmente um parâmetro e pressione Tab para exibir uma lista sugerida de parâmetros.

    $ 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
  • Insira um parâmetro e pressione Tab para exibir uma lista sugerida de valores de recursos. Esse recurso só está disponível na AWS CLI versão 2.

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

Configuração do preenchimento automático de comando no Linux ou no macOS

Para configurar o preenchimento automático de comandos no Linux ou macOS, você deve conhecer o nome do shell que está usando e a localização do script aws_completer.

nota

O preenchimento do comando é configurado automaticamente e habilitado por padrão nas instâncias do Amazon EC2 que executam o Amazon Linux.

Confirme se a pasta do completer está na variável path

Para o completer da AWS funcionar corretamente, o aws_completer deverá estar na variável path do seu shell. O comando which pode verificar se o completer está na variável path.

$ which aws_completer /usr/local/bin/aws_completer

Se o comando que não conseguir encontrar o completer, use as etapas a seguir para adicionar a pasta do completer à variável PATH.

Etapa 1: Localizar 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 para ele) em um local que faz parte do caminho padrão.

    • Se você usou o pip sem o parâmetro --user, o caminho padrão é /usr/local/bin/aws_completer.

    • Se você usou o pip com o parâmetro --user, o caminho padrão é /home/username/.local/bin/aws_completer.

  • Instalador empacotado: se você usou o instalador empacotado, o caminho padrão é /usr/local/bin/aws_completer.

Se tudo falhar, você poderá usar o comando find para pesquisar o completer da AWS em todo o seu sistema de arquivos.

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

Etapa 2: Identificar o shell

Para identificar qual shell você está usando, é possível usar um dos seguintes comandos.

  • echo $SHELL: exibe o nome do arquivo do programa de 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: exibe os processos em execução para o usuário atual. Um deles é o shell.

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

Etapa 3: Adicionar o completer ao caminho

  1. Encontre o script de perfil do shell em sua pasta de usuário.

    $ 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/bin/ pela pasta que você descobriu na seção anterior.

    export PATH=/usr/local/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 a conclusão de comando

Depois de confirmar que o completer está no caminho, habilite a conclusão de comando executando o comando apropriado para o shell que você está usando. Você pode adicionar o comando ao perfil do shell para executá-lo cada vez que você abrir um novo shell. Em cada comando, substitua o caminho /usr/local/bin/ pelo encontrado no seu sistema em Confirme se a pasta do completer está na variável path.

  • bash: usa o comando interno complete.

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

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

  • zsh: para executar o preenchimento de comandos, é necessário executar bashcompinit adicionando a seguinte linha de carregamento automático ao final do script do perfil ~/.zshrc.

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

    Para habilitar a conclusão de comando, use o comando interno complete.

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

    Adicione os comandos anteriores ao ~/.zshrc para executá-los cada vez que você abrir um novo shell.

  • tcsh: o preenchimento para tcsh utiliza um tipo de palavra e padrão para definir o comportamento do preenchimento.

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

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

Depois de habilitar o preenchimento automático de comandos, Verifique o preenchimento de comandos está funcionando.

Verifique o preenchimento de comandos

Após habilitar o preenchimento de comandos, insira um comando parcial e pressione Tab para ver os comandos disponíveis.

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

Configuração do preenchimento de comandos no Windows

nota

Para obter informações sobre como o PowerShell lida com a conclusão, incluindo as várias teclas de conclusão, consulte about_tab_Expansion na documentação do Microsoft PowerShell.

Para habilitar o preenchimento de comandos para o PowerShell no Windows, conclua as etapas a seguir no PowerShell.

  1. Abra o arquivo $PROFILE com o comando a seguir.

    PS C:\> Notepad $PROFILE

    Se você ainda não tiver um $PROFILE, use o procedimento a seguir para criar um perfil de usuário.

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

    Para obter mais informações sobre os perfis do PowerShell, consulte Como usar perfis no Windows PowerShell ISE no site de Documentação da Microsoft.

  2. Para ativar o preenchimento de comandos, adicione o seguinte bloco de código ao seu perfil, salve e, em seguida, feche o arquivo.

    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. Depois de habilitar a conclusão dos comandos, recarregue o shell, insira um comando parcial e pressione Tab para percorrer os comandos disponíveis.

    $ aws sTab
    $ aws s3

    Para ver todos os comandos disponíveis para conclusão, insira um comando parcial e pressione Ctrl + Espaço.

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