Docker Compose에서 .env 파일 사용하기: 주의사항과 설정 변경 방법

소개

Docker Compose를 효과적으로 사용하기 위해서는 .env 파일을 활용하는 것이 좋습니다. 이 글에서는 .env 파일을 작성할 때 주의사항과, 이를 Docker Compose 설정에 적용하는 방법에 대해 알아보겠습니다.

---

env 파일 작성 시 주의사항

• 보안 관리: .env 파일에는 민감한 정보(비밀번호, API 키 등)가 포함될 수 있습니다. 이러한 정보를 저장할 때는 꼭 보안을 고려하여 작성해야 합니다.
• 올바른 형식: .env 파일의 각 행은 "변수=값" 형식을 따라야 합니다. 오타나 잘못된 형식으로 작성하지 않도록 주의해야 합니다.
• 주석 사용: 필요에 따라 주석을 사용하여 각 변수의 역할이나 정보를 설명해 놓으면 이후 유지보수 시 도움이 됩니다.

---

Docker Compose 설정 변경

Docker Compose에서 .env 파일을 사용하려면 몇 가지 설정을 변경해야 합니다.

• 기존 설정:

version: '3'
services:
  web:
    image: nginx
    environment:
      - DATABASE_URL=${DATABASE_URL}

• 변경된 설정:

version: '3'
services:
  web:
    image: nginx
    env_file:
      - .env

위의 설정에서 env_file 항목을 추가하면 Docker Compose가 .env 파일을 읽어서 컨테이너의 환경 변수로 설정합니다.

---

Docker Compose 실행 확인

.env 파일과 Docker Compose 설정을 변경한 후에는 다음과 같이 명령어를 실행하여 변경 사항이 제대로 적용되었는지 확인할 수 있습니다:

docker-compose config

만약 정상적으로 .env 파일이 적용되었다면, 컨테이너에 정의된 환경 변수들이 출력될 것입니다.

---

주의사항 재강조

• Git 무시 설정: .env 파일을 반드시 .gitignore에 추가하여 Git에 업로드되지 않도록 해야 합니다.
• 접근 권한 관리: .env 파일에는 민감한 정보가 담겨있을 수 있으므로 적절한 접근 권한을 설정하여 외부 유출을 방지해야 합니다.

---

마무리

Docker Compose에서 .env 파일을 사용하면 환경 변수 관리가 간편해집니다. 주의사항을 잘 지키고, Docker Compose 설정을 변경하여 .env 파일이 제대로 적용되도록 하면 프로젝트를 효과적으로 관리할 수 있습니다. 설정 변경 후에는 반드시 확인 명령어를 통해 변경이 올바르게 이루어졌는지 확인하는 것이 좋습니다.