diff --git a/README.md b/README.md index ecf5bdfd..5e464ceb 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,7 @@ usecase/ -Dspring.profiles.active=prod -Dserver.port=8081 -Dfile.encoding=UTF-8 +-Dspring.sql.init.mode=never -Djava.net.preferIPv4Stack=true -Dlogging.level.org.springframework.security=DEBUG -Daes.secret-key=092HW829O0A0AVR0 @@ -62,6 +63,7 @@ usecase/ -Dpath.upload.tmpdir=/home/etribe/data/upload/tmp -Djasypt.encryptor.password=ko-research -Djasypt.encryptor.algorithm=PBEWITHHMACSHA512ANDAES_256 + ```` ## πŸ’» 둜컬 ꡬ동 μ‹œ ν•„μˆ˜ μ„€μ • @@ -89,6 +91,72 @@ usecase/ * 운영 DB에 직접 μ ‘κ·Όν•˜μ—¬ κ°œλ°œν•˜μ§€ μ•Šλ„λ‘ μ£Όμ˜κ°€ ν•„μš”ν•©λ‹ˆλ‹€ * `Jasypt`둜 μ•”ν˜Έν™”λœ DB 계정 정보가 μžˆλŠ” 경우, 둜컬 λΉ„λ°€λ²ˆν˜Έ λ³΅ν˜Έν™”λ₯Ό μœ„ν•œ `encryptor.password`κ°€ λ°˜λ“œμ‹œ ν•„μš”ν•©λ‹ˆλ‹€. +-- +λ‹€μŒμ€ `-Dspring.sql.init.mode=always` μ˜΅μ…˜ κ΄€λ ¨ λ‚΄μš©μ„ **μΈμˆ˜μΈκ³„ λ¬Έμ„œ** ν˜•μ‹μœΌλ‘œ μ •λ¦¬ν•œ μ˜ˆμ‹œμž…λ‹ˆλ‹€. 운영 ν™˜κ²½μ—μ„œμ˜ μœ„ν—˜μ„±κΉŒμ§€ κ°•μ‘°ν•΄μ„œ μž‘μ„±ν–ˆμŠ΅λ‹ˆλ‹€. + +--- + +## βš™οΈ 둜컬 DB μ΄ˆκΈ°ν™” 및 `initData` 적용 방법 + +### βœ… +Spring Boot ν”„λ‘œμ νŠΈμ—μ„œλŠ” `initData` SQL 슀크립트λ₯Ό 톡해 둜컬 DB에 초기 데이터λ₯Ό μ‚½μž…ν•  수 μžˆμŠ΅λ‹ˆλ‹€. 이λ₯Ό μœ„ν•΄ **VM μ˜΅μ…˜ 섀정이 λ°˜λ“œμ‹œ ν•„μš”**ν•©λ‹ˆλ‹€. + +--- + +### πŸ› οΈ 적용 방법 + +1. **VM μ˜΅μ…˜ μΆ”κ°€** + + ``` + -Dspring.sql.init.mode=always + ``` + +2. **μ„œλ²„ μž¬κΈ°λ™** + + * μœ„ μ˜΅μ…˜μ„ μ μš©ν•˜κ³  μ„œλ²„λ₯Ό μž¬κΈ°λ™ν•˜λ©΄ λ‹€μŒκ³Ό 같은 λ™μž‘μ΄ μˆ˜ν–‰λ©λ‹ˆλ‹€: + + * **λͺ¨λ“  ν…Œμ΄λΈ” DROP** + * **μŠ€ν‚€λ§ˆ μž¬μƒμ„± (CREATE)** + * **`01.init-data.sql` λ“±μ˜ μ΄ˆκΈ°ν™” SQL μ‹€ν–‰** + +3. **μ΄ˆκΈ°ν™” μ™„λ£Œ ν›„ ν•„μˆ˜ μž‘μ—…β€ΌοΈ** + + ``` + VM μ˜΅μ…˜μ„ λ°˜λ“œμ‹œ μ•„λž˜μ™€ 같이 λ³€κ²½: + -Dspring.sql.init.mode=never + ``` + + * 계속 `always` μƒνƒœλ‘œ 두면, μ„œλ²„ 기동 μ‹œλ§ˆλ‹€ 데이터가 **λͺ¨λ‘ μ‚­μ œλ¨** ⚠️⚠️⚠️ + +--- + +### ⚠️ 운영 ν™˜κ²½ μ£Όμ˜μ‚¬ν•­ + +> πŸ’₯ **운영 μ„œλ²„μ—λŠ” μ ˆλŒ€ `-Dspring.sql.init.mode=always` 섀정을 μ‚¬μš©ν•˜μ§€ λ§ˆμ„Έμš”!!** +> 이 섀정은 λͺ¨λ“  ν…Œμ΄λΈ”κ³Ό 데이터λ₯Ό μ œκ±°ν•˜κ³  λ‹€μ‹œ μƒμ„±ν•˜λ―€λ‘œ, +> 운영 DB에 적용 μ‹œ **치λͺ…적인 데이터 손싀**이 λ°œμƒν•  수 μžˆμŠ΅λ‹ˆλ‹€. + +--- + +### ℹ️ μ˜΅μ…˜ μ„€λͺ… + +| μ˜΅μ…˜κ°’ | μ„€λͺ… | +| -------- | ----------------------------- | +| `never` | SQL μ΄ˆκΈ°ν™” 슀크립트 **μ‹€ν–‰ν•˜μ§€ μ•ŠμŒ** (κΈ°λ³Έ) | +| `always` | SQL μ΄ˆκΈ°ν™” 슀크립트 **항상 싀행함** | + +--- + +### πŸ“ μ΄ˆκΈ°ν™” 슀크립트 μœ„μΉ˜ μ˜ˆμ‹œ + +* `core/src/main/resources/sql/schema/02_create-table.sql` (DDL) +* `core/src/main/resources/sql/schema/02_create-function.sql` (DDL) +* `core/src/main/resources/sql/schema/02_create-view.sql` (DDL) +* `core/src/main/resources/sql/data/01_init_data.sql` (DML) + +--- + + --- ## πŸ” Jasypt μ•”ν˜Έν™”