chore: Add Docker deployment config for admin-web
Add complete deployment toolchain for the Genex Admin Web (React + Next.js), mirroring the proven deployment pattern from the rwadurian project. ## Files added ### deploy.sh — One-click deployment script - Commands: build / start / stop / restart / logs / status / clean - Auto-detects `docker compose` vs `docker-compose` - Port conflict detection with auto-stop of old service - Health check verification after startup - Supports PORT env override (default: 3000) ### Dockerfile — Multi-stage production build - Stage 1 (deps): node:20-alpine, npm ci for deterministic installs - Stage 2 (builder): Next.js production build with telemetry disabled - Stage 3 (runner): Minimal runtime with standalone output - Non-root user (nextjs:nodejs) for security - curl installed for container health checks ### docker-compose.yml — Container orchestration - Service: genex-admin-web on genex-network bridge - Health check: GET /api/health every 30s, 3 retries - Auto-restart: unless-stopped policy - Timezone: Asia/Shanghai ### .env.development — Local dev environment - API: http://localhost:8080/api ### .env.production — Production environment - API: https://api.gogenex.com/api Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
e450bef7cd
commit
bae342f1bd
|
|
@ -0,0 +1,6 @@
|
|||
# API Configuration
|
||||
NEXT_PUBLIC_API_BASE_URL=http://localhost:8080/api
|
||||
|
||||
# Application Info
|
||||
NEXT_PUBLIC_APP_NAME=Genex Admin
|
||||
NEXT_PUBLIC_VERSION=1.0.0-dev
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
# API Configuration
|
||||
NEXT_PUBLIC_API_BASE_URL=https://api.gogenex.com/api
|
||||
|
||||
# Application Info
|
||||
NEXT_PUBLIC_APP_NAME=Genex Admin
|
||||
NEXT_PUBLIC_VERSION=1.0.0
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
# 阶段1: 依赖安装
|
||||
FROM node:20-alpine AS deps
|
||||
RUN apk add --no-cache libc6-compat
|
||||
WORKDIR /app
|
||||
|
||||
# 复制依赖文件
|
||||
COPY package.json package-lock.json ./
|
||||
|
||||
# 安装依赖
|
||||
RUN npm ci --only=production=false
|
||||
|
||||
# 阶段2: 构建
|
||||
FROM node:20-alpine AS builder
|
||||
WORKDIR /app
|
||||
|
||||
# 复制依赖
|
||||
COPY --from=deps /app/node_modules ./node_modules
|
||||
COPY . .
|
||||
|
||||
# 设置环境变量
|
||||
ENV NEXT_TELEMETRY_DISABLED=1
|
||||
ENV NODE_ENV=production
|
||||
|
||||
# 构建应用
|
||||
RUN npm run build
|
||||
|
||||
# 阶段3: 生产运行
|
||||
FROM node:20-alpine AS runner
|
||||
WORKDIR /app
|
||||
|
||||
ENV NODE_ENV=production
|
||||
ENV NEXT_TELEMETRY_DISABLED=1
|
||||
|
||||
# 安装 curl 用于健康检查
|
||||
RUN apk add --no-cache curl
|
||||
|
||||
# 创建非 root 用户
|
||||
RUN addgroup --system --gid 1001 nodejs
|
||||
RUN adduser --system --uid 1001 nextjs
|
||||
|
||||
# 复制构建产物
|
||||
COPY --from=builder /app/public ./public
|
||||
COPY --from=builder /app/.next/standalone ./
|
||||
COPY --from=builder /app/.next/static ./.next/static
|
||||
|
||||
# 设置权限
|
||||
USER nextjs
|
||||
|
||||
# 暴露端口
|
||||
EXPOSE 3000
|
||||
|
||||
ENV PORT=3000
|
||||
ENV HOSTNAME="0.0.0.0"
|
||||
|
||||
# 启动应用
|
||||
CMD ["node", "server.js"]
|
||||
|
|
@ -0,0 +1,218 @@
|
|||
#!/bin/bash
|
||||
|
||||
# Genex Admin Web 一键部署脚本
|
||||
# 使用方法: ./deploy.sh [命令]
|
||||
# 命令:
|
||||
# build - 仅构建镜像
|
||||
# start - 构建并启动服务
|
||||
# stop - 停止服务
|
||||
# restart - 重启服务
|
||||
# logs - 查看日志
|
||||
# status - 查看服务状态
|
||||
# clean - 清理容器和镜像
|
||||
|
||||
set -e
|
||||
|
||||
# 颜色定义
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
# 项目信息
|
||||
PROJECT_NAME="genex-admin-web"
|
||||
IMAGE_NAME="genex-admin-web"
|
||||
CONTAINER_NAME="genex-admin-web"
|
||||
DEFAULT_PORT=3000
|
||||
|
||||
# 日志函数
|
||||
log_info() {
|
||||
echo -e "${BLUE}[INFO]${NC} $1"
|
||||
}
|
||||
|
||||
log_success() {
|
||||
echo -e "${GREEN}[SUCCESS]${NC} $1"
|
||||
}
|
||||
|
||||
log_warn() {
|
||||
echo -e "${YELLOW}[WARN]${NC} $1"
|
||||
}
|
||||
|
||||
log_error() {
|
||||
echo -e "${RED}[ERROR]${NC} $1"
|
||||
}
|
||||
|
||||
# 检查 Docker 是否安装
|
||||
check_docker() {
|
||||
if ! command -v docker &> /dev/null; then
|
||||
log_error "Docker 未安装，请先安装 Docker"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! docker info &> /dev/null; then
|
||||
log_error "Docker 服务未运行，请启动 Docker"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
log_success "Docker 检查通过"
|
||||
}
|
||||
|
||||
# 检查 Docker Compose 是否安装
|
||||
check_docker_compose() {
|
||||
if docker compose version &> /dev/null; then
|
||||
COMPOSE_CMD="docker compose"
|
||||
elif command -v docker-compose &> /dev/null; then
|
||||
COMPOSE_CMD="docker-compose"
|
||||
else
|
||||
log_error "Docker Compose 未安装"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
log_success "Docker Compose 检查通过 ($COMPOSE_CMD)"
|
||||
}
|
||||
|
||||
# 构建镜像
|
||||
build() {
|
||||
log_info "开始构建 Docker 镜像..."
|
||||
$COMPOSE_CMD build --no-cache
|
||||
log_success "镜像构建完成"
|
||||
}
|
||||
|
||||
# 启动服务
|
||||
start() {
|
||||
log_info "开始部署 Genex Admin Web..."
|
||||
|
||||
# 检查端口是否被占用
|
||||
PORT=${PORT:-$DEFAULT_PORT}
|
||||
if lsof -Pi :$PORT -sTCP:LISTEN -t >/dev/null 2>&1; then
|
||||
log_warn "端口 $PORT 已被占用，尝试停止旧服务..."
|
||||
stop
|
||||
fi
|
||||
|
||||
# 构建并启动
|
||||
$COMPOSE_CMD up -d --build
|
||||
|
||||
# 等待服务启动
|
||||
log_info "等待服务启动..."
|
||||
sleep 5
|
||||
|
||||
# 检查服务状态
|
||||
if docker ps | grep -q $CONTAINER_NAME; then
|
||||
log_success "服务部署成功!"
|
||||
log_info "访问地址: http://localhost:$PORT"
|
||||
log_info "健康检查: http://localhost:$PORT/api/health"
|
||||
else
|
||||
log_error "服务启动失败，请查看日志: ./deploy.sh logs"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# 停止服务
|
||||
stop() {
|
||||
log_info "停止服务..."
|
||||
$COMPOSE_CMD down
|
||||
log_success "服务已停止"
|
||||
}
|
||||
|
||||
# 重启服务
|
||||
restart() {
|
||||
log_info "重启服务..."
|
||||
stop
|
||||
start
|
||||
}
|
||||
|
||||
# 查看日志
|
||||
logs() {
|
||||
$COMPOSE_CMD logs -f
|
||||
}
|
||||
|
||||
# 清理
|
||||
clean() {
|
||||
log_info "清理容器和镜像..."
|
||||
|
||||
# 停止并删除容器
|
||||
$COMPOSE_CMD down --rmi local --volumes --remove-orphans
|
||||
|
||||
# 删除悬空镜像
|
||||
docker image prune -f
|
||||
|
||||
log_success "清理完成"
|
||||
}
|
||||
|
||||
# 显示状态
|
||||
status() {
|
||||
log_info "服务状态:"
|
||||
docker ps -a --filter "name=$CONTAINER_NAME" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
|
||||
}
|
||||
|
||||
# 显示帮助
|
||||
show_help() {
|
||||
echo ""
|
||||
echo "Genex Admin Web 部署脚本"
|
||||
echo ""
|
||||
echo "使用方法: ./deploy.sh [命令]"
|
||||
echo ""
|
||||
echo "命令:"
|
||||
echo " build 仅构建 Docker 镜像"
|
||||
echo " start 构建并启动服务 (默认)"
|
||||
echo " stop 停止服务"
|
||||
echo " restart 重启服务"
|
||||
echo " logs 查看服务日志"
|
||||
echo " status 查看服务状态"
|
||||
echo " clean 清理容器和镜像"
|
||||
echo " help 显示此帮助信息"
|
||||
echo ""
|
||||
echo "环境变量:"
|
||||
echo " PORT 服务端口 (默认: 3000)"
|
||||
echo ""
|
||||
echo "示例:"
|
||||
echo " ./deploy.sh start # 默认端口 3000 启动"
|
||||
echo " PORT=8080 ./deploy.sh start # 指定端口 8080 启动"
|
||||
echo ""
|
||||
}
|
||||
|
||||
# 主函数
|
||||
main() {
|
||||
# 切换到脚本所在目录
|
||||
cd "$(dirname "$0")"
|
||||
|
||||
# 检查环境
|
||||
check_docker
|
||||
check_docker_compose
|
||||
|
||||
# 执行命令
|
||||
case "${1:-start}" in
|
||||
build)
|
||||
build
|
||||
;;
|
||||
start)
|
||||
start
|
||||
;;
|
||||
stop)
|
||||
stop
|
||||
;;
|
||||
restart)
|
||||
restart
|
||||
;;
|
||||
logs)
|
||||
logs
|
||||
;;
|
||||
status)
|
||||
status
|
||||
;;
|
||||
clean)
|
||||
clean
|
||||
;;
|
||||
help|--help|-h)
|
||||
show_help
|
||||
;;
|
||||
*)
|
||||
log_error "未知命令: $1"
|
||||
show_help
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
main "$@"
|
||||
|
|
@ -0,0 +1,26 @@
|
|||
services:
|
||||
admin-web:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile
|
||||
image: genex-admin-web:latest
|
||||
container_name: genex-admin-web
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "${PORT:-3000}:3000"
|
||||
environment:
|
||||
- TZ=Asia/Shanghai
|
||||
- NODE_ENV=production
|
||||
- NEXT_TELEMETRY_DISABLED=1
|
||||
healthcheck:
|
||||
test: ["CMD", "curl", "-f", "http://localhost:3000/api/health"]
|
||||
interval: 30s
|
||||
timeout: 3s
|
||||
retries: 3
|
||||
start_period: 40s
|
||||
networks:
|
||||
- genex-network
|
||||
|
||||
networks:
|
||||
genex-network:
|
||||
driver: bridge
|
||||
Loading…
Reference in New Issue