작동 원리 및 구조
CLI 토크나이저가 POSIX 셸 줄 바꿈(`\`), 따옴표 값, 결합된 짧은 플래그(`-dit`)를 처리해 `-p`, `-v`, `-e`, `--name`, `--restart`, `--network`와 이미지·커맨드 인자를 구조화된 YAML로 매핑합니다. 역변환 시에는 들여쓰기 기반 `services:` YAML 섹션에서 서비스 속성을 추출해 CLI 명령어로 재조립합니다.
단계별 사용 방법
변환 방향(`docker run -> compose.yaml` 또는 `compose.yaml -> docker run`)을 선택합니다.
컨테이너 CLI 명령어나 Compose YAML 서비스 명세를 붙여넣습니다.
지원되지 않는 커스텀 데몬 플래그에 대한 경고 메시지가 있는지 확인합니다.
결과 코드를 복사하거나 `compose.yaml` / `docker-run.sh` 파일로 바로 다운로드합니다.
주요 기능 및 장점
- 여러 줄 `\` 셸 연속 구문과 따옴표가 포함된 인자를 오류 없이 깔끔하게 파싱
- `-p` 포트, `-v` 볼륨, `-e` 환경변수, `--restart`, `--network`, 커맨드 오버라이드 완벽 매핑
- 더 이상 권장되지 않는 최상위 `version:` 보일러플레이트 없는 최신 Compose v2 규격 출력
- `compose.yaml` 서비스들을 개별 `docker run` CLI 명령어로 역변환하는 기능 지원
- 오프라인 실행으로 사내 비공개 레지스트리 URL과 DB 환경변수를 안전하게 보호
계산 방식, 공식 및 기술 표준
셸 토크나이징은 플래그 쌍(`--flag=val` 및 `--flag val`) 해석 전 상태 머신 기반 따옴표 처리(`'`, `"`, 이스케이프)를 먼저 수행합니다. YAML 출력은 콜론과 셸 특수문자를 일관되게 이스케이프해 유효한 서비스 블록을 생성합니다.
실제 활용 사례
- 공식 문서의 일회성 `docker run` 명령어를 버전 관리가 가능한 `compose.yaml` 스택으로 마이그레이션
- 복잡한 다중 컨테이너 Compose 파일을 CI 러너 실행용 단독 `docker run` 명령어로 역변환
- 복사한 컨테이너 스니펫에 어떤 포트와 호스트 경로가 마운트되는지 빠르게 확인
- 팀원 온보딩을 위한 재현 가능한 로컬 Postgres/Redis Compose 템플릿 작성
입출력 예시 및 엣지 케이스
Redis CLI -> compose.yaml
docker run -d --name cache -p 6379:6379 -v redis_data:/data redis:7-alpine
services:
cache:
image: redis:7-alpine
ports:
- "6379:6379" Automatically infers the Compose service key from `--name` or image name.
Compose -> Standalone CLI
services:
postgres:
image: postgres:16-alpine
ports: ["5432:5432"] docker run -d -p "5432:5432" postgres:16-alpine
Handy when debugging single containers outside Compose.
제한 사항 및 정확도 안내
- • 고급 Compose 키(`deploy.resources`, `depends_on` 헬스체크 조건, 복잡한 YAML 앵커)는 CLI 역변환 시 생략되거나 경고로 표시됩니다.
- • 생성된 YAML 파일을 Git에 커밋하기 전에 `-e` 옵션에 들어있던 민감한 비밀번호가 없는지 꼭 확인하세요.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. Docker Run ↔ Compose YAML 양방향 변환기 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
생성된 `compose.yaml`에 왜 `version:` 키가 빠져 있나요?
Docker Compose v2부터 최상위 `version:` 속성은 지원 중단(Deprecated)되었으며, 최신 Compose 파일은 바로 `services:`로 시작하는 것이 표준입니다.
백슬래시(\)로 줄바꿈된 여러 줄 `docker run` 명령어도 인식되나요?
네. 이스케이프된 줄바꿈과 작은/큰따옴표로 묶인 플래그 인자들은 파싱 전 자동으로 한 줄로 정규화되어 처리됩니다.
여러 개의 서비스가 들어 있는 `compose.yaml`도 CLI로 변환할 수 있나요?
네. `services:` 아래에 정의된 각 서비스마다 빈 줄로 구분된 개별 `docker run` 명령어가 각각 생성됩니다.
사내 비공개 이미지 주소나 환경변수 비밀값이 외부에 기록되나요?
아니요. 모든 변환은 서버 호출 없이 브라우저 JavaScript 내에서 동기적으로 실행됩니다.
관련 마이크로 도구 살펴보기
.env 환경변수 비교(Diff) · 정렬 & 비밀키 제거기 (.env.example)
개발/스테이징/운영 .env 파일을 나란히 비교하고, 알파벳순 정렬하며, 비밀키를 지워 .env.example을 만드세요
YAML · JSON · TOML 3방향 변환기 & 검증기
YAML 1.2, JSON, TOML 1.0 설정 파일을 네트워크 호출 없이 안전하게 상호 변환·검증하세요
스택별 .gitignore 생성기 & 중복 제거기
Node, Astro, Python, Rust, Go, macOS, VS Code, Docker 프리셋을 조합해 중복 없는 깔끔한 .gitignore 생성