Kubernetes on 홈랩운영일지

Hugo 블로그 셀프호스팅 하기

Wed, 18 Feb 2026 00:00:00 +0000

Hugo 블로그와 Obsidian 기반 콘텐츠 관리 구조를 설계하고, Git Submodule로 멀티 레포 구조를 구성했다. Argo Events와 Argo Workflows를 이용해 Gitea Webhook 기반 CI/CD 파이프라인을 구축하고, 이미지 빌드부터 Helm 배포까지 자동화했다.

Helm Chart 작성방법 (1)

Mon, 21 Jul 2025 00:00:00 +0000

Kubernetes 환경에서 애플리케이션 배포를 반복하다 보면, 결국 매니페스트 관리의 복잡성과 중복 문제에 직면하게 된다. Helm은 이러한 문제를 해결하기 위한 사실상의 표준 도구로, 매개변수화된 Kubernetes 리소스 정의와 배포 자동화를 가능하게 한다.

Helm Chart는 Kubernetes 리소스(YAML)를

템플릿화
버전 관리
파라미터화(values.yaml)
패키징/배포

하기 위한 애플리케이션 패키지 규격

기본 구조

my-app/
├── Chart.yaml # 차트 메타데이터 (필수)
├── values.yaml # 기본 설정값 (필수)
├── values.schema.json # values 검증 (선택)
├── templates/ # Kubernetes 리소스 템플릿
│ ├── deployment.yaml
│ ├── service.yaml
│ ├── ingress.yaml
│ ├── configmap.yaml
│ ├── secret.yaml
│ ├── _helpers.tpl # 공통 함수 정의
│ └── NOTES.txt # helm install 후 출력 메시지
└── charts/ # 의존 차트 (서브차트)

Chart.yaml 작성

apiVersion: v2
name: my-app
description: My application Helm chart
type: application
version: 0.1.0 # Helm Chart 버전
appVersion: "1.2.3" # 실제 애플리케이션 버전

필드	의미
version	차트 변경 시 증가 (semver)
appVersion	컨테이너/앱 버전 (image tag)
type	application / library

Tip

CI에서 앱 버전 자동 감지 → appVersion 업데이트 패턴을 자주 사용함

Helm Chart 작성방법 (2)

Mon, 21 Jul 2025 00:00:00 +0000

Helm Chart의 핵심은 단순한 YAML 파일이 아니라, Go Template을 기반으로 한 동적 렌더링 로직에 있다. 조건문, 반복문, 변수 치환, 함수 호출 등 Go Template 문법을 이해하지 못하면 Chart가 커질수록 유지보수가 어려워진다.

Go Template의 기본 문법을 알아보자.

1. 기본 표현식 구문

템플릿 블록

{% raw %}
{{ EXPRESSION }}
{% endraw %}

{``{ }``}내부만 템플릿 엔진이 평가
YAML/문자열 어디든 삽입 가능

공백 제어

{% raw %}
{{- EXP }} # 왼쪽 공백 제거
{{ EXP -}} # 오른쪽 공백 제거
{{- EXP -}} # 양쪽 제거
{% endraw %}

2. 값 참조 (Value Access)

기본 경로 접근

.Values.key
.Values.parent.child

YAML map → dot(.)으로 접근

Helm Chart 작성방법 (3)

Mon, 21 Jul 2025 00:00:00 +0000

Helm Chart의 규모가 커질수록, Template 파일 곳곳에 반복되는 코드와 공통 로직이 늘어나게 된다. 이러한 중복을 줄이고 Chart를 구조적으로 관리하기 위해 Helm은 _helpers.tpl이라는 공용 Template 파일을 제공한다.

_helpers.tpl은 Helm Chart 내에서 사용하는 Go template 조각(template definitions)을 모아두는 파일

파일명은 관례적으로 _helpers.tpl
_로 시작하는 이유는 Kubernetes 리소스로 렌더링되지 않기 때문

즉, _helpers.tpl 자체는 YAML 리소스를 생성하지 않는다. {: .prompt-info }

Helm이 `_helpers.tpl`을 처리하는 방식

Helm은 templates/ 디렉터리 아래의 모든 .yaml, .tpl 파일을 한 번 전부 로드

Kubernetes에서 사용 가능한 CRI 비교

Sat, 07 Jun 2025 00:00:00 +0000

쿠버네티스에서 컨테이너를 실행하려면 반드시 **CRI(Container Runtime Interface)**가 필요하다. 현재 쿠버네티스 환경에서 가장 널리 선택되는 옵션은 다음 세 가지다.

containerd
CRI-O
cri-dockerd

각 런타임은 태생적 배경과 목표가 다르기 때문에 구조, 성능, 운영 방식에도 차이가 있다.
이 글에서는 세 런타임을 비교하고, 어떤 환경에서 어떤 런타임을 선택해야 하는지 정리한다.

1. containerd

containerd는 원래 Docker 내부의 핵심 엔진이었지만, 컨테이너 표준화를 위해 CNCF 독립 프로젝트로 분리된 런타임이다.
현재 Kubernetes에서 가장 널리 사용되며, 쿠버네티스 공식 문서에서도 권장하는 런타임이다.

kubeconfig 파일 병합하기

Wed, 12 Jun 2024 00:00:00 +0000

여러 개의 Kubernetes 클러스터를 운영하다 보면 kubeconfig 파일이 여러 개로 흩어지기 쉽다. 테스트·운영 클러스터가 각각 따로 있고, 로컬 개발 환경까지 더해지면 설정 파일이 폴더 곳곳에 생겨 관리가 복잡해진다.

이 글에서는 이러한 여러 kubeconfig 파일을 하나로 병합해 관리성을 높이는 방법을 소개한다. kubectl을 사용할 때 context 전환을 쉽게 하고, 설정이 산재해 생기는 혼란을 방지하는 데 도움이 된다.

1. kubeconfig 파일 백업하기

기존 설정을 잃어버리면 곤란하므로 병합 작업을 시작하기 전에 반드시 백업을 만들어둔다.

Kubernetes on 홈랩운영일지

Hugo 블로그 셀프호스팅 하기

Helm Chart 작성방법 (1)

기본 구조

Chart.yaml 작성

Helm Chart 작성방법 (2)

1. 기본 표현식 구문

템플릿 블록

공백 제어

2. 값 참조 (Value Access)

기본 경로 접근

Helm Chart 작성방법 (3)

Helm이 _helpers.tpl을 처리하는 방식

Kubernetes에서 사용 가능한 CRI 비교

1. containerd

kubeconfig 파일 병합하기

1. kubeconfig 파일 백업하기

Helm이 `_helpers.tpl`을 처리하는 방식