Utilizzo del completamento automatico della CLI su una macchina remota con SSH - Sviluppatore Amazon Q
Integrazione locale con macOSIntegrazione remota con LinuxLimiti noti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo del completamento automatico della CLI su una macchina remota con SSH

Quando installi Amazon Q per la riga di comando localmente, aggiunge il completamento automatico per oltre 500 strumenti CLI al tuo terminale esistente nell'ambiente locale. Abilitando l'integrazione SSH, puoi rendere accessibile il completamento automatico della CLI anche su macchine remote.

Integrazione locale con macOS

Per abilitare l'integrazione SSH, abilita le integrazioni SSH locali eseguendo il seguente comando: 

q integrations install ssh

Integrazione remota con Linux

Requisiti di installazione e aggiornamento

  • È necessario estrarre o "decomprimere" il pacchetto scaricato. Se il tuo sistema operativo non dispone del comando unzip integrato, usa un comando equivalente.

  • La CLI di Amazon Q utilizza glibc 2.34 o versione successiva. È inclusa di default nella maggior parte delle principali distribuzioni di Linux rilasciate dal 2021.

  • Supportiamo l'Amazon Q CLI nelle versioni a 64 bit delle distribuzioni recenti di Fedora, Ubuntu e Amazon Linux 2023.

  • Poiché AWS non mantiene repository di terze parti, non possiamo garantire che contengano l'ultima versione della Q CLI.

Installa la CLI di Amazon Q

  1. Scaricare il file di installazione in uno dei seguenti modi:

    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"

    ARM Linux (aarch64)

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

  2. (Facoltativo) Verifica dell'integrità del file zip scaricato

    Se hai scelto di scaricare manualmente il pacchetto di installazione Amazon Q CLI .zip nei passaggi precedenti, puoi utilizzare i seguenti passaggi per verificare le firme utilizzando lo strumento GnuPG.

    I file.zip del pacchetto di installazione Amazon Q CLI sono firmati crittograficamente utilizzando firme PGP. Se i file sono in qualche modo danneggiati o alterati, questa verifica non va a buon fine e l'installazione deve essere arrestata.

    1. Scarica e installa il comando gpg usando il tuo gestore di pacchetti. Per ulteriori informazioni su GnuPG, consulta il sito Web GnuPG.

    2. Per creare il file della chiave pubblica, creare un file di testo e incollare il testo seguente.

      -----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. Importa la chiave pubblica Amazon Q CLI con il seguente comando, sostituendola public-key-file-name con il nome file della chiave pubblica che hai creato.

      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. Scarica il file di firma Amazon Q CLI per il pacchetto che hai scaricato. Ha lo stesso percorso e lo stesso nome del file.zip a cui corrisponde, ma ha l'estensione .sig. Negli esempi seguenti, lo salviamo nella directory corrente come file denominato q.zip.sig.

      Linux x86-64

      Per la versione più recente della CLI di Amazon Q, usa il seguente blocco di comandi:

      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"

      Per una versione specifica dell'Amazon Q CLI, sostituisci l'ultima con il numero di versione. Per questo esempio, il percorso per la versione 1.1.0 sarebbe /1.1.0/ q-linux-x 86_64.zip.sig e otterrebbe il seguente comando:

      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)

      Per la versione più recente della CLI di Amazon Q, usa il seguente blocco di comandi:

      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"

      Per una versione specifica dell'Amazon Q CLI, sostituisci l'ultima con il numero di versione. Per questo esempio, il percorso per la versione 1.1.0 sarebbe /1.1.0/ q-linux-aarch 64.zip.sig e otterrebbe il seguente comando:

      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"

      Per una versione specifica dell'Amazon Q CLI, sostituisci l'ultima con il numero di versione. Per questo esempio, il percorso per la versione 1.1.0 sarebbe /1.1.0/ q-linux-aarch 64.zip.sig e otterrebbe il seguente comando:

      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. Verifica la firma, passando entrambi i nomi dei file .sig e .zip scaricati come parametri al comando gpg.

      gpg --verify q.zip.sig q.zip

      L'output visualizzato dovrebbe essere simile al seguente:

      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
      Nota

      L'avviso nell'output è previsto e non indica un problema. Si verifica perché non esiste una catena di fiducia tra la tua chiave PGP personale (se ne hai una) e la chiave PGP di Amazon Q for command line. Per ulteriori informazioni, consulta Web of trust.

  3. Decomprimi il programma di installazione. Se la tua distribuzione Linux non ha un comando unzip integrato, usa un equivalente per decomprimerlo. Il comando di esempio seguente decomprime il pacchetto e crea una directory denominata q nella directory corrente.

    unzip q.zip

  4. Esegui il programma di installazione. Il comando di installazione utilizza un file denominato install nella directory q appena decompressa. Per impostazione predefinita, i file sono tutti installati in ~/.local/bin.

    ./q/install.sh

  5. Installa le integrazioni di configurazione ssh. Per fare ciò è necessario modificare l'impostazione e sshd_config aggiungere l'AcceptEnvimpostazione and. AllowStreamLocalForwarding Per modificare la sshd_config corsa:

    sudo -e /etc/ssh/sshd_config

    Dopo aver modificato sshd_config, aggiungi quanto segue alla fine del file di configurazione:

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

    Nota, devi anche riavviare il processo sshd dopo l'installazione, se stai usando systemd puoi eseguire:

    sudo systemctl restart sshd

  6. Per completare la configurazione delle integrazioni è necessario disconnettersi dall'istanza SSH e riconnettersi. Una volta fatto, puoi accedere a Q eseguendo:

    q login

    Per verificare eventuali altri problemi di installazione esegui:

    q doctor

Limiti noti

Una limitazione nota è che se il client desktop Amazon Q viene chiuso mentre è connesso a una macchina remota tramite SSH, un messaggio di errore verrà stampato ripetutamente tramite SSH. Per esempio:

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

Per eliminare il messaggio di errore, esci dalla sessione SSH e riconnettiti o riavvia il client desktop Amazon Q.