File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -167,3 +167,110 @@ src
167167<img width =" 855 " height =" 484 " alt =" screencapture-miricanvas-v2-ko-design2-139b13ea-a2b5-4b45-a015-0ad51e6e0d34-2026-03-17-17_36_17 " src =" https://github.com/user-attachments/assets/db33fbb4-8823-4c77-830d-cb7fc1e871cb " />
168168
169169---
170+ ## 🐳 Docker 실행 방법
171+
172+ 이 프로젝트는 ** MySQL 8.0** 과 ** Redis 7.2** 를 Docker Compose로 실행합니다.
173+ 로컬 개발 환경에서 데이터베이스와 캐시 서버를 쉽게 구성할 수 있습니다.
174+
175+ ---
176+
177+ ## 1️⃣ 환경 변수 설정
178+
179+ 프로젝트 루트에 ` .env ` 파일을 생성하고 아래 내용을 작성합니다.
180+
181+ ``` env
182+ MYSQL_PORT=3306
183+ MYSQL_ROOT_PASSWORD=root
184+ MYSQL_DATABASE=concert
185+ MYSQL_USER=user
186+ MYSQL_PASSWORD=password
187+
188+ REDIS_PORT=6379
189+ ```
190+
191+ ` .env ` 파일은 ` docker-compose.yml ` 에서 사용하는 환경 변수입니다.
192+
193+ ---
194+
195+ ## 2️⃣ Docker 컨테이너 실행
196+
197+ 아래 명령어로 MySQL과 Redis 컨테이너를 실행합니다.
198+
199+ ``` bash
200+ docker compose up -d
201+ ```
202+
203+ 옵션 설명
204+
205+ | 옵션 | 설명 |
206+ | ---| ---|
207+ | up | 컨테이너 실행 |
208+ | -d | 백그라운드 실행 |
209+
210+ ---
211+
212+ ## 3️⃣ 실행 상태 확인
213+
214+ ``` bash
215+ docker ps
216+ ```
217+
218+ 정상적으로 실행되면 다음과 같은 컨테이너가 실행됩니다.
219+
220+ | Container | Service |
221+ | ---| ---|
222+ | concert-mysql | MySQL 8.0 |
223+ | concert-redis | Redis 7.2 |
224+
225+ ---
226+
227+ ## 4️⃣ 로그 확인
228+
229+ 문제가 발생했을 경우 로그를 확인할 수 있습니다.
230+
231+ ``` bash
232+ docker compose logs
233+ ```
234+
235+ 특정 서비스 로그 확인
236+
237+ ``` bash
238+ docker compose logs mysql
239+ docker compose logs redis
240+ ```
241+
242+ ---
243+
244+ ## 5️⃣ 컨테이너 종료
245+
246+ ``` bash
247+ docker compose down
248+ ```
249+
250+ ---
251+
252+ ## 6️⃣ 데이터 유지 (Volume)
253+
254+ MySQL과 Redis 데이터는 Docker Volume에 저장됩니다.
255+
256+ | Volume | 설명 |
257+ | ---| ---|
258+ | mysql-data | MySQL 데이터 저장 |
259+ | redis-data | Redis 데이터 저장 |
260+
261+ 컨테이너를 삭제해도 데이터는 유지됩니다.
262+
263+ ---
264+
265+ ## 7️⃣ 포트 정보
266+
267+ | Service | Port |
268+ | ---| ---|
269+ | MySQL | ` ${MYSQL_PORT}:3306 ` |
270+ | Redis | ` ${REDIS_PORT}:6379 ` |
271+
272+ ---
273+
274+ 💡 ** Tip**
275+
276+ 처음 실행할 때는 Docker 이미지 다운로드로 인해 시간이 조금 걸릴 수 있습니다.
You can’t perform that action at this time.
0 commit comments