Verwenden von CLI Autocomplete auf einem Remote-Computer mit SSH - Amazon Q-Entwickler
Lokale macOS-IntegrationLinux-FernintegrationBekannte Beschränkungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von CLI Autocomplete auf einem Remote-Computer mit SSH

Wenn Sie Amazon Q für die Befehlszeile lokal installieren, fügt es Ihrem vorhandenen Terminal in Ihrer lokalen Umgebung die automatische Vervollständigung für über 500 CLI-Tools hinzu. Durch die Aktivierung der SSH-Integration können Sie die automatische Vervollständigung von CLI auch auf Remote-Computern zugänglich machen.

Lokale macOS-Integration

Um die SSH-Integration zu aktivieren, aktivieren Sie die lokalen SSH-Integrationen, indem Sie den folgenden Befehl ausführen: 

$ q integrations install ssh

Linux-Fernintegration

Voraussetzungen für die Installation und Aktualisierung

  • Sie müssen das heruntergeladene Paket extrahieren oder „entpacken“ können. Wenn Ihr Betriebssystem nicht über den integrierten Befehl zum Entpacken verfügt, verwenden Sie einen gleichwertigen Befehl.

  • Die Amazon Q CLI verwendet Glibc 2.34 oder neuer. Es ist standardmäßig in den meisten wichtigen Linux-Distributionen enthalten, die seit 2021 veröffentlicht wurden.

  • Wir unterstützen die Amazon Q CLI auf 64-Bit-Versionen neuerer Distributionen von Fedora, Ubuntu und Amazon Linux 2023.

  • Da AWS keine Repositorys von Drittanbietern verwaltet werden, können wir nicht garantieren, dass sie die neueste Version der Q CLI enthalten.

Installieren Sie die Amazon Q CLI

  1. Laden Sie die Installationsdatei auf eine der folgenden Arten herunter:

    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. (Optional) Überprüfen der Integrität Ihrer heruntergeladenen Zip-Datei

    Wenn Sie sich in den obigen Schritten dafür entschieden haben, das Amazon Q CLI-Installationspaket (.zip) manuell herunterzuladen, können Sie die folgenden Schritte verwenden, um die Signaturen mit dem GnuPG-Tool zu überprüfen.

    Die ZIP-Dateien des Amazon Q CLI-Installationspakets sind mithilfe von PGP-Signaturen kryptografisch signiert. Wenn die Dateien beschädigt oder verändert wurden, schlägt diese Verifizierung fehl und Sie sollten nicht mit der Installation fortfahren.

    1. Laden Sie den Befehl gpg mit Ihrem Paketmanager herunter und installieren Sie ihn. Weitere Informationen zu GnuPG finden Sie auf der GnuPG-Website.

    2. Um die öffentliche Schlüsseldatei zu erstellen, müssen Sie eine Textdatei erstellen und den folgenden Text einfügen.

      -----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. Importieren Sie den öffentlichen Schlüssel von Amazon Q CLI mit dem folgenden Befehl und ersetzen public-key-file-name Sie ihn durch den Dateinamen des öffentlichen Schlüssels, den Sie erstellt haben.

      $ 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. Laden Sie die Amazon Q CLI-Signaturdatei für das Paket herunter, das Sie heruntergeladen haben. Sie hat denselben Pfad und Namen wie die entsprechende ZIP-Datei, hat aber die Erweiterung .sig. In den folgenden Beispielen speichern wir sie im aktuellen Verzeichnis als Datei mit dem Namen q.zip.sig.

      Linux x86-64

      Verwenden Sie für die neueste Version der Amazon Q CLI den folgenden Befehlsblock:

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

      Ersetzen Sie für eine bestimmte Version der Amazon Q CLI die neueste Version durch die Versionsnummer. In diesem Beispiel wäre der Pfad für Version 1.1.0 /1.1.0/q-linux-x86_64.zip.sig, was zu dem folgenden Befehl führen würde:

      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)

      Verwenden Sie für die neueste Version der Amazon Q CLI den folgenden Befehlsblock:

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

      Ersetzen Sie für eine bestimmte Version der Amazon Q CLI die neueste Version durch die Versionsnummer. In diesem Beispiel wäre der Pfad für Version 1.1.0 /1.1.0/q-linux-aarch64.zip.sig, was zu dem folgenden Befehl führen würde:

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

      Ersetzen Sie für eine bestimmte Version der Amazon Q CLI die neueste Version durch die Versionsnummer. In diesem Beispiel wäre der Pfad für Version 1.1.0 /1.1.0/q-linux-aarch64.zip.sig, was zu dem folgenden Befehl führen würde:

      $ 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. Überprüfen Sie die Signatur, indem Sie sowohl die heruntergeladenen SIG- als auch die ZIP-Dateinamen als Parameter an den Befehl gpg übergeben.

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

      Die Ausgabe sollte in etwa folgendermaßen aussehen:

      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
      Anmerkung

      Die Warnung in der Ausgabe wird erwartet und ist kein Hinweis auf ein Problem. Das liegt daran, dass es keine Vertrauenskette zwischen Ihrem persönlichen PGP-Schlüssel (falls Sie einen haben) und dem PGP-Schlüssel von Amazon Q for Command Line gibt. Weitere Informationen finden Sie unter Web of trust (Netz des Vertrauens).

  3. Entpacken Sie das Installationsprogramm. Wenn Ihre Linux-Distribution nicht über einen integrierten Befehl zum Entpacken verfügt, verwenden Sie ein Äquivalent zum Entpacken. Der folgende Beispielbefehl entpackt das Paket und erstellt ein Verzeichnis mit dem Namen q unter dem aktuellen Verzeichnis.

    $ unzip q.zip

  4. Führen Sie das Installationsprogramm aus. Der Installationsbefehl verwendet eine Datei mit dem Namen install im neu entpackten q-Verzeichnis. Standardmäßig werden alle Dateien in ~/.local/bin installiert.

    $ ./q/install.sh

  5. Installieren Sie die SSH-Konfigurationsintegrationen. Dazu müssen Sie Ihre Einstellung bearbeitensshd_config, um die Einstellung AcceptEnv und AllowStreamLocalForwarding hinzuzufügen. Um den sshd_config Lauf zu bearbeiten:

    $ sudo -e /etc/ssh/sshd_config

    Sobald Sie die sshd_config bearbeitet haben, fügen Sie am Ende der Konfigurationsdatei Folgendes hinzu:

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

    Beachten Sie, dass Sie den sshd-Prozess auch nach der Installation neu starten müssen. Wenn Sie Systemd verwenden, können Sie Folgendes ausführen:

    $ sudo systemctl restart sshd

  6. Um die Einrichtung der Integrationen abzuschließen, müssen Sie die Verbindung zur SSH-Instanz trennen und die Verbindung erneut herstellen. Sobald Sie dies getan haben, können Sie sich bei Q anmelden, indem Sie Folgendes ausführen:

    $ q login

    Um nach anderen Installationsproblemen zu suchen, führe folgenden Befehl aus:

    $ q doctor

Bekannte Beschränkungen

Eine bekannte Einschränkung besteht darin, dass, wenn der Amazon Q-Desktop-Client beendet wird, während er über SSH mit einem Remote-Computer verbunden ist, wiederholt eine Fehlermeldung per SSH ausgegeben wird. Beispielsweise:

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

Um die Fehlermeldung zu beheben, beenden Sie entweder die SSH-Sitzung und stellen Sie die Verbindung wieder her oder starten Sie den Amazon Q-Desktop-Client neu.