digital-archive/server

Fork 0

Files

aipper 20e8d3b342 test

2025-11-01 15:36:47 +08:00

4.0 KiB

Raw Blame History

数字档案系统脚本使用说明

统一管理脚本

所有功能已合并到 archive-manager.sh 一个脚本中，提供完整的系统管理功能。

基本用法

# 显示帮助
./archive-manager.sh -h

# 构建镜像
./archive-manager.sh build

# 部署应用（默认目录）
./archive-manager.sh deploy

# 部署到指定目录
./archive-manager.sh deploy /opt/digital-archive

# 检查环境
./archive-manager.sh check

# 启动服务
./archive-manager.sh start

# 停止服务
./archive-manager.sh stop

# 重启服务
./archive-manager.sh restart

# 查看日志
./archive-manager.sh logs
./archive-manager.sh logs -f  # 实时日志

# 查看状态
./archive-manager.sh status

# 更新服务
./archive-manager.sh update

# 清理资源
./archive-manager.sh clean

高级选项

# 详细输出
./archive-manager.sh -v build

# 强制执行（跳过确认）
./archive-manager.sh -f deploy

# 静默模式
./archive-manager.sh -q build

功能特性

1. 统一管理

一个脚本管理所有功能
自动检测Docker Compose版本
统一的日志和错误处理
彩色的输出显示

2. 环境检查

检查Docker环境
验证proxy网络
检查必需容器（MySQL、Redis、Elasticsearch）
测试网络连通性

3. 智能部署

自动创建部署目录结构
生成环境配置文件
创建管理脚本
设置正确的权限

4. 服务管理

启动/停止/重启服务
查看日志和状态
更新服务（拉取最新镜像）
清理Docker资源

5. 优化配置

使用容错Dockerfile（Dockerfile.robust）
Maven国内镜像加速
Alpine包管理器国内镜像
多镜像源容错机制

部署目录结构

/root/server/archive/
├── docker-compose.yml          # 服务编排文件
├── .env                        # 环境变量配置
├── start.sh                    # 启动脚本
├── stop.sh                     # 停止脚本
├── update.sh                   # 更新脚本
├── data/                       # 数据目录
│   ├── upload/
│   ├── temp/
│   ├── unzip/
│   ├── images/
│   ├── reports/
│   └── elasticsearch/
└── logs/                       # 日志目录

环境要求

必需服务

Docker和Docker Compose
proxy网络：docker network create proxy
MySQL容器（连接到proxy网络）
Redis容器（连接到proxy网络）

可选服务

Elasticsearch容器（连接到proxy网络）

故障排除

构建失败

# 检查Docker环境
./archive-manager.sh -v check

# 重新构建
./archive-manager.sh clean
./archive-manager.sh build

服务启动失败

# 查看详细日志
./archive-manager.sh logs -f

# 检查服务状态
./archive-manager.sh status

# 重启服务
./archive-manager.sh restart

网络问题

# 检查网络配置
docker network ls
docker network inspect proxy

# 测试连通性
docker run --rm --network proxy alpine ping mysql

配置文件说明

settings.xml

Maven配置文件，包含：

多个国内镜像源
仓库和插件仓库配置
代理设置（可选）

Dockerfile.robust

优化的Dockerfile，包含：

多段构建
Alpine国内镜像源
容错机制
安全配置

docker-compose.simple.yml

简化的服务编排文件，包含：

应用服务配置
Elasticsearch服务
网络配置

最佳实践

首次部署

./archive-manager.sh check
./archive-manager.sh build
./archive-manager.sh deploy
./archive-manager.sh start

日常维护

./archive-manager.sh status    # 检查状态
./archive-manager.sh logs -f    # 查看日志
./archive-manager.sh update    # 更新服务

问题排查

./archive-manager.sh -v status   # 详细状态信息
./archive-manager.sh clean     # 清理资源
./archive-manager.sh rebuild   # 重新构建

现在你只需要一个 archive-manager.sh 脚本就能完成所有管理任务！

4.0 KiB Raw Blame History Unescape Escape