SSH를 사용하는 원격 시스템에서 CLI 자동완성 사용 - Amazon Q 개발자
로컬 macOS 통합원격 리눅스 통합알려진 제한 사항

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SSH를 사용하는 원격 시스템에서 CLI 자동완성 사용

명령줄용 Amazon Q를 로컬에 설치하면 로컬 환경의 기존 터미널에 500개 이상의 CLI 도구에 대한 자동 완성 기능이 추가됩니다. SSH 통합을 활성화하면 원격 시스템에서도 CLI 자동 완성에 액세스할 수 있습니다.

로컬 macOS 통합

SSH 통합을 활성화하려면 다음 명령을 실행하여 로컬 SSH 통합을 활성화하십시오.

q integrations install ssh

원격 리눅스 통합

설치 및 업데이트 요구 사항

  • 다운로드한 패키지를 추출 또는 "압축 해제"할 수 있어야 합니다. 운영 체제에 기본 제공 unzip 명령이 없는 경우 이에 상응하는 명령을 사용하십시오.

  • Amazon Q CLI는 glibc 2.34 이상을 사용합니다. 2021년 이후 출시된 대부분의 주요 Linux 배포판에 기본적으로 포함되어 있습니다.

  • 페도라, 우분투, 아마존 리눅스 2023의 최신 배포판의 64비트 버전에서 Amazon Q CLI를 지원합니다.

  • 타사 리포지토리를 유지 관리하지 AWS 않기 때문에 최신 버전의 Q CLI가 포함되어 있다고 보장할 수 없습니다.

아마존 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"

    리눅스 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-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"

      리눅스 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-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 키 (있는 경우) 와 명령줄 PGP 키용 Amazon Q 사이에 신뢰 체인이 없기 때문에 발생합니다. 자세한 내용은 Web of trust를 참조하세요.

  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

알려진 제한 사항

알려진 제한 사항으로는 SSH를 통해 원격 시스템에 연결된 상태에서 Amazon Q 데스크톱 클라이언트가 종료되면 SSH에서 오류 메시지가 반복적으로 인쇄된다는 점입니다. 예:

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

오류 메시지를 없애려면 SSH 세션을 종료하고 Amazon Q 데스크톱 클라이언트를 다시 연결하거나 다시 시작하십시오.