Kubernetes

컨피그맵 생성설정 값을 문자열 그대로

입력의 의미를 선택하고 ConfigMap, Opaque Secret, ENV 또는 문자열 JSON으로 출력하세요.

컨피그맵 생성

입력

결과

현재 브라우저 페이지 메모리에서만 처리하며 입력을 네트워크 요청이나 공유 링크로 보내지 않습니다.

결과만 가리며 입력 원문은 보입니다. 실제 값을 복사하거나 저장하려면 가리기를 해제하세요.

YAML에서 값만 추출하고 현재 옵션으로 메타데이터를 다시 만듭니다. Base64는 암호화가 아닙니다.

입력·데이터 각각 256 KiB · 최대 1000개 키 · 출력 1 MiB · UTF-8 텍스트만

텍스트를 입력하세요

컨피그맵 생성 작업에서는 환경 변수 여러 개와 설정 파일 하나를 구분해야 합니다. PORT=0080이 개별 설정인지 파일 내용의 일부인지에 따라 키 구조가 달라집니다. 값이 숫자처럼 보여도 이 도구는 문자열을 유지합니다.

기존 매니페스트를 읽으려면 YAML 입력을 선택하세요. 시크릿 디코딩은 Base64 인코딩 값을 UTF-8로 복원하고, 같은 키의 stringData가 있으면 그 값을 우선합니다. 원본 메타데이터를 편집하는 작업과는 범위가 다릅니다.

컨피그맵 생성 전에 확인할 차이

값은 유지하고 표현만 선택

컨피그맵 생성 도구는 같은 입력을 일반 data, Secret의 Base64 data 또는 평문 stringData로 나타냅니다. 결과 값은 처음에 모두 가려집니다. 가리기를 해제해야 전체 결과를 복사하거나 저장할 수 있으며, 입력 원문은 계속 보입니다.

같은 설정 값을 일반 data, 인코딩한 data, 평문 stringData로 표현한 그림.

파일 하나를 변수 여러 개로 쪼개지 않기

설정 파일의 등호와 빈 줄, 마지막 개행은 파일 내용입니다. 전체 파일 모드는 선택한 키 하나에 원문을 넣습니다. ENV 모드는 대입문마다 키를 만들기 때문에 결과의 키 개수로 해석이 맞는지 확인할 수 있습니다.

ENV 대입문은 여러 키로 나뉘고 전체 파일은 키 하나의 값으로 유지되는 그림.

해석 방식부터 내보내기까지 확인하기

01

파일을 읽기 전에 형식 선택

파일 이름으로 파서를 추측하지 않습니다. 마운트할 설정 파일이면 전체 파일을 선택하고, 대입문별 환경 변수라면 ENV를 선택하세요. 예제, 비우기, 파일 읽기는 교체 내용을 미리 본 뒤 적용하며 한 번 되돌릴 수 있습니다.

02

출력 이름과 파일 키 점검

이름과 네임스페이스는 현재 옵션에서 가져옵니다. 네임스페이스를 비우면 해당 필드를 생략합니다. application.properties 같은 파일 키는 YAML과 JSON에 보존되지만 도구의 이식 가능한 ENV 이름 규칙에는 맞지 않습니다.

03

최신 결과만 표시하고 내보내기

입력이나 변환 옵션이 바뀌면 내보내기가 즉시 비활성화됩니다. 자동 모드는 350ms 후 갱신합니다. 자동 실행을 끄면 변환 버튼 또는 Ctrl/Cmd+Enter를 사용하세요. 되돌리기는 입력과 이전 결과를 함께 복원합니다.

매니페스트와 실제 문자열 값 사이

세 가지 저장 표현

ConfigMap은 data에 텍스트를 저장합니다. Opaque Secret은 Base64 data와 평문 stringData 중에서 선택합니다. 출력 YAML의 키와 값에 모두 따옴표를 붙여 숫자나 불리언으로 바뀌는 것을 방지합니다.

덮어쓴 값의 개수 확인

Secret의 data를 먼저 검증한 뒤 stringData를 병합합니다. 같은 키가 덮어써진 개수는 상태에 표시합니다. 나중에 교체될 값이라도 Base64가 잘못되면 오류가 발생하므로 손상된 값을 숨기지 않습니다.

파일 본문 그대로 유지

전체 파일 모드는 Unicode, CRLF, 마지막 개행을 포함한 텍스트를 하나의 키에 넣습니다. 문자열 JSON에서도 파일 키와 여러 줄 값을 지원합니다. 중첩 객체를 펼치거나 배열을 문자열로 바꾸지는 않습니다.

실패한 일부 결과는 내보내지 않기

중복 키, 잘못된 이름, 문자열이 아닌 값, YAML 구문 오류는 변환을 중단합니다. 위치를 알 수 있으면 행과 열을 표시하고 입력 줄을 강조합니다. 성공한 결과에만 모든 키가 포함됩니다.

지원 범위와 명시적인 제한

텍스트 리소스 하나만 지원
YAML 입력은 v1 ConfigMap 또는 Opaque Secret 하나입니다. binaryData, 다른 Secret 유형, 여러 문서, 별칭, 병합 키, 사용자 태그는 거부합니다. 보수적인 YAML 1.1 해석에서 날짜나 숫자로 읽히는 값은 따옴표가 필요합니다.
ENV는 dotenv 규칙 적용
지원하는 따옴표와 주석을 해석하지만 변수나 명령은 실행하지 않습니다. 따옴표를 값에 남기는 kubectl --from-env-file과 다릅니다. 주석, 들여쓰기, 원래 따옴표 형식은 유지하지 않습니다.
문자열만 받고 중복은 오류
JSON은 평면 문자열 객체여야 하고 YAML 설정 값도 문자열이어야 합니다. 숫자, null, 목록, 중첩 맵을 강제로 변환하지 않습니다. 중복 키는 오류이며 stringData가 data를 덮어쓰는 규칙만 별도로 적용합니다.
키를 자동 수정하지 않기
설정 키는 ASCII 영숫자와 점, 하이픈, 밑줄을 사용해 최대 253자입니다. 점 하나이거나 두 점으로 시작하면 거부합니다. ENV 출력은 더 좁은 식별자 규칙을 사용하고 __proto__도 거부합니다. 호환되지 않는 키가 있으면 전체 ENV 내보내기가 실패합니다.
처리량 제한
입력과 디코딩한 키·값은 각각 256 KiB, 최대 1000개 항목이며 결과는 1 MiB입니다. Kubernetes 객체 전체의 크기 검증을 대신하는 수치는 아닙니다. UTF-8이 아닌 파일, NUL 문자, 제한을 넘는 데이터는 거부합니다.
기존 객체 편집 기능은 없음
원본 YAML에서 값만 추출합니다. labels, annotations, immutable 같은 메타데이터는 보존하지 않고 현재 이름과 네임스페이스로 새로 만듭니다. Helm 실행, 클러스터 조회, Pod 연결 생성, 배포 권한 검증은 하지 않습니다.

컨피그맵 생성 관련 질문

env 파일의 값으로 컨피그맵을 만들려면 어떻게 하나요?

ENV 입력과 ConfigMap 출력을 선택하고 객체 이름을 정하세요. 지원하는 dotenv 따옴표는 제거되지만 값은 모두 문자열로 남습니다. 생성한 data를 확인한 후 사용해야 하며 도구가 클러스터에 리소스를 생성하는 것은 아닙니다.

시크릿의 data와 stringData는 어떻게 다른가요?

data에는 Base64로 나타낸 값이 들어가고 stringData에는 일반 문자열을 씁니다. 두 필드에 같은 키가 있으면 stringData가 우선합니다. 두 표현을 모두 생성하고 읽을 수 있지만 stringData가 더 강한 보안 기능인 것은 아닙니다.

Base64로 인코딩하면 비밀번호가 암호화되나요?

아니요. Base64는 되돌릴 수 있는 인코딩입니다. 화면의 가리기 역시 암호화가 아닙니다. Secret의 보호는 클러스터 접근 제어와 저장 설정에 달려 있으며 내보낸 파일도 별도로 보호해야 합니다.

숫자처럼 보이는 설정 값에 따옴표가 필요한 이유는 무엇인가요?

따옴표 없는 012나 false는 YAML에서 숫자나 불리언으로 읽힐 수 있습니다. 생성할 때 키와 값에 따옴표를 붙입니다. 이미 문자열이 아닌 입력은 원래 의도를 추측하지 않고 거부합니다.

파일 전체를 넣는 방식과 env 파일을 읽는 방식은 어떻게 다른가요?

ENV 모드는 대입문마다 키를 만듭니다. 전체 파일 모드는 원문을 하나의 값으로 담습니다. application.properties처럼 마운트할 파일에는 전체 파일 모드를 쓰세요. 본문 속 등호는 새로운 환경 변수로 해석하지 않습니다.

주석과 따옴표, 중복 키는 어떻게 처리되나요?

중복 키를 발견하면 마지막 값만 선택하지 않고 중단합니다. dotenv 따옴표는 값 해석에 사용하고 주석은 버립니다. YAML의 주석과 서식도 남기지 않습니다. 이 문자들이 파일 내용으로 필요하다면 전체 파일 모드를 선택하세요.

필요한 변환이 빠졌나요?

내보내기 전에 구조 확인

컨피그맵 생성 예제로 키 개수와 출력 필드를 먼저 확인하세요. 애플리케이션이 기대하는 표현을 고른 뒤 최신 결과의 값을 표시하고 내보낼 수 있습니다.