본문으로 건너뛰기

서비스 등록 시나리오

Git 저장소를 KIWI에 연동하고 서비스를 등록하여 빌드/배포 파이프라인을 구성하는 방법을 안내합니다.

사전 준비사항​

  • Git 저장소 URL (GitLab, GitHub 등)
  • 저장소 접근 토큰 또는 인증 정보
  • 필요한 권한: service
  • 런타임 환경이 등록되어 있어야 함 ([런타임 환경])

시나리오 1: Git 저장소 연동하기​

Q. 우리 회사의 GitLab 저장소를 KIWI에 연동하고 싶습니다​

단계별 안내:

Step 1: 서비스 관리 페이지 이동​

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

Step 2: 서비스 등록 시작​

  • UI 요소: 서비스등록버튼 - 우측 상단 "서비스 등록" 버튼 클릭
  • 동작: 서비스 등록 마법사가 시작됩니다

Step 3: Git 저장소 정보 입력​

  • 필수 입력 항목:
    항목설명예시
    서비스명식별 가능한 이름my-web-app
    Git URL저장소 클론 URLhttps://gitlab.com/company/project.git
    브랜치기본 빌드 브랜치main
    인증 방식Personal Access Token 권장PAT

Step 4: 인증 정보 설정​

  • GitLab PAT 생성 방법:
    1. GitLab → Settings → Access Tokens
    2. 권한: read_repository, read_api 선택
    3. 토큰 생성 후 KIWI에 입력

Step 5: 저장소 연결 확인​

  • UI 요소: "연결 테스트" 버튼 클릭
  • 확인: 브랜치 목록이 정상적으로 조회되는지 확인

시나리오 2: 빌드 설정하기​

Q. 등록한 서비스의 Docker 이미지를 빌드하고 싶습니다​

단계별 안내:

Step 1: 서비스 상세 페이지 이동​

  • 동작: 서비스목록테이블에서 등록한 서비스 클릭

Step 2: 빌드 탭 선택​

  • UI 요소: 빌드탭 - 상단 탭에서 "빌드" 클릭

Step 3: Dockerfile 설정​

  • 옵션:
    방식설명
    자동 감지저장소 내 Dockerfile 자동 탐지
    경로 지정Dockerfile 경로 직접 입력
    빌드 마법사Dockerfile 자동 생성

Step 4: 이미지 레지스트리 설정​

  • 입력 항목:
    항목설명예시
    레지스트리 URLHarbor/DockerHub 주소harbor.company.com
    이미지 이름이미지 경로library/my-web-app
    태그 규칙버전 태깅 방식${BRANCH}-${SHORT_SHA}

Step 5: 빌드 런타임 선택​

  • 선택: 등록된 Kubernetes 클러스터 중 빌드를 실행할 환경 선택
  • 참고: Kaniko를 사용하여 클러스터 내에서 이미지 빌드

Step 6: 빌드 실행​

  • UI 요소: "빌드 시작" 버튼 클릭
  • 확인: 빌드 로그 실시간 확인 가능

시나리오 3: 배포 환경 설정하기​

Q. 빌드된 이미지를 Kubernetes에 배포하고 싶습니다​

단계별 안내:

Step 1: 배포 탭 선택​

  • UI 요소: 배포탭 - 상단 탭에서 "배포" 클릭

Step 2: 배포 대상 선택​

  • 선택: 등록된 런타임 환경 중 배포할 클러스터 선택
  • 환경 구분: Development / Staging / Production

Step 3: 배포 설정​

  • 입력 항목:
    항목설명
    네임스페이스K8s 네임스페이스
    레플리카 수Pod 복제본 개수
    리소스 제한CPU/메모리 제한
    환경 변수애플리케이션 설정

Step 4: 배포 실행​

  • UI 요소: "배포" 버튼 클릭
  • 확인: 배포 상태 모니터링

관련 질문​

자주 묻는 질문​

질문답변관련 페이지
Git 연결이 실패합니다토큰 권한 및 URL 형식 확인[서비스 관리]
빌드가 실패합니다Dockerfile 문법 및 베이스 이미지 확인[서비스 관리]
이미지 푸시가 실패합니다레지스트리 인증 정보 확인[서비스 관리]
배포 후 Pod가 시작되지 않습니다리소스 제한 및 이미지 경로 확인[서비스 관리]

다음 단계​

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

  1. 보안 스캔 설정 - SAST/SCA 자동 스캔