Uso de CLI Autocomplete en una máquina remota con SSH - Amazon Q Developer
Integración local con macOSIntegración remota de LinuxLimitaciones conocidas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de CLI Autocomplete en una máquina remota con SSH

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

Integración local con macOS

Para habilitar la integración de SSH, habilite las integraciones de SSH locales ejecutando el siguiente comando: 

q integrations install ssh

Integración remota de Linux

Requisitos de instalación y actualización

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

  • La CLI de Amazon Q usa glibc 2.34 o una versión más reciente. Se incluye de forma predeterminada en la mayoría de las principales distribuciones de Linux lanzadas desde 2021.

  • Admitimos la CLI de Amazon Q en las versiones de 64 bits de las distribuciones recientes de Fedora, Ubuntu y Amazon Linux 2023.

  • Como AWS no mantiene repositorios de terceros, no podemos garantizar que contengan la última versión de la QCLI.

Instalación de la CLI de Amazon Q

  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"

    ARM para 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. (Opcional) Verificación de la integridad del archivo zip descargado

    Si optó por descargar manualmente el paquete de instalación de la CLI de Amazon Q .zip en los pasos anteriores, puede utilizar los siguientes pasos para verificar las firmas mediante la herramienta GnuPG.

    Los archivos.zip del paquete de instalación de Amazon Q CLI se firman criptográficamente con firmas PGP. Si hay algún tipo de daño o alteración en los archivos, esta verificación produce un error, por lo que no debería continuar con la instalación.

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

    2. Para crear el archivo de clave pública, cree un archivo de texto y pegue el siguiente texto en él:

      -----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 Amazon Q CLI 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 CLI Team <q-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

    4. Descargue el archivo de firma de Amazon Q CLI del paquete que ha descargado. Tiene la misma ruta y el mismo nombre que el archivo.zip al que corresponde, pero tiene la extensión .sig. En los ejemplos siguientes, lo guardamos en el directorio actual como un archivo denominado q.zip.sig.

      Linux x86-64

      Para obtener la versión más reciente de la CLI de Amazon Q, utilice el siguiente bloque de comandos:

      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 CLI 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-x 86_64.zip.sig y generaría el siguiente 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"

      ARM para Linux (aarch64)

      Para obtener la versión más reciente de la CLI de Amazon Q, utilice el siguiente bloque de comandos:

      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 CLI 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-aarch 64.zip.sig y generaría 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 CLI 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-aarch 64.zip.sig y generaría 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. Compruebe la firma y pase los nombres de los archivos.sig y .zip descargados como parámetros al comando gpg.

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

      El resultado de debería parecerse 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 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

      Se espera la advertencia en la salida y ello no indica un problema. Esto se debe a que no hay una cadena de confianza entre tu clave PGP personal (si tienes una) y la clave PGP de Amazon Q para la línea de comandos. Para obtener más información, consulte 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 configuración sshd_config para añadir la configuración AcceptEnv andAllowStreamLocalForwarding. Para editar la sshd_config ejecución:

    sudo -e /etc/ssh/sshd_config

    Una vez que esté editando el sshd_config, añada lo siguiente al final del archivo de configuración:

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

    Tenga en cuenta que también debe reiniciar el proceso sshd después de la instalación. Si utiliza systemd, puede ejecutar:

    sudo systemctl restart sshd

  6. Para terminar de configurar las integraciones, debes desconectarte de la instancia de SSH y volver a conectarte. Una vez que lo hagas, puedes iniciar sesión en Q ejecutando:

    q login

    Para comprobar si hay otros problemas de instalación, ejecute:

    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 mediante SSH, SSH imprimirá un mensaje de error repetidamente. Por ejemplo:

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

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