๋ชฉ์ฐจ (7)
- [๋ธ๋ก๊ทธ ์๊ฐ] ๋ฌด์ค๋จ ๋ฐฐํฌ์์ DBยท๋ฐฑ์๋ยทํ๋ก ํธยท์ฑ ํธํ์ฑ
- 1. ๊ณต์ DB โ Blue/Green ๋ฐฑ์๋: Expand & Contract
- ์ฌ๋ก. ๊ฒ์๊ธ ํ ์ด๋ธ โ ๋ค๊ตญ์ด ํ ์ด๋ธ ์ ํ (Expand + Dual-Write)
- 2. ๋ฐฑ์๋ โ ์น ํ๋ก ํธ์๋: ํ์ ํธํ + ๋ฐฐํฌ ์์ + ํต์ฌ ํด๋ฐฑ
- 3. ์ฝ๋ ๋ฐฐํฌ์ ๊ธฐ๋ฅ ๊ฐ๋ฐฉ ๋ถ๋ฆฌ: ๊ธฐ๋ณธ๊ฐ OFF ํผ์ฒ ํ๋๊ทธ
- 4. ์น ํ๋ก ํธ โ ๋ชจ๋ฐ์ผ ์ฑ: ๊ฐ์ฅ ๊ธด ๊ณต์กด ๊ตฌ๊ฐ ๋ค๋ฃจ๊ธฐ
- ์ ๋ฆฌ: ๋ค ๊ณ์ธต์ ํธํ์ฑ ๊ธฐ์ค
[๋ธ๋ก๊ทธ ์๊ฐ] ๋ฌด์ค๋จ ๋ฐฐํฌ์์ DBยท๋ฐฑ์๋ยทํ๋ก ํธยท์ฑ ํธํ์ฑ
์ด์ ๊ธ์์๋ blue์ green ์ปจํ
์ด๋๋ฅผ ๋ฒ๊ฐ์ ๋์ ๋ฐฑ์๋ ๋ฐฐํฌ ์ค 502 ์๋ฌ๋ฅผ ์์ด์ด์.
๊ทธ๋ฐ๋ฐ ์ดํ ๊ธฐ๋ฅ์ ์ถ๊ฐ ๋ฐ ์์ ํ๋ค ๋ณด๋, ์๋ก ๋ค๋ฅธ ๋ฒ์ ์ด ์ ๊น ๊ณต์กดํ๋ ์๊ฐ์ด ๋ฌธ์ ์์ด์. ์ด ๋ธ๋ก๊ทธ๋ DB ยท ๋ฐฑ์๋(GCP Blue/Green) ยท ์น ํ๋ก ํธ ยท ๋ชจ๋ฐ์ผ ์ฑ์ด ๊ฐ์ ๋ค๋ฅธ ์์ ์ ๋ฐฐํฌ๋๊ฑฐ๋ ์.
green์ด DB ์คํค๋ง๋ฅผ ๋ฐ๊พธ๋ ๋์ ์์ง ๋ ์๋blue๊ฐ ๊นจ์ง์ง ์์ผ๋ ค๋ฉด?ํ๋ก ํธ์ ๋ฐฑ์๋๋ ๋ฐฐํฌ ํ์ด๋ฐ์ด ๋๊ฐ์ด ๋ง์ง ์๋๋ฐ, ๊ตฌํ ํ๋ก ํธ์ ์ ๊ท ๋ฐฑ์๋(๋๋ ๊ทธ ๋ฐ๋)๊ฐ ๋ง๋๋ฉด?
์ฑ ์คํ ์ด ์ ๋ฐ์ดํธ๋ฅผ ์ ํ ๊ตฌ๋ฒ์ ์ฑ ์ฌ์ฉ์๊ฐ ์๋ก ๋ฐฐํฌ๋ ์น ํ๋ฉด์ ๋ค์ด์ค๋ฉด?
์ด๋ฒ ๊ธ์์๋ ์ด๋๊น์ง ์ฝ๋๋ก ํธํ์ฑ์ ๋ณด์ฅํ๊ณ , ์ด๋๋ ๋ฐฐํฌ ์์๋ก ํ์๋์ง ์ ๋ฆฌํ๋ คํด์.
1. ๊ณต์ DB โ Blue/Green ๋ฐฑ์๋: Expand & Contract
๋ฐฑ์๋์๋ ์คํค๋ง ๋ฒ์ ๋์ ์ํด Flyway๋ฅผ ๋ถ์ฌ ๋ฌ์, ์ ์ปจํ
์ด๋(green)๊ฐ ๋ฐ ๋ ๋ง์ด๊ทธ๋ ์ด์
์ด ์๋ ์คํ๋ผ์. ๋ฌธ์ ๋ DB๋ ํ๋๋ฟ์ธ๋ฐ green์ด ํธ๋ํฝ์ ๋ฐ๊ธฐ๋ ์ ์ DB๋ฅผ ๋จผ์ ๋ฐ๊พผ๋ค๋ ์ ์ด์์.
sequenceDiagram
autonumber
participant User as "Visitor"
participant Caddy as "Caddy"
participant Blue as "Blue (Old)"
participant Green as "Green (New)"
participant DB as "Cloud SQL (Shared)"
%% 1. ๋ฐฐํฌ ์ ์ ์ ์ฌ์ดํด
User->>Caddy: ์ค์๊ฐ ์์ฒญ
Caddy->>Blue: ์์ฒญ ์ ๋ฌ
Blue->>DB: ๊ธฐ์กด ๋ฐฉ์๋๋ก ์ฝ๊ธฐ/์ฐ๊ธฐ
DB-->>Blue: ๊ฒฐ๊ณผ ๋ฐํ
Blue-->>Caddy: ์๋ต ๋ฐํ
Caddy-->>User: ์๋ต ์๋ฃ
%% 2. Green ๊ธฐ๋ ๋ฐ DB ์คํค๋ง ๋ณ๊ฒฝ
Green->>DB: ๊ธฐ๋ ์ ๋ง์ด๊ทธ๋ ์ด์
์คํ (DB ๋ณ๊ฒฝ)
%% 3. ๊ณผ๋๊ธฐ ์ฌ์ดํด (Blue๊ฐ ๋๊น์ง ์ฒ๋ฆฌ)
Note over Blue,DB: Green ํฌ์ค์ฒดํฌ ๋๊ธฐ(~25์ด, ์คํจ ์ ์๊ตฌ) ๋์<br/>Blue๋ ๋ฐ๋ DB ์์์ ๊ณ์ ๋์ํด์ผ ํจ
User->>Caddy: ์ค์๊ฐ ์์ฒญ (์ ํ ์ )
Caddy->>Blue: ์์ฒญ ์ ๋ฌ
Blue->>DB: ๊ธฐ์กด ์ฟผ๋ฆฌ ์คํ (ํ์ ํธํ ํ์!)
DB-->>Blue: ์ ์ ๊ฒฐ๊ณผ ๋ฐํ
Blue-->>Caddy: ์๋ต ๋ฐํ
Caddy-->>User: ์๋ต ์๋ฃ (Blue๊ฐ ๋๊น์ง ์ฒ๋ฆฌ)
%% 4. ํฌ์ค์ฒดํฌ ํต๊ณผ ๋ฐ ํธ๋ํฝ ์ ํ
Green-->>Caddy: Healthcheck 200
Note over Caddy,Green: ๋ผ์ฐํ
๋์ ์ ํ (Blue โ Green)
%% 5. ์ ํ ํ ์ ์์ฒญ ์ฌ์ดํด (Green์ด ์ฒ๋ฆฌ)
User->>Caddy: ์๋ก์ด ์ค์๊ฐ ์์ฒญ (์ ํ ํ)
Caddy->>Green: ์์ฒญ ์ ๋ฌ
Green->>DB: ์ ์ฟผ๋ฆฌ ์คํ
DB-->>Green: ๊ฒฐ๊ณผ ๋ฐํ
Green-->>Caddy: ์๋ต ๋ฐํ
Caddy-->>User: ์๋ต ์๋ฃ
%% 6. ๊ตฌ๋ฒ์ ์ข
๋ฃ
Caddy--xBlue: ์ข
๋ฃBlue/Green ๋ฐฐํฌ ์ค ๊ณต์ DB๊ฐ ๋จผ์ ๋ฐ๋๋ ๊ตฌ๊ฐ
green์ด ํฌ์ค์ฒดํฌ๋ฅผ ํต๊ณผํ ๋๊น์ง (๊ทธ๋ฆฌ๊ณ green์ด ๋ถํ
์ ์คํจํด ๋ฐฐํฌ๊ฐ ์ทจ์๋๋ฉด ๊ทธ ์ดํ์๋ ๊ณ์), blue๋ ๋ฐ๋ DB ์์์ ๊ธฐ์กด ๋ฐฉ์๋๋ก ๋ฐ์ดํฐ๋ฅผ ์ฝ๊ณ ์์์ผ ํด์.
๊ทธ๋์ DB ๊ตฌ์กฐ๋ฅผ ๋ฐ๊ฟ ๋๋ ํ ๋ฒ์ ๊ฐ์์์ง ์๊ณ Expand & Contract(ํ์ฅ-์ถ์) ์์๋ก ๋ฐฐํฌ๋ฅผ ๋๋ ์. ๊ธฐ์กด ์๋ฒ๊ฐ ์์ ํ ๋ด๋ ค๊ฐ๊ธฐ ์ ์๋ ์ ์คํค๋ง๋ฅผ ์ง์ฐ๊ฑฐ๋ ์ด๋ฆ์ ๋ฐ๊พธ์ง ์๋ ์์น์ด์์.
flowchart LR
S1["1. Expand (์ ์คํค๋ง ์ถ๊ฐ)"] --> S2["2. Dual-Write & Backfill (์์ชฝ ๊ธฐ๋ก)"]
S2 --> S3["3. Switch (๊ตฌ๋ฒ์ ์์ ์ข
๋ฃ)"]
S3 --> S4["4. Contract (๋ค์ ๋ฐฐํฌ์์ ๊ตฌ ์คํค๋ง ์ ๋ฆฌ)"]Expand & Contract ๋ฌด์ค๋จ ์คํค๋ง ์ ํ
์ฌ๋ก. ๊ฒ์๊ธ ํ ์ด๋ธ โ ๋ค๊ตญ์ด ํ ์ด๋ธ ์ ํ (Expand + Dual-Write)
์๋ ๊ธ ์ ๋ชฉยท๋ณธ๋ฌธยท์์ฝ์ ์ ๋ถ article_mst์ ์์๋๋ฐ, 4๊ฐ ๊ตญ์ด๋ฅผ ์ง์ํ๋ ค๋ฉด article_translation ํ
์ด๋ธ๋ก ์ฎ๊ฒจ์ผ ํ์ด์. ๋ง์ฝ ๊ธฐ์กด ์ปฌ๋ผ์ ๋ฐ๋ก ์ง์ฐ๊ณ ์ฎ๊ฒผ๋ค๋ฉด ๋ฐฐํฌ ์๊ฐ blue ์ฟผ๋ฆฌ๊ฐ ์ฆ์ ๊นจ์ง๊ณ ๋กค๋ฐฑ๋ ๋ถ๊ฐ๋ฅํ์ ๊ฑฐ์์.
๊ทธ๋์ ํธํ์ฑ์ ์ํด์ ๋ ๊ฐ์ง ์ฒ๋ฆฌ๋ฅผ ํด์คฌ์ด์.
Expand + Backfill (
V2):article_mst์ ๊ธฐ์กด ์ปฌ๋ผ์ ๊ทธ๋๋ก ๋๊ณarticle_translation๋ง ์๋ก ๋ง๋ ๋ค, ๊ธฐ์กด ํ๊ตญ์ด ๊ธ์ON CONFLICT DO NOTHING์ผ๋ก ๋ฉฑ๋ฑ ๋ฐฑํํ์ด์.Dual-Write (
ArticleService): ์ ์๋ฒ(green)๋ ๊ธ์ ์์ฑยท์์ ยท๊ณต๊ฐํ ๋article_mst์article_translation(ko)์์ชฝ์ ๋์์ ๊ธฐ๋กํด์.
// ์ ์๋ฒ(green)๊ฐ ๋์ด์ง๋ ๋์ ๊ตฌ ํ
์ด๋ธ๊ณผ ์ ํ
์ด๋ธ ์์ชฝ์ ํจ๊ป ๊ธฐ๋กํ๋คArticle saved = articleRepository.save(article); // ๊ธฐ์กด article_mstarticleTranslationRepository.save(buildKoTranslation(saved, published)); // ์ article_translation๋๋ถ์ ์ ํ ์ค blue๋ ์ ํ
์ด๋ธ์ ์์ ๋ชจ๋ฅธ ์ฑ ๊ธฐ์กด ๋ฐฉ์๋๋ก ์ผํ๊ณ , green์ ๋ฒ๊ทธ๊ฐ ์๊ฒจ blue๋ก ๋๋๋ ค๋ ๊ทธ์ฌ์ด ์ด ๊ธ์ด article_mst์ ๊ฐ์ด ๋จ์ ์์ด ๋ฐ์ดํฐ ์ ์ค ์์ด ๋กค๋ฐฑํ ์ ์์ด์. ํ๋ก ํธ ์ ํ์ด ์์ ํ ๋๋ ๋ค ๋ค์ ๋ฐฐํฌ์์ ๊ตฌ ์ปฌ๋ผ์ ์ ๋ฆฌ(Contract)ํ๋ฉด ๋ผ์.
2. ๋ฐฑ์๋ โ ์น ํ๋ก ํธ์๋: ํ์ ํธํ + ๋ฐฐํฌ ์์ + ํต์ฌ ํด๋ฐฑ
๋ฐฑ์๋์ ํ๋ก ํธ๋ ์๋ก ๋ค๋ฅธ ์ ์ฅ์ยทํ์ดํ๋ผ์ธ์ผ๋ก ๋ฐฐํฌ๋๊ธฐ ๋๋ฌธ์ ์ ํํ ํ์ด๋ฐ์ ๊ฐ์ด ๋ฐฐํฌ๋์ง ์์์. ๊ทธ๋์ ์๊ธธ ์ ์๋ ๋ฌธ์ ๋ 2๊ฐ์ง์์
๊ตฌํ ํ๋ก ํธ -> ์ ๊ท ๋ฐฑ์๋ ์ฐธ์กฐ
์ ํ ํ๋ก ํธ -> ๊ตฌํ ๋ฐฑ์๋ ์ฐธ์กฐ
๊ทธ๋์ ๊ฐ๊ฐ์ ๋ฌธ์ ๊ฐ ๋ฐ์ํ์ง ์๋๋ก ์ ๋ต์ ์ธ์ ์ด์.
๋ฐฑ์๋๋ ํญ์ ๊ตฌํ ํ๋ก ํธ์ ํ์ ํธํ๋๊ฒ ๋ง๋ญ๋๋ค.
๋ค๊ตญ์ด
?lang=ํ๋ผ๋ฏธํฐ๋ ์ ๋ถrequired = false(์ ๋ณด๋ด๋ฉด ๊ธฐ์กด์ฒ๋ผko์๋ต)์๋ต DTO์ ๊ธฐ์กด ํ๋๋ ์ ์งํ๊ณ ์ ํ๋๋ง ์ถ๊ฐ
ํธ์ ์๋ฆผยท์นดํ ๊ณ ๋ฆฌ ์ด๋ฆ ๋ณ๊ฒฝยท๋ฒ์ญ ๊ด๋ฆฌ๋ ๋ชจ๋ ์ ๊ท ์๋ํฌ์ธํธ๋ก ๋ถ๋ฆฌ
๋ชจ๋ ์ API๋ฅผ ์๋ฐฉํฅ ํด๋ฐฑํ๊ธฐ์ ๋น์ฉ์ด ์ปค์ ๊ธฐ๋ณธ ์์น์ ๋ฐฑ์๋ ์ ๋ฐฐํฌ โ ํ๋ก ํธ ํ๋ฐฐํฌ์ ๋๋ค.
์ ๋์ ๋ต์ด ๊ฐ์ฅ ์ฝ๋๋ฅผ ๋ณต์กํ๊ฒ ๋ง๋ค์ง ์๋ ๋ฐฉ๋ฒ์ด๋ผ ์๊ฐํ์ด์. ๋ฌผ๋ก ์ฌ์ฉ์๊ฐ ๊ฑฐ์ ์๋ ๋ธ๋ก๊ทธ ์๋น์ค๋ผ์ ์ฌ์ค์ ์ ๊น ์ ๊ฒ์๊ฐ์ ๋๊ณ ์ฒ๋ฆฌํ๋๊ฒ ๊ฐ์ฅ ๊น๋ํ ๊ฑฐ์์!! ์ฌ์ง์ด๋ ์ ๋ฐฉ๋ฒ์ด ํญ์ 100% ๋ฌด์ค๋จ์ผ๋ก ์ด์๋๊ฒ ๋จนํ๊ฑฐ๋ผ ์๊ฐํ์ง๋ ์์์. ํ์ง๋ง ๊ฐ์ธ ๋ธ๋ก๊ทธ์ด๊ธฐ ๋๋ฌธ์ ๋ง์ํธํ ๋์ ํด๋ณผ ์ ์๊ธฐ ๋๋ฌธ์ ๋์ ํ์ด์.
3. ์ฝ๋ ๋ฐฐํฌ์ ๊ธฐ๋ฅ ๊ฐ๋ฐฉ ๋ถ๋ฆฌ: ๊ธฐ๋ณธ๊ฐ OFF ํผ์ฒ ํ๋๊ทธ
์ธ๋ถ API ํค๋ ์ ์ธํ๋ผ๊ฐ ํ์ํ ๊ธฐ๋ฅ์ ์ฝ๋ ๋ฐฐํฌ ์์ ๊ณผ ๊ธฐ๋ฅ์ ์ผ๋ ์์ ์ ์์ ๋ถ๋ฆฌํ์ด์.
์ค์์น๊ฐ ๊ธฐ๋ณธ false๋ฉด ์คํค๋ง์ ์ฝ๋๋ฅผ ๋จผ์ ์์ ํ๊ฒ ๋ฐฐํฌํ ์ ์์ด์. ๊ทธ๋ฆฌ๊ณ ํ๋ก ํธ์ ๋ฐฑ์๋ ๋ชจ๋ ์์ ํ ๋ฐฐํฌ๋๋ฉด ๊ทธ ๋ ๊ธฐ๋ฅ์ ์ผ์.
4. ์น ํ๋ก ํธ โ ๋ชจ๋ฐ์ผ ์ฑ: ๊ฐ์ฅ ๊ธด ๊ณต์กด ๊ตฌ๊ฐ ๋ค๋ฃจ๊ธฐ
๋ฐฑ์๋์ ์น ํ๋ก ํธ๋ ๋ฐฐํฌ ์ฐจ์ด๊ฐ ๊ธธ์ด์ผ ๋ช ๋ถ์ด์ง๋ง, ๋ชจ๋ฐ์ผ ์ฑ์ ์คํ ์ด ์ฌ์ฌ์ ์ฌ์ฉ์ ์ ๋ฐ์ดํธ ์ง์ฐ ๋๋ฌธ์ ๊ตฌ๋ฒ์ ๊ณผ ์ ๋ฒ์ ์ด ๋ช ์ฃผ์ฉ ๊ณต์กดํ ์ ์๋ค๋ ๊ฒ์ ์์์ด์. (์ ๋ ์ฑ์ ์ค๋ซ๋์ ์ ๋ฐ์ดํธ ์ํ์ ์ด ์์ด์...)
์ด ๋ฌธ์ ์ ๋ํด ์๊ฐํ๋ ์ํฉ์, ํธ์ ์๋ฆผ์ ๋ถ์ผ ๋ WebView ์ฑ์ ๋ค์ดํฐ๋ธ์์ FCM ํ ํฐ์ ๋ฐ์ ์น์ผ๋ก ๋๊ฒจ์ฃผ๋ ๋ธ๋ฆฌ์ง๊ฐ ํ์ํ๋ฐ, ์ ๋ฐ์ดํธ๋ฅผ ์ ํ ๊ตฌ๋ฒ์ ์ฑ์๋ ๊ทธ ๋ธ๋ฆฌ์ง๊ฐ ์์ด์.
WebView๊ฐ ํ์ด์ง๋ฅผ ๋ก๋ํ๊ธฐ ์ ์ window.__carrotAppPush = {version: 1, platform}์ ์ฌ์ด ์ค๋๋ค. ์น์ ์ด ๊ฐ์ฒด๋ฅผ ๋ณด๊ณ ์ฑ ํธ์ ๋ธ๋ฆฌ์ง๋ก ํ ํฐ์ ์์ฒญํฉ๋๋ค.
window.ReactNativeWebView๋ ์์ง๋ง window.__carrotAppPush๊ฐ ์์ต๋๋ค. ์น์ ์ด ์ํ๋ฅผ ๊ฐ์งํด ์ค๋ฅ ๋์ "์ฑ ์
๋ฐ์ดํธ ํ์" ์๋ด ํ๋ฉด์ผ๋ก ์์ ํ๊ฒ ๋ถ๊ธฐํฉ๋๋ค.
๊ทธ๋์ App์ด ์๋๋ผ Web์์ window์ ๋ฑ๋ก๋ ๋ณ์๋ฅผ ํตํด ํด๊ฒฐํ ์ ์๋๋ก ํ์ด์. ์น์์ ์ฑ์ Webview๋ฅผ ํตํด์ ๋ก๋๋ ๊ฒ์ธ์ง ํ์ธํ๋ ๋ฐฉ์์ผ๋ก ์ ๋ฐ์ดํธ๋ฅผ ์ ๋ํ๋๋ก ํด๊ฒฐํ๊ฑฐ์์.
์ ๋ฆฌ: ๋ค ๊ณ์ธต์ ํธํ์ฑ ๊ธฐ์ค
๊ฒฝ๊ณ | ๊ณต์กด ์๊ฐ | ํด๊ฒฐ ๋ฐฉ์ |
|---|---|---|
DB โ Blue/Green ๋ฐฑ์๋ | ~25์ด (์คํจ ์ ์๊ตฌ) | Expand & Contract, Dual-Write, |
๋ฐฑ์๋ โ ์น ํ๋ก ํธ | ๋ช ๋ถ | ๋ฐฑ์๋ ํ์ ํธํ(optional ํ๋ผ๋ฏธํฐยท๊ธฐ์กด ํ๋ ์ ์ง) + ๋ฐฑ์๋ ์ ๋ฐฐํฌ |
์ฝ๋ ๋ฐฐํฌ โ ๊ธฐ๋ฅ ๊ฐ๋ฐฉ | ์ค์ ์๋ฃ๊น์ง | ํผ์ฒ ํ๋๊ทธ ๊ธฐ๋ณธ๊ฐ |
์น ํ๋ก ํธ โ ๋ชจ๋ฐ์ผ ์ฑ | ์์ผ ~ ์์ฃผ ํน์ ๊ทธ์ด์ |
|
์ด์ ๊ธ์ด Caddy Blue/Green์ด ํธ๋ํฝ ์ ํ์ ํตํด ๋ฌด์ค๋จ ๋ฐฐํฌ๋ฅผ ๊ตฌํํ ๊ฒ์ด๋ผ๋ฉด, ์ด๋ฒ์๋ ๋ฌด์ค๋จ ๋ฐฐํฌ์์ ์ค์ ๋ก ์๋น์ค๊ฐ์ DBยท๋ฐฑ์๋ยทํ๋ก ํธยท์ฑ์ ๊ฐ์ ๋ฐ๋ก ๋ฐฐํฌํด๋ ๊นจ์ง์ง ์๊ฒ ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ด์์. ๋ฌด์ค๋จ ๋ฐฐํฌ์ ๋ชฉ์ ์ด ๊ธฐ์กด ์๋น์ค๊ฐ ๋๊น์์ด ์ด์๋๋ ๊ฒ์ธ๋ฐ, ์ค์ ๋ก๋ ๋ฒ์ ๊ฐ ์ ํฉ์ฑ์ด ์๋ง์ผ๋ฉด ๋๊ธธ ์ ๋ฐ์ ์์์์?
์ด๋ฒ์๋ ์ฒ์์ผ๋ก ๊ณ์ธต๋ณ๋ก ๋๋ ์ ๋ฒ์ ์ด ๋ฌ๋ผ์ ธ๋ ํธํ๋๋๋ก ๋ง๋ค์ด๋ดค์ด์. ์ฝ๋๋ฅผ ์งค ๋ ์ด๋ค์์ผ๋ก ํธํ์ฑ์ ์๊ฐํด์ผํ ์ง ๋ง์ ๊นจ๋ฌ์์ ์คฌ์ด์.
