Compose 파일 작성
서비스, 네트워크 및 볼륨을 정의하는 YAML 구문을 학습합니다.
Compose 파일 작성은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
Compose 파일: 설계도
Docker Compose 파일 작성 과정에 오신 것을 환영합니다! docker-compose.yml 파일은 다중 컨테이너 Docker 애플리케이션을 정의하고 실행하기 위한 설계도입니다.
YAML 구문을 사용하여 하나의 파일에서 애플리케이션의 서비스, 네트워크, 볼륨을 구성합니다.

YAML: 빠른 복습
Docker Compose 파일은 YAML(YAML Ain't Markup Language)로 작성합니다. YAML은 사람이 읽기 쉬운 데이터 직렬화 표준입니다.
- 키-값 쌍:
key: value - 목록: 항목은 하이픈(
- item)으로 시작합니다. - 들여쓰기: 구조와 계층을 정의하는 데 중요합니다. 탭이 아니라 공백을 사용하세요!
`version` 키
모든 docker-compose.yml 파일은 version 키로 시작합니다. 이 키는 Compose 파일 형식의 버전을 지정하여 Docker Compose가 파일을 해석하는 방법을 결정하는 데 도움을 줍니다.
대부분의 최신 애플리케이션에는 '3.8' 또는 이와 유사한 '3.x' 버전을 사용하는 것이 좋습니다.
version: '3.8'`services` 정의하기
services 섹션에서는 애플리케이션을 구성하는 개별 컨테이너(서비스)를 정의합니다. 각 서비스는 웹 서버나 데이터베이스 같은 구성 요소를 나타냅니다.
services 아래에 원하는 이름으로 각 서비스를 나열합니다.
version: '3.8'
services:
web:
# Service configuration goes here
database:
# Another service's configuration서비스의 `image`와 `ports`
서비스 정의 내부에서 image는 사용할 Docker 이미지를 지정합니다(예: nginx:latest). ports 키는 컨테이너 포트를 호스트 포트에 연결하여 외부에서 액세스할 수 있게 합니다.
"80:80"은 호스트의 80번 포트를 컨테이너의 80번 포트에 연결합니다.
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "80:80"서비스의 `volumes`
서비스 내부의 volumes 키를 사용하면 호스트 컴퓨터의 경로를 컨테이너에 마운트하거나, 지속적인 저장을 위해 이름이 있는 볼륨을 사용할 수 있습니다.
이 예에서는 로컬 디렉터리 ./app을 컨테이너 내부의 /usr/src/app에 마운트합니다.
version: '3.8'
services:
app:
image: my-node-app
volumes:
- ./app:/usr/src/app서비스 `environment` 변수
environment 키를 사용하면 서비스의 컨테이너에 환경 변수를 전달할 수 있습니다. 이는 환경에 따라 달라질 수 있는 설정(예: 데이터베이스 연결 문자열)에 매우 중요합니다.
변수는 키-값 쌍으로 나열하거나 목록 형식으로 작성할 수 있습니다.
version: '3.8'
services:
backend:
image: my-api
environment:
- DATABASE_URL=postgres://user:pass@host:5432/db
- NODE_ENV=development최상위 `networks` 및 `volumes`
서비스 내부에서 정의하는 것 외에도 docker-compose.yml 파일의 최상위 수준에서 사용자 지정 이름 있는 볼륨과 네트워크를 선언할 수 있습니다.
이렇게 하면 데이터 지속성과 컨테이너 간 통신을 위한 정의를 더욱 체계적이고 재사용 가능하게 관리할 수 있습니다.
version: '3.8'
services:
# ... service definitions ...
networks:
my_app_network:
# custom network configuration
volumes:
db_data:
# named volume configuration모든 내용 하나로 합치기
지금까지 배운 내용을 결합한 간단한 예를 살펴보겠습니다. 이 예에서는 이미지, 포트, 이름 있는 볼륨을 사용하여 웹 서비스와 데이터베이스 서비스를 정의합니다.
들여쓰기가 구조를 만드는 방식을 확인해 보세요.
version: '3.8'
services:
web:
image: nginx:latest
ports:
- "80:80"
volumes:
- web_content:/usr/share/nginx/html
db:
image: postgres:13
environment:
- POSTGRES_DB=mydb
- POSTGRES_USER=user
- POSTGRES_PASSWORD=secret
volumes:
web_content:
db_data:컴포즈 파일 확인
다음 YAML 코드 조각 중 'api'라는 이름의 Docker Compose 서비스를 올바르게 정의하고, 'myapi:1.0' 이미지를 사용하며, 컨테이너 포트 3000을 호스트 포트 8080에 공개하는 것은 무엇인가요?
복습: 컴포즈 파일의 핵심
잘하셨습니다! 이제 docker-compose.yml 파일 작성의 기본을 익혔습니다.
version으로 시작합니다.services에서 애플리케이션 구성 요소를 정의합니다.- 각 서비스는
image를 사용하고,ports를 공개할 수 있으며, 지속성을 위해volumes를 사용하고environment변수를 설정할 수 있습니다. - 최상위 수준의
networks와volumes를 사용하면 고급 설정이 가능합니다.
이 YAML 구조를 익히는 것은 여러 컨테이너로 구성된 앱을 오케스트레이션하는 데 핵심입니다!
자주 묻는 질문
“Compose 파일 작성” 강의는 무료인가요?
네 — “Compose 파일 작성” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
“Compose 파일 작성”에서 뭘 배우나요?
서비스, 네트워크 및 볼륨을 정의하는 YAML 구문을 학습합니다. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“Compose 파일 작성” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Docker Compose란 무엇인가요?
- Compose 파일 작성
- 다중 서비스 앱 배포
- 환경 변수와 .env 파일