광고 자리 모집 중 · 제휴 문의
한국어
English简体中文繁體中文日本語EspañolPortuguês한국어DeutschFrançais
전체 사이트

AWS 관리 콘솔에서 Amazon Q Developer 활용하기: 인프라 오류 진단, 리소스 구성 검토 및 CLI 명령 생성

가이드
365Finds Editorial
Wiki 문서 11,430편 수록

내 AI에서 365 Wiki 사용하기

아래 프롬프트를 복사해 평소 사용하는 AI에 붙여넣고 바로 질문하세요.

전체 Skill 다운로드

먼저 프롬프트로 체험해 보세요. 365 Wiki를 자주 쓴다면 전체 365Wiki Skill을 설치해 매번 붙여넣는 수고를 줄일 수 있습니다. 평소 쓰는 AI가 없다면 Gemini나 Microsoft Copilot 웹 버전도 사용할 수 있습니다.

365Wiki Skill

전체 Skill 다운로드
클라우드 엔지니어와 DevOps 담당자는 일상적인 운영 업무의 상당 부분을 AWS 관리 콘솔(AWS Management Console)에서 보냅니다. 서비스 오류의 원인을 파악하고, 클라우드 리소스 구성을 점검하며, 콘솔에서의 수동 설정을 자동화 스크립트로 전환하기 위해 AWS CLI 명령을 조합하는 작업이 대표적입니다. 기존에는 이러한 작업 시 여러 서비스 콘솔을 번갈아 이동하고, CloudTrail 이벤트를 분석하며, 복잡한 IAM 정책 평가 논리를 해석하고, 방대한 CLI 문서를 찾아보아야 했습니다.


AWS 관리 콘솔에 네이티브로 통합된 Amazon Q Developer를 사용하면 엔지니어는 작업 화면을 벗어나지 않고도 인프라 오류의 근본 원인을 즉시 진단하고, 자연어 대화로 현재 리소스 상태를 감사하며, 콘솔 조작 내역으로부터 프로덕션 환경에 적합한 AWS CLI 명령을 생성할 수 있습니다.




1. 콘솔 화면에서 인프라 오류 즉시 진단하기


Amazon Q Developer가 운영 환경에 제공하는 가장 직접적인 장점 중 하나는 서비스 오류 배너에서 바로 실행되는 자동화된 근본 원인 분석(Root Cause Analysis)입니다.


콘솔 진단 기능의 동작 방식


지원되는 AWS 서비스 콘솔에서 작업이 실패하면 오류 배너 옆에 Diagnose with Amazon Q(또는 Inspect with Amazon Q) 버튼이 표시됩니다. 이 버튼을 클릭하면 현재 작업 페이지를 떠나지 않고도 컨텍스트 기반 문제 해결을 수행하는 진단 패널이 열립니다.


주요 지원 콘솔은 다음과 같습니다:



동작 원리: 컨텍스트 추출과 계정 심층 질의


Amazon Q Developer는 오류 메시지의 텍스트만 단순 번역하거나 요약하지 않습니다. 실제 배포 환경에 기반하여 체계적인 다단계 조사를 수행합니다:


    

  1. 컨텍스트 자동 추출: Amazon Q는 발생한 오류 코드, 콘솔 URL, 현재 AWS 리전, 로그인한 사용자가 수임 중인 IAM 역할, 화면 입력 필드 값을 자동으로 캡처합니다. 예를 들어 https://s3.console.aws.amazon.com/s3/bucket/prod-data-archive/delete?region=us-east-1에서 발생한 오류의 경우 aws_region = "us-east-1" 및 s3_bucket_name = "prod-data-archive"를 식별합니다.
    2. 

  2. Cloud Control API(CCAPI)를 통한 계정 질의: 권한 부족이나 종속성 문제 등 복합적인 오류가 감지되면 Amazon Q는 AWS Cloud Control API(cloudformation:GetResource 및 cloudformation:ListResources)를 활용해 계정 리소스의 상태와 상호 관계를 읽기 전용으로 질의합니다.
    3. 

  3. IAM 정책 교차 검증: AccessDenied 오류 발생 시, Amazon Q는 현재 역할에 연결된 자격 증명 기반 정책과 대상 리소스에 부여된 리소스 기반 정책을 대조 검토합니다. 명시적 Allow의 누락인지, Deny 조건에 걸린 것인지, 특정 조건 키(Condition Key) 불일치인지를 판별합니다.
    4. 

  4. 단계별 해결 절차 생성: Help me resolve를 클릭하면 실행 가능한 구체적 조치 목록이 제공됩니다. 모호한 플레이스홀더 대신 실제 버킷 이름, 보안 그룹 ID, 정확한 ARN이 반영된 맞춤형 가이드를 제시합니다.
    5. 



구성 문제가 아닌 플랫폼 단의 문제로 해결이 어려운 경우, Amazon Q는 진단 컨텍스트와 조사 내용을 그대로 유지한 상태로 AWS Support 문의 케이스를 작성할 수 있도록 지원합니다.




2. Amazon Q 채팅 패널을 통한 리소스 구성 검토


오류 배너에 대응하는 것 외에도, DevOps 엔지니어는 정기적으로 인프라 구성을 감사하고 보안 상태를 검토하며 서비스 간 종속성을 추적해야 합니다. 콘솔 상단 탐색 표시줄에 상주하는 Amazon Q 채팅 서랍은 지능형 클라우드 운영 비서 역할을 합니다.


자연어로 클라우드 리소스 검색 및 감사


별도의 임시 스크립트를 작성하거나 깊은 하위 메뉴를 탐색할 필요 없이 자연어 프롬프트로 계정 상태를 조회할 수 있습니다:



Amazon Q는 Cloud Control API와 AWS Resource Explorer를 연계하여 종합적인 결과를 반환하며, 콘솔 딥링크(Deep Link)를 함께 제공하여 즉시 실제 화면으로 이동할 수 있도록 돕습니다.


액세스 제어 트러블슈팅 및 FinOps 비용 비교





3. AWS CLI 명령 생성 및 최적화


콘솔에서의 수동 구성을 스크립트나 CI/CD 파이프라인에서 실행 가능한 CLI 명령으로 전환하는 작업은 DevOps 엔지니어링의 핵심 업무입니다. Amazon Q는 콘솔 내에서 이를 위한 두 가지 경로를 제공합니다.


방식 A: AWS Console-to-Code(동작 녹화 및 코드 추출)


AWS Console-to-Code는 콘솔에서 마우스로 클릭하고 입력한 일련의 작업을 기록하여, 이를 그대로 재현할 수 있는 정확한 AWS CLI 명령으로 변환해 주는 기능입니다.


Console-to-Code 작업 흐름:


    

  1. 지원 서비스 콘솔 진입: 현재 Amazon EC2, Amazon VPC, Amazon RDS 콘솔에서 지원됩니다.
    2. 

  2. 녹화 시작: 콘솔 우측의 AWS Console-to-Code 패널에서 Start recording을 클릭합니다.
    3. 

  3. 콘솔 작업 수행: 서브넷 지정, 보안 그룹 연결, IMDSv2 메타데이터 옵션 강제 등 EC2 인스턴스 시작 설정을 진행하거나 RDS 파라미터 그룹을 수정합니다.
    4. 

  4. 녹화 중지 및 검토: 작업이 끝나면 Stop을 누릅니다. Recorded actions 목록에서 세션 중 발생한 API 호출을 확인하고, 쓰기 작업(Write) 위주로 필터링합니다.
    5. 

  5. CLI 명령 복사: 원하는 작업(예: RunInstances 또는 CreateDBInstance)을 선택하고 Copy CLI를 누르면 모든 설정 파라미터가 포함된 AWS CLI 명령이 복사됩니다.
    6. 



리소스 생성 없는 코드 미리보기(Preview Code)


EC2 인스턴스 시작 마법사나 Auto Scaling 그룹 생성 화면에서는 실제로 리소스를 배포하지 않고도 Preview code를 선택할 수 있습니다. 비용 발생이나 불필요한 리소스 프로비저닝 없이 테스트 목적으로 CLI 명령이나 IaC(CDK, CloudFormation) 템플릿을 안전하게 확보할 수 있습니다.


방식 B: Amazon Q 채팅 패널을 통한 즉시 CLI 생성


단발성 운영 명령이나 특정 옵션 플래그가 필요한 경우 채팅창에 직접 프롬프트를 입력할 수 있습니다:


프롬프트 예시:




"us-west-2 리전에서 web-asg-prod Auto Scaling 그룹의 최소 용량을 2, 희망 용량을 6, 최대 용량을 10으로 변경하는 AWS CLI 명령을 작성해줘."




생성 결과:


aws autoscaling update-auto-scaling-group \
    --auto-scaling-group-name web-asg-prod \
    --min-size 2 \
    --desired-capacity 6 \
    --max-size 10 \
    --region us-west-2



Amazon Q는 필수 매개변수를 검증하고 역슬래시를 사용한 가독성 높은 다중 행 형식으로 명령을 정리하며 각 플래그의 의미를 함께 설명합니다. 콘솔 내에 내장된 AWS CloudShell에 붙여넣어 즉시 실행하거나 로컬 셸 스크립트에 반영할 수 있습니다.


Console-to-Code와 Q 채팅 생성 방식 비교





































비교 항목AWS Console-to-CodeAmazon Q 콘솔 채팅
주요 용도복잡한 콘솔 위저드 설정을 정확한 CLI/IaC로 전환자연어 프롬프트 기반 빠른 명령어 작성 및 문법 조회
지원 콘솔Amazon EC2, Amazon VPC, Amazon RDSAWS 관리 콘솔의 모든 서비스 페이지
인터랙티브 녹화지원 (실시간 클릭 및 입력 필드 추적)미지원 (대화형 프롬프트 기반 생성)
사전 안전성Preview code 기능으로 리소스 생성 없이 코드 추출 가능생성된 코드를 작업자가 직접 검토 후 실행
IaC 지원 범위CDK(Python, TypeScript, Java) 및 CloudFormation 기본 생성CLI 명령, 셸 스크립트, SDK 코드 스니펫 중심




4. 권한 거버넌스, 세션 수명 주기 및 비용 정책


Amazon Q Developer를 DevOps 워크플로에 도입할 때는 보안 경계와 세션의 특성을 반드시 숙지해야 합니다:





참고 자료


다룬 제품
Amazon Q Developer