본문으로 건너뛰기

시스템 등록 시나리오

회사에 구축된 시스템(서버, Kubernetes 클러스터, Docker 환경 등)을 KIWI에 등록하는 전체 과정을 안내합니다.

사전 준비사항​

시스템 등록 전 다음 정보를 준비하세요:

  • 서버 IP 주소 및 SSH 접속 정보
  • Kubernetes 클러스터 접속 정보 (kubeconfig)
  • 필요한 권한: device, infra

시나리오 1: 서버(장비) 등록하기​

Q. 회사 서버를 KIWI에 등록하고 싶습니다​

단계별 안내:

Step 1: 장비 관리 페이지 이동​

  • 이동 경로: [장비 관리]
  • UI 요소: 좌측 메뉴에서 "장비 관리" 클릭

Step 2: 새 장비 등록​

  • UI 요소: 장비등록버튼 - 우측 상단 "장비 등록" 버튼 클릭
  • 동작: 장비 등록 모달이 열립니다

Step 3: 장비 정보 입력​

  • 필수 입력 항목:
    항목설명예시
    장비명식별 가능한 이름production-server-01
    IP 주소서버 IP192.168.1.100
    SSH 포트SSH 접속 포트22
    사용자명SSH 계정admin
    인증 방식비밀번호 또는 SSH 키비밀번호

Step 4: 연결 테스트​

  • UI 요소: 연결테스트버튼 - "연결 테스트" 버튼 클릭
  • 확인: 연결 성공 메시지 확인

Step 5: 등록 완료​

  • UI 요소: "저장" 버튼 클릭
  • 결과: 장비목록테이블에 새 장비가 추가됩니다

시나리오 2: 외부 Kubernetes 클러스터 등록​

Q. 기존에 구축된 Kubernetes 클러스터를 KIWI에 연결하고 싶습니다​

단계별 안내:

Step 1: 런타임 환경 페이지 이동​

  • 이동 경로: [런타임 환경]
  • UI 요소: 좌측 메뉴에서 "런타임 환경" 클릭

Step 2: 외부 런타임 가져오기​

  • UI 요소: 외부런타임가져오기 - "외부 런타임 가져오기" 버튼 클릭
  • 동작: 외부 런타임 연결 모달이 열립니다

Step 3: 연결 방식 선택​

  • 옵션:
    방식설명사용 시점
    kubeconfigkubeconfig 파일 업로드직접 접근 가능한 클러스터
    SSH 터널SSH를 통한 접근방화벽 뒤의 클러스터
    VPNVPN을 통한 접근VPN 연결 필요한 환경

Step 4: kubeconfig 업로드 (kubeconfig 방식)​

  • 동작: kubeconfig 파일을 드래그앤드롭 또는 파일 선택
  • 주의: kubeconfig에 접근 토큰이 포함되어 있는지 확인

Step 5: 연결 확인 및 저장​

  • UI 요소: "연결 테스트" → "저장" 순서로 클릭
  • 결과: 런타임목록에 새 클러스터가 추가됩니다

시나리오 3: Docker 런타임 등록​

Q. Docker가 설치된 서버를 KIWI 런타임으로 등록하고 싶습니다​

사전 조건: 해당 서버가 [장비 관리]에 먼저 등록되어 있어야 합니다.

단계별 안내:

Step 1: 런타임 환경 페이지 이동​

  • 이동 경로: [런타임 환경]

Step 2: 런타임 등록​

  • UI 요소: 런타임등록버튼 - "런타임 등록" 버튼 클릭

Step 3: 런타임 유형 선택​

  • 선택: "Docker" 또는 "Podman"
  • 장비 선택: 등록된 장비 목록에서 Docker가 설치된 서버 선택

Step 4: Docker 소켓 경로 설정​

  • 기본값: /var/run/docker.sock
  • 원격 API: 필요시 TCP 소켓 설정 (예: tcp://192.168.1.100:2375)

Step 5: 등록 완료​

  • 결과: 런타임목록에 Docker 런타임이 추가됩니다
  • 확인: 컨테이너 목록 조회가 정상적으로 되는지 확인

관련 질문​

자주 묻는 질문​

질문답변관련 페이지
SSH 연결이 실패합니다방화벽 설정 및 SSH 포트 확인 필요[장비 관리]
kubeconfig가 작동하지 않습니다토큰 만료 또는 권한 부족 확인[런타임 환경]
Docker 소켓 접근이 거부됩니다사용자를 docker 그룹에 추가 필요[런타임 환경]

다음 단계​

시스템 등록이 완료되면 다음 작업을 진행하세요:

  1. 서비스 등록 시나리오 - Git 저장소 연동
  2. 보안 스캔 설정 - SAST/SCA 설정