Applications

Print

Overview

ZCP v2의 가장 중요한 기능은 Multi Cluster 지원입니다. ZCP v1 에서는 각 클러스터 별로 ZCP 가 설치되어 해당 클러스터에만 어플리케이션을 배포하고, 로그를 수집하고, 모니터링 메트릭을 수집할 수 있었습니다. ZCP v2는 Control Plane 클러스터를 중심으로 여러 Data Plane 클러스터를 관리하고, 어플리케이션을 배포하고, 데이터를 수집하는 중앙 집중형으로 구성이 되어있습니다.

ZCP v2 의 Application (이하 ZCP Application. 일반적으로 말하는 Application 과 용어 구분하기 위함) 과 Deploy Group 은 단일 클러스터가 아닌 멀티 클러스터에 대한 CI/CD 를 위한 개념입니다. CI/CD란 결국 어플리케이션을 빌드하고, 자신이 원하는 환경에 빌드한 어플리케이션을 배포하는 과정을 지속적으로 수행할 수 있도록 자동화한 것입니다. 단일 클러스터를 대상으로 CI/CD 를 수행 할 경우 빌드 → 배포로 이어지는 프로세스가 한 번씩만 수행되어도 큰 문제가 없습니다. 하지만, 멀티 클러스터가 대상인 경우(배포 할 타겟 환경이 여러 곳인 경우) 빌드는 한번만 수행되고, 배포를 타겟만 바꿔가며 여러 번 실행할 수 있는 구성이 가능해야 합니다. ZCP v2 에서는 어플리케이션 빌드를 위한 ZCP Application과 원하는 클러스터에 배포를 하기 위한 Deploy Group 이란 개념을 만들어서 빌드와 배포의 과정을 분리했습니다.

일반적으로 Kubernetes 를 대상으로 하는 빌드/배포 파이프라인은 Source Checkout → Application Build → Docker Image Build & Push → Deploy 를 수행합니다. ZCP Application 은 이 과정 중 Source Checkout → Application Build → Docker Image Build & Push 를 담당합니다. 개발팀의 소스 코드를 체크아웃 받아 Kubernetes 에 배포 가능한 Docker Image 를 만들어내는 것이 목적이며, 별도의 스크립트 작성없이 최소한의 UI 설정만으로 빌드 파이프라인을 설정하고 수행 할 수 있도록 개발했습니다. 실제 작업을 수행하는 파이프라인의 엔진은 오픈소스 CI/CD framework 인 Tekton 을 사용합니다.

지원하는 도구

  • 형상 관리 Tool : GIT

  • 빌드 Tool : Maven, Gradle

ZCP Application 생성

ZCP Application 은 MSA 의 Application 과 1:1 Mapping 됩니다. MSA Application 당 하나의 ZCP Application 을 생성합니다.

ZCP Application 의 목표는 형상 관리 도구 안에 있는 소스 코드를 배포 가능한 Image 로 만드는 것이므로 생성하기 전에 Application 소스가 있는 Git 주소, Git 계정, Image 를 저장 할 Registry 주소, Registry 계정과 Docker Image 를 생성 할 Dockerfile 이 필요합니다.

Create Application

Create Application 버튼을 클릭합니다.

Source type 선택

현재는 표준 Git 만 지원합니다. ZCP 에서 지원하는 Gitea 나 Github, Gitlab 등 표준 Git 을 지원하는 Git server 는 모두 사용 가능합니다. 추후 다른 타입의 Source 가 추가될 수 있습니다.

기본 정보 입력

ZCP Application 의 기본 정보를 입력합니다.

  • Name (필수) : ZCP Application 의 이름입니다. label 등 시스템 내부에서 사용됩니다.

  • Display Name : 콘솔 화면에 표시 할 이름입니다. 입력하지 않으면 Name 이 표시됩니다.

  • Description : ZCP Application 에 대한 설명입니다.

Source Repository 정보 입력

빌드 시 Checkout 받을 소스 코드의 Repository 정보를 입력합니다.

  • Git Repository (필수) : Git Repository 의 Clone 주소입니다.

  • Authentication (필수) : 인증 타입을 선택할 수 있습니다. 현재는 ID, Password 방식인 Basic Authentication 만 지원합니다.

  • Secret (필수) : 계정 정보를 선택합니다. 계정 정보는 Secret 으로 관리되며 Project 내부에서 재사용이 가능합니다. 아래 절차대로 Secret 을 등록하고 선택합니다.

Secret 관리

  1. Add 버튼을 클릭하면 신규 Secret 을 생성 할 Row 가 추가됩니다.

  2. Secret Name 을 입력합니다. 소문자, 숫자, dash (-) 만 입력 가능합니다.

  3. Source checkout 받을 Git 사용자 계정을 입력합니다. 해당 계정은 Repository 생성 권한이 있어야 합니다. Deploy Group 에서 배포를 수행 할 때 소스 코드와 분리 된 GitOps 용 Repository 가 필요한데, 여기서 입력하는 계정으로 GitOps Repository를 생성하고, GitOps 배포를 수행합니다.

  4. Git Password 를 입력합니다.

  5. 입력이 완료되면 Save 버튼을 클릭해 Secret 을 저장합니다.

동일한 화면에서 이미 생성 된 Secret 을 수정, 삭제할 수 있습니다.

생성 한 Secret 을 선택한 후 Test Connection 버튼을 클릭해 접속이 가능한지 확인합니다.

Container Image 정보 입력

빌드한 Container Image 를 저장 할 Image Registry 의 정보를 입력합니다.

  • Image Repository (필수) : Container Image 를 업로드 할 Image Repository URL 을 입력합니다.

  • Secret (필수) : Image 를 업로드 할 때 필요한 계정 정보를 입력합니다. Source Repository 와 동일하게 Secret 관리 화면을 통해 계정 정보를 등록하고 선택할 수 있습니다.

  • Context : Image 빌드를 수행 할 때 파일 정보들을 읽어들일 Build Context 의 경로를 입력합니다. Build Context 에는 소스 코드 (또는 Artifact), 메타파일 등 Image 를 생성하기 위해 필요한 파일들이 존재해야 합니다. 입력하지 않을 경우 Source Repository 의 root 경로가 기본값으로 사용됩니다.

  • Dockerfile : Image 빌드 할 때 필요한 Command 들을 정리한 Dockerfile 의 파일명을 입력합니다. 입력하지 않을 경우 기본값은 Dockerfile 입니다.

기본 정보를 입력한 후 Save 버튼을 클릭하면 ZCP Application 이 생성됩니다.

저장 한 후 ZCP Application 이 생성 된 목록 화면입니다.

테이블 각 항목의 의미는 다음과 같습니다.

항목 명

설명

Name

ZCP Application 이름. 클릭하면 상세 화면으로 이동합니다.

Description

ZCP Application 에 대한 설명입니다.

Source Repo.

Application 소스 Repository의 경로입니다.

Image Registry

Container Image 를 업로드 할 Registry 경로입니다. Project, Repository 를 포함한 URL입니다.

Last Build Pipeline

마지막에 수행된 파이프라인 명입니다.

Last Build

마지막 빌드가 수행 된 시간입니다.

Last Build Status

마지막에 수행 된 빌드의 실행 결과입니다.

각 아이콘의 의미는 빌드 성공, 빌드 실패, 빌드 실행 중 입니다.

Actions

ZCP Application 에 대한 액션 수행 버튼입니다.

각 버튼은 상세 보기 (수정) 화면 이동, ZCP Application 삭제입니다.

ZCP Application 을 삭제해도 이미 생성되어 Image Registry 에 등록 된 Image 들은 삭제되지 않습니다. Data Plane 에 배포 된 어플리케이션도 삭제되지 않습니다.

파이프라인 설정하기

하나의 ZCP Application 은 여러 개의 빌드 파이프라인을 생성할 수 있습니다. 각 파이프라인 별로 서로 다른 Branch 를 사용하거나, 다른 빌드 Tool, 또는 빌드 Option 을 지정할 수 있습니다.

생성 된 ZCP Application 을 이름을 클릭하거나 Actions 컬럼의 Edit 버튼을 클릭하여 상세 화면으로 이동합니다.

상세 화면은 Overview, Basic Info, Build Pipeline 세 개의 탭으로 구성되어 있습니다.

Overview 탭에서는 각 파이프라인의 요약 정보와 마지막에 실행 된 빌드의 결과를 볼 수 있고, 우측 Actions 버튼으로 빌드를 실행하거나 지난 빌드 이력을 확인할 수 있습니다.