SSH によるリモートマシンでの CLI Autocomplete の使用 - Amazon Q Developer
ローカル macOS 統合リモート Linux 統合既知の制限事項

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

SSH によるリモートマシンでの CLI Autocomplete の使用

コマンドラインに Amazon Q をローカルにインストールすると、500 を超える CLI ツールのオートコンプリートがローカル環境の既存のターミナルに追加されます。SSH 統合を有効にすると、リモートマシンでも CLI オートコンプリートにアクセスできるようになります。

ローカル macOS 統合

SSH 統合を有効にするには、次のコマンドを実行してローカル SSH 統合を有効にします。

q integrations install ssh

リモート Linux 統合

インストールと更新の要件

  • ダウンロードしたパッケージを抽出または解凍できる必要があります。オペレーティングシステムに unzip コマンドが組み込まれていない場合は、同等のコマンドを使用します。

  • Amazon Q CLI は glibc 2.34 以降を使用します。これは、2021 年以降にリリースされた Linux のほとんどのメジャーディストリビューションにデフォルトで含まれています。

  • Amazon Q CLI は、Fedora、Ubuntu、Amazon Linux 2023 の最近のディストリビューションの 64 ビットバージョンでサポートされています。

  • 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 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. (オプション) ダウンロードした 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-x86_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 ARM (aarch64)

      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-aarch64.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-aarch64.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 キー (持っている場合) とコマンドライン PGP キーの Amazon Q の間に信頼チェーンがないために発生します。詳細については、「信用の輪 (Web of Trust)」を参照してください。

  3. インストーラを解凍します。Linux ディストリビューションに組み込み unzip コマンドがない場合は、同等のコマンドを使用して解凍します。次のコマンド例では、 パッケージを解凍し、現在のディレクトリの下に 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

既知の制限事項

既知の制限は、SSH 経由でリモートマシンに接続している間に Amazon Q デスクトップクライアントが終了すると、SSH によってエラーメッセージが繰り返し出力されることです。例:

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

エラーメッセージを削除するには、SSH セッションを終了し、Amazon Q デスクトップクライアントを再接続または再起動します。