Menginstal Amazon Q untuk baris perintah - Amazon Q Developer
macOSLinux AppImageUbuntuHomebrewKonfigurasi proxyMenghapus instalasiDebugging

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

Menginstal Amazon Q untuk baris perintah

Anda dapat menginstal Amazon Q untuk baris perintah untuk macOS dengan memulai unduhan file untuk aplikasi Amazon Q. Untuk informasi selengkapnya, lihat Lingkungan baris perintah yang didukung.

Ada dua opsi instalasi yang perlu dipertimbangkan saat menginstal Amazon Q untuk baris perintah. Instalasi minimal hanya mencakup binari yang diperlukan di Linux untuk obrolan Amazon Q dan agar fitur pelengkapan otomatis berfungsi melalui SSH (qdan). qterm Instalasi lengkap berisi aplikasi desktop dan membutuhkan fitur pelengkapan otomatis untuk digunakan. Jika Anda hanya ingin menggunakan obrolan Amazon Q, pertimbangkan bahwa instalasi minimal juga dikirimkan dan diinstal qterm ke shell Anda. Anda dapat menggunakan qterm untuk zsh untuk mendukung penyelesaian sebaris dan versi lengkap tidak diperlukan. Untuk informasi selengkapnya, lihat Menginstal dengan file zip.

catatan

Untuk informasi tentang menggunakan Amazon Q CLI dengan Windows, lihat posting blog ini di dev.to.

macOS

Anda dapat menginstal Amazon Q untuk baris perintah untuk macOS dengan mengunduh aplikasi atau dengan menggunakan Homebrew.

Setelah menginstal Amazon Q untuk baris perintah untuk macOS, Anda dapat mengaktifkan integrasi shell untuk dapat menggunakan pelengkapan otomatis untuk lebih dari 500 alat baris perintah. Untuk informasi selengkapnya, lihat Integrasi macOS Lokal.

Untuk menginstal Amazon Q untuk baris perintah untuk macOS, selesaikan prosedur berikut.

  1. Unduh Amazon Q untuk baris perintah untuk macOS.

  2. (Opsional) Verifikasi file yang diunduh untuk Amazon Q untuk baris perintah di macOS. Untuk informasi selengkapnya, lihat Untuk memverifikasi unduhan (opsional).

  3. Klik dua kali pada file.dmg yang diunduh, dan seret aplikasi ke folder aplikasi Anda.

  4. Di folder aplikasi Anda, klik dua kali pada Amazon Q. GUI akan terbuka.

  5. Aktifkan integrasi shell. Ini akan memungkinkan Anda untuk menjalankan Amazon Q dari shell, dan juga akan memungkinkan Amazon Q untuk membantu Anda dengan penyelesaian otomatis perintah shell.

  6. Otentikasi dengan Builder ID, atau dengan IAM Identity Center menggunakan URL awal yang diberikan kepada Anda oleh administrator akun Anda.

  7. Ikuti petunjuk untuk menginstal integrasi shell, dan untuk memberikan izin aksesibilitas macOS.

    Amazon Q Developer memeriksa antarmuka otomatis yang menunjukkan integrasi Shell dengan tanda centang hijau dan Aktifkan aksesibilitas dengan X merah, yang menunjukkan integrasi shell selesai tetapi izin aksesibilitas masih perlu diberikan

Linux AppImage

Awas

Metode instalasi ini membutuhkan GUI. Jika Anda menginstal di Linux tanpa GUI, lihatMenginstal dengan file zip.

Anda dapat menginstal Amazon Q untuk baris perintah untuk Linux menggunakan AppImage format, yang merupakan format portabel yang bekerja pada sebagian besar distribusi Linux tanpa memerlukan instalasi.

Untuk menginstal Amazon Q untuk baris perintah untuk Linux menggunakan AppImage, selesaikan prosedur berikut.

  1. Unduh Amazon Q untuk baris perintah untuk Linux AppImage.

  2. Buat yang dapat AppImage dieksekusi:

    chmod +x amazon-q.appimage

  3. Jalankan AppImage:

    ./amazon-q.appimage

  4. Otentikasi dengan Builder ID, atau dengan IAM Identity Center menggunakan URL awal yang diberikan kepada Anda oleh administrator akun Anda.

Ubuntu

Awas

Metode instalasi ini membutuhkan GUI. Jika Anda menginstal di Linux tanpa GUI, lihatMenginstal dengan file zip.

Anda dapat menginstal Amazon Q untuk baris perintah untuk Ubuntu menggunakan paket.deb.

Untuk menginstal Amazon Q untuk baris perintah untuk Ubuntu, selesaikan prosedur berikut.

  1. Unduh Amazon Q untuk baris perintah untuk Ubuntu. 

    wget https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb

  2. Instal paket:

    sudo dpkg -i amazon-q.deb
sudo apt-get install -f

  3. Luncurkan Amazon Q untuk baris perintah:

    q

  4. Otentikasi dengan Builder ID, atau dengan IAM Identity Center menggunakan URL awal yang diberikan kepada Anda oleh administrator akun Anda.

Homebrew

Untuk menginstal Amazon Q Developer CLI dengan Homebrew, jalankan perintah berikut:

brew install --cask amazon-q

Konfigurasi proxy

Amazon Q Developer CLI (v1.8.0 dan yang lebih baru) mendukung server proxy yang biasa digunakan di lingkungan perusahaan. CLI secara otomatis menghormati variabel lingkungan proxy standar.

Mengatur variabel lingkungan proxy

Konfigurasikan pengaturan proxy dengan menyetel variabel lingkungan ini di shell Anda:

# HTTP proxy for non-SSL traffic
export HTTP_PROXY=http://proxy.company.com:8080

# HTTPS proxy for SSL traffic  
export HTTPS_PROXY=http://proxy.company.com:8080

# Bypass proxy for specific domains
export NO_PROXY=localhost,127.0.0.1,.company.com

Proxy dengan otentikasi

Untuk proxy yang membutuhkan otentikasi:

export HTTP_PROXY=http://username:password@proxy.company.com:8080
export HTTPS_PROXY=http://username:password@proxy.company.com:8080

Dukungan proxy SOCKS

Amazon Q CLI juga mendukung proxy SOCKS:

export HTTP_PROXY=socks5://proxy.company.com:1080
export HTTPS_PROXY=socks5://proxy.company.com:1080

Memverifikasi konfigurasi proxy

Setelah mengatur variabel lingkungan proxy, uji konektivitas:

q doctor

Memecahkan masalah proxy

Jika Anda mengalami masalah koneksi terkait proxy:

  • Verifikasi aksesibilitas dan kredensi server proxy

  • Pastikan firewall perusahaan Anda memungkinkan koneksi ke titik AWS akhir

  • Hubungi administrator TI Anda jika validasi sertifikat SSL gagal

  • Periksa apakah server proxy mendukung protokol yang diperlukan

Menghapus instalasi Amazon Q untuk baris perintah

Anda dapat menghapus Amazon Q untuk baris perintah jika Anda tidak lagi membutuhkannya.

Untuk menghapus Amazon Q untuk baris perintah di macOS, selesaikan prosedur berikut.

  1. Buka folder Aplikasi di Finder.

  2. Temukan aplikasi Pengembang Amazon Q.

  3. Seret aplikasi ke Sampah, atau klik kanan dan pilih “Pindahkan ke Sampah”.

  4. Kosongkan Sampah untuk menyelesaikan penghapusan instalasi.

Untuk menghapus Amazon Q untuk baris perintah di Ubuntu, selesaikan prosedur berikut.

  1. Gunakan manajer paket apt untuk menghapus paket:

    sudo apt-get remove amazon-q

  2. Hapus file konfigurasi yang tersisa:

    sudo apt-get purge amazon-q

Debugging Amazon Q Developer untuk baris perintah

Jika Anda mengalami masalah dengan Amazon Q Developer untuk baris perintah, jalankan q doctor untuk mengidentifikasi dan memperbaiki masalah umum.

Output yang diharapkan

$ q doctor

✔ Everything looks good!

Amazon Q still not working? Run q issue to let us know!

Jika output Anda tidak terlihat seperti output yang diharapkan, ikuti petunjuk untuk menyelesaikan masalah Anda. Jika masih tidak berfungsi, gunakan q issue untuk melaporkan bug.

Masalah umum

Berikut adalah beberapa masalah umum yang mungkin Anda temui saat menggunakan Amazon Q untuk baris perintah:

Kegagalan otentikasi

Jika Anda mengalami masalah dalam autentikasi, coba jalankan q login untuk mengautentikasi ulang.

Pelengkapan otomatis tidak berfungsi

Pastikan integrasi shell Anda diinstal dengan benar dengan menjalankanq doctor.

Masalah integrasi SSH

Verifikasi bahwa server SSH Anda dikonfigurasi dengan benar untuk menerima variabel lingkungan yang diperlukan.

Langkah pemecahan masalah

Ikuti langkah-langkah berikut untuk memecahkan masalah dengan Amazon Q untuk baris perintah:

  1. Jalankan q doctor untuk mengidentifikasi dan memperbaiki masalah umum.

  2. Periksa koneksi internet Anda.

  3. Verifikasi bahwa Anda menggunakan lingkungan yang didukung. Untuk informasi selengkapnya, lihat Lingkungan baris perintah yang didukung.

  4. Coba instal ulang Amazon Q untuk baris perintah.

  5. Jika masalah berlanjut, laporkan menggunakanq issue.