서버를 무중단 배포할 수 있게 한다. (#17)

.github/workflows/server_cd.yml

@@ -84,11 +84,13 @@ jobs:
       - name: View
         run: cat .env
 
-      - name: Compose Docker image
+      - name: Compose Docker image and Update Nginx configuration
         env:
           DOCKER_APP_IMAGE: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }}
 
-        run: docker compose -f compose.yml up -d
+        run: |
+          chmod +x ./scripts/deploy.sh # 실행 권한 부여
+          sudo -E ./scripts/deploy.sh # 환경 변수 유지 및 실행
 
       - name: Docker remove unused images
         run: docker image prune -af

README.md

@@ -3,11 +3,18 @@
 **▷ 개발 기간 : 2024.11 ~ 현재</br>**
 **▷ 개발 인원 : 1명**
 
-서버 주소: https://api.fluppy.run
-API 명세서: https://api.fluffy.run/docs/index.html
-웹 프론트엔드 주소: https://fluppy.run
+## 프로젝트 소개
 
-## Server
+플러피(Fluffy)는 온라인 시험 문제 제작 및 관리 서비스입니다.
+
+## 프로젝트 개요
+
+- 서버 주소: https://api.fluppy.run
+- API 명세서: https://api.fluffy.run/docs/index.html
+- 웹 프론트엔드 주소: https://fluppy.run
+- 서비스 개발 블로그: https://alstn113.tistory.com/tag/플러피
+
+## 서버
 
 ### 기술 스택
 
@@ -16,7 +23,7 @@ API 명세서: https://api.fluffy.run/docs/index.html
 - redis
 - supabase(postgreSQL)
 
-## Web Frontend
+## 웹 프론트엔드
 
 ### 기술 스택
 

server/build.gradle

@@ -68,6 +68,9 @@ dependencies {
     annotationProcessor 'jakarta.annotation:jakarta.annotation-api'
     annotationProcessor 'jakarta.persistence:jakarta.persistence-api'
 
+    // monitoring
+    implementation 'org.springframework.boot:spring-boot-starter-actuator'
+
     // test
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

server/compose.local.yml

@@ -1,6 +1,6 @@
 services:
   redis:
-    container_name: fluffy-redis
+    container_name: redis
     image: redis:7.4.1
     restart: always
     ports:

server/compose.yml

@@ -1,18 +1,28 @@
+x-app: &app
+  image: ${DOCKER_APP_IMAGE}
+  env_file:
+    - .env
+  environment:
+    TZ: Asia/Seoul
+    SPRING_PROFILES_ACTIVE: prod
+  restart: always
+  depends_on:
+    - redis
+
 services:
-  app:
-    container_name: fluffy-app
-    image: ${DOCKER_APP_IMAGE}
-    ports:
-      - '8080:8080'
-    env_file:
-      - .env
-    environment:
-      TZ: Asia/Seoul
-      SPRING_PROFILES_ACTIVE: prod
-    restart: always
   redis:
-    container_name: fluffy-redis
+    container_name: redis
     image: redis:7.4.1
     restart: always
     ports:
       - '6379:6379'
+  app-blue:
+    <<: *app
+    container_name: app-blue
+    ports:
+      - '8080:8080'
+  app-green:
+    <<: *app
+    container_name: app-green
+    ports:
+      - '8081:8080'

server/scripts/deploy.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+NGINX_CONFIG_PATH="/etc/nginx/sites-available/api.fluffy.run"
+HOST_HEALTH_CHECK_ENDPOINT="http://localhost:8082/actuator/health"
+HEALTH_CHECK_ATTEMPTS=5
+HEALTH_CHECK_DELAY=3
+
+health_check() {
+    for i in $(seq 1 $HEALTH_CHECK_ATTEMPTS); do
+        echo "Health check attempt ($i/$HEALTH_CHECK_ATTEMPTS)"
+        response=$(curl -s -o /dev/null -w "%{http_code}" $HOST_HEALTH_CHECK_ENDPOINT)
+
+        if [ $response -eq 200 ]; then
+            echo "Health check passed"
+            return 0
+        fi
+
+        sleep $HEALTH_CHECK_DELAY
+    done
+
+    echo "Health check failed"
+    return 1
+}
+
+switch_container() {
+    local prev_container=$1
+    local next_container=$2
+
+    docker compose -f compose.yml up $next_container -d
+
+    if ! health_check; then
+        echo "Health check failed, rolling back"
+        docker compose -f compose.yml down $next_container
+        return 1
+    fi
+
+    sed -i "s/server $prev_container:8080;/server $next_container:8080;/" "$NGINX_CONFIG_PATH"
+
+    sudo nginx -s reload
+}
+
+IS_GREEN=$(docker container ps | grep app-green)
+
+if [ -z "$IS_GREEN" ]; then
+    echo "### BLUE >> GREEN ###"
+    switch_container "app-blue" "app-green"
+else
+    echo "### GREEN >> BLUE ###"
+    switch_container "app-green" "app-blue"
+fi

server/src/main/resources/application.yml

@@ -1,7 +1,6 @@
 spring:
   profiles:
     active: local
-
 ---
 spring:
   config:
@@ -61,6 +60,14 @@ logging:
     org.springframework.orm.transaction: DEBUG
     org.hibernate.orm.jdbc.bind: trace
 
+management:
+  server:
+    port: 8082
+  endpoints:
+    web:
+      exposure:
+        include: health
+
 ---
 spring:
   config:
@@ -84,7 +91,7 @@ spring:
       ddl-auto: validate
   data:
     redis:
-      host: fluffy-redis
+      host: redis
       port: 6379
 
 api-host: https://api.fluffy.run
@@ -118,3 +125,11 @@ logging:
     org.springframework.orm.jpa: DEBUG
     org.springframework.orm.transaction: DEBUG
     org.hibernate.orm.jdbc.bind: trace
+
+management:
+  server:
+    port: 8082
+  endpoints:
+    web:
+      exposure:
+        include: health