AI SREClickHouse Workshops

보관됨: 06b 호스팅 LibreChat으로 하는 AI SRE

이전에 선택 모듈이었던 호스팅 LibreChat 모듈의 보관된 강사 참고 자료.

Your computer
macOS terminal: Run workshop commands in Terminal using zsh or bash.

보관된 모듈

모듈 06b는 더 이상 진행 순서에 포함되지 않습니다. 현재 워크숍을 위해 LibreChat, 학습자 계정, 관련 MCP 연결을 프로비저닝하지 마세요. 모듈 06에서 바로 모듈 07로 이어가세요. 아래 노트는 과거 기록으로만 남아 있습니다.

06b 호스팅 LibreChat으로 하는 AI SRE에 대응하는 진행자용 안내서입니다.

과거 타이밍

이 모듈은 예전에 모듈 07 직전에 약 15분이 걸렸습니다. 모듈 06이 이미 원격 ClickStack MCP 워크플로를 다룹니다.

과거 클라우드 사전 작업

학습자는 LibreChat이나 MongoDB를 로컬에 배포하면 안 됩니다.

  1. 행사 전에 공식 Railway 원클릭 가이드로 HTTPS LibreChat 인스턴스 하나를 배포하거나, 조직에서 승인한 호스팅 인스턴스를 사용하세요.
  2. 학습자 계정을 만들거나 아이덴티티 공급자를 설정하세요. 기본 워크숍 비밀번호를 공유하는 일은 절대 없어야 합니다.
  3. 도구 호출이 가능한 LLM 공급자와 모델을 설정하고, API 키는 호스팅된 배포에만 저장하며, 워크숍 지출 한도를 적용하세요.
  4. 다음 원격 MCP 정의를 추가하고 공유하세요:
    • clickstack → https://mcp.clickhouse.cloud/clickstack, 사용자별 CLICKSTACK_SERVICE_ID와 OAuth 사용.
    • github → https://api.githubcopilot.com/mcp/, 사용자별 fine-grained PAT, 읽기 전용 헤더, 저장소 툴셋 사용.
  5. 호스팅된 배포를 코드로 관리한다면 app/librechat/librechat.yaml을 마운트하거나 복사하세요. 여기에는 공유되는 학습자 토큰이 없습니다.
  6. app/librechat/sre-agent-definition.md로 SRE 에이전트를 만들어 학습자에게 Viewer로 공유하거나, 학습자가 실습 중에 직접 만들게 하세요.
  7. 관리자가 아닌 학습자 계정으로 테스트하세요: 설정한 모델로 ClickStack MCP 쿼리 하나와 GitHub 소스 읽기 하나를 실행합니다. 두 콜백 모두 localhost가 아니라 호스팅된 HTTPS 도메인으로 돌아와야 합니다.

LibreChat은 원격 MCP OAuth, 사용자별 자격 증명, 에이전트 공유를 MCP 가이드와 Agents 가이드에 문서화해 두었습니다.

토크 트랙

  • 모듈 06은 에디터 안의 에이전트이고, 06b는 같은 증거 사슬을 호스팅 채팅 UI에서 다룬 것이었습니다.
  • LibreChat은 클라이언트 표면입니다. ClickStack/HyperDX와 텔레메트리는 ClickHouse Cloud에서 매니지드 상태로 유지되고, GitHub는 여전히 신뢰할 수 있는 원천 서비스입니다.
  • 각 학습자는 자신의 ClickHouse OAuth 세션과 GitHub PAT를 소유합니다.

흔한 실패 사례

  • 호스팅 URL을 사용할 수 없음: 이 보관된 모듈을 건너뛰고 모듈 06으로 계속하세요. 워크숍 중에 로컬 Docker 배포를 즉흥적으로 시도하지 마세요.
  • OAuth가 잘못된 호스트로 돌아옴: LibreChat의 공개 DOMAIN_SERVER와 DOMAIN_CLIENT를 HTTPS 배포 URL로 바로잡은 뒤 다시 연결하세요.
  • 잘못된 ClickStack 서비스: 학습자의 CLICKSTACK_SERVICE_ID를 해당 ClickStack 연결의 UUID로 교체한 뒤 다시 연결하세요.
  • GitHub 도구 오류: 학습자의 PAT를 ClickHouse/ClickHouse_Demos로 제한된 fine-grained 토큰(Contents: read)으로 교체하세요.
  • 브라우저 장애 텔레메트리가 없음: 결함을 주입한 뒤 로컬 앱을 열어 브라우저 SDK가 기록하게 하세요.

초기화 절차

  • 호스팅 LibreChat에서 학습자의 MCP 연결이나 PAT를 폐기하세요.
  • 행사가 끝나면 접근 정책에 따라 임시 학습자 계정을 제거하세요.
  • 모듈 07의 stash 후 브랜치 전환 절차로 로컬 워크숍 앱을 초기화하세요.
  • 호스팅 인스턴스에 패치를 유지하거나, 워크숍 후 Railway 프로젝트를 폐기하세요.

이 페이지의 내용

KO