Mengkonfigurasi penyelesaian perintah di AWS CLI - AWS Command Line Interface
Cara kerjanyaMengkonfigurasi penyelesaian perintah di Linux atau macOSMengkonfigurasi penyelesaian perintah pada Windows

Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengkonfigurasi penyelesaian perintah di AWS CLI

The AWS Command Line Interface (AWS CLI) menyertakan fitur penyelesaian perintah yang kompatibel dengan bash yang memungkinkan Anda menggunakan tombol Tab untuk menyelesaikan perintah yang dimasukkan sebagian. Pada sebagian besar sistem Anda perlu mengkonfigurasi ini secara manual.

Cara kerjanya

Saat Anda memasukkan sebagian perintah, parameter, atau opsi, fitur penyelesaian perintah secara otomatis melengkapi perintah Anda atau menampilkan daftar perintah yang disarankan. Untuk meminta penyelesaian perintah, Anda memasukkan sebagian perintah dan tekan tombol penyelesaian, yang biasanya Tab di sebagian besar cangkang.

Contoh berikut menunjukkan berbagai cara yang dapat Anda gunakan penyelesaian perintah:

  • Masukkan sebagian perintah dan tekan Tab untuk menampilkan daftar perintah yang disarankan.

    $ 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

  • Masukkan sebagian parameter dan tekan Tab untuk menampilkan daftar parameter yang disarankan.

    $ 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

  • Masukkan parameter dan tekan Tab untuk menampilkan daftar nilai sumber daya yang disarankan. Fitur ini hanya tersedia di AWS CLI versi 2.

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

Mengkonfigurasi penyelesaian perintah di Linux atau macOS

Untuk mengonfigurasi penyelesaian perintah di Linux atau macOS, Anda harus mengetahui nama shell yang Anda gunakan dan lokasi skrip. aws_completer

catatan

Penyelesaian perintah secara otomatis dikonfigurasi dan diaktifkan secara default pada EC2 instans Amazon yang menjalankan Amazon Linux.

Konfirmasikan folder pelengkap ada di jalur Anda

Agar AWS pelengkap berhasil bekerja, aws_completer kebutuhan harus berada di jalur shell Anda. whichPerintah dapat memeriksa apakah pelengkap ada di jalur Anda.

$ which aws_completer
/usr/local/bin/aws_completer

Jika perintah yang tidak dapat menemukan pelengkap, maka gunakan langkah-langkah berikut untuk menambahkan folder pelengkap ke jalur Anda.

Langkah 1: Temukan AWS pelengkap

Lokasi AWS pelengkap dapat bervariasi tergantung pada metode instalasi yang digunakan.

  • Package Manager - Program seperti pipyum,brew,, dan apt-get biasanya menginstal AWS completer (atau symlink ke sana) ke lokasi jalur standar.

    • Jika Anda menggunakan pip tanpa --user parameter, jalur defaultnya adalah/usr/local/bin/aws_completer.

    • Jika Anda menggunakan pip --user parameter, jalur defaultnya adalah/home/username/.local/bin/aws_completer.

  • Penginstal yang Dibundel - Jika Anda menggunakan penginstal yang dibundel, jalur defaultnya adalah. /usr/local/bin/aws_completer

Jika semuanya gagal, Anda dapat menggunakan find perintah untuk mencari sistem file Anda untuk AWS pelengkap. 

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

Langkah 2: Identifikasi shell Anda

Untuk mengidentifikasi shell yang Anda gunakan, Anda dapat menggunakan salah satu perintah berikut.

  • echo $ SHELL - Menampilkan nama file program shell. Ini biasanya cocok dengan nama shell yang sedang digunakan, kecuali jika Anda meluncurkan shell yang berbeda setelah masuk.

    $ echo $SHELL
/bin/bash

  • ps — Menampilkan proses yang berjalan untuk pengguna saat ini. Salah satunya adalah cangkangnya.

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

Langkah 3: Tambahkan pelengkap ke jalur Anda

  1. Temukan penulisan profil shell Anda di folder pengguna Anda.

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

    • Bash —.bash_profile,.profile, atau .bash_login

    • Zsh — .zshrc

    • Tcsh—.tcshrc,.cshrc, atau .login

  2. Tambahkan perintah ekspor di akhir skrip profil Anda yang mirip dengan contoh berikut. Ganti /usr/local/bin/ dengan folder yang Anda temukan di bagian sebelumnya.

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

  3. Muat ulang profil ke sesi saat ini untuk menerapkan perubahan tersebut. Ganti .bash_profile dengan nama skrip shell yang Anda temukan di bagian pertama.

    $ source ~/.bash_profile

Aktifkan penyelesaian perintah

Setelah mengonfirmasi bahwa pelengkap ada di jalur Anda, aktifkan penyelesaian perintah dengan menjalankan perintah yang sesuai untuk shell yang Anda gunakan. Anda dapat menambahkan perintah ke profil shell Anda untuk menjalankannya setiap kali Anda membuka shell baru. Dalam setiap perintah, ganti /usr/local/bin/ jalur dengan yang ditemukan di sistem Anda diKonfirmasikan folder pelengkap ada di jalur Anda.

  • bash— Gunakan perintah bawaancomplete.

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

    Tambahkan perintah sebelumnya ~/.bashrc untuk menjalankannya setiap kali Anda membuka shell baru. Anda ~/.bash_profile harus mencari sumber ~/.bashrc untuk memastikan bahwa perintah juga dijalankan di shell login.

  • zsh— Untuk menjalankan penyelesaian perintah, Anda perlu menjalankan bashcompinit dengan menambahkan baris autoload berikut di akhir skrip ~/.zshrc profil Anda.

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

    Untuk mengaktifkan penyelesaian perintah, gunakan perintah bawaancomplete.

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

    Tambahkan perintah sebelumnya ~/.zshrc untuk menjalankannya setiap kali Anda membuka shell baru.

  • tcsh— Lengkap untuk tcsh mengambil jenis kata dan pola untuk menentukan perilaku penyelesaian. 

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

    Tambahkan perintah sebelumnya ~/.tschrc untuk menjalankannya setiap kali Anda membuka shell baru.

Setelah Anda mengaktifkan penyelesaian perintah, Verifikasi penyelesaian perintah berfungsi.

Verifikasi penyelesaian perintah

Setelah mengaktifkan penyelesaian perintah, muat ulang shell Anda, masukkan perintah sebagian, dan tekan Tab untuk melihat perintah yang tersedia.

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

Mengkonfigurasi penyelesaian perintah pada Windows

catatan

Untuk informasi tentang cara PowerShell menangani penyelesaiannya, termasuk berbagai kunci penyelesaiannya, lihat About_TAB_EXPANSION di Microsoft Docs. PowerShell

Untuk mengaktifkan penyelesaian perintah PowerShell di Windows, selesaikan langkah-langkah berikut di PowerShell.

  1. Buka Anda $PROFILE dengan perintah berikut.

    PS C:\> Notepad $PROFILE

    Jika Anda tidak memiliki$PROFILE, buat profil pengguna menggunakan perintah berikut.

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

    Untuk informasi selengkapnya tentang PowerShell profil, lihat Cara Menggunakan Profil di Windows PowerShell ISE di situs web Microsoft Docs.

  2. Untuk mengaktifkan penyelesaian perintah, tambahkan blok kode berikut ke profil Anda, simpan, lalu tutup file.

    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. Setelah mengaktifkan penyelesaian perintah, muat ulang shell Anda, masukkan perintah sebagian, dan tekan Tab untuk menelusuri perintah yang tersedia.

    $ aws sTab
    $ aws s3

    Untuk melihat semua perintah yang tersedia untuk penyelesaian Anda, masukkan perintah paral dan tekan Ctrl+Space.

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