Volume 마운트
PVC·ConfigMap·Secret을 Pod(Deployment)에 마운트하거나 환경 변수로 주입합니다.
사전 조건
- Container 앱 접근 권한
- 마운트할 PVC·ConfigMap·Secret이 동일 Namespace에 존재
- 대상 Deployment가 존재
- 왼쪽 끝의 클러스터 아이콘을 눌러 대상 Cluster 안으로 들어간 뒤 Workloads → Deployments 메뉴를 엽니다.
- 대상 Deployment 행 오른쪽 끝의 Action(
...) 메뉴에서 Edit Config를 선택합니다.
편집 진입 (행 Action 메뉴)
볼륨을 마운트할 Deployment 행의 Action 버튼을 누르면 작업 메뉴가 열립니다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 1-1 | Edit Config | 폼 편집 | · 폼 편집기를 열어 컨테이너 탭의 Storage(볼륨 마운트)·Environment variables(환경 변수) 섹션을 편집합니다. |
| 1-2 | Edit YAML | YAML 편집 | · YAML에서 volumes·volumeMounts를 직접 작성합니다. |
볼륨 마운트 (컨테이너 Storage 섹션)
Edit Config 폼 상단에서 컨테이너 탭을 선택하면 Storage 섹션이 나타납니다. 미리 생성해 둔 볼륨(PVC·ConfigMap·Secret·Empty Dir 등)을 선택해 컨테이너에 마운트합니다. 볼륨 리소스 자체는 Persistent volume claims·ConfigMaps·Secrets 페이지에서 먼저 만듭니다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 2-1 | Select Volume | 볼륨 선택 | · 마운트할 볼륨을 선택합니다. 같은 Namespace의 PVC·ConfigMap·Secret 등이 목록에 나타납니다. |
| 2-2 | Mount Point | 마운트 경로 | · 컨테이너 내부에서 볼륨이 마운트될 경로를 입력합니다. (필수) 필요하면 Sub Path·Read Only를 함께 지정합니다. |
| 2-3 | Add Mount | 마운트 추가 | · 같은 볼륨을 다른 경로에도 마운트해야 할 때 경로를 하나 더 추가합니다. |
환경 변수 주입 (Environment variables 섹션)
같은 컨테이너 탭의 Environment variables 섹션에서 컨테이너에 환경 변수를 주입합니다. 행마다 Type·Variable Name·Value를 지정하고, 하단 Add Variable로 행을 추가합니다.
| 번호 | 기능 | 항목 | 설명 |
|---|---|---|---|
| 3-1 | Type | 주입 방식 | · 값을 직접 입력하는 Key/value pair 외에, ConfigMap·Secret의 값을 참조해 주입하는 방식도 선택할 수 있습니다. |
| 3-2 | Variable Name | 변수 이름 | · 컨테이너에 전달될 환경 변수 이름을 입력하고, 오른쪽 Value에 값(또는 참조할 Key)을 지정합니다. |
TIP
PVC를 마운트하려면 Persistent volume claims, 설정 파일은 ConfigMaps, 민감 정보는 Secrets 페이지에서 볼륨 리소스를 먼저 만든 뒤, 위 Storage 섹션의 Select Volume에서 선택합니다.
WARNING
Secret을 파일로 마운트하면 마운트 경로에 평문으로 저장됩니다. 애플리케이션이 읽은 후 메모리에서만 사용하도록 구성하세요.
세밀한 편집이 필요하면 Action 메뉴의 Edit YAML에서 volumes·volumeMounts를 직접 작성할 수도 있습니다.
Save를 누르면 Deployment가 업데이트되고, 새 Pod에서 지정한 경로에 볼륨이 마운트되면 완료입니다.