딥위키-오픈을 활용한 클라우드 기반 AI 문서 시스템 구축 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

웹 개발, 인공지능

대상자

소프트웨어 개발자, DevOps 엔지니어 (중급 이상)

핵심 요약

• 하나의 클릭으로 Clawcloud Run에 DeepWiki-Open 배포 : deepwiki-xxxx.run.claw.cloud 형식의 컨테이너 URL 생성
• AI 기반 문서 생성 기능 : RAG 기반 Q&A, Mermaid 시퀀스 다이어그램 자동 생성
• CI/CD 통합 지원 : Markdown/PDF 형식의 문서 내보내기 기능 제공
• 보안 강화 설정 : NEXTAUTH_SECRET 설정, Clawcloud 방화벽 IP 제한 적용

섹션별 세부 요약

1. 코드베이스 자동 문서화

• GitHub/GitLab/BitBucket URL 입력 시 자동 구조화 Wiki 생성
• 사설 저장소 지원 (Access Token 필요), Markdown/PDF/소스 파일 등 다중 포맷 지원

2. AI 기반 분석 기능

• 스마트 Q&A : RAG 기반 AI가 "컨트롤러가 서비스 레이어를 호출하는 방식?" 같은 질문 답변
• 심층 분석 : 복잡한 로직에 대해 3단계 추론 후 분석 결과 출력

3. 시각화 출력

• Mermaid 아키텍처 다이어그램 및 데이터 흐름 자동 생성
• 인터랙티브 UI로 코드 내비게이션 및 관계 추적 가능

4. Clawcloud Run 배포 절차

• Clawcloud Run 콘솔에서 GitHub 계정으로 가입 후 App Store에서 "DeepWiki-Open" 검색
• Deploy App 클릭 후 3~5분 대기 (예: deepwiki-xxxx.run.claw.cloud 생성)

5. 설정 및 보안

• 모델 선택 : Google Gemini (기본 문서), OpenAI GPT-4o (심층 분석), Local Ollama (자체 호스팅), Custom AI Endpoints
• 보안 설정 : Clawcloud 방화벽 IP 제한, HTTPS 활성화, NEXTAUTH_SECRET 강력 설정

6. 문서 생성 및 내보내기

• Enter Repo URL 및 Access Token 입력 후 Deep Analysis 실행
• "주문/결제 서비스 간 통신 흐름 설명" 같은 질문에 시퀀스 다이어그램 생성
• Markdown/PDF 형식으로 내보내기 후 CI/CD 파이프라인 통합

결론

• Clawcloud Run의 무료 컨테이너 크레딧 (180일 이상 계정) 활용하여 빠른 배포
• AI 기반 분석 및 시각적 인터페이스를 통해 오픈소스 프로젝트 문서화, 신규 개발자 온보딩, 팀 지식 보존에 효과적
• OLLAMA_HOST 및 OPENAI_API_BASE 환경 변수 설정으로 자체 호스팅 및 커스텀 AI 통합 가능