Integrasi macOS Lokal Integrasi Linux Jarak Jauh Keterbatasan yang Sudah Diketahui

Menggunakan CLI Autocomplete pada mesin jarak jauh dengan SSH

Saat Anda menginstal Amazon Q untuk baris perintah secara lokal, ia menambahkan pelengkapan otomatis untuk lebih dari 500 alat CLI ke terminal yang ada di lingkungan lokal Anda. Dengan mengaktifkan integrasi SSH, Anda dapat membuat pelengkapan otomatis CLI dapat diakses pada mesin jarak jauh juga.

Integrasi macOS Lokal

Untuk mengaktifkan integrasi SSH, aktifkan integrasi SSH lokal dengan menjalankan perintah berikut:


q integrations install ssh

Integrasi Linux Jarak Jauh

Instal dan perbarui persyaratan

Anda harus dapat mengekstrak atau “unzip” paket yang diunduh. Jika sistem operasi Anda tidak memiliki perintah unzip bawaan, gunakan yang setara.
Amazon Q CLI menggunakan glibc 2.34 atau yang lebih baru. Ini disertakan secara default di sebagian besar distribusi utama Linux yang dirilis sejak 2021.
Kami mendukung Amazon Q CLI pada versi 64-bit dari distribusi terbaru Fedora, Ubuntu, dan Amazon Linux 2023.
Karena AWS tidak memelihara repositori pihak ketiga, kami tidak dapat menjamin bahwa repositori tersebut berisi versi terbaru dari Q CLI.

Instal Amazon Q CLI

Unduh file instalasi dengan salah satu cara berikut:

Linux x86-64


curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip" -o "q.zip"

Linux ARM (aarch64)


curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux.zip" -o "q.zip"

(Opsional) Memverifikasi integritas file zip yang Anda unduh

Jika Anda memilih untuk mengunduh paket penginstal Amazon Q CLI secara manual .zip pada langkah-langkah di atas, Anda dapat menggunakan langkah-langkah berikut untuk memverifikasi tanda tangan dengan menggunakan alat GnuPG.

Paket penginstal Amazon Q CLI. File zip ditandatangani secara kriptografis menggunakan tanda tangan PGP. Jika ada kerusakan atau perubahan file, verifikasi ini gagal dan Anda tidak boleh melanjutkan dengan instalasi.
1. Unduh dan instal perintah gpg menggunakan manajer paket Anda. Untuk informasi selengkapnya tentang GnuPG, lihat situs web GnuPG.
2. Untuk membuat file kunci publik, buat file teks dan tempel dalam teks berikut.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----

mDMEZig60RYJKwYBBAHaRw8BAQdAy/+G05U5/EOA72WlcD4WkYn5SInri8pc4Z6D
BKNNGOm0JEFtYXpvbiBRIENMSSBUZWFtIDxxLWNsaUBhbWF6b24uY29tPoiZBBMW
CgBBFiEEmvYEF+gnQskUPgPsUNx6jcJMVmcFAmYoOtECGwMFCQPCZwAFCwkIBwIC
IgIGFQoJCAsCBBYCAwECHgcCF4AACgkQUNx6jcJMVmef5QD/QWWEGG/cOnbDnp68
SJXuFkwiNwlH2rPw9ZRIQMnfAS0A/0V6ZsGB4kOylBfc7CNfzRFGtovdBBgHqA6P
zQ/PNscGuDgEZig60RIKKwYBBAGXVQEFAQEHQC4qleONMBCq3+wJwbZSr0vbuRba
D1xr4wUPn4Avn4AnAwEIB4h+BBgWCgAmFiEEmvYEF+gnQskUPgPsUNx6jcJMVmcF
AmYoOtECGwwFCQPCZwAACgkQUNx6jcJMVmchMgEA6l3RveCM0YHAGQaSFMkguoAo
vK6FgOkDawgP0NPIP2oA/jIAO4gsAntuQgMOsPunEdDeji2t+AhV02+DQIsXZpoB
=f8yY
-----END PGP PUBLIC KEY BLOCK-----
```
3. Impor kunci publik Amazon Q CLI dengan perintah berikut, ganti public-key-file-name dengan nama file kunci publik yang Anda buat.
```
gpg --import public-key-file-name
gpg: directory '/home/username/.gnupg' created
gpg: keybox '/home/username/.gnupg/pubring.kbx' created
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key 50DC7A8DC24C5667: public key "Amazon Q CLI Team <q-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1
```
4. Unduh file tanda tangan Amazon Q CLI untuk paket yang Anda unduh. Ini memiliki jalur dan nama yang sama dengan file.zip yang sesuai dengannya, tetapi memiliki ekstensi .sig. Dalam contoh berikut, kami menyimpannya ke direktori saat ini sebagai file bernama q.zip.sig.
  
  Linux x86-64
  
  Untuk versi terbaru Amazon Q CLI, gunakan blok perintah berikut:
```
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip.sig" -o "q.zip.sig"
```
  Untuk versi tertentu dari Amazon Q CLI, ganti yang terbaru dengan nomor versi. Untuk contoh ini jalur untuk versi 1.1.0 adalah /1.1.0/ q-linux-x 86_64.zip.sig menghasilkan perintah berikut:
```
q curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/1.1.0/q-x86_64-linux.zip.sig" -o "q.zip.sig"
```
  Linux ARM (aarch64)
  
  Untuk versi terbaru Amazon Q CLI, gunakan blok perintah berikut:
```
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-aarch64-linux.zip.sig" -o "q.zip.sig"
```
  Untuk versi tertentu dari Amazon Q CLI, ganti yang terbaru dengan nomor versi. Untuk contoh ini jalur untuk versi 1.1.0 adalah /1.1.0/ q-linux-aarch 64.zip.sig menghasilkan perintah berikut:
```
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/1.1.0/q-aarch64-linux.zip.sig" -o "q.zip.sig"
```
  Untuk versi tertentu dari Amazon Q CLI, ganti yang terbaru dengan nomor versi. Untuk contoh ini jalur untuk versi 1.1.0 adalah /1.1.0/ q-linux-aarch 64.zip.sig menghasilkan perintah berikut:
```
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.codewhisperer.us-east-1.amazonaws.com/1.1.0/q-aarch64-linux.zip.sig" -o "q.zip.sig"
```
5. Verifikasi tanda tangan, meneruskan nama file.sig dan .zip yang diunduh sebagai parameter ke perintah gpg.
```
gpg --verify q.zip.sig q.zip
```
  Outputnya akan terlihat serupa dengan yang berikut ini:
```
gpg: Signature made Wed 24 Apr 2024 12:08:49 AM UTC
gpg:                using EDDSA key 9AF60417E82742C9143E03EC50DC7A8DC24C566
gpg: Good signature from "Amazon Q CLI Team <q-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 9AF6 0417 E827 42C9 143E  03EC 50DC 7A8D C24C 5667
```
  catatan
  Peringatan dalam output diharapkan dan tidak menunjukkan masalah. Itu terjadi karena tidak ada rantai kepercayaan antara kunci PGP pribadi Anda (jika Anda memilikinya) dan Amazon Q untuk kunci PGP baris perintah. Untuk informasi selengkapnya, lihat Web kepercayaan.
Buka zip penginstal. Jika distribusi Linux Anda tidak memiliki perintah unzip bawaan, gunakan yang setara dengan unzip. Contoh perintah berikut membuka ritsleting paket dan membuat direktori bernama q di bawah direktori saat ini.
```
unzip q.zip
```
Jalankan program instal. Perintah instalasi menggunakan file bernama install di direktori q yang baru di-unzip. Secara default, semua file diinstal ke ~/.local/bin.
```
./q/install.sh
```
Instal integrasi konfigurasi ssh. Untuk melakukan ini, Anda harus mengedit Anda sshd_config untuk menambahkan AcceptEnv dan AllowStreamLocalForwarding pengaturan. Untuk mengedit sshd_config run:
```
sudo -e /etc/ssh/sshd_config
```
Setelah Anda mengedit sshd_config tambahkan yang berikut ini ke akhir file konfigurasi:
```
AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes
```
Catatan, Anda juga harus memulai ulang proses sshd setelah menginstal, jika Anda menggunakan systemd Anda dapat menjalankan:
```
sudo systemctl restart sshd
```
Untuk menyelesaikan pengaturan integrasi, Anda harus memutuskan sambungan dari instance SSH dan menyambung kembali. Setelah Anda melakukannya, Anda dapat masuk ke Q dengan menjalankan:
```
q login
```
Untuk memeriksa masalah instalasi lainnya, jalankan:
```
q doctor
```

Keterbatasan yang Sudah Diketahui

Keterbatasan yang diketahui adalah bahwa jika klien desktop Amazon Q berhenti saat terhubung ke mesin jarak jauh melalui SSH, pesan kesalahan akan dicetak berulang kali oleh SSH. Sebagai contoh:


connect to /var/folders/tg/u1vx4xfmvqav0oxfa4zfknaxiwmbsbr/T/cwrun/remote.sock port -2 failed: Connection refused

Untuk menghilangkan pesan kesalahan, keluar dari sesi SSH dan sambungkan kembali atau restart klien desktop Amazon Q.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Penyelesaian CLI

Sebaris