Uso de la función de autocompletar mediante línea de comandos en una máquina remota con SSH

Al instalar Amazon Q para la línea de comandos de forma local, se añade la función de autocompletar para más de 500 herramientas de línea de comandos a la terminal existente en el entorno local. Al habilitar la integración con SSH, también puede hacer que la función de autocompletar mediante línea de comandos sea accesible en máquinas remotas.

Integración local de macOS

Para habilitar la integración de SSH

1. Abra el terminal o el símbolo del sistema.

2. Habilite las integraciones de SSH locales mediante el siguiente comando:

   q integrations install ssh

Integración remota con Linux

Requisitos de instalación y actualización

• Debe poder extraer o “descomprimir” el paquete descargado. Si el sistema operativo no tiene el comando de descomprimir integrado, utilice un equivalente.

• Amazon Q para la línea de comandos usa glibc 2.34 o posterior. Se incluye de forma predeterminada en la mayoría de las principales distribuciones de Linux lanzadas desde 2021.

• Amazon Q para línea de comandos es compatible con las versiones de 64 bits de las distribuciones recientes de Fedora, Ubuntu y Amazon Linux 2023.

• AWS no mantiene repositorios de terceros, por lo que no se garantiza que contengan la última versión de la línea de comandos de Amazon Q.

Instalación con configuración SSH para la integración remota de Linux

Para instalar Amazon Q para la línea de comandos con configuración de SSH

1. Descargue el archivo de instalación de una de las siguientes maneras:

   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. (Opcional) Verificar la integridad del archivo zip descargado.

   Si optaste por descargar manualmente el paquete de instalación de línea de comandos .zip de Amazon Q en los pasos anteriores, puedes usar los siguientes pasos para verificar las firmas con la herramienta GnuPG.

   Los archivos.zip del paquete de instalación de línea de comandos de Amazon Q se firman criptográficamente con firmas PGP. Si hay algún daño o alteración en los archivos, la verificación no se realizará correctamente y no deberá continuar con la instalación.

   1. Descargue e instale el comando gpg usando su administrador de paquetes. Para obtener más información sobre GnuPG, consulte la documentación de GnuPG.

   2. Para crear el archivo de clave pública, cree un archivo de texto y, a continuación, pegue el texto siguiente.

      -----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. Importe la clave pública de la línea de comandos de Amazon Q con el siguiente comando y public-key-file-name sustitúyala por el nombre de archivo de la clave pública que creó.

      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 command line Team <q-command [e-mail]>" imported
      gpg: Total number processed: 1
      gpg:               imported: 1

   4. Descarga el archivo de firma de línea de comandos de Amazon Q del paquete que descargaste. Tiene la misma ruta y el mismo nombre que el archivo .zip al que corresponde, pero tiene la extensión .sig. En los siguientes ejemplos, lo guardaremos en el directorio actual como un archivo llamado q.zip.sig.

      Linux x86-64

      Para obtener la última versión de la línea de comandos de Amazon Q, usa el siguiente comando:

      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"

      Para una versión específica de la línea de comandos de Amazon Q, sustituya la última por el número de versión. En este ejemplo, la ruta de la versión 1.1.0 sería/1.1.0/q-linux-x86_64.zip.sig, dando como resultado el siguiente comando:

      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)

      Para obtener la última versión de la línea de comandos de Amazon Q, usa el siguiente comando:

      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"

      Para una versión específica de la línea de comandos de Amazon Q, sustituya la última por el número de versión. En este ejemplo, la ruta de la versión 1.1.0 sería/1.1.0/q-linux-aarch64.zip.sig, dando como resultado el siguiente 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"

      Para una versión específica de la línea de comandos de Amazon Q, sustituya la última por el número de versión. En este ejemplo, la ruta de la versión 1.1.0 sería/1.1.0/q-linux-aarch64.zip.sig, dando como resultado el siguiente 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. Verifique la firma pasando los nombres de archivo .sig y .zip como parámetros al comando gpg.

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

      El resultado debería tener un aspecto similar al siguiente:

      gpg: Signature made Wed 24 Apr 2024 12:08:49 AM UTC
      gpg:                using EDDSA key 9AF60417E82742C9143E03EC50DC7A8DC24C566
      gpg: Good signature from "Amazon Q command line Team <q-command [e-mail]>" [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

      Se espera la advertencia en la salida y ello no indica un problema. Esto se produce porque no existe una cadena de confianza entre su clave PGP personal (si es su caso) y la clave PGP de Amazon Q para la línea de comandos. Para obtener más información, consulta Red de confianza.

3. Descomprima el instalador. Si su distribución de Linux no tiene un comando unzip integrado, use un equivalente para descomprimirlo. El siguiente comando de ejemplo descomprime el paquete y crea un directorio denominado q en el directorio actual:

   unzip q.zip

4. Ejecute el programa de instalación. El comando de instalación utiliza un archivo denominado install en el directorio q recién descomprimido. De forma predeterminada, todos los archivos se instalan en. ~/.local/bin

   ./q/install.sh

5. Instala las integraciones de configuración de SSH. Para ello, debe editar su sshd_config para añadir la configuración AcceptEnv y AllowStreamLocalForwarding. Para editarlosshd_config, usa lo siguiente:

   sudo -e /etc/ssh/sshd_config

   Cuando estés editando elsshd_config, añade lo siguiente al final del archivo de configuración:

   AcceptEnv Q_SET_PARENT
   AllowStreamLocalForwarding yes

   También debes reiniciar el proceso sshd después de instalar el programa. Si usas systemd, puedes usar lo siguiente:

   sudo systemctl restart sshd

6. Para terminar de configurar las integraciones, debes desconectarte de la instancia de SSH y volver a conectarte. Cuando te vuelvas a conectar, puedes iniciar sesión en Amazon Q ejecutando:

   q login

   Para comprobar si hay otros problemas de instalación, utilice lo siguiente:

   q doctor

Limitaciones conocidas

Una limitación conocida es que si el cliente de escritorio Amazon Q se cierra mientras está conectado a una máquina remota con SSH, SSH imprime repetidamente un mensaje de error. Por ejemplo:

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

Para detener el error, salga de la sesión SSH y vuelva a conectarse o reinicie el cliente de escritorio Amazon Q.