이 워크숍을 자율 진행으로 운영하기
강의실에 강사가 없어도 워크숍 전체를 혼자 끝내는 방법 - 무엇이 달라지고, 무엇이 강사를 대체하며, 어떻게 속도를 조절할지.
이 워크숍은 강사가 있는 강의실에서 진행하도록 설계되었지만, 혼자서 끝내는 데 필요한 모든 것이 이미 이 플레이북에 들어 있습니다. 저장소를 혼자 따라가고 있거나 - 혹은 행사 후에 누군가 공유해 주었다면 - 이 페이지가 여러분의 지도입니다.
설치 전에 페이지 헤더에서 macOS 또는 Windows를 선택하세요. Windows 학습자는 모든 워크숍 명령을 WSL 2의 Ubuntu에서 실행합니다. PowerShell은 명시적으로 표시된 Windows 부트스트랩 및 복구 블록에서만 등장합니다.
강사가 없을 때 달라지는 것
짧은 답: 모듈 00부터 07까지는 아무것도 달라지지 않습니다. 기본 경로는 완전히 셀프서비스입니다.
여러분은 자신의 ClickHouse Cloud 트라이얼, clickhousectl로 만드는 자신의 ClickHouse 매니지드
Postgres(모듈 03), 자신의 API 키를 만듭니다 - 의존해야 하는 공유 리소스가 없습니다. 모듈 04부터
09까지도 동일합니다.
강사는 보통 두 가지를 제공하는데, 각각에 대해 이 자료에 셀프서비스 대체 수단이 내장되어 있습니다:
- 직접 지원되는 설치 클리닉(모듈 00)은
ClickHouse_Demos/workshops/build_workshop/app의./preflight.sh로 대체됩니다. 이 스크립트는 실제 실행에서 걸려 넘어지는 모든 항목을 점검합니다. 또한 테스트에서 확인된 모든 실패와 정확한 해결책을 정리한 트러블슈팅 페이지가 있습니다. - 모듈 진행 중의 실시간 문제 해결은 두 가지로 대체됩니다: 강사 역할을 하는 코딩 에이전트(아래), 그리고 정답지 역할을 하는 강사 트랙(아래).
강사 트랙이 여러분의 정답지입니다
강사 트랙은 같은 플레이북 안에 게시되어 있습니다. 각 모듈에는 타이밍, 실제로 발생하는 실패와 해결 방법, 정상 상태로 되돌리는 초기화 절차를 담은 대응 강사 페이지가 있습니다. 어떤 모듈이 검증 단계의 기대대로 동작하지 않으면 해당 강사 페이지를 여세요 - 바로 그 순간을 위해 쓰인 글입니다.
한 페이지는 아껴두세요: 모듈 07 정답지
07 테스트, 실패, 수정 강사 페이지에는 전체 결함 정답지가 담겨 있습니다 - 주입된 각 결함의 정확한 증상, 신호, 수정 방법입니다. 결함을 스스로 진단하는 것이 모듈 07의 핵심이므로, 먼저 텔레메트리로 시도해 보고 정말로 막혔을 때만 정답지를 여세요.
코딩 에이전트가 여러분의 강사입니다
여러분은 모듈 00에서 이미 ClickHouse 에이전트 스킬을 로드하고 원격 ClickHouse MCP를 코딩 에이전트에 연결했습니다. 그 에이전트가 유능한 워크숍 강사가 됩니다. 아래 블록을 붙여넣고, 모듈 번호와 지금 보이는 상황을 채우세요:
You are my workshop instructor. The workshop lives in this repo: the app is in workshops/build_workshop/app/, infrastructure notes are in workshops/build_workshop/infra/README.md, and the playbook markdown (learner and instructor tracks) is in site/content/docs/build-workshop. I am on module NN and stuck: <describe what you see>. Read the relevant module page and the troubleshooting page, inspect my local state (docker compose ps, container logs, and .env.workshop WITHOUT printing any secret values), and walk me to the module's verify step.모듈 00에서 얻은 스킬과 MCP가 있으므로, 에이전트는 도와주는 동안 여러분의 Cloud 서비스를 직접 쿼리할 수도 있습니다 - 즉 문서만 읽는 것이 아니라 테이블, 파이프, 텔레메트리가 실제로 들어왔는지 확인할 수 있습니다.
강사 역할 지시를 매번 다시 붙여넣지 않고 세션 간에 유지하고 싶다면, 사용하는 도구의 프로젝트
지시 파일에 넣으세요: Claude Code는 CLAUDE.md, Codex CLI는 AGENTS.md, Cursor는
.cursor/rules/(또는 Cursor도 읽는 AGENTS.md)입니다. 각 도구는 저장소 루트에서 그 파일을
자동으로 로드하므로, 워크숍을 열 때마다 안내가 컨텍스트에 들어 있습니다.
속도 조절 조언
개요의 모듈별 시간 예산은 계정 가입이 미리 완료된 강의실을 전제로 합니다. 혼자 진행할 때는 모듈 00이 가장 큰 비중을 차지합니다: 브라우저에서 하는 세 가지 가입(ClickHouse Cloud, Langfuse, OpenAI)이 각각 5~10분이며, 대부분은 이메일이나 전화 인증을 기다리는 시간입니다. 00 설치의 "당일 이전에 계정 가입을 마치세요" 콜아웃은 혼자 진행할 때 두 배로 중요합니다 - 세 가입을 먼저 모두 끝내고 키를 손에 들고 돌아오면, 모듈 00의 나머지는 빠르게 끝납니다. 그 뒤 모듈 01부터 09까지는 명시된 예산에 가깝게 진행됩니다.
절대 낙오되지 않습니다: 모든 모듈의 시작점 섹션이 무엇이 준비되어 있어야 하는지 정확히 알려주므로, 멈추고 나중에 돌아와 그 지점에서 이어갈 수 있습니다.