시스템 설정
KIOPS 플랫폼을 처음 사용하신다면 환영합니다! 이 가이드에서는 플랫폼에 장비, 런타임, 서비스를 등록하는 방법을 차근차근 안내해 드립니다.
왜 이 순서대로 등록하나요?
KIOPS에서 서비스를 배포하려면 먼저 어디에 배포할지를 정해야 합니다. 그래서 아래와 같은 순서로 설정을 진행합니다.
장비 등록 → 런타임 등록 → 서비스 등록
- 장비 등록: 서버/물리 장비를 KIOPS에 연결합니다 (예: 클라우드 VM, 온프레미스 서버)
- 런타임 등록: 장비에서 실행되는 컨테이너 환경을 연결합니다 (예: Kubernetes 클러스터, Docker 호스트)
- 서비스 등록: 배포할 애플리케이션을 등록합니다 (예: Git 저장소 기반의 마이크로서비스)
처음 시작하시나요?
아직 서버가 없으시다면 로컬 개발 환경의 Docker부터 연결해 보세요. 클라우드 환경 구축 없이도 KIOPS의 기능을 체험할 수 있습니다.
런타임 환경 추가 단일 진입점
런타임 환경(K8s, Docker, Podman)은 모두 [런타임 환경] 페이지 > 런타임 환경 추가 버튼에서 시작합니다. 버튼을 클릭하면 런타임 환경 추가 모달(AddInfraSelectModal) 이 열리며, 다음 두 가지 흐름 중 하나를 선택합니다.
- 새 런타임 설치: KIOPS가 SSH로 접속하여 kubeadm 또는 Docker/Podman을 직접 설치합니다. K8s의 경우 VIP/HA 옵션을 포함합니다.
- 기존 런타임 연결 (임포트): 이미 운영 중인 클러스터 또는 호스트에 접속하여 preflight 검증을 거친 뒤 KIOPS에 등록합니다. K8s, Docker, Podman 모두 동일한 흐름을 따릅니다.
Podman 런타임 등록도 docker-registration 가이드에 포함됩니다
KIOPS는 Docker와 Podman을 동일한 모달에서 처리합니다. 환경 유형 선택에서 Podman을 고르면 동일한 흐름으로 등록됩니다. 자세한 절차는 Docker 런타임 등록을 참고하세요.
설정 시나리오
아래 가이드를 순서대로 따라가시면 KIOPS 플랫폼을 완벽하게 설정할 수 있습니다.
- 장비 등록 - 관리할 서버/장비를 등록합니다.
- K8s 클러스터 등록 - Kubernetes 클러스터를 신규 설치하거나 기존 클러스터를 연결합니다.
- Docker 런타임 등록 - Docker/Podman 런타임을 신규 설치하거나 기존 호스트를 연결합니다.
- 서비스 등록 - GitLab/GitHub/Docker Hub 기반 서비스를 등록합니다.
- 메트릭 서버 설치 - 클러스터에 metrics-server를 설치하여 리소스 사용량을 수집합니다.
- 모니터링 확장 설치 - cAdvisor 또는 Prometheus Stack으로 네트워크 I/O 등 확장 메트릭을 수집합니다.
- RBAC 관리 - 클러스터 권한과 통합 계정을 관리합니다.
- K8s 인증서 갱신 - kubeadm 클러스터 인증서를 갱신합니다.
어떤 런타임을 선택해야 하나요?
- Kubernetes: 대규모 운영 환경에 적합합니다. 오토스케일링, 롤링 업데이트 등 고급 기능을 사용할 수 있습니다.
- Docker/Podman: 소규모 환경이나 개발/테스트 환경에 적합합니다. 설정이 간단하고 빠르게 시작할 수 있습니다.