๐Ÿ“ [Wiki] KubeAI โ†’ Kubernetes Dashboard with Integrated AI Assistant

:bookmark_tabs: [KubeAI] Official Wiki

KR: ์ด ํŽ˜์ด์ง€๋Š” KubeAI์˜ ๋น„์ „, ๊ธฐ์ˆ ์  ๋ฐฉํ–ฅ์„ฑ, ๊ทธ๋ฆฌ๊ณ  ํ˜‘์—… ๋ฐฉ์‹์„ ์ •์˜ํ•˜๋Š” ํ†ตํ•ฉ ๋ฌธ์„œ์ž…๋‹ˆ๋‹ค. ํŒ€์›๊ณผ ์™ธ๋ถ€ ๊ธฐ์—ฌ์ž๋“ค์ด ์กฐํ™”๋กญ๊ฒŒ ํ˜‘์—…ํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•๋Š” ๊ณต์‹ ๊ฐ€์ด๋“œ๋ผ์ธ์ž…๋‹ˆ๋‹ค.

EN: This page serves as the comprehensive documentation defining the vision, technical direction, and collaboration methods for KubeAI. It is an official guideline to ensure seamless collaboration between the team and external contributors.

1. ํ”„๋กœ์ ํŠธ ๊ฐœ์š” (Project Overview)

  • Purpose: ๊ธฐ์กด ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋Œ€์‹œ๋ณด๋“œ์— AI ์ฑ—๋ด‡์„ ๊ฒฐํ•ฉํ•˜์—ฌ ์ดˆ์‹ฌ์ž๋„ ์ž์—ฐ์–ด ๋ช…๋ น์œผ๋กœ ์‰ฝ๊ฒŒ ํด๋Ÿฌ์Šคํ„ฐ๋ฅผ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•˜๋Š” ์„œ๋น„์Šค ; A service that integrates an AI chatbot with the existing Kubernetes dashboard, enabling even beginners to manage clusters with ease through natural language commands.

  • Background / Introduction (KR):

    • K9s, kubectl-ai ๋“ฑ์—์„œ ์˜๊ฐ์„ ์–ป์—ˆ์ง€๋งŒ, CLI ํ™˜๊ฒฝ์˜ ๋ถ€๋‹ด์„ ์ค„์ด๊ณ  GUI์— ํ†ตํ•ฉํ•œ ๊ฒƒ์ด ์ฐจ๋ณ„์ ์ž…๋‹ˆ๋‹ค. ํ˜„์žฌ ๋ณด๊ณ  ์žˆ๋Š” ๋ฆฌ์†Œ์Šค, ๋กœ๊ทธ ๋“ฑ์„ AI ์ปจํ…์ŠคํŠธ๋กœ ์ „๋‹ฌํ•ด ๋” ์ •ํ™•ํ•œ ๋‹ต๋ณ€์„ ์ œ๊ณตํ•˜๊ณ , UI์—์„œ ํ•ด๋‹น ๋ฆฌ์†Œ์Šค๋ฅผ ํ•˜์ด๋ผ์ดํŒ…ํ•˜๋Š” ๊ธฐ๋Šฅ๋„ ๊ตฌ์ƒ ์ค‘์ž…๋‹ˆ๋‹ค.
  • Background / Introduction (EN):

    • Moving beyond CLI-based utilities such as K9s, we offer a GUI-integrated solution designed to lower the cognitive load of cluster management. Our context-aware AI leverages real-time logs and resource data to provide pinpoint-accurate troubleshooting. Our roadmap also includes interactive UI highlighting, where the AI directly points out problematic resources on the dashboard.
  • Core Values:

    • e.g., Knowledge Sovereignty (์ง€์‹ ์ฃผ๊ถŒ), Open Source (์˜คํ”ˆ ์†Œ์Šค ์ •์‹ ), Innovation (๊ธฐ์ˆ  ํ˜์‹ )

2. ํŒ€ ๊ตฌ์„ฑ (The Team)

Roles and responsibilities for the member team.

์ด๋ฆ„ (Name) ID ์—ญํ•  (Role) SNS ์ฃผ์š” ์ฑ…์ž„ (Responsibilities - KR/EN)
ํŒ€์› A @id_a Team Leader Link ๋กœ๋“œ๋งต ๋ฐ ์ตœ์ข… ์˜์‚ฌ๊ฒฐ์ • / Roadmap & Final decision-making
ํŒ€์› B @id_b Tech Lead Link ์•„ํ‚คํ…์ฒ˜ ๋ฐ ์ฝ”๋“œ ๋ฆฌ๋ทฐ / Architecture & Code reviews
ํŒ€์› C @id_c Core Dev Link ํ•ต์‹ฌ ๊ธฐ๋Šฅ ๊ตฌํ˜„ / Core logic & API implementation
ํŒ€์› D @id_d DevOps Link ์ธํ”„๋ผ ๋ฐ CI/CD ๊ด€๋ฆฌ / Infrastructure & CI/CD management
ํŒ€์› E @id_e Writer Link ๋ฌธ์„œํ™” ๋ฐ ์ปค๋ฎค๋‹ˆํ‹ฐ ๊ด€๋ฆฌ / Documentation & Community

3. ๊ธฐ์ˆ  ์Šคํƒ (Tech Stack)

  • Language: (e.g., TypeScript, Go, Python)
  • Infra: (e.g., Kubernetes, Docker, Terraform)
  • Communication: Discord, GitHub Issues

4. ๋กœ๋“œ๋งต (Roadmap)

  • Phase 1: MVP ์š”๊ตฌ์‚ฌํ•ญ ์ •์˜ (MVP Requirement Definition)
  • Phase 2: ํ•ต์‹ฌ ๋ชจ๋“ˆ ๊ฐœ๋ฐœ ๋ฐ ์•ŒํŒŒ ํ…Œ์ŠคํŠธ (Core Module Dev & Alpha Test)
  • Phase 3: ๊ธ€๋กœ๋ฒŒ ์ปค๋ฎค๋‹ˆํ‹ฐ ๊ณต๊ฐœ (Global Community Launch)

5. ์ฐธ์—ฌ ๋ฐฉ๋ฒ• (How to Contribute)

  • Issues: ๋ฒ„๊ทธ๋‚˜ ๊ธฐ๋Šฅ ์ œ์•ˆ์€ GitHub Issues๋ฅผ ํ™œ์šฉํ•˜์„ธ์š”. (Please use GitHub Issues for bug reports or feature requests.)
  • PRs: ๋ชจ๋“  Pull Request๋Š” Tech Lead์˜ ๊ฒ€ํ†  ํ›„ ๋ณ‘ํ•ฉ๋ฉ๋‹ˆ๋‹ค. (All PRs will be merged after review by the Tech Lead.)
  • Guide: [CONTRIBUTING.md] ํŒŒ์ผ์„ ์ฐธ๊ณ ํ•˜์„ธ์š”. (Please refer to the [CONTRIBUTING.md] file.)
  • Discord (Official): [KubeAI Invite Link]
    • KR: ์‹ค์‹œ๊ฐ„ ์†Œํ†ต ๋ฐ ๊ธฐ์ˆ  ์ง€์›์„ ์œ„ํ•œ ์ฑ„๋„์ž…๋‹ˆ๋‹ค.
    • EN: Official channel for real-time communication and technical support.

6. ๋ฆฌ์†Œ์Šค ๋ฐ ๋งํฌ (Resources & Links)

  • GitHub Repository: [Link]
  • Docs: [Architecture / API Specs]

| This is a space where knowledge is not merely consumed, but respected, sovereign, and connectedโ€”shared together with cloud industry professionals (Bros).|
| ์ง€์‹์ด ์†Œ๋น„๋˜์ง€ ์•Š๊ณ  ์กด์ค‘ยท์ฃผ๊ถŒ๋ณด์žฅยท์—ฐ๊ฒฐ๋˜๋Š” ๊ณต๊ฐ„์œผ๋กœ ํด๋ผ์šฐ๋“œ ํ˜„์—… ์ „๋ฌธ๊ฐ€(Bro)์™€ ํ•จ๊ป˜ ๊ณต์œ ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. |