Ubuntu Web Service 배포 가이드 (개선판)

2025.11.16 40 분 소요

Oracle Cloud Ubuntu 프로덕션 배포 가이드

아키텍처 개요

                      [Oracle Cloud - 공인 IP]
                                |
                        [OCI 보안 목록]
                      (포트: 80, 443, 22)
                                |
                      [Ubuntu VM 인스턴스]
                                |
                      [Nginx (80/443)]
                      SSL: Let's Encrypt
                                |
         +----------------------+----------------------+
         |                      |                      |
    [/worklog]             [/worklog1]            [/worklog2]
     :5173, :5174           :5175, :5176           :5177, :5178
     (Node.js)              (Node.js)              (Node.js)
         |                      |                      |
         +----------------------+----------------------+
                                |
                            [/api]
                        :8090, :8095
                      (Spring Boot JAR)
                                |
                     +----------+----------+
                     |                     |
               [PostgreSQL]           [Redis]
                 :5432                 :6379
              (Docker Network)     (Docker Network)

1단계: OCI 인스턴스 설정

컴퓨트 인스턴스 생성

인스턴스 사양 (권장):

Shape: VM.Standard.E2.1.Micro (무료 티어) 또는 VM.Standard.E4.Flex
이미지: Canonical Ubuntu 22.04 LTS
OCPU: 1-2
메모리: 8-16 GB
부트 볼륨: 100 GB (여유 공간 확보)
VCN: 신규 생성 또는 기존 사용
공인 IP: 공인 IPv4 할당 필수

OCI 보안 목록 규칙 (인그레스)

VCN의 보안 목록에 다음 규칙 추가:

SSH (임시, 배포 후 특정 IP로 제한)

Stateless: No
Source: 0.0.0.0/0 → 나중에 관리자 IP로 변경
IP Protocol: TCP
Source Port Range: All
Destination Port Range: 22

HTTP

Stateless: No
Source: 0.0.0.0/0
IP Protocol: TCP
Source Port Range: All
Destination Port Range: 80

HTTPS

Stateless: No
Source: 0.0.0.0/0
IP Protocol: TCP
Source Port Range: All
Destination Port Range: 443

2단계: 초기 Ubuntu 설정

인스턴스 SSH 접속

ssh ubuntu@<OCI-공인-IP>

시스템 업데이트

sudo apt update && sudo apt upgrade -y

Swap 메모리 설정 (OOM 방지)

# 2GB Swap 파일 생성
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 영구 설정
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Swappiness 조정 (메모리 사용 우선)
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf

# VFS 캐시 압력 조정 (자원 효율 향상)
echo 'vm.vfs_cache_pressure=50' | sudo tee -a /etc/sysctl.conf

sudo sysctl -p

# 확인
free -h
sysctl vm.swappiness vm.vfs_cache_pressure

필수 패키지 설치

sudo apt install -y curl wget git unzip build-essential ufw fail2ban htop

Node.js 22.x 설치

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 확인
node --version  # v22.x
npm --version

Java 17 설치

sudo apt install -y openjdk-17-jdk

# 확인
java -version  # openjdk version "17.x"

Docker & Docker Compose 설치

# Docker 설치
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker ubuntu

# 새 그룹 적용 (재로그인 대신)
newgrp docker

# Docker Compose Plugin 설치
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# Docker GPG key 추가
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Docker repository 추가
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 패키지 업데이트 및 설치
sudo apt update
sudo apt install -y docker-compose-plugin

# 확인
docker --version
docker compose version

3단계: 방화벽 설정 (Ubuntu UFW)

UFW 기본 정책 설정

sudo ufw default deny incoming
sudo ufw default allow outgoing

필수 포트 허용

# SSH (나중에 특정 IP로 제한)
sudo ufw allow 22/tcp

# HTTP/HTTPS
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

UFW 활성화

sudo ufw --force enable
sudo ufw status verbose

방화벽 확인

sudo ufw status numbered

4단계: Nginx 설치 및 기본 설정

Nginx 설치

sudo apt install -y nginx

# 기본 사이트 비활성화
sudo systemctl stop nginx
sudo systemctl disable nginx  # 나중에 수동으로 활성화

5단계: PostgreSQL & Redis 설정 (Docker)

디렉토리 구조 생성

sudo mkdir -p /opt/moremong/{docker,backend,frontends/{worklog,worklog1,worklog2},backups,versions}
sudo chown -R ubuntu:ubuntu /opt/moremong

# 구조 확인
tree -L 2 /opt/moremong 2>/dev/null || find /opt/moremong -maxdepth 2 -type d

개선된 디렉토리 구조:

/opt/moremong/
├── docker/               # Docker Compose 설정
│   ├── docker-compose.yml
│   └── .env
├── backend/              # Spring Boot 백엔드
│   ├── moremong-restapi.jar
│   └── .env
├── frontends/            # ✅ 모든 프론트엔드 앱 (통합 관리)
│   ├── worklog/          # 첫 번째 앱 (BASE_PATH=/worklog)
│   │   ├── build/        # SvelteKit 빌드 결과
│   │   ├── .env
│   │   ├── package.json
│   │   └── node_modules/
│   ├── worklog1/         # 두 번째 앱 (BASE_PATH=/worklog1)
│   │   └── (구조 동일)
│   └── worklog2/         # 세 번째 앱 (BASE_PATH=/worklog2)
│       └── (구조 동일)
├── backups/              # 데이터베이스 백업
│   ├── postgres_*.sql.gz
│   └── redis_*.rdb
└── versions/             # 애플리케이션 버전 백업
    └── moremong-*.tar.gz

설계 원칙:

✅ 일관성: 모든 프론트엔드는 frontends/ 하위에 위치
✅ 명확성: frontends/worklog/로 용도 즉시 파악 가능
✅ 확장성: 새 앱 추가 시 frontends/<app-name>/ 생성
✅ 자동화 친화적: 스크립트에서 frontends/* 패턴 매칭 가능
✅ 효율성: 동일 앱의 여러 인스턴스는 같은 빌드 디렉토리 공유

명명 규칙:

frontends/<app-name>/ : 앱 이름은 BASE_PATH와 동일 (슬래시 제외)
예: BASE_PATH=/worklog → frontends/worklog/
예: BASE_PATH=/admin → frontends/admin/

Docker Compose 파일 생성

cat > /opt/moremong/docker/docker-compose.yml <<'EOF'
services:
  postgresql:
    image: postgres:16  # ✅ 안정 버전 (17은 아직 프로덕션 검증 부족)
    container_name: moremong-postgres
    restart: always
    environment:
      POSTGRES_DB: moremong
      POSTGRES_USER: moremong
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5432:5432"
    networks:
      - moremong-network
    command:
      - "postgres"
      - "-c"
      - "max_connections=200"
      - "-c"
      - "shared_buffers=256MB"
      - "-c"
      - "effective_cache_size=1GB"
      - "-c"
      - "maintenance_work_mem=64MB"
      - "-c"
      - "checkpoint_completion_target=0.9"
      - "-c"
      - "wal_buffers=16MB"
      - "-c"
      - "default_statistics_target=100"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U moremong"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7.2.3
    container_name: moremong-redis
    restart: always
    command: >
      redis-server
      --requirepass ${REDIS_PASSWORD}
      --appendonly yes
      --appendfsync everysec
    volumes:
      - redis_data:/data
    ports:
      - "127.0.0.1:6379:6379"
    networks:
      - moremong-network
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres_data:
    driver: local
  redis_data:
    driver: local

networks:
  moremong-network:
    driver: bridge
EOF

환경 변수 파일 생성

cat > /opt/moremong/docker/.env <<'EOF'
POSTGRES_PASSWORD=CHANGE_THIS_STRONG_PASSWORD_1
REDIS_PASSWORD=CHANGE_THIS_STRONG_PASSWORD_2
EOF

# ✅ 보안 권한 설정 (중요!)
chmod 600 /opt/moremong/docker/.env
chmod 600 /opt/moremong/docker/docker-compose.yml  # 실수로 소스 저장소 업로드 방지

⚠️ 보안 주의사항:

.env 파일과 docker-compose.yml 모두 권한 600 설정
이 파일들은 절대 Git 저장소에 커밋하지 마세요
.gitignore에 추가 권장:
```
.env
.env.*
docker-compose.yml
```

⚠️ 중요: 실제 강력한 비밀번호로 변경하세요!

# 비밀번호 생성 예시
openssl rand -base64 32

Docker 서비스 시작

cd /opt/moremong/docker
docker compose up -d

# 상태 확인
docker compose ps
docker compose logs -f

PostgreSQL 초기 설정 확인

# PostgreSQL 접속 테스트
docker exec -it moremong-postgres psql -U moremong -d moremong

# psql 프롬프트에서
\l  # 데이터베이스 목록
\q  # 종료

6단계: 애플리케이션 파일 배포

방법 1: Git Clone

cd /opt/moremong
git clone <저장소-URL> repo

방법 2: SCP 업로드

# 로컬 머신에서 실행
scp -r ./your-app ubuntu@<OCI-공인-IP>:/opt/moremong/repo

방법 3: rsync (증분 업데이트)

# 로컬 머신에서 실행
rsync -avz --progress ./your-app/ ubuntu@<OCI-공인-IP>:/opt/moremong/repo/

7단계: 백엔드 빌드 & 배포

프로덕션 환경 파일 생성

cat > /opt/moremong/repo/restapi/.env.production <<'EOF'
# Jasypt 암호화 마스터 키
JASYPT_ENCRYPTOR_PASSWORD=YOUR_MASTER_ENCRYPTION_KEY

# Spring Profile
SPRING_PROFILES_ACTIVE=prod

# ⚠️ 포트 설정 주의사항:
# - server.port는 systemd 서비스 파일에서 -Dserver.port=8090/8095로 설정됨
# - 여기에 SERVER_PORT를 정의하지 마세요 (인스턴스별로 다른 포트 사용)
# - Spring Boot는 JVM 시스템 프로퍼티(-D)를 최우선으로 사용합니다

# 데이터베이스
SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/moremong
SPRING_DATASOURCE_USERNAME=moremong
SPRING_DATASOURCE_PASSWORD=CHANGE_THIS_STRONG_PASSWORD_1

# Redis
SPRING_DATA_REDIS_HOST=localhost
SPRING_DATA_REDIS_PORT=6379
SPRING_DATA_REDIS_PASSWORD=CHANGE_THIS_STRONG_PASSWORD_2

# OAuth (암호화된 값으로 대체)
# KAKAO_CLIENT_ID=ENC(...)
# KAKAO_CLIENT_SECRET=ENC(...)
# NAVER_CLIENT_ID=ENC(...)
# NAVER_CLIENT_SECRET=ENC(...)
# GOOGLE_CLIENT_ID=ENC(...)
# GOOGLE_CLIENT_SECRET=ENC(...)
EOF

chmod 600 /opt/moremong/repo/restapi/.env.production

Spring Boot 포트 설정 메커니즘:

Spring Boot의 server.port 설정 우선순위 (높은 순서):

JVM 시스템 프로퍼티 (-Dserver.port=8090) ← ✅ 현재 사용 방식
명령줄 인자 (--server.port=8090)
환경변수 (SERVER_PORT=8090) ← Spring Boot 2.0+에서 지원
application.properties / application.yml
기본값 (8080)

현재 배포 전략:

✅ 인스턴스 1: systemd에서 -Dserver.port=8090 명시
✅ 인스턴스 2: systemd에서 -Dserver.port=8095 명시
✅ .env 파일: 포트 설정 없음 (공통 설정만 포함)
✅ 장점: 명시적이고 디버깅 쉬움, 포트 충돌 방지

JAR 빌드

cd /opt/moremong/repo/restapi

# 권한 설정 (필요시)
chmod +x gradlew

# 프로덕션 빌드
./gradlew -Pprod clean bootJar

# 빌드 확인
ls -lh build/libs/*.jar

첫 배포

# JAR 파일 복사
cp build/libs/*.jar /opt/moremong/backend/moremong-restapi.jar

# 환경 파일 복사
cp .env.production /opt/moremong/backend/.env

# 권한 설정
chmod 600 /opt/moremong/backend/.env

Systemd 서비스 생성

백엔드 인스턴스 1 (포트 8090)

sudo tee /etc/systemd/system/moremong-api-1.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Backend API Instance 1
After=network.target docker.service
Wants=docker.service

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/backend
EnvironmentFile=/opt/moremong/backend/.env

# ✅ JVM 시스템 프로퍼티로 포트 명시 (-Dserver.port)
ExecStart=/usr/bin/java \
  -server \
  -Xms1g \
  -Xmx2g \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UseStringDeduplication \
  -XX:+OptimizeStringConcat \
  -Djava.security.egd=file:/dev/./urandom \
  -Dspring.profiles.active=prod \
  -Dserver.port=8090 \
  -jar /opt/moremong/backend/moremong-restapi.jar

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-api-1

# 로그 제한
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

중요:

✅ -Dserver.port=8090: JVM 시스템 프로퍼티로 포트 명시 (최우선 순위)
❌ Environment="SERVER_PORT=8090": 제거됨 (Spring Boot에서 인식 안 됨)
.env 파일에 있는 SERVER_PORT는 무시되거나 다른 용도로 사용 가능

백엔드 인스턴스 2 (포트 8095)

sudo tee /etc/systemd/system/moremong-api-2.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Backend API Instance 2
After=network.target docker.service
Wants=docker.service

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/backend
EnvironmentFile=/opt/moremong/backend/.env

# ✅ JVM 시스템 프로퍼티로 포트 명시 (-Dserver.port)
ExecStart=/usr/bin/java \
  -server \
  -Xms1g \
  -Xmx2g \
  -XX:+UseG1GC \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UseStringDeduplication \
  -XX:+OptimizeStringConcat \
  -Djava.security.egd=file:/dev/./urandom \
  -Dspring.profiles.active=prod \
  -Dserver.port=8095 \
  -jar /opt/moremong/backend/moremong-restapi.jar

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-api-2

# 로그 제한
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

8단계: 프론트엔드 빌드 & 배포

프로덕션 환경 파일 생성

cd /opt/moremong/repo/moremong-front

cat > .env.production <<'EOF'
PUBLIC_API_URL=https://moremong.com
EOF

chmod 644 .env.production

SvelteKit 설정 확인

svelte.config.js 파일에서 adapter와 paths 설정 확인:

import adapter from '@sveltejs/adapter-node';

/** @type {import('@sveltejs/kit').Config} */
const config = {
  kit: {
    adapter: adapter(),
    paths: {
      base: process.env.BASE_PATH || ''
    }
  }
};

export default config;

⚠️ 중요: @sveltejs/adapter-node는 빌드 시 다음 구조를 생성합니다:

build/
├── index.js          # 메인 서버 진입점 (이 파일을 실행해야 함!)
├── server/
│   └── index.js      # 서버 로직
└── client/           # 클라이언트 자산

반드시 build/index.js를 실행해야 합니다!

빌드 (worklog)

cd /opt/moremong/repo/moremong-front

# BASE_PATH를 환경변수로 설정하고 빌드
BASE_PATH=/worklog npm run build

# ✅ 빌드 결과 확인 (매우 중요!)
ls -la build/
ls -la build/index.js  # 이 파일이 반드시 존재해야 함!

# 빌드 파일이 없으면 에러
if [ ! -f "build/index.js" ]; then
    echo "❌ 에러: build/index.js 파일이 없습니다!"
    echo "svelte.config.js에서 adapter 설정을 확인하세요."
    exit 1
fi

echo "✅ 빌드 성공: build/index.js 확인됨"

# 빌드 파일 복사
cp -r build /opt/moremong/frontends/worklog/
cp .env.production /opt/moremong/frontends/worklog/.env
cp package.json package-lock.json /opt/moremong/frontends/worklog/

# 프로덕션 의존성 설치
cd /opt/moremong/frontend
npm ci --omit=dev

# ✅ 실행 테스트 (선택적이지만 강력 권장)
echo "서버 실행 테스트 중..."
PORT=5173 HOST=127.0.0.1 timeout 5 node build/index.js || true
echo "테스트 완료"

🚨 일반적인 빌드 오류 해결

문제 1: build/index.js 파일이 생성되지 않음

원인: svelte.config.js에 adapter가 잘못 설정됨

해결방법:

// svelte.config.js
import adapter from '@sveltejs/adapter-node';  // ✅ 올바름

// ❌ 잘못된 예시들:
// import adapter from '@sveltejs/adapter-static';
// import adapter from '@sveltejs/adapter-auto';

const config = {
  kit: {
    adapter: adapter()  // ✅ adapter() 호출해야 함
  }
};

문제 2: 빌드는 성공하지만 서버가 시작되지 않음

원인: systemd 서비스에 잘못된 경로 설정

해결방법:

# ❌ 잘못됨
ExecStart=/usr/bin/node build

# ✅ 올바름
ExecStart=/usr/bin/node build/index.js

문제 3: 의존성 누락

해결방법:

cd /opt/moremong/frontend
npm ci --omit=dev  # package-lock.json 기반으로 설치

Systemd 서비스 생성

프론트엔드 인스턴스 1 (포트 5173)

sudo tee /etc/systemd/system/moremong-front-1.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog Instance 1
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend
EnvironmentFile=/opt/moremong/frontends/worklog/.env
Environment="PORT=5173"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"

# ✅ 정확한 실행 경로: build/index.js
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front-1

# 로그 제한
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

프론트엔드 인스턴스 2 (포트 5174)

sudo tee /etc/systemd/system/moremong-front-2.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog Instance 2
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend
EnvironmentFile=/opt/moremong/frontends/worklog/.env
Environment="PORT=5174"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"

# ✅ 정확한 실행 경로: build/index.js
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front-2

# 로그 제한
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

추가 프론트엔드 인스턴스 (필요시)

frontend1 (worklog1) - 포트 5175, 5176

cd /opt/moremong/repo/moremong-front1
BASE_PATH=/worklog1 npm run build

# 빌드 결과 확인
ls -la build/index.js  # 이 파일이 존재해야 함!

cp -r build /opt/moremong/frontends/worklog1/
cp .env.production /opt/moremong/frontends/worklog1/.env
cp package.json package-lock.json /opt/moremong/frontends/worklog1/
cd /opt/moremong/frontend1
npm ci --omit=dev

유사하게 systemd 서비스 생성 (포트 5175, 5176 사용):

# moremong-front1-1.service
sudo tee /etc/systemd/system/moremong-front1-1.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog1 Instance 1
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend1
EnvironmentFile=/opt/moremong/frontends/worklog1/.env
Environment="PORT=5175"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front1-1
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

# moremong-front1-2.service
sudo tee /etc/systemd/system/moremong-front1-2.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog1 Instance 2
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend1
EnvironmentFile=/opt/moremong/frontends/worklog1/.env
Environment="PORT=5176"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front1-2
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

frontend2 (worklog2) - 포트 5177, 5178

cd /opt/moremong/repo/moremong-front2
BASE_PATH=/worklog2 npm run build

# 빌드 결과 확인
ls -la build/index.js  # 이 파일이 존재해야 함!

cp -r build /opt/moremong/frontends/worklog2/
cp .env.production /opt/moremong/frontends/worklog2/.env
cp package.json package-lock.json /opt/moremong/frontends/worklog2/
cd /opt/moremong/frontend2
npm ci --omit=dev

유사하게 systemd 서비스 생성 (포트 5177, 5178 사용):

# moremong-front2-1.service
sudo tee /etc/systemd/system/moremong-front2-1.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog2 Instance 1
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend2
EnvironmentFile=/opt/moremong/frontends/worklog2/.env
Environment="PORT=5177"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front2-1
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

# moremong-front2-2.service
sudo tee /etc/systemd/system/moremong-front2-2.service > /dev/null <<'EOF'
[Unit]
Description=Moremong Frontend /worklog2 Instance 2
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/moremong/frontend2
EnvironmentFile=/opt/moremong/frontends/worklog2/.env
Environment="PORT=5178"
Environment="HOST=127.0.0.1"
Environment="ORIGIN=https://moremong.com"
ExecStart=/usr/bin/node build/index.js

Restart=always
RestartSec=5
StartLimitIntervalSec=60
StartLimitBurst=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=moremong-front2-2
LogRateLimitIntervalSec=30s
LogRateLimitBurst=1000

[Install]
WantedBy=multi-user.target
EOF

9단계: SSL 인증서 발급 (Let’s Encrypt)

Certbot 설치

sudo apt install -y certbot python3-certbot-nginx

⚠️ 주의사항:

python3-certbot-nginx 패키지를 설치하지만, 실제로는 standalone 모드를 사용합니다
Nginx plugin은 사용하지 않음 (Nginx가 이미 직접 설정되어 있으므로)
standalone 모드로 인증서 발급 시 포트 80을 일시적으로 사용

SSL 인증서 발급

⚠️ 중요: 도메인 DNS가 OCI 공인 IP를 가리켜야 합니다!

# 실제 도메인으로 변경
sudo certbot certonly --standalone \
  -d moremong.com \
  -d www.moremong.com \
  --non-interactive \
  --agree-tos \
  -m your-email@example.com \
  --preferred-challenges http

# 인증서 위치 확인
sudo ls -l /etc/letsencrypt/live/moremong.com/

자동 갱신 설정

# Certbot 타이머 활성화 (자동 갱신)
sudo systemctl enable certbot.timer
sudo systemctl start certbot.timer

# 타이머 상태 확인
sudo systemctl status certbot.timer

# 갱신 테스트 (dry-run)
sudo certbot renew --dry-run

갱신 후 Nginx 리로드 설정

sudo tee /etc/letsencrypt/renewal-hooks/deploy/nginx-reload.sh > /dev/null <<'EOF'
#!/bin/bash
systemctl reload nginx
EOF

sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/nginx-reload.sh

10단계: Nginx 설정

Nginx 메인 설정 파일

sudo tee /etc/nginx/nginx.conf > /dev/null <<'EOF'
user www-data;
worker_processes auto;
pid /run/nginx.pid;
error_log /var/log/nginx/error.log warn;

events {
    worker_connections 2048;
    use epoll;
    multi_accept on;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for" '
                    'rt=$request_time uct="$upstream_connect_time" '
                    'uht="$upstream_header_time" urt="$upstream_response_time"';

    access_log /var/log/nginx/access.log main;

    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    client_max_body_size 20M;
    server_tokens off;  # 버전 정보 숨김

    # WebSocket 지원을 위한 map 설정
    map $http_upgrade $connection_upgrade {
        default upgrade;
        ''      close;
    }

    # Gzip 압축
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_min_length 256;        # 256바이트 이상만 압축 (작은 파일 압축 오버헤드 방지)
    gzip_buffers 16 8k;         # 압축 버퍼 최적화
    gzip_types text/plain text/css text/xml text/javascript
               application/json application/javascript application/xml+rss
               application/rss+xml font/truetype font/opentype
               application/vnd.ms-fontobject image/svg+xml;
    gzip_disable "msie6";

    # 보안 헤더
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    # Rate limiting
    limit_req_zone $binary_remote_addr zone=general:10m rate=30r/s;
    limit_req_zone $binary_remote_addr zone=api:10m rate=50r/s;
    limit_req_zone $binary_remote_addr zone=login:10m rate=5r/m;

    # 업스트림 백엔드 (로드 밸런싱)
    upstream backend_api {
        least_conn;
        server 127.0.0.1:8090 max_fails=3 fail_timeout=30s;
        server 127.0.0.1:8095 max_fails=3 fail_timeout=30s;
        keepalive 32;
    }

    # 업스트림 프론트엔드
    upstream frontend_worklog {
        least_conn;
        server 127.0.0.1:5173 max_fails=3 fail_timeout=30s;
        server 127.0.0.1:5174 max_fails=3 fail_timeout=30s;
        keepalive 16;
    }

    upstream frontend_worklog1 {
        least_conn;
        server 127.0.0.1:5175 max_fails=3 fail_timeout=30s;
        server 127.0.0.1:5176 max_fails=3 fail_timeout=30s;
        keepalive 16;
    }

    upstream frontend_worklog2 {
        least_conn;
        server 127.0.0.1:5177 max_fails=3 fail_timeout=30s;
        server 127.0.0.1:5178 max_fails=3 fail_timeout=30s;
        keepalive 16;
    }

    # HTTP -> HTTPS 리다이렉트
    server {
        listen 80;
        listen [::]:80;
        server_name moremong.com www.moremong.com;

        # Let's Encrypt ACME 챌린지
        location /.well-known/acme-challenge/ {
            root /var/www/html;
        }

        # 나머지는 HTTPS로 리다이렉트
        location / {
            return 301 https://$host$request_uri;
        }
    }

    # HTTPS 메인 서버
    server {
        listen 443 ssl http2;
        listen [::]:443 ssl http2;
        server_name moremong.com www.moremong.com;

        # SSL 인증서
        ssl_certificate /etc/letsencrypt/live/moremong.com/fullchain.pem;
        ssl_certificate_key /etc/letsencrypt/live/moremong.com/privkey.pem;
        ssl_session_timeout 1d;
        ssl_session_cache shared:MozSSL:10m;
        ssl_session_tickets off;

        # 최신 SSL 프로토콜 및 암호화
        ssl_protocols TLSv1.2 TLSv1.3;
        ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
        ssl_prefer_server_ciphers off;

        # HSTS (HTTP Strict Transport Security)
        add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload" always;

        # 백엔드 API
        location /api {
            limit_req zone=api burst=50 nodelay;

            proxy_pass http://backend_api;
            proxy_http_version 1.1;
            proxy_set_header Connection "";
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Forwarded-Host $host;
            proxy_set_header X-Forwarded-Port $server_port;

            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
            proxy_buffering off;

            # CORS 헤더 (필요시)
            # add_header Access-Control-Allow-Origin "https://moremong.com" always;
        }

        # OAuth2 로그인 엔드포인트
        location ~ ^/(oauth2|login) {
            limit_req zone=login burst=10 nodelay;

            proxy_pass http://backend_api;
            proxy_http_version 1.1;
            proxy_set_header Connection "";
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_set_header X-Forwarded-Host $host;
            proxy_set_header X-Forwarded-Port $server_port;

            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }

        # Management 엔드포인트 (로컬만 접근)
        location /management {
            allow 127.0.0.1;
            deny all;

            proxy_pass http://backend_api;
            proxy_http_version 1.1;
            proxy_set_header Connection "";
            proxy_set_header Host $host;
        }

        # 프론트엔드 /worklog
        location /worklog {
            limit_req zone=general burst=50 nodelay;

            proxy_pass http://frontend_worklog;
            proxy_http_version 1.1;
            
            # WebSocket 지원 (SvelteKit HMR, 이벤트 스트림용)
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            # 타임아웃 설정
            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }

        # 프론트엔드 /worklog1
        location /worklog1 {
            limit_req zone=general burst=50 nodelay;

            proxy_pass http://frontend_worklog1;
            proxy_http_version 1.1;
            
            # WebSocket 지원 (SvelteKit HMR, 이벤트 스트림용)
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            # 타임아웃 설정
            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }

        # 프론트엔드 /worklog2
        location /worklog2 {
            limit_req zone=general burst=50 nodelay;

            proxy_pass http://frontend_worklog2;
            proxy_http_version 1.1;
            
            # WebSocket 지원 (SvelteKit HMR, 이벤트 스트림용)
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            
            # 타임아웃 설정
            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }

        # 루트 경로 리다이렉트
        location = / {
            return 301 https://$host/worklog;
        }

        # 헬스 체크 엔드포인트
        location /health {
            access_log off;
            return 200 "healthy\n";
            add_header Content-Type text/plain;
        }

        # 파비콘 무시 (404 방지)
        location = /favicon.ico {
            log_not_found off;
            access_log off;
        }
    }
}
EOF

Nginx 설정 테스트

sudo nginx -t

아직 시작하지 마세요! 모든 서비스가 준비된 후 시작합니다.

11단계: 모든 서비스 시작

Systemd 데몬 리로드

sudo systemctl daemon-reload

백엔드 서비스 시작

# 활성화 (부팅 시 자동 시작)
sudo systemctl enable moremong-api-1 moremong-api-2

# 서비스 시작
sudo systemctl start moremong-api-1
sleep 10  # 첫 인스턴스가 완전히 시작되길 기다림

sudo systemctl start moremong-api-2

# 상태 확인
sudo systemctl status moremong-api-1
sudo systemctl status moremong-api-2

# 로그 확인
sudo journalctl -u moremong-api-1 -n 50 --no-pager
sudo journalctl -u moremong-api-2 -n 50 --no-pager

# 헬스 체크
curl http://localhost:8090/management/health
curl http://localhost:8095/management/health

프론트엔드 서비스 시작

# 활성화 및 시작
sudo systemctl enable moremong-front-1 moremong-front-2
sudo systemctl start moremong-front-1 moremong-front-2

# 상태 확인
sudo systemctl status moremong-front-1
sudo systemctl status moremong-front-2

# 헬스 체크
curl -I http://localhost:5173/worklog
curl -I http://localhost:5174/worklog

Nginx 시작

sudo systemctl enable nginx
sudo systemctl start nginx
sudo systemctl status nginx

# 설정 리로드 (설정 변경 시)
sudo nginx -s reload

전체 서비스 확인

# 모든 서비스 상태
sudo systemctl status moremong-api-1 moremong-api-2 moremong-front-1 moremong-front-2 nginx

# Docker 컨테이너 확인
docker compose -f /opt/moremong/docker/docker-compose.yml ps

# 포트 리스닝 확인
sudo netstat -tuln | grep LISTEN

12단계: OAuth 제공자 설정

각 OAuth 제공자 콘솔에서 리다이렉트 URI를 업데이트하세요.

Google Cloud Console

Google Cloud Console 접속
API 및 서비스 > 사용자 인증 정보
OAuth 2.0 클라이언트 ID 선택
승인된 리다이렉트 URI 추가:
- https://moremong.com/login/oauth2/code/google

Kakao Developers

Kakao Developers 접속
내 애플리케이션 > 앱 설정 > 플랫폼
Redirect URI 추가:
- https://moremong.com/login/oauth2/code/kakao

Naver Developers

Naver Developers 접속
내 애플리케이션 > API 설정
Callback URL 추가:
- https://moremong.com/login/oauth2/code/naver

백엔드 application.yml 확인

Spring Boot의 application.yml 또는 application-prod.yml에 다음 설정이 있는지 확인:

application:
  oauth2:
    allowed-redirect-uris:
      - https://moremong.com/worklog/oauth/callback
      - https://moremong.com/worklog1/oauth/callback
      - https://moremong.com/worklog2/oauth/callback

spring:
  security:
    oauth2:
      client:
        registration:
          google:
            redirect-uri: "{baseUrl}/login/oauth2/code/{registrationId}"
          kakao:
            redirect-uri: "{baseUrl}/login/oauth2/code/{registrationId}"
          naver:
            redirect-uri: "{baseUrl}/login/oauth2/code/{registrationId}"

13단계: 보안 강화

1. Fail2ban 설정

sudo tee /etc/fail2ban/jail.local > /dev/null <<'EOF'
[DEFAULT]
bantime = 3600
findtime = 600
maxretry = 5
destemail = your-email@example.com
sendername = Fail2Ban-Moremong

[sshd]
enabled = true
port = 22
logpath = /var/log/auth.log
maxretry = 3

[nginx-http-auth]
enabled = true
port = http,https
logpath = /var/log/nginx/error.log

[nginx-limit-req]
enabled = true
filter = nginx-limit-req
port = http,https
logpath = /var/log/nginx/error.log
maxretry = 10
EOF

# Fail2ban 활성화
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

# 상태 확인
sudo fail2ban-client status
sudo fail2ban-client status sshd

2. SSH 강화

# SSH 설정 백업
sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.backup

# SSH 보안 강화 적용
sudo tee -a /etc/ssh/sshd_config > /dev/null <<'EOF'

# === 보안 강화 설정 ===
PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes
ChallengeResponseAuthentication no
UsePAM yes
X11Forwarding no
PrintMotd no
AcceptEnv LANG LC_*

# 연결 타임아웃
ClientAliveInterval 300
ClientAliveCountMax 2

# 인증 시도 제한
MaxAuthTries 3
MaxSessions 5
LoginGraceTime 60

# 허용 사용자 (선택적)
# AllowUsers ubuntu
EOF

# SSH 재시작
sudo systemctl restart sshd

# SSH 상태 확인
sudo systemctl status sshd

⚠️ 주의: SSH 재시작 전에 다른 터미널로 접속 테스트를 먼저 하세요!

3. 자동 보안 업데이트

# Unattended Upgrades 설치
sudo apt install -y unattended-upgrades

# 설정
sudo tee /etc/apt/apt.conf.d/50unattended-upgrades > /dev/null <<'EOF'
Unattended-Upgrade::Allowed-Origins {
    "${distro_id}:${distro_codename}-security";
    "${distro_id}ESMApps:${distro_codename}-apps-security";
};

Unattended-Upgrade::AutoFixInterruptedDpkg "true";
Unattended-Upgrade::MinimalSteps "true";
Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";
Unattended-Upgrade::Remove-Unused-Dependencies "true";
Unattended-Upgrade::Automatic-Reboot "false";
Unattended-Upgrade::Automatic-Reboot-Time "03:00";

Unattended-Upgrade::Mail "your-email@example.com";
Unattended-Upgrade::MailReport "on-change";
EOF

# 자동 업데이트 활성화
sudo dpkg-reconfigure -plow unattended-upgrades

4. 파일 권한 강화

# 애플리케이션 디렉토리
sudo chown -R ubuntu:ubuntu /opt/moremong
sudo chmod -R 755 /opt/moremong

# 민감한 환경 파일
sudo chmod 600 /opt/moremong/backend/.env
sudo chmod 600 /opt/moremong/frontends/worklog/.env
sudo chmod 600 /opt/moremong/docker/.env

# Nginx 설정
sudo chown -R root:root /etc/nginx
sudo chmod 644 /etc/nginx/nginx.conf

# SSL 인증서
sudo chmod 644 /etc/letsencrypt/live/moremong.com/fullchain.pem
sudo chmod 600 /etc/letsencrypt/live/moremong.com/privkey.pem

5. 감사 로깅 (Auditd)

# Auditd 설치
sudo apt install -y auditd

# 감사 규칙 추가
sudo tee /etc/audit/rules.d/moremong.rules > /dev/null <<'EOF'
# 시스템 파일 변경 감시
-w /etc/passwd -p wa -k passwd_changes
-w /etc/group -p wa -k group_changes
-w /etc/sudoers -p wa -k sudoers_changes
-w /etc/ssh/sshd_config -p wa -k sshd_config_changes

# 애플리케이션 디렉토리 변경 감시
-w /opt/moremong -p wa -k moremong_changes

# Nginx 설정 변경 감시
-w /etc/nginx -p wa -k nginx_changes

# systemd 서비스 변경 감시
-w /etc/systemd/system -p wa -k systemd_changes
EOF

# Auditd 재시작
sudo systemctl restart auditd
sudo systemctl enable auditd

# 감사 로그 확인
sudo ausearch -k passwd_changes

6. 로그 로테이션

# Nginx 로그 로테이션
sudo tee /etc/logrotate.d/moremong-nginx > /dev/null <<'EOF'
/var/log/nginx/*.log {
    daily
    missingok
    rotate 14
    compress
    delaycompress
    notifempty
    create 0640 www-data adm
    sharedscripts
    postrotate
        if [ -f /var/run/nginx.pid ]; then
            kill -USR1 `cat /var/run/nginx.pid`
        fi
    endscript
}
EOF

# 애플리케이션 로그 로테이션 (journald가 관리하지만 추가 설정 가능)
sudo tee /etc/logrotate.d/moremong-app > /dev/null <<'EOF'
/var/log/moremong/*.log {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    create 0640 ubuntu ubuntu
}
EOF

# systemd journald 로그 크기 제한 (디스크 공간 절약)
sudo tee /etc/systemd/journald.conf > /dev/null <<'EOF'
[Journal]
SystemMaxUse=200M
SystemMaxFileSize=50M
RuntimeMaxUse=100M
MaxRetentionSec=2week
ForwardToSyslog=no
EOF

# journald 재시작
sudo systemctl restart systemd-journald

# 로그 로테이션 테스트
sudo logrotate -d /etc/logrotate.d/moremong-nginx

7. 불필요한 서비스 비활성화

# 사용하지 않는 서비스 확인
systemctl list-unit-files --type=service --state=enabled

# 예시: Bluetooth, CUPS 등 비활성화
sudo systemctl disable bluetooth.service 2>/dev/null || true
sudo systemctl disable cups.service 2>/dev/null || true

# 불필요한 패키지 제거
sudo apt autoremove -y

8. Ubuntu 시스템 튜닝 (운영 안정성 향상)

파일 핸들 제한 확장

# 파일 디스크립터 제한 증가
sudo tee -a /etc/security/limits.conf > /dev/null <<'EOF'

# === Moremong 애플리케이션 최적화 ===
* soft nofile 65535
* hard nofile 65535
EOF

Sysctl 네트워크 및 파일 시스템 최적화

# 기존 sysctl 설정에 추가
sudo tee -a /etc/sysctl.conf > /dev/null <<'EOF'

# === Moremong 추가 최적화 ===
# 파일 시스템
fs.file-max=100000

# 네트워크 성능 (고부하 환경 대비)
net.core.somaxconn=65535
EOF

# 설정 적용
sudo sysctl -p

# 확인
sysctl fs.file-max net.core.somaxconn vm.swappiness vm.vfs_cache_pressure

최적화 설명:

fs.file-max: 시스템 전체 파일 핸들 제한 (100,000)
net.core.somaxconn: 대기 중인 연결 큐 크기 증가
nofile: 프로세스당 파일 디스크립터 제한 (65,535)
Nginx, Node.js, Java 모두 혜택을 받음

14단계: 모니터링 설정

1. Node Exporter 설치 (Prometheus용)

# 최신 버전 다운로드
cd /tmp
wget https://github.com/prometheus/node_exporter/releases/download/v1.7.0/node_exporter-1.7.0.linux-amd64.tar.gz
tar xvfz node_exporter-1.7.0.linux-amd64.tar.gz
sudo mv node_exporter-1.7.0.linux-amd64/node_exporter /usr/local/bin/
rm -rf node_exporter-1.7.0.linux-amd64*

# Systemd 서비스 생성
sudo tee /etc/systemd/system/node_exporter.service > /dev/null <<'EOF'
[Unit]
Description=Node Exporter
After=network.target

[Service]
Type=simple
User=nobody
ExecStart=/usr/local/bin/node_exporter \
  --web.listen-address=127.0.0.1:9100

Restart=always

[Install]
WantedBy=multi-user.target
EOF

# 서비스 시작
sudo systemctl daemon-reload
sudo systemctl enable node_exporter
sudo systemctl start node_exporter

# 확인
curl http://localhost:9100/metrics

2. 로그 모니터링 도구

# lnav 설치 (로그 뷰어)
sudo apt install -y lnav

# 사용 예시
sudo lnav /var/log/nginx/*.log
sudo journalctl -u moremong-api-1 -u moremong-api-2 -f

3. 헬스 체크 스크립트

cat > /opt/moremong/health-check.sh <<'EOF'
#!/bin/bash

echo "================================================"
echo "    Moremong 시스템 헬스 체크"
echo "    타임스탬프: $(date '+%Y-%m-%d %H:%M:%S')"
echo "================================================"
echo ""

# 서비스 상태
echo "=== 서비스 상태 ==="
printf "%-25s %s\n" "백엔드 API 1:" "$(systemctl is-active moremong-api-1)"
printf "%-25s %s\n" "백엔드 API 2:" "$(systemctl is-active moremong-api-2)"
printf "%-25s %s\n" "프론트엔드 1:" "$(systemctl is-active moremong-front-1)"
printf "%-25s %s\n" "프론트엔드 2:" "$(systemctl is-active moremong-front-2)"
printf "%-25s %s\n" "Nginx:" "$(systemctl is-active nginx)"
printf "%-25s %s\n" "PostgreSQL:" "$(docker ps --filter name=moremong-postgres --format '' | head -c 20)"
printf "%-25s %s\n" "Redis:" "$(docker ps --filter name=moremong-redis --format '' | head -c 20)"
echo ""

# 포트 리스닝
echo "=== 포트 리스닝 상태 ==="
netstat -tuln | grep -E ':(80|443|5173|5174|8090|8095|5432|6379) ' | awk '{print $4}' | sort -u
echo ""

# 디스크 사용량
echo "=== 디스크 사용량 ==="
df -h / | tail -n 1
echo ""

# 메모리 사용량
echo "=== 메모리 사용량 ==="
free -h | grep -E '^Mem|^Swap'
echo ""

# CPU 로드
echo "=== CPU 로드 ==="
uptime
echo ""

# Docker 컨테이너 상태
echo "=== Docker 컨테이너 ==="
docker ps --format "table \t\t"
echo ""

# 최근 에러 로그 (있을 경우)
echo "=== 최근 에러 로그 (1시간) ==="
ERROR_COUNT=$(sudo journalctl --since "1 hour ago" -p err --no-pager | wc -l)
if [ $ERROR_COUNT -gt 0 ]; then
    echo "⚠️  에러 로그 ${ERROR_COUNT}개 발견"
    sudo journalctl --since "1 hour ago" -p err --no-pager | tail -n 10
else
    echo "✓ 에러 없음"
fi
echo ""

echo "================================================"
EOF

chmod +x /opt/moremong/health-check.sh

# 실행 테스트
/opt/moremong/health-check.sh

4. 크론잡으로 정기 체크

# 매시간 헬스 체크 수행 및 로그 저장
(crontab -l 2>/dev/null; echo "0 * * * * /opt/moremong/health-check.sh >> /var/log/moremong-health.log 2>&1") | crontab -

# 크론 확인
crontab -l

15단계: 백업 전략

1. 데이터베이스 백업 스크립트

cat > /opt/moremong/backup-db.sh <<'EOF'
#!/bin/bash

set -e  # 에러 시 중단

BACKUP_DIR="/opt/moremong/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
POSTGRES_CONTAINER="moremong-postgres"
REDIS_CONTAINER="moremong-redis"

mkdir -p $BACKUP_DIR

echo "================================================"
echo "  데이터베이스 백업 시작: $TIMESTAMP"
echo "================================================"

# PostgreSQL 백업
echo "PostgreSQL 백업 중..."
docker exec $POSTGRES_CONTAINER pg_dump -U moremong moremong | \
  gzip > $BACKUP_DIR/postgres_$TIMESTAMP.sql.gz

if [ $? -eq 0 ]; then
    echo "✓ PostgreSQL 백업 완료: postgres_$TIMESTAMP.sql.gz"
else
    echo "✗ PostgreSQL 백업 실패!"
    exit 1
fi

# Redis 백업
echo "Redis 백업 중..."
docker exec $REDIS_CONTAINER redis-cli --rdb /data/dump.rdb SAVE
docker cp $REDIS_CONTAINER:/data/dump.rdb $BACKUP_DIR/redis_$TIMESTAMP.rdb

if [ $? -eq 0 ]; then
    echo "✓ Redis 백업 완료: redis_$TIMESTAMP.rdb"
else
    echo "✗ Redis 백업 실패!"
    exit 1
fi

# 7일 이전 백업 삭제
echo "오래된 백업 정리 중..."
find $BACKUP_DIR -name "postgres_*.sql.gz" -mtime +7 -delete
find $BACKUP_DIR -name "redis_*.rdb" -mtime +7 -delete

# 백업 파일 크기 확인
echo ""
echo "=== 백업 파일 ==="
ls -lh $BACKUP_DIR | tail -n 5

echo ""
echo "백업 완료: $TIMESTAMP"
echo "================================================"
EOF

chmod +x /opt/moremong/backup-db.sh

# 백업 테스트
/opt/moremong/backup-db.sh

2. 자동 백업 크론잡

# 매일 새벽 2시에 백업 수행
(crontab -l 2>/dev/null; echo "0 2 * * * /opt/moremong/backup-db.sh >> /var/log/moremong-backup.log 2>&1") | crontab -

# 확인
crontab -l

3. 백업 복원 스크립트

cat > /opt/moremong/restore-db.sh <<'EOF'
#!/bin/bash

set -e

BACKUP_DIR="/opt/moremong/backups"

if [ $# -ne 1 ]; then
    echo "사용법: $0 <백업파일_타임스탬프>"
    echo "예시: $0 20250116_020000"
    echo ""
    echo "사용 가능한 백업:"
    ls -lh $BACKUP_DIR | grep postgres
    exit 1
fi

TIMESTAMP=$1
POSTGRES_BACKUP="$BACKUP_DIR/postgres_${TIMESTAMP}.sql.gz"
REDIS_BACKUP="$BACKUP_DIR/redis_${TIMESTAMP}.rdb"

if [ ! -f "$POSTGRES_BACKUP" ]; then
    echo "✗ PostgreSQL 백업 파일을 찾을 수 없습니다: $POSTGRES_BACKUP"
    exit 1
fi

echo "================================================"
echo "  데이터베이스 복원 시작: $TIMESTAMP"
echo "================================================"
echo ""
read -p "⚠️  기존 데이터가 삭제됩니다. 계속하시겠습니까? (yes/no): " CONFIRM

if [ "$CONFIRM" != "yes" ]; then
    echo "복원 취소됨."
    exit 0
fi

# PostgreSQL 복원
echo "PostgreSQL 복원 중..."
docker exec moremong-postgres psql -U moremong -d postgres -c "DROP DATABASE IF EXISTS moremong;"
docker exec moremong-postgres psql -U moremong -d postgres -c "CREATE DATABASE moremong;"
gunzip < $POSTGRES_BACKUP | docker exec -i moremong-postgres psql -U moremong -d moremong

echo "✓ PostgreSQL 복원 완료"

# Redis 복원 (선택적)
if [ -f "$REDIS_BACKUP" ]; then
    echo "Redis 복원 중..."
    docker cp $REDIS_BACKUP moremong-redis:/data/dump.rdb
    docker restart moremong-redis
    echo "✓ Redis 복원 완료"
fi

echo ""
echo "================================================"
echo "  복원 완료: $TIMESTAMP"
echo "================================================"
EOF

chmod +x /opt/moremong/restore-db.sh

4. 애플리케이션 버전 백업 및 자동화

# 버전 관리 디렉토리
mkdir -p /opt/moremong/versions

# 개선된 버전 백업 스크립트 (압축 아카이브 생성)
cat > /opt/moremong/backup-version.sh <<'EOF'
#!/bin/bash

set -e

VERSION=${1:-"unknown"}
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/opt/moremong/versions"
TEMP_DIR="/tmp/moremong-backup-${TIMESTAMP}"

echo "================================================"
echo "  버전 백업 시작"
echo "  버전: $VERSION"
echo "  타임스탬프: $TIMESTAMP"
echo "================================================"
echo ""

# 임시 디렉토리 생성
mkdir -p $TEMP_DIR/{backend,frontends/{worklog,worklog1,worklog2}}

# 백엔드 JAR 파일 백업
if [ -f "/opt/moremong/backend/moremong-restapi.jar" ]; then
    echo "백엔드 JAR 백업 중..."
    cp /opt/moremong/backend/moremong-restapi.jar $TEMP_DIR/backend/
    echo "✓ 백엔드 백업 완료"
fi

# 프론트엔드 빌드 백업 (frontends 구조)
for app in worklog worklog1 worklog2; do
    if [ -d "/opt/moremong/frontends/$app/build" ]; then
        echo "frontends/$app 빌드 백업 중..."
        mkdir -p $TEMP_DIR/frontends/$app
        cp -r /opt/moremong/frontends/$app/build $TEMP_DIR/frontends/$app/
        cp /opt/moremong/frontends/$app/package.json $TEMP_DIR/frontends/$app/ 2>/dev/null || true
        echo "✓ frontends/$app 백업 완료"
    fi
done

# 압축 아카이브 생성
ARCHIVE_NAME="moremong-${VERSION}-${TIMESTAMP}.tar.gz"
echo ""
echo "압축 아카이브 생성 중..."
tar -czf $BACKUP_DIR/$ARCHIVE_NAME -C $TEMP_DIR .

if [ $? -eq 0 ]; then
    echo "✓ 아카이브 생성 완료: $ARCHIVE_NAME"
    echo "  크기: $(du -h $BACKUP_DIR/$ARCHIVE_NAME | cut -f1)"
else
    echo "✗ 아카이브 생성 실패!"
    rm -rf $TEMP_DIR
    exit 1
fi

# 임시 디렉토리 정리
rm -rf $TEMP_DIR

# 30일 이전 백업 삭제
echo ""
echo "오래된 백업 정리 중..."
find $BACKUP_DIR -name "moremong-*.tar.gz" -mtime +30 -delete

echo ""
echo "================================================"
echo "  ✓ 버전 백업 완료"
echo "  파일: $BACKUP_DIR/$ARCHIVE_NAME"
echo "================================================"
EOF

chmod +x /opt/moremong/backup-version.sh

# 사용 예시
# /opt/moremong/backup-version.sh v1.0.0

버전 복원 스크립트:

cat > /opt/moremong/restore-version.sh <<'EOF'
#!/bin/bash

set -e

if [ $# -ne 1 ]; then
    echo "사용법: $0 <아카이브파일명>"
    echo ""
    echo "사용 가능한 백업:"
    ls -lht /opt/moremong/versions/*.tar.gz | head -10
    exit 1
fi

ARCHIVE_FILE="/opt/moremong/versions/$1"

if [ ! -f "$ARCHIVE_FILE" ]; then
    echo "✗ 아카이브 파일을 찾을 수 없습니다: $ARCHIVE_FILE"
    exit 1
fi

echo "================================================"
echo "  버전 복원 시작"
echo "  파일: $1"
echo "================================================"
echo ""

read -p "⚠️  현재 버전을 복원하시겠습니까? (yes/no): " CONFIRM
if [ "$CONFIRM" != "yes" ]; then
    echo "복원 취소됨."
    exit 0
fi

# 서비스 중지
echo "서비스 중지 중..."
sudo systemctl stop moremong-api-1 moremong-api-2
sudo systemctl stop moremong-front-1 moremong-front-2

# 임시 디렉토리에 압축 해제
TEMP_DIR="/tmp/moremong-restore-$(date +%s)"
mkdir -p $TEMP_DIR
tar -xzf $ARCHIVE_FILE -C $TEMP_DIR

# 백엔드 복원
if [ -f "$TEMP_DIR/backend/moremong-restapi.jar" ]; then
    echo "백엔드 복원 중..."
    cp $TEMP_DIR/backend/moremong-restapi.jar /opt/moremong/backend/
    echo "✓ 백엔드 복원 완료"
fi

# 프론트엔드 복원 (frontends 구조)
for app in worklog worklog1 worklog2; do
    if [ -d "$TEMP_DIR/frontends/$app/build" ]; then
        echo "frontends/$app 복원 중..."
        rm -rf /opt/moremong/frontends/$app/build
        cp -r $TEMP_DIR/frontends/$app/build /opt/moremong/frontends/$app/
        echo "✓ frontends/$app 복원 완료"
    fi
done

# 임시 디렉토리 정리
rm -rf $TEMP_DIR

# 서비스 시작
echo ""
echo "서비스 시작 중..."
sudo systemctl start moremong-api-1
sleep 10
sudo systemctl start moremong-api-2
sleep 5
sudo systemctl start moremong-front-1 moremong-front-2

echo ""
echo "================================================"
echo "  ✓ 버전 복원 완료"
echo "================================================"
EOF

chmod +x /opt/moremong/restore-version.sh

16단계: Zero-Downtime 배포 전략

개요

무중단 배포는 사용자에게 서비스 중단 없이 새 버전을 배포하는 전략입니다. Nginx 로드 밸런서를 활용하여 롤링 업데이트를 수행합니다.

배포 프로세스

새 버전 빌드
인스턴스 1 중지 (Nginx가 트래픽을 인스턴스 2로 라우팅)
인스턴스 1 업데이트 및 시작
헬스 체크 통과 확인
인스턴스 2 중지 (Nginx가 트래픽을 인스턴스 1로 라우팅)
인스턴스 2 업데이트 및 시작
헬스 체크 통과 확인
배포 완료

Zero-Downtime 배포 스크립트 (백엔드)

cat > /opt/moremong/deploy-backend.sh <<'EOF'
#!/bin/bash

set -e

VERSION=${1:-"unknown"}
JAR_PATH=${2:-"/opt/moremong/repo/restapi/build/libs/moremong-restapi.jar"}

if [ ! -f "$JAR_PATH" ]; then
    echo "✗ JAR 파일을 찾을 수 없습니다: $JAR_PATH"
    exit 1
fi

echo "================================================"
echo "  백엔드 Zero-Downtime 배포 시작"
echo "  버전: $VERSION"
echo "  JAR: $JAR_PATH"
echo "================================================"
echo ""

# 자동 버전 백업 (압축 아카이브)
echo "=== 자동 버전 백업 ==="
if [ -x "/opt/moremong/backup-version.sh" ]; then
    /opt/moremong/backup-version.sh $VERSION
else
    echo "⚠️  backup-version.sh 스크립트를 찾을 수 없습니다. 수동 백업 진행..."
    # 수동 백업 (기존 방식)
    TIMESTAMP=$(date +%Y%m%d_%H%M%S)
    BACKUP_DIR="/opt/moremong/versions/${VERSION}_${TIMESTAMP}"
    mkdir -p $BACKUP_DIR
    cp /opt/moremong/backend/moremong-restapi.jar $BACKUP_DIR/moremong-restapi.jar.backup
    echo "✓ 현재 버전 백업 완료: $BACKUP_DIR"
fi
echo ""

# 새 JAR 복사
cp $JAR_PATH /opt/moremong/backend/moremong-restapi.jar.new
echo "✓ 새 JAR 파일 복사 완료"
echo ""

# 인스턴스 1 업데이트
echo "=== 인스턴스 1 업데이트 ==="
echo "인스턴스 1 중지 중..."
sudo systemctl stop moremong-api-1

echo "JAR 교체 중..."
mv /opt/moremong/backend/moremong-restapi.jar /opt/moremong/backend/moremong-restapi.jar.old
mv /opt/moremong/backend/moremong-restapi.jar.new /opt/moremong/backend/moremong-restapi.jar

echo "인스턴스 1 시작 중..."
sudo systemctl start moremong-api-1

# 헬스 체크 대기
echo "헬스 체크 대기 중..."
for i in {1..30}; do
    if curl -s -f http://localhost:8090/management/health > /dev/null 2>&1; then
        echo "✓ 인스턴스 1 헬스 체크 통과 (${i}초)"
        break
    fi
    echo -n "."
    sleep 1
done
echo ""

if ! curl -s -f http://localhost:8090/management/health > /dev/null 2>&1; then
    echo "✗ 인스턴스 1 헬스 체크 실패! 롤백 중..."
    sudo systemctl stop moremong-api-1
    mv /opt/moremong/backend/moremong-restapi.jar.old /opt/moremong/backend/moremong-restapi.jar
    sudo systemctl start moremong-api-1
    exit 1
fi

sleep 5
echo ""

# 인스턴스 2 업데이트
echo "=== 인스턴스 2 업데이트 ==="
echo "인스턴스 2 중지 중..."
sudo systemctl stop moremong-api-2

echo "인스턴스 2 시작 중..."
sudo systemctl start moremong-api-2

# 헬스 체크 대기
echo "헬스 체크 대기 중..."
for i in {1..30}; do
    if curl -s -f http://localhost:8095/management/health > /dev/null 2>&1; then
        echo "✓ 인스턴스 2 헬스 체크 통과 (${i}초)"
        break
    fi
    echo -n "."
    sleep 1
done
echo ""

if ! curl -s -f http://localhost:8095/management/health > /dev/null 2>&1; then
    echo "✗ 인스턴스 2 헬스 체크 실패!"
    exit 1
fi

# 정리
rm -f /opt/moremong/backend/moremong-restapi.jar.old

echo ""
echo "================================================"
echo "  ✓ 백엔드 배포 완료"
echo "  버전: $VERSION"
echo "  타임스탬프: $TIMESTAMP"
echo "================================================"

# 배포 후 확인
echo ""
echo "=== 배포 후 확인 ==="
sudo systemctl status moremong-api-1 --no-pager | grep Active
sudo systemctl status moremong-api-2 --no-pager | grep Active
curl -s http://localhost:8090/management/health | head -n 1
curl -s http://localhost:8095/management/health | head -n 1
EOF

chmod +x /opt/moremong/deploy-backend.sh

Zero-Downtime 배포 스크립트 (프론트엔드)

cat > /opt/moremong/deploy-frontend.sh <<'EOF'
#!/bin/bash

set -e

VERSION=${1:-"unknown"}
BUILD_PATH=${2:-"/opt/moremong/repo/moremong-front/build"}
APP_NAME=${3:-"worklog"}  # worklog, worklog1, worklog2
SERVICE_PREFIX=${4:-"moremong-front"}  # moremong-front, moremong-front1, moremong-front2

if [ ! -d "$BUILD_PATH" ]; then
    echo "✗ 빌드 디렉토리를 찾을 수 없습니다: $BUILD_PATH"
    exit 1
fi

# ✅ 중요: build/index.js 파일 존재 확인
if [ ! -f "$BUILD_PATH/index.js" ]; then
    echo "✗ 빌드 진입점을 찾을 수 없습니다: $BUILD_PATH/index.js"
    echo "  SvelteKit adapter-node는 build/index.js 파일을 생성해야 합니다."
    echo "  svelte.config.js를 확인하고 다시 빌드하세요."
    exit 1
fi

DEPLOY_DIR="/opt/moremong/frontends/$APP_NAME"  # ✅ frontends 구조 사용

echo "================================================"
echo "  프론트엔드 Zero-Downtime 배포 시작"
echo "  버전: $VERSION"
echo "  앱: $APP_NAME"
echo "  배포 경로: $DEPLOY_DIR"
echo "  빌드 경로: $BUILD_PATH"
echo "================================================"
echo ""

# 현재 버전 백업
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/opt/moremong/versions/${APP_NAME}_${VERSION}_${TIMESTAMP}"
mkdir -p $BACKUP_DIR
cp -r $DEPLOY_DIR/build $BACKUP_DIR/build.backup
echo "✓ 현재 버전 백업 완료: $BACKUP_DIR"
echo ""

# 새 빌드 복사
cp -r $BUILD_PATH $DEPLOY_DIR/build.new
echo "✓ 새 빌드 복사 완료"
echo ""

# 인스턴스 1 업데이트
echo "=== 인스턴스 1 업데이트 ==="
echo "인스턴스 1 중지 중..."
sudo systemctl stop ${SERVICE_PREFIX}-1

echo "빌드 교체 중..."
mv $DEPLOY_DIR/build $DEPLOY_DIR/build.old
mv $DEPLOY_DIR/build.new $DEPLOY_DIR/build

echo "인스턴스 1 시작 중..."
sudo systemctl start ${SERVICE_PREFIX}-1

# 헬스 체크 대기
echo "헬스 체크 대기 중..."
PORT1=$(systemctl show ${SERVICE_PREFIX}-1 -p Environment | grep -oP 'PORT=\K[0-9]+')
for i in {1..30}; do
    if curl -s -f http://localhost:${PORT1}/ > /dev/null 2>&1; then
        echo "✓ 인스턴스 1 헬스 체크 통과 (${i}초)"
        break
    fi
    echo -n "."
    sleep 1
done
echo ""

if ! curl -s -f http://localhost:${PORT1}/ > /dev/null 2>&1; then
    echo "✗ 인스턴스 1 헬스 체크 실패! 롤백 중..."
    sudo systemctl stop ${SERVICE_PREFIX}-1
    rm -rf $DEPLOY_DIR/build
    mv $DEPLOY_DIR/build.old $DEPLOY_DIR/build
    sudo systemctl start ${SERVICE_PREFIX}-1
    exit 1
fi

sleep 5
echo ""

# 인스턴스 2 업데이트
echo "=== 인스턴스 2 업데이트 ==="
echo "인스턴스 2 중지 중..."
sudo systemctl stop ${SERVICE_PREFIX}-2

echo "인스턴스 2 시작 중..."
sudo systemctl start ${SERVICE_PREFIX}-2

# 헬스 체크 대기
PORT2=$(systemctl show ${SERVICE_PREFIX}-2 -p Environment | grep -oP 'PORT=\K[0-9]+')
echo "헬스 체크 대기 중..."
for i in {1..30}; do
    if curl -s -f http://localhost:${PORT2}/ > /dev/null 2>&1; then
        echo "✓ 인스턴스 2 헬스 체크 통과 (${i}초)"
        break
    fi
    echo -n "."
    sleep 1
done
echo ""

if ! curl -s -f http://localhost:${PORT2}/ > /dev/null 2>&1; then
    echo "✗ 인스턴스 2 헬스 체크 실패!"
    exit 1
fi

# 정리
rm -rf $DEPLOY_DIR/build.old

echo ""
echo "================================================"
echo "  ✓ 프론트엔드 배포 완료"
echo "  버전: $VERSION"
echo "  타임스탬프: $TIMESTAMP"
echo "================================================"

# 배포 후 확인
echo ""
echo "=== 배포 후 확인 ==="
sudo systemctl status ${SERVICE_PREFIX}-1 --no-pager | grep Active
sudo systemctl status ${SERVICE_PREFIX}-2 --no-pager | grep Active
curl -I http://localhost:${PORT1}/ 2>/dev/null | head -n 1
curl -I http://localhost:${PORT2}/ 2>/dev/null | head -n 1
EOF

chmod +x /opt/moremong/deploy-frontend.sh

전체 배포 스크립트 (백엔드 + 프론트엔드)

cat > /opt/moremong/deploy-all.sh <<'EOF'
#!/bin/bash

set -e

VERSION=${1:-"v1.0.0"}

echo "================================================"
echo "  전체 애플리케이션 배포"
echo "  버전: $VERSION"
echo "================================================"
echo ""

# 1. 백엔드 빌드
echo "=== 1. 백엔드 빌드 ==="
cd /opt/moremong/repo/restapi
./gradlew -Pprod clean bootJar
echo "✓ 백엔드 빌드 완료"
echo ""

# 2. 프론트엔드 빌드
echo "=== 2. 프론트엔드 빌드 ==="
cd /opt/moremong/repo/moremong-front
BASE_PATH=/worklog npm run build

# 빌드 결과 검증
if [ ! -f "build/index.js" ]; then
    echo "✗ 프론트엔드 빌드 실패: build/index.js 파일이 생성되지 않았습니다."
    exit 1
fi
echo "✓ 프론트엔드 빌드 완료 (build/index.js 확인됨)"
echo ""

# 3. 데이터베이스 백업
echo "=== 3. 데이터베이스 백업 ==="
/opt/moremong/backup-db.sh
echo ""

# 4. 백엔드 배포
echo "=== 4. 백엔드 배포 ==="
/opt/moremong/deploy-backend.sh $VERSION /opt/moremong/repo/restapi/build/libs/*.jar
echo ""

# 5. 프론트엔드 배포
echo "=== 5. 프론트엔드 배포 ==="
/opt/moremong/deploy-frontend.sh $VERSION /opt/moremong/repo/moremong-front/build worklog moremong-front
echo ""

# 6. 배포 확인
echo "=== 6. 배포 확인 ==="
echo "백엔드 헬스 체크:"
curl -s https://moremong.com/api/management/health | head -n 1

echo ""
echo "프론트엔드 확인:"
curl -I https://moremong.com/worklog 2>/dev/null | head -n 1

echo ""
echo "================================================"
echo "  ✓ 전체 배포 완료: $VERSION"
echo "================================================"
EOF

chmod +x /opt/moremong/deploy-all.sh

배포 사용 예시

# 백엔드만 배포
/opt/moremong/deploy-backend.sh v1.0.1 /path/to/new.jar

# 프론트엔드만 배포 (worklog 앱)
/opt/moremong/deploy-frontend.sh v1.0.1 /path/to/build worklog moremong-front

# 프론트엔드만 배포 (worklog1 앱)
/opt/moremong/deploy-frontend.sh v1.0.1 /path/to/build1 worklog1 moremong-front1

# 프론트엔드만 배포 (worklog2 앱)
/opt/moremong/deploy-frontend.sh v1.0.1 /path/to/build2 worklog2 moremong-front2

# 전체 배포
/opt/moremong/deploy-all.sh v1.0.1

파라미터 설명:

$1: 버전명 (예: v1.0.1)
$2: 빌드 경로 (예: /opt/moremong/repo/moremong-front/build)
$3: 앱 이름 (worklog, worklog1, worklog2) → frontends/<app-name>/에 배포
$4: systemd 서비스 접두사 (moremong-front, moremong-front1, moremong-front2)

롤백 프로세스

cat > /opt/moremong/rollback.sh <<'EOF'
#!/bin/bash

set -e

if [ $# -ne 1 ]; then
    echo "사용법: $0 <버전_타임스탬프>"
    echo ""
    echo "사용 가능한 버전:"
    ls -lt /opt/moremong/versions/ | head -n 10
    exit 1
fi

VERSION_DIR="/opt/moremong/versions/$1"

if [ ! -d "$VERSION_DIR" ]; then
    echo "✗ 버전 디렉토리를 찾을 수 없습니다: $VERSION_DIR"
    exit 1
fi

echo "================================================"
echo "  롤백 시작: $1"
echo "================================================"
echo ""

read -p "⚠️  이전 버전으로 롤백하시겠습니까? (yes/no): " CONFIRM
if [ "$CONFIRM" != "yes" ]; then
    echo "롤백 취소됨."
    exit 0
fi

# 백엔드 롤백
if [ -f "$VERSION_DIR/moremong-restapi.jar.backup" ]; then
    echo "백엔드 롤백 중..."
    sudo systemctl stop moremong-api-1 moremong-api-2
    cp $VERSION_DIR/moremong-restapi.jar.backup /opt/moremong/backend/moremong-restapi.jar
    sudo systemctl start moremong-api-1
    sleep 10
    sudo systemctl start moremong-api-2
    echo "✓ 백엔드 롤백 완료"
fi

# 프론트엔드 롤백
if [ -d "$VERSION_DIR/frontend-build.backup" ]; then
    echo "프론트엔드 롤백 중..."
    sudo systemctl stop moremong-front-1 moremong-front-2
    rm -rf /opt/moremong/frontends/worklog/build
    cp -r $VERSION_DIR/frontend-build.backup /opt/moremong/frontends/worklog/build
    sudo systemctl start moremong-front-1
    sleep 5
    sudo systemctl start moremong-front-2
    echo "✓ 프론트엔드 롤백 완료"
fi

echo ""
echo "================================================"
echo "  ✓ 롤백 완료"
echo "================================================"
EOF

chmod +x /opt/moremong/rollback.sh

17단계: 배포 체크리스트

배포 전후 이 체크리스트를 실행하세요.

배포 전 체크리스트

cat > /opt/moremong/pre-deployment-checklist.sh <<'EOF'
#!/bin/bash

echo "================================================"
echo "  배포 전 체크리스트"
echo "================================================"
echo ""

PASS=0
FAIL=0

check() {
    if eval "$2"; then
        echo "✓ $1"
        ((PASS++))
    else
        echo "✗ $1"
        ((FAIL++))
    fi
}

# 1. 서비스 상태
echo "=== 서비스 상태 ==="
check "백엔드 API 1 실행 중" "systemctl is-active moremong-api-1 > /dev/null 2>&1"
check "백엔드 API 2 실행 중" "systemctl is-active moremong-api-2 > /dev/null 2>&1"
check "프론트엔드 1 실행 중" "systemctl is-active moremong-front-1 > /dev/null 2>&1"
check "프론트엔드 2 실행 중" "systemctl is-active moremong-front-2 > /dev/null 2>&1"
check "Nginx 실행 중" "systemctl is-active nginx > /dev/null 2>&1"
echo ""

# 2. Docker 컨테이너
echo "=== Docker 컨테이너 ==="
check "PostgreSQL 실행 중" "docker ps | grep moremong-postgres > /dev/null"
check "Redis 실행 중" "docker ps | grep moremong-redis > /dev/null"
echo ""

# 3. 디스크 공간
echo "=== 디스크 공간 ==="
DISK_USAGE=$(df -h / | tail -1 | awk '{print $5}' | sed 's/%//')
check "디스크 사용량 < 80% (현재: ${DISK_USAGE}%)" "[ $DISK_USAGE -lt 80 ]"
echo ""

# 4. 백업 존재
echo "=== 백업 ==="
check "최근 24시간 내 백업 존재" "find /opt/moremong/backups -name 'postgres_*.sql.gz' -mtime -1 | grep -q ."
echo ""

# 5. SSL 인증서
echo "=== SSL 인증서 ==="
CERT_EXPIRY=$(sudo openssl x509 -in /etc/letsencrypt/live/moremong.com/fullchain.pem -noout -enddate | cut -d= -f2)
DAYS_LEFT=$(( ( $(date -d "$CERT_EXPIRY" +%s) - $(date +%s) ) / 86400 ))
check "SSL 인증서 만료일 > 30일 (${DAYS_LEFT}일 남음)" "[ $DAYS_LEFT -gt 30 ]"
echo ""

# 6. 네트워크
echo "=== 네트워크 ==="
check "HTTPS 접근 가능" "curl -s -f -I https://moremong.com/health > /dev/null 2>&1"
echo ""

# 결과
echo "================================================"
echo "  통과: $PASS / 실패: $FAIL"
if [ $FAIL -eq 0 ]; then
    echo "  상태: ✓ 배포 준비 완료"
    exit 0
else
    echo "  상태: ✗ 문제 해결 필요"
    exit 1
fi
echo "================================================"
EOF

chmod +x /opt/moremong/pre-deployment-checklist.sh

배포 후 체크리스트

cat > /opt/moremong/post-deployment-checklist.sh <<'EOF'
#!/bin/bash

echo "================================================"
echo "  배포 후 체크리스트"
echo "================================================"
echo ""

PASS=0
FAIL=0

check() {
    if eval "$2"; then
        echo "✓ $1"
        ((PASS++))
    else
        echo "✗ $1"
        ((FAIL++))
    fi
}

# 1. 헬스 체크
echo "=== 헬스 체크 ==="
check "백엔드 API 1 헬스" "curl -s -f http://localhost:8090/management/health > /dev/null 2>&1"
check "백엔드 API 2 헬스" "curl -s -f http://localhost:8095/management/health > /dev/null 2>&1"
check "프론트엔드 1 접근" "curl -s -f http://localhost:5173/worklog > /dev/null 2>&1"
check "프론트엔드 2 접근" "curl -s -f http://localhost:5174/worklog > /dev/null 2>&1"
echo ""

# 2. 공개 엔드포인트
echo "=== 공개 엔드포인트 ==="
check "HTTPS 메인 페이지" "curl -s -f https://moremong.com/worklog > /dev/null 2>&1"
check "API 엔드포인트" "curl -s https://moremong.com/api/management/health | grep -q UP"
echo ""

# 3. 에러 로그
echo "=== 에러 로그 (최근 10분) ==="
ERROR_COUNT=$(sudo journalctl --since "10 minutes ago" -p err --no-pager | wc -l)
check "에러 로그 < 10개 (현재: ${ERROR_COUNT}개)" "[ $ERROR_COUNT -lt 10 ]"
echo ""

# 4. 응답 시간
echo "=== 응답 시간 ==="
RESPONSE_TIME=$(curl -o /dev/null -s -w '%{time_total}' https://moremong.com/worklog)
RESPONSE_MS=$(echo "$RESPONSE_TIME * 1000" | bc | cut -d. -f1)
check "페이지 응답 시간 < 2초 (현재: ${RESPONSE_MS}ms)" "[ $RESPONSE_MS -lt 2000 ]"
echo ""

# 5. OAuth 로그인 테스트 (수동)
echo "=== OAuth 테스트 (수동 확인 필요) ==="
echo "  ⚠️  브라우저에서 다음 테스트를 수행하세요:"
echo "  1. https://moremong.com/worklog 접속"
echo "  2. 로그인 버튼 클릭"
echo "  3. OAuth 제공자 선택 및 로그인"
echo "  4. 리다이렉트 정상 작동 확인"
echo ""

# 결과
echo "================================================"
echo "  통과: $PASS / 실패: $FAIL"
if [ $FAIL -eq 0 ]; then
    echo "  상태: ✓ 배포 성공"
    exit 0
else
    echo "  상태: ✗ 문제 발생 - 조사 필요"
    exit 1
fi
echo "================================================"
EOF

chmod +x /opt/moremong/post-deployment-checklist.sh

18단계: 문제 해결 가이드

일반적인 문제와 해결 방법

1. 서비스가 시작되지 않을 때

# 서비스 상태 확인
sudo systemctl status moremong-api-1
sudo journalctl -u moremong-api-1 -n 100 --no-pager

# 포트 충돌 확인
sudo netstat -tuln | grep 8090

# 수동 실행 (디버깅)
cd /opt/moremong/backend
java -jar moremong-restapi.jar

1-1. 🔥 포트 충돌 문제 (Spring Boot)

증상: 두 인스턴스가 모두 실패하거나 하나만 시작됨

# 로그에서 다음과 같은 에러 확인
sudo journalctl -u moremong-api-1 -n 50 | grep -i port

# 일반적인 에러 메시지:
# "Web server failed to start. Port 8080 was already in use"
# "Address already in use"

원인 분석:

systemd 서비스에서 포트 미설정

# ❌ 잘못된 설정
ExecStart=/usr/bin/java -jar moremong-restapi.jar
# → 두 인스턴스 모두 기본 포트 8080 사용 시도 → 충돌!

환경변수로 포트 설정 시도 (작동 안 함)

# ❌ Spring Boot에서 인식 안 됨
Environment="SERVER_PORT=8090"
Environment="SPRING_PORT=8090"
Environment="PORT=8090"

해결 방법:

# ✅ 올바른 방법 1: JVM 시스템 프로퍼티 (권장)
ExecStart=/usr/bin/java -Dserver.port=8090 -jar moremong-restapi.jar

# ✅ 올바른 방법 2: Spring Boot 환경변수 (대문자_언더스코어)
Environment="SERVER_PORT=8090"
# 주의: Spring Boot 2.0+ 필요, JVM 프로퍼티보다 우선순위 낮음

# ✅ 올바른 방법 3: 명령줄 인자
ExecStart=/usr/bin/java -jar moremong-restapi.jar --server.port=8090

현재 설정 확인:

# systemd 서비스 파일 확인
sudo cat /etc/systemd/system/moremong-api-1.service | grep -A 15 ExecStart

# 다음이 포함되어야 함:
# -Dserver.port=8090 (인스턴스 1)
# -Dserver.port=8095 (인스턴스 2)

# 포트 리스닝 확인
sudo netstat -tuln | grep -E ':(8090|8095) '

# 두 개의 Java 프로세스 확인
ps aux | grep java | grep moremong

포트 설정이 누락된 경우 수정:

# systemd 서비스 파일 수정
sudo systemctl edit --full moremong-api-1

# ExecStart 줄에 -Dserver.port=8090 추가
ExecStart=/usr/bin/java \
  -Dserver.port=8090 \
  -jar /opt/moremong/backend/moremong-restapi.jar

# 저장 후
sudo systemctl daemon-reload
sudo systemctl restart moremong-api-1
sudo systemctl restart moremong-api-2

2. Nginx 502 Bad Gateway

# 백엔드 서비스 확인
curl http://localhost:8090/management/health
curl http://localhost:8095/management/health

# Nginx 에러 로그
sudo tail -f /var/log/nginx/error.log

# 업스트림 연결 테스트
sudo nginx -t

3. SSL 인증서 문제

# 인증서 확인
sudo certbot certificates

# 수동 갱신
sudo certbot renew --dry-run
sudo certbot renew

# Nginx 리로드
sudo nginx -s reload

4. 데이터베이스 연결 실패

# PostgreSQL 컨테이너 확인
docker ps | grep postgres
docker logs moremong-postgres

# 데이터베이스 접속 테스트
docker exec -it moremong-postgres psql -U moremong -d moremong

# 연결 문자열 확인
cat /opt/moremong/backend/.env | grep DATASOURCE

5. 디스크 공간 부족

# 디스크 사용량 확인
df -h
du -sh /opt/moremong/* | sort -h

# Docker 정리
docker system prune -a

# 오래된 로그 정리
sudo journalctl --vacuum-time=7d

# 오래된 백업 삭제
find /opt/moremong/backups -mtime +30 -delete

6. 🔥 프론트엔드 서비스가 시작되지 않을 때 (SvelteKit)

증상: systemctl status moremong-front-1에서 실패 또는 에러 로그

가장 흔한 원인: 잘못된 실행 경로

# 로그 확인
sudo journalctl -u moremong-front-1 -n 50 --no-pager

# 일반적인 에러 메시지:
# "Error: Cannot find module '/opt/moremong/frontends/worklog/build'"
# "ENOENT: no such file or directory"

해결 방법:

# 1. build/index.js 파일 존재 확인
ls -la /opt/moremong/frontends/worklog/build/index.js

# 파일이 없다면:
echo "❌ build/index.js 파일이 없습니다!"

# 2. 빌드 디렉토리 구조 확인
tree -L 2 /opt/moremong/frontends/worklog/build/
# 또는
ls -la /opt/moremong/frontends/worklog/build/

# 3. systemd 서비스 파일 확인
sudo cat /etc/systemd/system/moremong-front-1.service | grep ExecStart

# ✅ 올바른 경로:
# ExecStart=/usr/bin/node build/index.js

# ❌ 잘못된 경로:
# ExecStart=/usr/bin/node build
# ExecStart=/usr/bin/node build/server/index.js
# ExecStart=/usr/bin/node index.js

# 4. 수동 실행 테스트
cd /opt/moremong/frontend
PORT=5173 HOST=127.0.0.1 node build/index.js

# 5. package.json 의존성 확인
npm list --depth=0

# 6. 의존성 재설치
npm ci --omit=dev

build/index.js가 없는 경우:

# svelte.config.js 확인
cat /opt/moremong/repo/moremong-front/svelte.config.js

# adapter-node가 올바르게 설정되어야 함:
# import adapter from '@sveltejs/adapter-node';

# 다시 빌드
cd /opt/moremong/repo/moremong-front
BASE_PATH=/worklog npm run build

# 빌드 후 확인
ls -la build/index.js  # 이 파일이 존재해야 함!

# 배포 디렉토리로 복사
cp -r build /opt/moremong/frontends/worklog/

7. SvelteKit ORIGIN 오류

증상: “Cross-site POST form submissions are forbidden” 에러

# systemd 서비스 파일에 ORIGIN 환경변수 추가
sudo systemctl edit moremong-front-1

# 다음 내용 추가:
[Service]
Environment="ORIGIN=https://moremong.com"

sudo systemctl daemon-reload
sudo systemctl restart moremong-front-1

빠른 롤백 절차

# 1. 모든 서비스 중지
sudo systemctl stop moremong-api-1 moremong-api-2
sudo systemctl stop moremong-front-1 moremong-front-2

# 2. 백업 버전으로 복원
ls -lt /opt/moremong/versions/  # 버전 확인
/opt/moremong/rollback.sh <버전_타임스탬프>

# 3. 데이터베이스 복원 (필요시)
ls -lt /opt/moremong/backups/  # 백업 확인
/opt/moremong/restore-db.sh <타임스탬프>

# 4. 서비스 재시작
sudo systemctl start moremong-api-1 moremong-api-2
sudo systemctl start moremong-front-1 moremong-front-2

# 5. 확인
/opt/moremong/post-deployment-checklist.sh

19단계: 성능 최적화

1. JVM 튜닝 (프로덕션 환경)

백엔드 systemd 서비스 파일의 JVM 옵션을 최적화했습니다 (이미 7단계에 포함):

-server
-Xms1g
-Xmx2g
-XX:+UseG1GC
-XX:MaxGCPauseMillis=200
-XX:+UseStringDeduplication
-XX:+OptimizeStringConcat

2. PostgreSQL 최적화

Docker Compose 파일에 이미 PostgreSQL 튜닝이 포함되어 있습니다 (5단계):

command:
  - "postgres"
  - "-c"
  - "max_connections=200"
  - "-c"
  - "shared_buffers=256MB"
  # ... 기타 최적화 설정

3. Nginx 캐싱 (정적 파일)

sudo tee -a /etc/nginx/nginx.conf > /dev/null <<'EOF'

# 정적 파일 캐싱
location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2|ttf|eot)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}
EOF

sudo nginx -t && sudo nginx -s reload

4. 커널 파라미터 최적화

sudo tee -a /etc/sysctl.conf > /dev/null <<'EOF'

# 네트워크 최적화
net.core.somaxconn = 1024
net.ipv4.tcp_max_syn_backlog = 2048
net.ipv4.ip_local_port_range = 1024 65535
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_fin_timeout = 15

# 파일 디스크립터 증가
fs.file-max = 100000
EOF

sudo sysctl -p

5. Systemd 제한 증가

# 백엔드 서비스 파일에 추가
sudo systemctl edit moremong-api-1

# 다음 내용 추가:
[Service]
LimitNOFILE=65536
LimitNPROC=4096

sudo systemctl daemon-reload
sudo systemctl restart moremong-api-1 moremong-api-2

최종 점검

전체 시스템 확인 스크립트

# 헬스 체크 실행
/opt/moremong/health-check.sh

# 배포 전 체크리스트
/opt/moremong/pre-deployment-checklist.sh

# 외부 접근 테스트
curl -I https://moremong.com/worklog
curl -s https://moremong.com/api/management/health

# 서비스 로그 확인 (에러 없는지)
sudo journalctl -u moremong-api-1 --since "1 hour ago" -p err --no-pager
sudo journalctl -u moremong-front-1 --since "1 hour ago" -p err --no-pager

# SSL 인증서 확인
sudo certbot certificates

# 방화벽 상태
sudo ufw status verbose

# OCI 보안 목록 확인 (웹 콘솔)

유지보수 명령어 요약

# === 서비스 관리 ===
sudo systemctl status moremong-api-1 moremong-api-2 moremong-front-1 moremong-front-2
sudo systemctl restart moremong-api-1
sudo journalctl -u moremong-api-1 -f

# === Docker 관리 ===
cd /opt/moremong/docker
docker compose ps
docker compose logs -f
docker compose restart postgresql

# === Nginx 관리 ===
sudo nginx -t
sudo nginx -s reload
sudo systemctl restart nginx
sudo tail -f /var/log/nginx/access.log

# === 백업 ===
/opt/moremong/backup-db.sh
ls -lh /opt/moremong/backups/

# === 배포 ===
/opt/moremong/deploy-all.sh v1.0.2

# === 모니터링 ===
/opt/moremong/health-check.sh
htop
docker stats

추가 리소스

공식 문서

보안 체크리스트

OCI 보안 목록 최소 권한 원칙
SSH 키 기반 인증 사용
방화벽 규칙 정기 검토
SSL/TLS 최신 버전 유지
정기 보안 업데이트
강력한 비밀번호 정책
로그 모니터링 및 감사

작성일: 2025-11-16
버전: 2.0
작성자: DevOps Team

Twitter Facebook LinkedIn

moregorenine

Oracle Cloud Ubuntu 프로덕션 배포 가이드

아키텍처 개요

1단계: OCI 인스턴스 설정

컴퓨트 인스턴스 생성

OCI 보안 목록 규칙 (인그레스)

2단계: 초기 Ubuntu 설정

인스턴스 SSH 접속

시스템 업데이트

Swap 메모리 설정 (OOM 방지)

필수 패키지 설치

Node.js 22.x 설치

Java 17 설치

Docker & Docker Compose 설치

3단계: 방화벽 설정 (Ubuntu UFW)

UFW 기본 정책 설정

필수 포트 허용

UFW 활성화

방화벽 확인

4단계: Nginx 설치 및 기본 설정

Nginx 설치

5단계: PostgreSQL & Redis 설정 (Docker)

디렉토리 구조 생성

Docker Compose 파일 생성

환경 변수 파일 생성

Docker 서비스 시작

PostgreSQL 초기 설정 확인

6단계: 애플리케이션 파일 배포

방법 1: Git Clone

방법 2: SCP 업로드

방법 3: rsync (증분 업데이트)

7단계: 백엔드 빌드 & 배포

프로덕션 환경 파일 생성

JAR 빌드

첫 배포

Systemd 서비스 생성

8단계: 프론트엔드 빌드 & 배포

프로덕션 환경 파일 생성

SvelteKit 설정 확인

빌드 (worklog)

🚨 일반적인 빌드 오류 해결

Systemd 서비스 생성

추가 프론트엔드 인스턴스 (필요시)

9단계: SSL 인증서 발급 (Let’s Encrypt)

Certbot 설치

SSL 인증서 발급

자동 갱신 설정

갱신 후 Nginx 리로드 설정

10단계: Nginx 설정

Nginx 메인 설정 파일

Nginx 설정 테스트

11단계: 모든 서비스 시작

Systemd 데몬 리로드

백엔드 서비스 시작

프론트엔드 서비스 시작

Nginx 시작

전체 서비스 확인

12단계: OAuth 제공자 설정

Google Cloud Console

Kakao Developers

Naver Developers

백엔드 application.yml 확인

13단계: 보안 강화

1. Fail2ban 설정

2. SSH 강화

3. 자동 보안 업데이트

4. 파일 권한 강화

5. 감사 로깅 (Auditd)

6. 로그 로테이션

7. 불필요한 서비스 비활성화

8. Ubuntu 시스템 튜닝 (운영 안정성 향상)

파일 핸들 제한 확장

Sysctl 네트워크 및 파일 시스템 최적화

14단계: 모니터링 설정

1. Node Exporter 설치 (Prometheus용)

2. 로그 모니터링 도구

3. 헬스 체크 스크립트

4. 크론잡으로 정기 체크

15단계: 백업 전략

1. 데이터베이스 백업 스크립트