Kubernetes 환경에서 Application을 운영할 때 Container Image와 설정 데이터를 분리하는 것은 매우 중요합니다.

예를 들어 개발 환경과 Production 환경은 같은 Application이라도 Database 주소, API Endpoint, 실행 옵션 등이 다를 수 있습니다.

만약 이러한 설정 값을 Container Image 내부에 포함하면 환경 변경 시마다 Image를 다시 생성해야 하는 문제가 발생합니다.

Kubernetes에서는 이러한 문제를 해결하기 위해 ConfigMap 기능을 제공합니다.

ConfigMap은 Application 설정 데이터를 별도의 Resource로 관리하고 Pod에 전달하는 Kubernetes 설정 관리 기능입니다.

구성 요소	역할
ConfigMap	환경 설정 데이터 저장
Pod	설정 값 사용
Container	Application 실행
API Server	ConfigMap 관리

ConfigMap 구조를 이해하면 Kubernetes에서 Application과 설정 데이터를 분리하고 효율적으로 운영하는 방식을 이해할 수 있습니다.

Kubernetes ConfigMap이란 무엇인가?

ConfigMap은 Kubernetes에서 설정 데이터를 저장하는 Resource입니다.

Application Code와 Configuration을 분리하여 동일한 Container Image를 다양한 환경에서 사용할 수 있도록 합니다.

기존 방식:

Application Image

↓

환경 설정 포함

↓

환경 변경

↓

Image 재생성 필요

ConfigMap 방식:

Container Image

ConfigMap 설정

↓

Application 실행

설정 변경만으로 Application 환경을 변경할 수 있습니다.

Kubernetes ConfigMap이 필요한 이유

Cloud Native 환경에서는 Application과 Configuration을 분리하는 것이 중요합니다.

문제:

방식	문제
설정 값 Image 포함	재빌드 필요
환경별 Image 생성	관리 복잡
설정 변경 어려움	배포 시간 증가
공통 설정 관리 부족	운영 효율 저하

ConfigMap을 사용하면 설정을 독립적으로 관리할 수 있습니다.

Kubernetes ConfigMap 동작 구조

ConfigMap은 Kubernetes API Server에 저장되고 Pod가 참조하여 사용합니다.

구조:

구성 요소	역할
ConfigMap	설정 데이터 저장
Pod	ConfigMap 연결
Volume	파일 형태 전달
Environment Variable	환경 변수 전달

동작 과정:

단계	내용
1단계	ConfigMap 생성
2단계	Pod 설정 연결
3단계	Container 시작
4단계	Application 설정 적용

Application은 Kubernetes 외부 설정을 받아 실행됩니다.

Kubernetes ConfigMap 생성 방식

ConfigMap은 여러 방법으로 생성할 수 있습니다.

방식	설명
YAML 작성	Resource 정의
파일 기반 생성	설정 파일 저장
Literal 값 생성	직접 값 입력

관리 목적에 따라 적절한 방식을 선택합니다.

Kubernetes ConfigMap 데이터 구조

ConfigMap은 Key-Value 형태로 데이터를 저장합니다.

예:

Key	Value
DATABASE_HOST	db-service
LOG_LEVEL	INFO
APP_MODE	production

Application은 Key를 통해 필요한 설정 값을 가져옵니다.

Kubernetes ConfigMap과 Environment Variable

ConfigMap 값은 Container 환경 변수로 전달할 수 있습니다.

구조:

ConfigMap

↓

Environment Variable

↓

Application

예:

DATABASE_HOST=db-service

Application은 일반 환경 변수처럼 사용할 수 있습니다.

Kubernetes ConfigMap과 Volume Mount

ConfigMap은 파일 형태로 Container에 Mount할 수도 있습니다.

구조:

ConfigMap

↓

Volume

↓

Container File System

예:

/config/application.yaml

Application 설정 파일처럼 사용할 수 있습니다.

Kubernetes ConfigMap과 Secret 차이

ConfigMap과 Secret은 비슷하지만 목적이 다릅니다.

구분	ConfigMap	Secret
목적	일반 설정	민감 정보
데이터	일반 Text	Password, Token
보안	기본 보호 없음	암호화 옵션 지원
예시	Application 설정	Database Password

비밀번호와 같은 정보는 Secret 사용이 적합합니다.

Kubernetes ConfigMap 변경 적용 방식

ConfigMap 값을 변경해도 실행 중인 Container에 즉시 적용되지는 않습니다.

적용 방식:

방법	설명
Pod 재시작	새 설정 적용
Volume Mount	일정 시간 후 반영 가능
Rolling Update	안정적 적용

Production 환경에서는 배포 전략과 함께 관리해야 합니다.

Kubernetes ConfigMap 활용 사례

ConfigMap은 다양한 설정 관리에 사용됩니다.

활용 사례	설명
Database 설정	Connection 정보
Application 옵션	실행 설정
Log 설정	Logging Level
환경 구분	Dev, Test, Production 설정

Application 환경 관리에 매우 유용합니다.

Kubernetes ConfigMap과 Helm 관계

Helm Chart에서도 ConfigMap을 Template 형태로 관리할 수 있습니다.

구조:

Helm Values

↓

ConfigMap Template

↓

Kubernetes ConfigMap

↓

Application

배포 자동화 환경에서 많이 활용됩니다.

Kubernetes ConfigMap 운영 시 고려사항

Production 환경에서는 ConfigMap 관리 전략이 필요합니다.

항목	설명
Version 관리	변경 기록 관리
Backup	중요 설정 보호
권한 관리	RBAC 적용
Update 정책	변경 영향 확인

설정 변경은 Application 동작에 직접 영향을 줄 수 있습니다.

Kubernetes ConfigMap 보안 관리

ConfigMap에는 민감하지 않은 데이터만 저장하는 것이 원칙입니다.

저장 권장:

데이터	사용
Application 설정	ConfigMap
환경 옵션	ConfigMap
Password	Secret
API Key	Secret

중요 정보는 반드시 Secret으로 관리해야 합니다.

Kubernetes ConfigMap 장점

장점	설명
설정 분리	Image 재생성 감소
환경 관리	여러 환경 지원
운영 편의	변경 관리 용이
재사용성	동일 Image 활용

ConfigMap은 Kubernetes Application 운영에서 필수적인 설정 관리 기능입니다.

자주 묻는 질문

ConfigMap과 Secret 차이는 무엇인가요?

ConfigMap은 일반 설정 데이터를 저장하고 Secret은 Password, Token 같은 민감 정보를 저장합니다.

ConfigMap 변경하면 Pod가 자동 재시작되나요?

아닙니다.

일반적으로 변경 내용을 적용하려면 Pod 재시작 또는 배포 전략이 필요합니다.

ConfigMap에 모든 설정을 저장해도 되나요?