Go Academy · 강의

로컬 개발을 위한 Docker Compose

Go 서비스와 PostgreSQL 및 Redis 연결

로컬 개발을 위한 Docker Compose은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Docker Compose를 사용하는 이유

Docker Compose는 여러 컨테이너(앱, 데이터베이스, 캐시, 메시지 브로커)를 조정하여, 서비스를 수동으로 설정하지 않고도 로컬 개발에서 운영 환경과 유사한 환경을 재현합니다.

docker-compose.yml 구조

YAML 파일에 서비스, 네트워크, 볼륨을 정의합니다:

services:
  app:
    build: .
    ports: ["8080:8080"]
    environment:
      - DATABASE_URL=postgres://app:pass@db/mydb
    depends_on: [db]
  db:
    image: postgres:15
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

Air를 사용한 실시간 다시 불러오기

개발 중 실시간으로 코드를 다시 불러오려면 github.com/air-verse/air를 사용하십시오. 소스를 컨테이너에 마운트하고 바이너리 대신 air를 실행합니다:

app:
  volumes:
    - .:/app
  command: air

상태 점검

상태 점검을 정의하여 depends_on이 단순히 시작된 상태가 아니라 데이터베이스가 실제로 준비될 때까지 기다리도록 하십시오:

db:
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U app"]
    interval: 5s
    timeout: 3s
    retries: 5
app:
  depends_on:
    db:
      condition: service_healthy

환경별 재정의

로컬 전용 설정에는 docker-compose.override.yml(자동으로 병합됨)을 사용하고, CI에서 사용할 기본 파일은 깔끔하게 유지하십시오:

# docker-compose.override.yml
services:
  app:
    volumes: [".:/app"]  # source mount for live reload

이름 있는 네트워크

서비스 이름을 사용한 DNS 기반 서비스 검색을 위해 서비스를 공유 사용자 지정 네트워크에 배치하십시오:

networks:
  backend:
    driver: bridge
services:
  app:
    networks: [backend]
  db:
    networks: [backend]

환경 파일

env_file 키를 사용하여 .env 파일을 컨테이너에 불러오고, YAML에서 비밀 정보를 분리하십시오:

app:
  env_file: .env.local

명령 실행

일반적인 Compose 명령:

docker compose up -d      # start in background
docker compose down -v    # stop and remove volumes
docker compose logs -f app # stream app logs
docker compose exec db psql -U app mydb # run in container

데이터베이스 초기 데이터 삽입

postgres 이미지의 /docker-entrypoint-initdb.d 디렉터리에 SQL 초기 데이터 파일을 마운트하십시오. 이 파일은 컨테이너를 처음 만들 때 실행됩니다:

db:
  volumes:
    - ./migrations:/docker-entrypoint-initdb.d

프로필

필요할 때만 선택적 서비스(예: 모니터링 스택)를 시작하려면 Compose 프로필을 사용하십시오:

services:
  grafana:
    profiles: ["monitoring"]

CI에서 Compose 사용

Compose를 사용하여 CI에서 실제 서비스를 대상으로 통합 테스트를 실행하십시오. GitHub Actions는 Docker Compose를 기본적으로 지원하므로, 서비스가 준비될 때까지 기다리려면 상태 점검을 사용하십시오.

빠른 확인

Docker Compose에서 앱 컨테이너가 데이터베이스가 준비될 때까지 기다리도록 하려면 어떻게 해야 합니까?

요약: Docker Compose

핵심 사항:

docker-compose.yml은 모든 서비스, 네트워크, 볼륨을 정의합니다
서비스 준비 상태를 확인하려면 depends_on과 healthcheck를 함께 사용합니다
로컬 개발 설정에는 재정의 파일을, 비밀 정보에는 env_file을 사용합니다
실시간 다시 불러오기에는 Air를 사용하고 소스를 볼륨으로 마운트합니다

자주 묻는 질문

“로컬 개발을 위한 Docker Compose” 강의는 무료인가요?

네 — “로컬 개발을 위한 Docker Compose” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“로컬 개발을 위한 Docker Compose”에서 뭘 배우나요?

Go 서비스와 PostgreSQL 및 Redis 연결 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“로컬 개발을 위한 Docker Compose” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기