INIT(deploy): portfolio project setup

Add complete portfolio project including:
- Next.js application in services/nextjs
- Docker configurations for dev and prod
- Kubernetes deployment manifests with kustomize
- ArgoCD application configuration
- GitHub Actions workflow for automated builds
This commit is contained in:
2025-11-23 23:40:15 +09:00
commit 95584b666a
18 changed files with 835 additions and 0 deletions

173
scripts/common.sh Executable file
View File

@@ -0,0 +1,173 @@
#!/bin/bash
# Portfolio 스크립트 공통 유틸리티 함수들
# 모든 Portfolio 스크립트에서 사용할 수 있는 공통 기능들을 정의
set -e
# shopt -s inherit_errexit
# 공통 스크립트의 절대 경로 기반 디렉토리 상수
# 함수 호출 컨텍스트에 따라 BASH_SOURCE 해석이 달라질 수 있으므로
# 로드 시점에 고정해 신뢰 가능한 루트를 계산한다
PORTFOLIO_SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PORTFOLIO_ROOT="$(dirname "${PORTFOLIO_SCRIPTS_DIR}")"
# 색상 정의
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# 로깅 함수들
log_info() {
echo -e "${GREEN}[INFO]${NC} ${1}"
}
log_warn() {
echo -e "${YELLOW}[WARN]${NC} ${1}"
}
log_error() {
echo -e "${RED}[ERROR]${NC} ${1}"
}
log_debug() {
echo -e "${BLUE}[DEBUG]${NC} ${1}"
}
# 경로 계산 함수
get_portfolio_root() {
# 로드 시점에 고정된 루트 경로 반환
echo "${PORTFOLIO_ROOT}"
}
get_mayne_root() {
# portfolio 루트를 기준으로 mayne 루트 경로 계산
local portfolio_root
portfolio_root="$(get_portfolio_root)"
dirname "$(dirname "${portfolio_root}")"
}
# 확인 함수
confirm_action() {
local message="${1}"
local default="${2:-N}"
if [[ "${default}" == "Y" ]]; then
read -p "${message} (Y/n): " -n 1 -r
echo
if [[ ${REPLY} =~ ^[Nn]$ ]]; then
return 1
fi
return 0
else
read -p "${message} (y/N): " -n 1 -r
echo
if [[ ${REPLY} =~ ^[Yy]$ ]]; then
return 0
fi
return 1
fi
}
# 필수 디렉토리 확인
check_required_dirs() {
local portfolio_root
portfolio_root="$(get_portfolio_root)"
local dirs=("${@}")
for dir in "${dirs[@]}"; do
if [[ ! -d "${portfolio_root}/${dir}" ]]; then
log_error "필수 디렉토리가 없습니다: ${dir}"
exit 1
fi
done
}
# 필수 파일 확인
check_required_files() {
local portfolio_root
portfolio_root="$(get_portfolio_root)"
local files=("${@}")
for file in "${files[@]}"; do
if [[ ! -f "${portfolio_root}/${file}" ]]; then
log_error "필수 파일이 없습니다: ${file}"
exit 1
fi
done
}
# Docker 관련 유틸리티
docker_cleanup_portfolio() {
log_info "Portfolio 관련 Docker 리소스 정리 중..."
# 컨테이너 중지 및 삭제
docker-compose -p portfolio -f deploy/docker/docker-compose.yml down --remove-orphans 2>/dev/null || true
docker-compose -p portfolio -f deploy/docker/docker-compose.dev.yml down --remove-orphans 2>/dev/null || true
docker ps -aq --filter "name=portfolio" | xargs -r docker rm -f 2>/dev/null || true
# 이미지 삭제
docker images --filter "reference=portfolio*" -q | xargs -r docker rmi -f 2>/dev/null || true
docker images --filter "reference=*portfolio*" -q | xargs -r docker rmi -f 2>/dev/null || true
# 볼륨 삭제
docker volume ls -q --filter "name=portfolio" | xargs -r docker volume rm -f 2>/dev/null || true
# 시스템 정리
docker system prune -f
log_info "Docker 리소스 정리 완료"
}
# 환경 변수 로드
load_env_file() {
local portfolio_root
portfolio_root="$(get_portfolio_root)"
local env_file="${portfolio_root}/.env"
if [[ -f "${env_file}" ]]; then
log_info "환경 변수 파일 로드: ${env_file}"
# shellcheck source=/dev/null
source "${env_file}"
return 0
else
log_warn "환경 변수 파일이 없습니다: ${env_file}"
return 1
fi
}
# 에러 처리
handle_error() {
local exit_code=$?
log_error "스크립트 실행 중 오류가 발생했습니다 (종료 코드: ${exit_code})"
exit "${exit_code}"
}
# 스크립트 시작 시 공통 설정
setup_script() {
# 에러 발생 시 자동으로 handle_error 함수 호출
trap handle_error ERR
# 스크립트 디렉토리로 이동
local portfolio_root
portfolio_root="$(get_portfolio_root)"
cd "${portfolio_root}"
log_info "스크립트 시작: $(basename "${BASH_SOURCE[1]}")"
}
# 스크립트 종료 시 정리
cleanup_script() {
local exit_code=$?
if [[ "${exit_code}" -eq 0 ]]; then
log_info "스크립트 완료: $(basename "${BASH_SOURCE[1]}")"
else
log_error "스크립트 실패: $(basename "${BASH_SOURCE[1]}") (종료 코드: ${exit_code})"
fi
exit "${exit_code}"
}
# 스크립트 종료 시 정리 함수 등록
trap cleanup_script EXIT

93
scripts/docker-build.sh Executable file
View File

@@ -0,0 +1,93 @@
#!/bin/bash
# Portfolio Docker 빌드 및 실행 스크립트
# 공통 유틸리티 함수 로드
source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
# 스크립트 설정
setup_script
log_info "🚀 Portfolio Docker 빌드 및 실행 시작..."
# 필수 디렉토리 및 파일 확인
log_info "📁 폴더 구조 확인 중..."
check_required_dirs "services/nextjs" "deploy/docker"
log_info "📄 필수 파일 확인 중..."
check_required_files "deploy/docker/docker-compose.yml" "deploy/docker/docker-compose.dev.yml" "deploy/docker/Dockerfile.prod" "deploy/docker/Dockerfile.dev"
log_info "✅ 폴더 구조 및 필수 파일 확인 완료!"
# 환경 선택
echo ""
log_info "🎯 실행할 환경을 선택하세요:"
echo "1) 개발 환경 (Development)"
echo "2) 프로덕션 환경 (Production)"
echo "3) 빌드만 (Build Only)"
read -p "선택 (1-3): " -n 1 -r
echo
case ${REPLY} in
1)
log_info "🔧 개발 환경 빌드 및 실행 중..."
cd deploy/docker
docker-compose -p portfolio -f docker-compose.dev.yml build --no-cache
docker-compose -p portfolio -f docker-compose.dev.yml up -d
PORTFOLIO_ROOT=$(get_portfolio_root)
cd "${PORTFOLIO_ROOT}"
ENV_TYPE="development"
COMPOSE_FILE_PATH="deploy/docker/docker-compose.dev.yml"
;;
2)
log_info "🏭 프로덕션 환경 빌드 및 실행 중..."
cd deploy/docker
docker-compose -p portfolio -f docker-compose.yml build --no-cache
docker-compose -p portfolio -f docker-compose.yml up -d
PORTFOLIO_ROOT=$(get_portfolio_root)
cd "${PORTFOLIO_ROOT}"
ENV_TYPE="production"
COMPOSE_FILE_PATH="deploy/docker/docker-compose.yml"
;;
3)
log_info "🔨 이미지 빌드만 실행 중..."
cd deploy/docker
log_info " - 개발 이미지 빌드 중..."
docker-compose -p portfolio -f docker-compose.dev.yml build --no-cache
log_info " - 프로덕션 이미지 빌드 중..."
docker-compose -p portfolio -f docker-compose.yml build --no-cache
PORTFOLIO_ROOT=$(get_portfolio_root)
cd "${PORTFOLIO_ROOT}"
log_info "✅ 빌드 완료! 실행하려면 다시 이 스크립트를 실행하고 환경을 선택하세요."
exit 0
;;
*)
log_error "잘못된 선택입니다."
exit 1
;;
esac
# 서비스 상태 확인
echo ""
log_info "⏳ 서비스 시작 대기 중..."
sleep 10
echo ""
log_info "📊 서비스 상태 확인:"
docker-compose -p portfolio -f "${COMPOSE_FILE_PATH}" ps
echo ""
log_info "🔍 컨테이너 로그 확인:"
echo " - 애플리케이션 로그: docker-compose -p portfolio -f ${COMPOSE_FILE_PATH} logs -f app"
echo ""
log_info "🌐 접속 URL:"
echo " - 애플리케이션: http://localhost:3005"
echo ""
log_info "✅ Docker 빌드 및 실행 완료!"
echo ""
log_info "📋 유용한 명령어:"
echo " - 서비스 중지: docker-compose -p portfolio -f ${COMPOSE_FILE_PATH} down"
echo " - 로그 확인: docker-compose -p portfolio -f ${COMPOSE_FILE_PATH} logs -f"
echo " - 서비스 재시작: docker-compose -p portfolio -f ${COMPOSE_FILE_PATH} restart"
echo ""

38
scripts/docker-cleanup.sh Executable file
View File

@@ -0,0 +1,38 @@
#!/bin/bash
# Portfolio Docker 리소스 정리 스크립트
# 공통 유틸리티 함수 로드
source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
# 스크립트 설정
setup_script
log_info "🧹 Portfolio Docker 리소스 정리 시작..."
# 현재 실행 중인 Portfolio 관련 컨테이너 확인
log_info "📋 현재 실행 중인 Portfolio 관련 컨테이너:"
docker ps -a --filter "name=portfolio" --format "table {{.Names}}\t{{.Status}}\t{{.Image}}"
echo ""
if confirm_action "⚠️ 모든 Portfolio 관련 컨테이너, 이미지, 볼륨을 삭제하시겠습니까?"; then
: # 계속 진행
else
log_info "작업이 취소되었습니다."
exit 0
fi
echo ""
log_info "🛑 컨테이너 중지 및 삭제 중..."
# Docker 정리 실행
docker_cleanup_portfolio
log_info "✅ 정리 완료!"
echo ""
log_info "📊 정리된 리소스:"
echo " - Portfolio 관련 컨테이너: 삭제됨"
echo " - Portfolio 관련 이미지: 삭제됨"
echo " - Portfolio 관련 볼륨: 삭제됨"
echo " - 사용하지 않는 Docker 리소스: 정리됨"
echo ""
log_info "🚀 이제 './scripts/docker-build.sh' 스크립트를 실행하여 재빌드하세요!"