透過 SSH 在遠端機器上使用 CLI 自動完成功能 - Amazon Q Developer
本機 macOS 整合遠端整合已知限制

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

透過 SSH 在遠端機器上使用 CLI 自動完成功能

當您在本機上安裝 Amazon Q 時，它會將 500 多個 CLI 工具的自動完成功能新增到本機環境中的現有終端機。透過啟用 SSH 整合，您也可以讓 CLI 自動完成功能在遠端機器上存取。

本機 macOS 整合

若要啟用 SSH 整合，請執行下列命令來啟用本機 SSH 整合：

q integrations install ssh

遠端整合

安裝和更新需求

  • 您必須能夠解壓縮或「解壓縮」下載的套件。如果您的作業系統沒有內建的 unzip 指令，請使用對等的指令。

  • Amazon Q CLI 使用滑動 2.34 或更新版本。默認情況下，它包含在 2021 年以來發布的大多數主要 Linux 發行版中。

  • 我們支持 Amazon Q CLI 在 64 位版本的最新版本的 Fedora，Ubuntu 和 Amazon Linux 2023。

  • 由於 AWS 不維護第三方儲存庫，因此我們無法保證其中包含最新版本的 Q CLI。

安裝 Amazon Q CLI

  1. 使用下列其中一種方式下載安裝檔案：

    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 手臂 (系統 64)

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

  2. (可選) 驗證所下載 zip 檔案的完整性

    如果您在上述步驟中選擇手動下載 Amazon Q CLI 安裝程式套件 .zip，則可以使用以下步驟使用 GnuPG 工具來驗證簽名。

    Amazon Q CLI 安裝程式套件 .zip 檔案是使用 PGP 簽章以密碼編譯方式簽署的。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。

    1. 使用您的軟件包管理器下載並安裝 gpg 命令。如需 GnuPG 的詳細資訊，請參閱 GnuPG 網站。

    2. 若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。

      -----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. 使用下列命令匯入 Amazon Q CLI 公開金鑰，並以您建立 public-key-file-name 的公開金鑰的檔案名稱取代。

      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. 為您下載的套件下載 Amazon Q CLI 簽名檔案。它的路徑和名稱與它對應的 .zip 檔案具有相同的路徑和名稱，但副檔名為 .sig。在下面的例子中，我們將它保存到當前目錄作為一個名為 q.zip.sig 的文件。

      Linux x86-64

      如需最新版本的 Amazon Q CLI，請使用下列命令區塊：

      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"

      對於特定版本的 Amazon Q CLI，請使用版本號碼取代最新版本。在此範例中，版本 1.1.0 的路徑會是 /1.1.0/ q-linux-x 86_64.zip.sig，產生下列指令：

      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 手臂 (系統 64)

      如需最新版本的 Amazon Q CLI，請使用下列命令區塊：

      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"

      對於特定版本的 Amazon Q CLI，請使用版本號碼取代最新版本。在此範例中，版本 1.1.0 的路徑會是 /1.1.0/ q-linux-aarch 64.zip.sig，產生下列指令：

      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"

      對於特定版本的 Amazon Q CLI，請使用版本號碼取代最新版本。在此範例中，版本 1.1.0 的路徑會是 /1.1.0/ q-linux-aarch 64.zip.sig，產生下列指令：

      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. 驗證簽名，將下載的 .sig 和 .zip 文件名作為參數傳遞給 gpg 命令。

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

      輸出應看起來如下列內容。

      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
      注意

      輸出中的警告是預期的，並不表示有問題。這是因為您的個人 PGP 金鑰 (如果有的話) 與 Amazon Q (用於命令列 PGP 金鑰) 之間沒有信任鏈。如需詳細資訊，請參閱「信任網路」。

  3. 解壓縮安裝程式。如果您的 Linux 發行版沒有內置的解壓縮命令，請使用等效的解壓縮命令。下面的示例命令解壓縮包，並在當前目錄下創建一個名為 q 的目錄。

    unzip q.zip

  4. 執行安裝程式。安裝指令會在新解壓縮的 q 目錄中使用名為 install 的檔案。默認情況下，這些文件都安裝到〜 /.local /bin。

    ./q/install.sh

  5. 安裝 ssh 配置集成。若要執行此操作，您必須編輯sshd_config以新增AcceptEnv和AllowStreamLocalForwarding設定。若要編輯sshd_config管路：

    sudo -e /etc/ssh/sshd_config

    編輯 sshd_config 後，請將以下內容添加到配置文件的末尾：

    AcceptEnv Q_SET_PARENT
AllowStreamLocalForwarding yes

    請注意，您也必須在安裝後重新啟動 sshd 程序，如果您使用 systemd，您可以執行：

    sudo systemctl restart sshd

  6. 若要完成整合設定，您必須中斷與 SSH 執行個體的連線，然後重新連線。一旦你這樣做，你可以通過運行登錄到 Q：

    q login

    若要檢查是否有其他安裝問題，請執行：

    q doctor

已知限制

一個已知的限制是，如果 Amazon Q 桌面用戶端在透過 SSH 連線到遠端機器時結束，則 SSH 會重複列印錯誤訊息。例如：

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

若要修復錯誤訊息，請結束 SSH 工作階段並重新連線，或重新啟動 Amazon Q 桌面用戶端。