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

70
.dockerignore Normal file
View File

@@ -0,0 +1,70 @@
# Dependencies
node_modules
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# Next.js
.next/
out/
build/
# Production
dist/
# Environment variables
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
# Logs
logs
*.log
# Misc
.DS_Store
*.pem
# Vercel
.vercel
# TypeScript
*.tsbuildinfo
next-env.d.ts
# Git
.git
.gitignore
# Docker
Dockerfile*
docker-compose*
.dockerignore
# Documentation
README.md
*.md
# Scripts
scripts/
deploy/
# Coverage
coverage/
.nyc_output/
# IDE
.vscode/
.idea/
*.swp
*.swo
*~
# OS
.DS_Store
Thumbs.db
# Trunk
.trunk

77
.github/workflows/build.yml vendored Normal file
View File

@@ -0,0 +1,77 @@
name: Build Docker Image
on:
push:
branches: [main]
tags:
- 'v*'
workflow_dispatch:
env:
REGISTRY: ghcr.io
IMAGE_NAME: ${{ github.repository }}
jobs:
build-and-push:
runs-on: ubuntu-latest
permissions:
contents: read
packages: write
outputs:
image-tag: ${{ steps.meta.outputs.tags }}
image-digest: ${{ steps.build.outputs.digest }}
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
- name: Log in to GitHub Container Registry
uses: docker/login-action@v3
with:
registry: ${{ env.REGISTRY }}
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
- name: Lowercase repository name
id: lowercase
run: |
echo "repo=$(echo ${{ github.repository }} | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
- name: Extract metadata (tags, labels)
id: meta
uses: docker/metadata-action@v5
with:
images: ${{ env.REGISTRY }}/${{ steps.lowercase.outputs.repo }}
tags: |
type=ref,event=branch
type=ref,event=pr
type=semver,pattern={{version}}
type=semver,pattern={{major}}.{{minor}}
type=sha,prefix={{branch}}-
type=raw,value=latest,enable={{is_default_branch}}
- name: Build and push Docker image
id: build
uses: docker/build-push-action@v5
with:
context: ./services/nextjs
file: ./deploy/docker/Dockerfile.prod
push: true
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
cache-from: type=gha
cache-to: type=gha,mode=max
- name: Display image information
run: |
echo "✅ Image built and pushed successfully!"
echo "📦 Image tags:"
echo "${{ steps.meta.outputs.tags }}"
echo "🔖 Digest: ${{ steps.build.outputs.digest }}"
echo ""
echo "🚀 ArgoCD will automatically detect and deploy this new image"
echo " Monitor deployment at your ArgoCD dashboard"

45
.github/workflows/ci.yml vendored Normal file
View File

@@ -0,0 +1,45 @@
name: CI
on:
push:
branches: [main, develop]
pull_request:
branches: [main, develop]
jobs:
lint-and-build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
cache-dependency-path: services/nextjs/package-lock.json
- name: Install dependencies
working-directory: services/nextjs
run: npm ci
- name: Run ESLint
working-directory: services/nextjs
run: npm run lint
- name: Build Next.js application
working-directory: services/nextjs
run: npm run build
env:
NEXT_TELEMETRY_DISABLED: 1
- name: Check build output
working-directory: services/nextjs
run: |
if [ ! -d ".next" ]; then
echo "Build failed: .next directory not found"
exit 1
fi
echo "✅ Build completed successfully"

52
.gitignore vendored Normal file
View File

@@ -0,0 +1,52 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
# dependencies
node_modules
services/nextjs/node_modules
services/nextjs/.pnp
services/nextjs/.pnp.js
services/nextjs/.yarn/install-state.gz
# testing
services/nextjs/coverage
# next.js
services/nextjs/.next/
services/nextjs/out/
# production
services/nextjs/build
# misc
.DS_Store
*.pem
# debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*
# env files
.env*
!.env.example
# vercel
.vercel
# typescript
*.tsbuildinfo
next-env.d.ts
# IDE
.vscode
.idea
*.swp
*.swo
*~
# OS
Thumbs.db
# trunk
.trunk

View File

@@ -0,0 +1,38 @@
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: portfolio
namespace: argocd
finalizers:
- resources-finalizer.argocd.argoproj.io
spec:
project: default
source:
repoURL: https://github.com/Mayne0213/portfolio.git
targetRevision: main
path: deploy/k8s/overlays/prod
destination:
server: https://kubernetes.default.svc
namespace: portfolio
syncPolicy:
automated:
prune: true # 매니페스트에서 제거된 리소스 자동 삭제
selfHeal: true # 클러스터에서 수동 변경 시 자동 복구
allowEmpty: false
syncOptions:
- CreateNamespace=true # namespace가 없으면 자동 생성
- PrunePropagationPolicy=foreground
- PruneLast=true
retry:
limit: 5
backoff:
duration: 5s
factor: 2
maxDuration: 3m
revisionHistoryLimit: 10

View File

@@ -0,0 +1,26 @@
# Development Dockerfile for Portfolio Next.js application
FROM node:20-alpine AS base
# Install dependencies for development
RUN apk add --no-cache libc6-compat curl
WORKDIR /app
# Copy package files
COPY package.json package-lock.json* ./
# Install all dependencies (including dev dependencies)
RUN npm ci
# Copy source code
COPY . .
# Expose port
EXPOSE 3000
# Health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD curl -f http://localhost:3000 || exit 1
# Default command (can be overridden in docker-compose)
CMD ["npm", "run", "dev"]

View File

@@ -0,0 +1,56 @@
# Multi-stage build for Portfolio Next.js application
FROM node:20-alpine AS base
# Install dependencies only when needed
FROM base AS deps
# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
RUN apk add --no-cache libc6-compat curl
WORKDIR /app
# Install dependencies based on the preferred package manager
COPY package.json package-lock.json* ./
RUN npm ci
# Rebuild the source code only when needed
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
# Build the application
ENV NEXT_TELEMETRY_DISABLED=1
RUN npm run build
# Production image, copy all the files and run next
FROM base AS runner
WORKDIR /app
RUN apk add --no-cache curl
ENV NODE_ENV=production
ENV NEXT_TELEMETRY_DISABLED=1
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs
# Set the correct permission for prerender cache
RUN mkdir .next
RUN chown nextjs:nodejs .next
# Automatically leverage output traces to reduce image size
# https://nextjs.org/docs/advanced-features/output-file-tracing
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
USER nextjs
EXPOSE 3000
ENV PORT=3000
ENV HOSTNAME=0.0.0.0
# Health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD curl -f http://localhost:3000 || exit 1
CMD ["node", "server.js"]

View File

@@ -0,0 +1,27 @@
services:
# Development Portfolio Next.js Application
app:
build:
context: ../../services/nextjs
dockerfile: ../../deploy/docker/Dockerfile.dev
container_name: portfolio-app-dev
restart: unless-stopped
labels:
kompose.namespace: portfolio
ports:
- 3005:3000
environment:
- NODE_ENV=development
- WATCHPACK_POLLING=true
networks:
- portfolio-network
volumes:
- ../../services/nextjs:/app
- /app/node_modules
- /app/.next
command: npm run dev
networks:
portfolio-network:
driver: bridge
name: portfolio-network-dev

View File

@@ -0,0 +1,22 @@
services:
# Production Portfolio Next.js Application
app:
image: portfolio-app
build:
context: ../../services/nextjs
dockerfile: ../../deploy/docker/Dockerfile.prod
container_name: portfolio-app-prod
restart: unless-stopped
labels:
kompose.namespace: portfolio
ports:
- 3005:3000
environment:
- NODE_ENV=production
networks:
- portfolio-network
networks:
portfolio-network:
driver: bridge
name: portfolio-network-prod

View File

@@ -0,0 +1,51 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: portfolio-app
labels:
app: portfolio-app
spec:
replicas: 1
selector:
matchLabels:
app: portfolio-app
strategy:
type: RollingUpdate
rollingUpdate:
maxUnavailable: 1
maxSurge: 1
template:
metadata:
labels:
app: portfolio-app
spec:
containers:
- name: portfolio-app
image: ghcr.io/mayne0213/portfolio:latest
imagePullPolicy: Always
ports:
- containerPort: 3000
protocol: TCP
env:
- name: NODE_ENV
value: production
resources:
requests:
memory: "100Mi"
cpu: "50m"
limits:
memory: "200Mi"
cpu: "150m"
livenessProbe:
httpGet:
path: /
port: 3000
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /
port: 3000
initialDelaySeconds: 5
periodSeconds: 5
restartPolicy: Always

View File

@@ -0,0 +1,14 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- deployment.yaml
- service.yaml
commonLabels:
app.kubernetes.io/name: portfolio
app.kubernetes.io/component: web
images:
- name: ghcr.io/mayne0213/portfolio
newTag: latest

View File

@@ -0,0 +1,15 @@
apiVersion: v1
kind: Service
metadata:
name: portfolio-service
labels:
app: portfolio-app
spec:
type: ClusterIP
ports:
- name: http
port: 80
targetPort: 3000
protocol: TCP
selector:
app: portfolio-app

View File

@@ -0,0 +1,19 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: portfolio-app
labels:
environment: production
spec:
replicas: 1
template:
spec:
containers:
- name: portfolio-app
resources:
requests:
memory: "100Mi"
cpu: "50m"
limits:
memory: "200Mi"
cpu: "150m"

View File

@@ -0,0 +1,18 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: portfolio
resources:
- ../../base
commonLabels:
environment: production
# 이미지 태그 설정
images:
- name: ghcr.io/mayne0213/portfolio
newTag: latest
patchesStrategicMerge:
- deployment-patch.yaml

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' 스크립트를 실행하여 재빌드하세요!"

1
services/nextjs Submodule

Submodule services/nextjs added at 527de6b0f3