# deploy

**Repository Path**: smart-mip/deploy

## Basic Information

- **Project Name**: deploy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-13
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Smart-MIP Deploy

物联网系统部署配置仓库，包含 Docker 部署、本地二进制运行等多种部署方式。

## 📁 项目结构

```
deploy/
├── docker-compose.yml    # Docker Compose 主配置
├── .env                  # 环境变量配置
├── docker/               # Docker 相关配置
│   ├── mosquitto/        # MQTT Broker 配置
│   ├── service-api/      # API 服务 Dockerfile
│   ├── service-core/     # 核心服务 Dockerfile
│   ├── service-gateway/  # 网关服务 Dockerfile
│   └── service-ui/       # 前端服务 Dockerfile
├── scripts/              # 部署脚本
│   ├── start.sh          # 服务启动脚本
│   └── deploy.sh         # 生产部署脚本
├── config/               # 服务配置文件（运行时挂载）
│   ├── api/              # API 服务配置
│   ├── core/             # 核心服务配置
│   └── gateway/          # 网关服务配置
├── bin/                  # 本地运行的二进制文件
├── data/                 # 数据目录（运行时创建）
└── backup/               # 备份目录（运行时创建）
```

## 🚀 快速开始

### 方式一：Docker Compose 部署（推荐）

```bash
# 进入部署目录
cd deploy

# 启动所有服务
./scripts/start.sh start

# 查看服务状态
./scripts/start.sh status

# 查看日志
./scripts/start.sh logs

# 停止服务
./scripts/start.sh stop
```

### 方式二：本地二进制运行

```bash
# 进入部署目录
cd deploy

# 确保 bin 目录下有编译好的二进制文件
# api-service, data-service, gateway-service

# 启动服务
./scripts/start.sh local-start

# 停止服务
./scripts/start.sh local-stop
```

### 方式三：生产环境部署

```bash
# 完整部署（首次部署）
./scripts/deploy.sh deploy

# 健康检查
./scripts/deploy.sh health-check

# 备份数据
./scripts/deploy.sh backup

# 更新服务
./scripts/deploy.sh update
```

## 🌐 服务端口

| 服务 | 端口 | 说明 |
|------|------|------|
| service-api | 8080 | REST API |
| service-core | 8081 | 核心服务 |
| service-gateway | 8082 | 网关服务 |
| service-ui | 3001 | 前端界面 |
| mosquitto | 1883 | MQTT Broker |
| redis | 6379 | 缓存 |

## 🔧 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| ENV | production | 运行环境 |
| MQTT_BROKER | localhost | MQTT 地址 |
| MQTT_PORT | 1883 | MQTT 端口 |
| REDIS_HOST | localhost | Redis 地址 |
| REDIS_PORT | 6379 | Redis 端口 |
| LOG_LEVEL | info | 日志级别 |

## 📋 命令参考

### start.sh

| 命令 | 说明 |
|------|------|
| start | 启动所有服务（Docker模式） |
| stop | 停止所有服务（Docker模式） |
| restart | 重启所有服务（Docker模式） |
| status | 查看服务状态 |
| logs [service] | 查看日志 |
| local-start | 本地二进制启动 |
| local-stop | 停止本地服务 |
| build | 构建 Docker 镜像 |

### deploy.sh

| 命令 | 说明 |
|------|------|
| deploy | 完整部署 |
| update | 更新服务 |
| backup | 备份数据 |
| restore <file> | 恢复备份 |
| health-check | 健康检查 |

## 🐳 Docker 镜像说明

所有服务使用多阶段构建，最终镜像基于 Alpine，体积小且安全。

## 📝 注意事项

1. 首次启动前确保 Docker 和 Docker Compose 已安装
2. 本地运行需要提前编译好二进制文件
3. 数据目录会自动创建，建议定期备份
4. 生产环境建议配置反向代理和 SSL 证书