본문으로 건너뛰기
cdk8s로 사내 배포 설정을 Kubernetes 매니페스트로 변환하기
목차

cdk8s로 사내 배포 설정을 Kubernetes 매니페스트로 변환하기 (SRE 밋업 2회)

원문 정보

  • 원문: cdk8s 활용 당근마켓 서비스 배포 탬플릿 만들기 | 당근마켓 SRE 밋업 2회 (30:24)
  • 매체 · 게시일: YouTube 당근 채널 · 2021-12-02
  • 발표자: 김규환 (당근마켓 SRE 팀 딜리버리 파트). 영상 설명란으로 확인했고, 자막 자기소개에서는 영어 이름이 들리는데 인식이 깨져 있습니다.
  • 근거: YouTube 자동 자막 전체 + 발표 슬라이드. 슬라이드 글자 추출이 깨져 구조만 확인했고 내용은 자막을 따랐습니다.
  • 발표 영상의 내용을 바탕으로 재구성한 요약입니다.

개발자가 결정할 설정만 입력받기

당근은 개발자가 Kubernetes를 몰라도 서비스 저장소의 설정 파일로 배포할 수 있게 하려 했습니다. Kontrol 발표에 나온 사내 배포 매니페스트가 그 입력입니다. Dockerfile 경로, 사용할 구성, 워크로드, 인그레스 등 배포에 필요한 매개 변수만 받습니다.

개발자가 Kubernetes의 리소스·옵션과 여러 도구의 관계, 회사 고유 규칙까지 알아야 하는 부담을 줄이려는 선택입니다. 설정의 자유도는 줄이되 인프라 세부 구현을 직접 다루지 않게 했습니다. 이번 발표는 이 입력을 실제 Kubernetes 매니페스트로 변환할 도구를 고른 과정을 설명합니다.

숨길 설정을 정한 뒤 cdk8s를 선택

개발자는 서비스를 내부에만 공개할지 외부에도 공개할지 정합니다. Istio Gateway·VirtualService의 호스트 이름과 규칙은 템플릿이 만듭니다. HAProxy가 gRPC 연결을 별도로 처리할 때 필요한 호스트 접미사도 프로토콜 옵션에 따라 생성합니다. CPU·메모리는 스케줄링과 QoS를 고려해야 하는 클러스터 관리 영역으로 보고, 개발자는 EC2 인스턴스 클래스와 같은 사양을 선택하게 했습니다.

팀은 Helm과 cdk8s를 비교했습니다. 글로벌 배포와 잦은 실험으로 템플릿이 자주 바뀌는데, Helm에서는 복잡한 조건과 디자인 패턴을 적용하며 유지보수하기 어렵다고 판단했습니다. cdk8s에는 IDE 자동 완성, 테스트 도구, 객체지향 설계 등 프로그래밍 언어의 도구를 활용할 수 있다는 기대가 있었습니다.

발표는 cdk8s를 AWS 팀이 2020년에 공개한 CNCF 샌드박스 프로젝트로 소개하며, 당시에는 AWS 공식 프로젝트가 아닌 별도 팀의 오픈소스라고 설명했습니다. 선택한 언어는 정적 타입과 동적 언어의 특성을 함께 활용할 수 있는 TypeScript입니다. Kontrol의 주요 구성 요소가 Node 기반이라 npm 패키지로 같은 로직을 재사용하기에도 맞았습니다.

미리보기와 실제 배포가 같은 템플릿 사용

템플릿 엔진은 별도 코드베이스로 관리하고 Kontrol에서 패키지로 불러옵니다. 다른 저장소에 있는 매니페스트 미리보기 페이지도 같은 패키지를 사용합니다. 개발자는 배포하지 않고도 생성될 Kubernetes 리소스를 확인할 수 있습니다.

인자는 변경 빈도에 따라 나누고 유효성 검사를 추가했습니다. 잘못된 입력을 배포 전에 확인해 수정 결과를 빠르게 받을 수 있도록 했습니다.

도구를 바꾼 뒤에도 필요한 리소스 설계

cdk8s를 도입한다고 복잡도가 저절로 줄지는 않습니다. 당근은 관심사가 같은 리소스를 클래스로 묶었습니다. Deployment·Service·ServiceMonitor는 워크로드로, Istio 리소스는 트래픽으로 분류했습니다.

리전·환경·이미지 태그처럼 자주 바뀌는 인자는 Kontrol이 넣습니다. 포트와 헬스 체크처럼 환경과 무관하게 거의 바뀌지 않는 값은 배포 매니페스트에 둡니다.

발표에서는 재생되지 않는 데모 영상을 건너뛰었고 주제도 직전에 일부 바뀌었다고 설명합니다. 지원 언어와 구성은 2021년 당시의 설명이며, 자막 인식이 불명확한 언어 목록은 아래 표에서도 추정으로 표시했습니다.

주요 구간

  • 00:00 템플릿이란 무엇인가
  • 02:00 배포 매니페스트와 배포 인터페이스가 필요한 이유
  • 07:30 배포 매니페스트 설계: 호스트, 프로토콜, 인스턴스 클래스
  • 14:30 템플릿 엔진과 Helm, cdk8s 비교
  • 21:00 cdk8s와 TypeScript 선택
  • 26:00 리소스 나누기와 인자 분류, 유효성 검사
근거와 세부 수치
항목내용근거
배포 매니페스트에 담는 내용빌드 Dockerfile 경로, 사용 구성 목록, 워크로드 목록과 세부 설정, 인그레스 설정자막 기준
후보 비교Helm 템플릿(선언형)과 cdk8s(프로그래밍 언어) 비교슬라이드, 자막 기준
cdk8s 지원 언어2021년 9월 7일 기준 4개 언어(TypeScript, JavaScript, Python, Java로 추정)자막 기준
선택 언어TypeScript자막 기준
설계에서 숨긴 것호스트 도메인 규칙, gRPC 호스트 접미사, CPU와 메모리 사양(AWS 머신 타입으로 지정)자막 기준
쪼개기 기준관심사가 같은 리소스끼리 클래스로 묶기자막 기준
인자 분류자주 바뀌는 인자(리전, 환경, 이미지 태그, 애플리케이션 구성)와 안 바뀌는 인자(포트, 헬스 체크 등)자막 기준

슬라이드 PDF는 글꼴 인코딩 문제로 글자를 추출할 수 없어 페이지 제목 구조만 확인했습니다. 지원 언어 목록은 자막 인식이 깨져 있어 이름을 확정하지 않았습니다. 영상 설명란에는 녹화일이 2021년 1월 17일로 적혀 있으나 게시일은 2021-12-02입니다.

마지막 수정 일자