본문으로 건너뛰기

시스템 설정

KIOPS 플랫폼에 장비, 런타임, 서비스를 등록하는 순서를 안내합니다.

왜 이 순서대로 등록하나요?​

KIOPS에서 서비스를 배포하려면 먼저 어디에 배포할지를 정해야 합니다. 그래서 아래와 같은 순서로 설정을 진행합니다.

장비 등록 → 런타임 등록 → 서비스 등록
  • 장비 등록: 서버/물리 장비를 KIOPS에 연결합니다 (예: 클라우드 VM, 온프레미스 서버)
  • 런타임 등록: 장비에서 실행되는 컨테이너 환경을 연결합니다 (예: Kubernetes 클러스터, Docker 호스트)
  • 서비스 등록: 배포할 애플리케이션을 등록합니다 (예: Git 저장소 기반의 마이크로서비스)
처음 시작한다면

아직 서버가 없으시다면 로컬 개발 환경의 Docker부터 연결해 보세요. 클라우드 환경 구축 없이도 KIOPS의 기능을 체험할 수 있습니다.

런타임 환경 추가 버튼 하나로 시작합니다​

런타임 환경(K8s, Docker, Podman)은 모두 [런타임 환경] 페이지 > 런타임 환경 추가 버튼에서 시작합니다. 버튼을 클릭하면 런타임 환경 추가 모달이 열리며, 다음 두 가지 흐름 중 하나를 선택합니다.

  • 새 런타임 설치: KIOPS가 SSH로 접속하여 kubeadm 또는 Docker/Podman을 직접 설치합니다. K8s의 경우 VIP/HA 옵션을 포함합니다.
  • 기존 런타임 연결 (임포트): 이미 운영 중인 클러스터 또는 호스트에 접속하여 preflight 검증을 거친 뒤 KIOPS에 등록합니다. K8s, Docker, Podman 모두 동일한 흐름을 따릅니다.
Podman 런타임 등록도 docker-registration 가이드에 포함됩니다

KIOPS는 Docker와 Podman을 동일한 모달에서 처리합니다. 환경 유형 선택에서 Podman을 선택하면 동일한 흐름으로 등록됩니다. 자세한 절차는 Docker 런타임 등록을 참고하세요.

설정 시나리오​

아래 가이드를 순서대로 따라가면 배포에 필요한 설정이 모두 갖춰집니다.

  • 장비 등록 - 관리할 서버/장비를 등록합니다.
  • K8s 클러스터 등록 - Kubernetes 클러스터를 신규 설치하거나 기존 클러스터를 연결합니다.
  • Docker 런타임 등록 - Docker/Podman 런타임을 신규 설치하거나 기존 호스트를 연결합니다.
  • 서비스 등록 - GitLab/GitHub/Docker Hub 기반 서비스를 등록합니다.
  • 파드 리소스 메트릭 - 리소스 사용량은 설치 없이 수집됩니다. HPA를 쓸 때만 metrics-server가 별도로 필요합니다.
  • RBAC 관리 - 클러스터 권한과 통합 계정을 관리합니다.
  • K8s 인증서 갱신 - kubeadm 클러스터 인증서를 갱신합니다.
어떤 런타임을 선택해야 하나요?
  • Kubernetes: 대규모 운영 환경에 적합합니다. 오토스케일링, 롤링 업데이트 등 고급 기능을 사용할 수 있습니다.
  • Docker/Podman: 소규모 환경이나 개발/테스트 환경에 적합합니다. 설정이 간단하고 빠르게 시작할 수 있습니다.