Skip to content

Latest commit

 

History

History
59 lines (42 loc) · 2.48 KB

README.md

File metadata and controls

59 lines (42 loc) · 2.48 KB
Raw

README

Description

  • Sopt Official Spring Boot 공홈 API 서버 입니다.
  • Package Manager는 Gradle 을 사용합니다.
  • 기본적으로, 모든 연결된 API 앞에 /v2 가 붙습니다. servlet context-path
    • 프로젝트 내부적에서 routing 추가 X

INDEX

  1. Getting Started
  2. [Project Structure](#Project Structure)
  3. Deploy_Pipeline

Getting-started

서버 실행 환경

  • JDK 17
  • Spring Boot 3.2.3

서버 환경 변수

  • application-env.yml 에서 로컬에 있는 .env 값을 읽어와서 세팅합니다.

env 환경 변수는 담당자에게 공유 받으세요.

OpenAPI

/v2/api-docs

Project Structure

아키텍처는 다음과 같이 형성되어있습니다.

Architecture

Sopt_Official_diagram drawio

  • 인스턴스는 EC2 내부에서 동작합니다.
  • EC2 내부에 Docker container가 존재합니다.
  • NestJS 의 경우, 3000:3000으로 포워딩 및 / route 에 매핑되어 있습니다.
  • Spring Boot 의 경우, 8080:8080으로 포워딩 및 /v2 route 에 매핑되어 있습니다.

    • Production 레벨의 경우 아직 Spring Boot 셋팅은 완료되지 않았습니다.

  • Docker image는 AWS Public ECR 에서 관리하고 있고, 인수인계 시 AWS 계정에 PublicECR 관련 IAM Role 을 부여받아야 합니다.

Dev, Prod 모두 동일한 구조를 형성하고 있고, 리소스 차이밖에 없습니다.

Deploy-Pipeline

  • deploy pipeline은 github action을 이용하여 구성되어있습니다.
  • github action은 ./github/workflows 에서 확인할 수 있습니다.
  • workflow 파일은 총 3가지가 있고, 각각 다음과 같은 역할을 합니다.
    1. cd.develop.yml : develop 브랜치에 푸시(또는 머지)가 되었을때마다 수행합니다. develop 서버에 배포가 됩니다.
  • cd.***.yml workflow는 다음과 같은 동작을 합니다.
    1. docker image를 빌드합니다.
    2. docker image를 ECR 에 push합니다.
    3. EC2에 ssh로 접속하여 ECR 에서 이미지를 pull합니다.
    4. EC2에서 실행중인 container 를 종료합니다.
    5. spring-server docker container 를 실행합니다.

GitAction 관련 Secret은, GitHub 관리자에게 문의하여 Owner권한을 획득 후, Repository secret에서 설정하시기 바랍니다. 자세한 설명은 별도로 공유드린 문서에서 확인 하실 수 있습니다.