Utilisation de la saisie automatique de la CLI sur une machine distante avec SSH - Développeur Amazon Q
Intégration locale à macOSIntégration Linux à distanceLimitations connues

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de la saisie automatique de la CLI sur une machine distante avec SSH

Lorsque vous installez Amazon Q pour la ligne de commande localement, la saisie semi-automatique de plus de 500 outils CLI est ajoutée à votre terminal existant dans votre environnement local. En activant l'intégration SSH, vous pouvez également rendre la saisie semi-automatique de la CLI accessible sur les machines distantes.

Intégration locale à macOS

Pour activer l'intégration SSH, activez les intégrations SSH locales en exécutant la commande suivante : 

$ q integrations install ssh

Intégration Linux à distance

Exigences d'installation et de mise à jour

  • Vous devez être en mesure d'extraire ou de « décompresser » le package téléchargé. Si votre système d'exploitation ne dispose pas de la commande de décompression intégrée, utilisez une commande équivalente.

  • La CLI Amazon Q utilise la glibc 2.34 ou une version plus récente. Il est inclus par défaut dans la plupart des principales distributions de Linux publiées depuis 2021.

  • Nous prenons en charge la CLI Amazon Q sur les versions 64 bits des distributions récentes de Fedora, Ubuntu et Amazon Linux 2023.

  • Comme il AWS ne gère pas de référentiels tiers, nous ne pouvons pas garantir qu'ils contiennent la dernière version de la Q CLI.

Installation de l'interface de ligne de commande Amazon Q

  1. Téléchargez le fichier d'installation en utilisant une des manières suivantes :

    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"

  2. (Facultatif) Vérification de l'intégrité du fichier zip que vous avez téléchargé

    Si vous avez choisi de télécharger manuellement le package d'installation .zip de la CLI Amazon Q en suivant les étapes ci-dessus, vous pouvez utiliser les étapes suivantes pour vérifier les signatures à l'aide de l'outil GnuPG.

    Les fichiers .zip du package d'installation de la CLI Amazon Q sont signés cryptographiquement à l'aide de signatures PGP. En cas de dommage ou d'altération des fichiers, cette vérification échoue et vous ne devez pas poursuivre l'installation.

    1. Téléchargez et installez la commande gpg à l'aide de votre gestionnaire de paquets. Pour plus d'informations sur GNUpg, consultez le site Web GnuPG.

    2. Pour créer le fichier de clé publique, créez un fichier texte et collez le texte suivant.

      -----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. Importez la clé publique de la CLI Amazon Q à l'aide de la commande suivante, en la public-key-file-name remplaçant par le nom de fichier de la clé publique que vous avez créée.

      $ 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. Téléchargez le fichier de signature de la CLI Amazon Q correspondant au package que vous avez téléchargé. Il porte le même chemin et le même nom que le fichier .zip auquel il correspond, mais porte l'extension .sig. Dans les exemples suivants, nous l'enregistrons dans le répertoire en cours sous la forme d'un fichier nommé q.zip.sig.

      Linux x86-64

      Pour la dernière version de l'interface de ligne de commande Amazon Q, utilisez le bloc de commande suivant :

      $ 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"

      Pour une version spécifique de l'interface de ligne de commande Amazon Q, remplacez la dernière version par le numéro de version. Pour cet exemple, le chemin de la version 1.1.0 serait /1.1.0/q-linux-x86_64.zip.sig, avec pour résultat la commande suivante :

      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)

      Pour la dernière version de l'interface de ligne de commande Amazon Q, utilisez le bloc de commande suivant :

      $ 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"

      Pour une version spécifique de l'interface de ligne de commande Amazon Q, remplacez la dernière version par le numéro de version. Pour cet exemple, le chemin de la version 1.1.0 serait /1.1.0/q-linux-aarch64.zip.sig, avec pour résultat la commande suivante :

      $ 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"

      Pour une version spécifique de l'interface de ligne de commande Amazon Q, remplacez la dernière version par le numéro de version. Pour cet exemple, le chemin de la version 1.1.0 serait /1.1.0/q-linux-aarch64.zip.sig, avec pour résultat la commande suivante :

      $ 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. Vérifiez la signature en transmettant les noms des fichiers .sig et .zip téléchargés en tant que paramètres à la commande gpg.

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

      La sortie doit ressembler à ce qui suit :

      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
      Note

      L'avertissement mentionné dans la sortie est attendu et n'indique pas de problème. Cela se produit parce qu'il n'existe pas de chaîne de confiance entre votre clé PGP personnelle (si vous en avez une) et la clé PGP d'Amazon Q pour la ligne de commande. Pour de plus amples informations, consultez Web of trust.

  3. Décompressez le programme d'installation. Si votre distribution Linux ne possède pas de commande de décompression intégrée, utilisez une commande équivalente pour la décompresser. L'exemple de commande suivant décompresse le package et crée un répertoire nommé q dans le répertoire actuel.

    $ unzip q.zip

  4. Exécutez le programme d'installation. La commande d'installation utilise un fichier nommé install dans le répertoire q récemment décompressé. Par défaut, les fichiers sont tous installés dans ~/.local/bin.

    $ ./q/install.sh

  5. Installez les intégrations de configuration SSH. Pour ce faire, vous devez modifier votre sshd_config pour ajouter le AllowStreamLocalForwarding paramètre AcceptEnv et. Pour modifier la sshd_config course :

    $ sudo -e /etc/ssh/sshd_config

    Une fois que vous avez modifié le fichier sshd_config, ajoutez ce qui suit à la fin du fichier de configuration :

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

    Notez que vous devez également redémarrer le processus sshd après l'installation. Si vous utilisez systemd, vous pouvez exécuter :

    $ sudo systemctl restart sshd

  6. Pour terminer la configuration des intégrations, vous devez vous déconnecter de l'instance SSH et vous reconnecter. Une fois que vous l'avez fait, vous pouvez vous connecter à Q en exécutant :

    $ q login

    Pour vérifier s'il existe d'autres problèmes d'installation, exécutez :

    $ q doctor

Limitations connues

Une limitation connue est que si le client de bureau Amazon Q est fermé alors qu'il est connecté à une machine distante via SSH, un message d'erreur sera imprimé à plusieurs reprises par SSH. Par exemple :

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

Pour supprimer le message d'erreur, quittez la session SSH et reconnectez ou redémarrez le client de bureau Amazon Q.