[Sprint Mission5]
1. ํ๋ก์ ํธ ๋ง์ผ์คํค
- RESTful API๋ก ์ฌ์ค๊ณ ๋ฐ ๋ฆฌํฉํ ๋ง
- Swagger๋ฅผ ํ์ฉํ API ๋ฌธ์ ์๋ํ
- ํ๋ก ํธ์๋ ์ฐ๋
- PaaS๋ฅผ ํ์ฉํ ๋ฐฐํฌ
2. ์ฃผ์ ๋ณ๊ฒฝ ์ฌํญ
2-1. Google Java Style Guide๊ฐ ์ ์ฉ ๋์์ต๋๋ค.
- IntelliJ ์ ์ฉ ๋ฐฉ๋ฒ
- Google์์ ์ ๊ณตํ๋ IntelliJ ์ ์ฉ ํ์ผ์ ๋ค์ด๋ก๋ํฉ๋๋ค.
IntelliJ ์ค์ > Editor > Code Style๋ฉ๋ด์์ ๋ค์ด๋ก๋ํ xml ํ์ผ์ ์ํฌํธํฉ๋๋ค.
- ํ์ผ์ด ์์ ๋ ๋๋ง๋ค ์คํ์ผ์ด ์๋์ผ๋ก ์ ์ฉ๋ ์ ์๋๋ก ์ค์ ํฉ๋๋ค.

3. ๊ธฐ๋ณธ ์๊ตฌ์ฌํญ
- ์คํ๋ฆฐํธ ๋ฏธ์
#4์์ ๊ตฌํํ API๋ฅผ RESTful API๋ก ๋ค์ ์ค๊ณํด๋ณด์ธ์.
- API ์คํ์ ํ์ธํ๊ณ ๋ณธ์ธ์ด ์ค๊ณํ API์ ๋น๊ตํด๋ณด์ธ์.
- oasdiff๋ฅผ ํ์ฉํ๋ฉด ์ข ๋ ์์ํ๊ฒ ๋น๊ตํ ์ ์์ด์.
- API ์ค๊ณ์ ์ ๋ต์ ์์ง๋ง, ์ด์ด์ง๋ ์๊ตฌ์ฌํญ๊ณผ ๋ฏธ์ ์ ์ํํ ์ํํ๊ธฐ ์ํด ์ ๊ณต๋ API ์คํ์ ๋ง์ถ์ด ๊ตฌํํด์ฃผ์ธ์.
- ํนํ, ์ฌํ ์๊ตฌ์ฌํญ์์ ์ ๊ณต๋๋ ํ๋ก ํธ์๋ ์ฝ๋๋ ์ ๊ณต๋ API ์คํ์ ์ค์ํด์ผ ์ฐ๋ํ ์ ์์ต๋๋ค.
- Postman์ ํ์ฉํด ์ปจํธ๋กค๋ฌ๋ฅผ ํ
์คํธ ํ์ธ์.
- Postman API ํ ์คํธ ๊ฒฐ๊ณผ๋ฅผ exportํ์ฌ PR์ ์ฒจ๋ถํด์ฃผ์ธ์.
- springdoc-openapi๋ฅผ ํ์ฉํ์ฌ Swagger ๊ธฐ๋ฐ์ API ๋ฌธ์๋ฅผ ์์ฑํ์ธ์.
- Swagger-UI๋ฅผ ํ์ฉํด API๋ฅผ ํ ์คํธํด๋ณด์ธ์.
4. ์ฌํ ์๊ตฌ์ฌํญ
-
๋ค์์ ์ ์ ๋ฆฌ์์ค๋ฅผ ์๋นํ์ฌ ํ๋ก ํธ์๋์ ํตํฉํด๋ณด์ธ์. API ์คํ์ ์ค์ํ๋ค๋ฉด ์ ๋์ํ ๊ฑฐ์์.
-
Railway.app์ ํ์ฉํ์ฌ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋ฐฐํฌํด๋ณด์ธ์.
- Railway.app์ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฝ๊ฒ ๋ฐฐํฌํ ์ ์๋๋ก ๋์์ฃผ๋ PaaS์ ๋๋ค.
- Railway.app์ ๊ฐ์ ํ๊ณ , ๋ฐฐํฌํ GitHub ๋ ํฌ์งํ ๋ฆฌ๋ฅผ ์ฐ๊ฒฐํ์ธ์.
Settings > Network์น์ ์์Generate Domain๋ฒํผ์ ํตํด ๋๋ฉ์ธ์ ์์ฑํ์ธ์.- ์์ฑ๋ ๋๋ฉ์ธ์ ์ ์ํด ๋ฐฐํฌ๋ ์ ํ๋ฆฌ์ผ์ด์ ์ ํ ์คํธํด๋ณด์ธ์.
๋ฌด๋ฃ ์ฌ์ฉ ์ ํ์ด ์์ผ๋ฏ๋ก, ์ฝ๋ ๋ฆฌ๋ทฐ ์ดํ์๋ ๋ฐฐํฌ ์ธ์คํด์ค๋ฅผ ์ญ์ ํด์ฃผ์ธ์.
Leave a comment