콘텐츠로 이동

환경 준비 (0:00–0:15)

실습 환경은 Workshop Studio가 미리 만들어 둔 것을 그대로 씁니다. 따로 설치할 것은 없습니다.

1. Workshop Studio 접속

워크샵 참가 QR 코드

  1. https://bit.ly/c-devops-workshop 에 접속하거나 오른쪽 QR 코드를 스캔합니다. Event access code가 링크에 들어 있어 따로 입력하지 않아도 됩니다.
  2. Email one-time-password (OTP) 로 로그인합니다.
  3. 약관에 동의하고 Join event 를 누릅니다. (access code를 묻는 화면이 나오면 진행자가 화면에 띄운 코드를 입력)
  4. 왼쪽 사이드바에서 Open AWS console 과 VS Code IDE 를 각각 새 탭으로 엽니다. 명령은 모두 VS Code IDE 터미널에서 실행합니다.

임시 AWS 계정, VS Code IDE, 실습 인프라(CloudFormation 스택 cloudformation-template)가 모두 준비되어 있습니다.

명령은 어디서 실행하나요? → VS Code IDE 터미널

VS Code IDE (기본) 콘솔 + CloudShell (대안)
여는 법 Workshop Studio 사이드바 → VS Code IDE → 메뉴 Terminal → New Terminal. 브라우저에서 열리는 실습용 IDE이고, 내 PC의 VS Code가 아닙니다 AWS 콘솔 위쪽 막대의 CloudShell 아이콘 (>_), 리전 us-east-1
쓰는 곳 모든 실습 Part 1 명령, 확장 실습
Lab 3 가능 (Lab 3 코드와 대시보드가 IDE 서버에 있음) 불가

두 환경 모두 아래 3번의 bootstrap.sh 를 실행하면 이후 명령은 똑같습니다.

2. Agent Space 만들기 — 가장 먼저!

AWS DevOps Agent 콘솔 → Begin setup

항목 값
Name api-error-incident-space
Description Investigate order API failures
Role Auto-create a new DevOps Agent role (기본값)

만드는 데 1–2분이 걸립니다

Create 버튼을 먼저 누르고, 기다리는 동안 다음 단계를 진행하세요. 나머지 Lab도 모두 이 이름을 기준으로 진행합니다.

3. 이 저장소 내려받기

① AWS 자격 증명 넣기 (먼저!) — Workshop Studio 왼쪽 사이드바 Get AWS CLI credentials → Mac/Linux 탭의 export AWS_ACCESS_KEY_ID=... 세 줄(또는 네 줄)을 복사해 IDE 터미널에 붙여 넣습니다.

aws sts get-caller-identity --query Arn --output text   # 계정 정보가 나오면 OK

② 저장소 받기

cd /workshop        # IDE 왼쪽 탐색기(Explorer)의 최상위 폴더
git clone https://github.com/hsr87/devops-agent-workshop-kr.git ext
bash ext/scripts/bootstrap.sh
source ~/.ext-workshop.env

export 값은 그 터미널에서만 유효합니다

  • 새 터미널을 열 때마다 ①의 export를 다시 붙여 넣고 source ~/.ext-workshop.env 를 실행하세요. (Lab 3의 server.py 터미널, 메인 에이전트 실습 터미널 모두)
  • 값은 일정 시간이 지나면 만료됩니다. ExpiredToken 오류가 나면 Get AWS CLI credentials에서 새 값을 받아 다시 붙여 넣으세요.
  • CloudShell은 콘솔 로그인 권한을 그대로 쓰므로 이 단계가 필요 없습니다.
cd ~
git clone https://github.com/hsr87/devops-agent-workshop-kr.git ext
bash ext/scripts/bootstrap.sh
source ~/.ext-workshop.env
  • CloudShell의 기본 Python은 3.9입니다. bootstrap.sh 가 처음 한 번 Python 3.12 환경을 자동으로 설치합니다(약 1분).
  • 홈 디렉터리(~)는 CloudShell을 닫았다 열어도 유지됩니다.
  • 20–30분 동안 입력이 없으면 세션이 끊깁니다. 다시 열고 source ~/.ext-workshop.env 만 실행하면 됩니다.
  • 파일 올리기: 오른쪽 위 작업(Actions) → 파일 업로드(Upload file). 홈 디렉터리(~)에 저장됩니다.

bootstrap.sh 는 아래를 점검하고 ~/.ext-workshop.env 에 값을 저장합니다.

  • AWS 계정과 워크샵 스택 상태
  • Agent Space ID (메인 에이전트 실습, 확장 실습에서 사용)
  • 확장 실습용 Python 환경 (ext/.venv, Python 3.10 이상)
  • 저장소 위치 $EXT_REPO — 이후 모든 명령은 cd $EXT_REPO/... 로 시작하므로 어느 환경이든 같습니다

새 터미널을 열 때마다

source ~/.ext-workshop.env 를 다시 실행하세요. CloudShell 탭을 새로 열 때도 마찬가지입니다.

git clone이 막혀 있다면?

아래처럼 압축 파일로 내려받아도 됩니다. 

cd /workshop   # CloudShell이면 cd ~
curl -sL https://github.com/hsr87/devops-agent-workshop-kr/archive/refs/heads/main.tar.gz | tar xz
mv devops-agent-workshop-kr-main ext && bash ext/scripts/bootstrap.sh

저장소 구성

ext/
├── docs/                      # 이 가이드 사이트 원본
├── extensions/
│   ├── alert-forwarder/       # 확장 A: 비즈니스 메트릭 알림 → DevOps Agent 웹훅
│   ├── event-context-mcp/     # 확장 B: 외부 이벤트·baseline·서비스 owner MCP 서버
│   ├── triage-router/         # Part 2 메인 실습: 기존 메인 에이전트에 DevOps Agent 붙이기
│   └── rca-eval/              # 확장 C: 판별·라우팅·RCA 정확도 평가
└── scripts/
    ├── bootstrap.sh
    └── cleanup-extensions.sh  # 확장 실습 리소스 정리 (원본 스택·Agent Space는 그대로)