이 실습에서는 Amazon Q Developer CLI와 MCP를 이용한 Agentic AIOps를 사용하는 방법을 예제를 통해서 알아보겠습니다.
다음 실습 내용을 포함합니다.
Amazon Q Developer를 사용하여 git, npm, 및 docker와 같은 수백 개의 인기 있는 CLIs에 대한 완료를 활성화할 수 있습니다
aws 명령줄용 Amazon Q는 컨텍스트 정보를 통합하여 Amazon Q에 사용 사례에 대한 향상된 이해를 제공하여 관련 컨텍스트 인식 응답을 제공할 수 있습니다.
입력을 시작하면 Amazon Q는 컨텍스트와 관련된 하위 명령, 옵션 및 인수를 채웁니다.
자동 완성, Amazon Q 채팅 및 인라인 zsh 완성과 같은 기능을 제공하는 AppImage 및 Ubuntu 패키지를 포함하여 macOS 및 특정 Linux 환경에 명령줄용 Amazon Q를 설치할 수 있습니다.
Let's go!
-
실습 안내 엔지니어의 도움에 따라 워크샵 URL에 접속해주세요.
-
사용자 동의를 체크해서 워크샵 페이지에 접속합니다.
- 개인 AWS Builder ID가 있으면 이를 선택하고, 없으면 OTP(One Time Password)를 선택하고 개인메일주소를 입력합니다.
- 해당 메일 수신함에서 확인한 일회용 접속 정보를 이용해서 워크샵 페이지에 진입할 수 있습니다.
-
워크샵 페이지의 좌측 메뉴 아래에 있는 AWS 콘솔 접속링크를 클릭합니다.
-
AWS 콘솔화면에서 "EC2" 서비스를 검색해서 EC2 콘솔로 이동합니다.
-
EC 콘솔의 좌측 메뉴에서 "Instances"를 선택합니다.
-
실습을 위해 두 대의 EC2 인스턴스가 이미 배포되어 있습니다. 이 중에 "CLI"이름을 포함하고 있는 EC2 인스턴스를 선택하고 "Connect" 버튼을 클릭합니다.
-
"EC2 Instance Connect" 탭이 있는 화면에서 "Connect" 버튼을 클릭합니다.
-
해당 Instance의 쉘 커맨드 화면에 접속하였습니다.
아래 AWS CLI 커맨드를 실행해서 ElastiCache 클러스터를 생성합니다.
aws elasticache create-replication-group --replication-group-id test-valkey-cluster \
--replication-group-description 'q cli demo valkey cluster' \
--cache-node-type cache.r5.2xlarge \
--engine valkey \
--cluster-mode Enabled \
--no-transit-encryption-enabled \
--at-rest-encryption-enabled \
--num-node-groups 2 \
--replicas-per-node-group 2 \
--region us-east-1
아래 커맨드를 실행해서 실습에 필요한 EC2 인스턴스를 구성합니다.
mkdir ~/test1; cd ~/test1
curl -O https://raw.githubusercontent.com/noenemy/agentic-aiops/refs/heads/main/01_AIOps_EC2/create-ec2-q-cli-bootfail.sh
sh ./create-ec2-q-cli-bootfail.sh bootfail-01
커맨드 실행 결과 예시입니다. 예시와 결과가 다른 경우 말씀 부탁드립니다.
1. EC2 인스턴스 bootfail-01이 생성되었습니다.
2. 인스턴스 ID: i-XXXXXXXXXXXX <============= 출력 결과의 해당 <인스턴스 ID> 부분
3. 인스턴스 IP: 555.555.555.555
4. SSH 키: bootfail-01-key.pem <============= 생성된 SSH 접근 키
5. Amazon Q CLI가 성공적으로 설치되었습니다.
6. initramfs 파일이 백업되었습니다: /boot/initramfs-$(uname -r).img.bak
7. 시스템이 재부팅되었습니다.
아래 커맨드를 실행해서 실습에 필요한 두번째 EC2 인스턴스를 구성합니다.
mkdir ~/test1; cd ~/test1
curl -O https://raw.githubusercontent.com/noenemy/agentic-aiops/refs/heads/main/01_AIOps_EC2/create-ec2-q-cli-cpu50.sh
sh ./create-ec2-q-cli-cpu50.sh high-cpu-01
커맨드 실행 결과 예시입니다. 예시와 결과가 다른 경우 말씀 부탁드립니다.
설치 확인 중...
/home/ec2-user/.local/bin/q
q 1.12.7
CPU 부하 확인 중...
CPU 부하 상태:
CPU 사용률: 54.5%
===== 설치 완료 =====
인스턴스 이름: high-cpu-01
인스턴스 ID: i-XXXXXXXXXXXX <============= 출력 결과의 해당 <인스턴스 ID> 부분
인스턴스 IP: 100.27.17.98
IAM 역할: high-cpu-01-admin-role
인스턴스 프로파일: high-cpu-01-admin-profile
SSH 접속 명령어: ssh -i high-cpu-01-key.pem ec2-user@100.27.17.98
CPU 부하 확인 명령어: ssh -i high-cpu-01-key.pem ec2-user@100.27.17.98 '/home/ec2-user/check_load.sh'
- 커맨드 창에서 다음 명령을 실행합니다.
q chat
- Q Developer CLI를 사용하기 위한 계정 정보가 없는 상태이므로 먼저 로그인을 하라면 내용이 보여집니다. 계정 정보를 설정하기 위해 다음 명령을 실행합니다.
q login
-
Amazon Q Developer를 사용할 버전을 선택합니다. 목록에서 무료로 이용가능한 Free tier를 선택합니다.
-
터미널 화면에 인증 페이지에 접속하기 위한 URL일 보여집니다. URL 주소를 복사해서 웹 브라우저의 새로운 탭에서 붙여넣기 해서 접속합니다.
-
인증 승인을 하고 터미널 화면으로 돌아옵니다. Q Developer CLI를 실행하기 위해 다음 명령을 실행합니다.
q chat
- 실습 환경에 정상적으로 접속하셨습니다. Q Developer CLI를 사용할 준비가 되었습니다!!
실습 지원 엔지니어의 도움에 따라 다음 실습 과정을 진행하시면 됩니다.
-
EC2 실습 가이드를 따라 실습을 진행합니다. https://github.com/noenemy/agentic-aiops/blob/main/01_AIOps_EC2/README.md
-
ElastiCache 실습 가이드를 따라 실습을 진행합니다. https://github.com/noenemy/agentic-aiops/blob/main/02_AIOps_ElastiCache/README.md
감사합니다.