KubeSphere 는 Kubernetes 위에 올리는 관리 콘솔 · 플랫폼이다. 멀티 테넌트(워크스페이스 · 프로젝트), 앱 스토어, 모니터링 · 로깅 · 알림, DevOps 파이프라인, 서비스 메시 같은 기능을 확장(extension) 단위로 켜서 쓴다. 3.x 까지는 ks-installer 가 한 덩어리로 설치했지만 4.x 는 Helm 으로 ks-core 만 올리고 나머지는 Extension Center 에서 고른다.
Kubernetes 클러스터 자체를 만드는 도구는 같은 프로젝트의 KubeKey(kk) 다. 3.x 시절에는 kk create cluster --with-kubesphere 가 둘을 한 번에 했고, 4.x 에서는 kk 로 클러스터를 만든 뒤 Helm 으로 KubeSphere 를 올린다.
현행 버전은 KubeSphere v4.1.3 이다[1].
| 항목 | 내용 |
|---|---|
| Kubernetes | 동작 중인 클러스터. kubectl · Helm 3 |
| 자원 | 최소 구성이라도 콘솔 · 모니터링을 켜면 노드당 4 vCPU · 8 GB 이상을 잡는다 |
| 스토리지 | 기본 StorageClass. 모니터링 · 로깅 확장이 PVC 를 만든다 |
| 네트워크 | 콘솔은 ks-console 서비스의 NodePort 30880 |
helm upgrade --install -n kubesphere-system --create-namespace ks-core \
https://charts.kubesphere.io/main/ks-core-1.1.3.tgz --debug --wait
설치가 끝나면 콘솔 주소와 기본 계정(admin / 초기 암호 P@88w0rd)이 출력된다. 첫 로그인에서 암호를 바꾼다.
kubectl -n kubesphere-system get pods
kubectl -n kubesphere-system get svc ks-console
확장(모니터링 · DevOps 등)은 콘솔의 Extension Center 에서 설치한다.
노드가 준비된 상태에서 kk 로 Kubernetes 를 만든다. 아래 문서는 3.1.1 시절 기록이라 --with-kubesphere 옵션과 이미지 목록이 지금과 다르다.
kk create cluster. KubeSphere 3.1.1 · Kubernetes 1.20.4 로 2021년 테스트 됨.kk create config --from-cluster 로 설정을 뽑아 kk add nodes.최신 버전 v4.1.3 — 2026-09-20 확인. https://github.com/kubesphere/kubesphere/releases/latest · Helm 명령은 https://github.com/kubesphere/kubesphere/blob/master/README.md ↩︎