128 lines
2.1 KiB
Markdown
128 lines
2.1 KiB
Markdown
# 🔧 环境搭建指南
|
||
|
||
## 开发环境配置
|
||
|
||
### 1. 配置环境变量
|
||
|
||
```bash
|
||
# 复制环境变量模板
|
||
cp env.example .env
|
||
|
||
# 编辑环境变量（根据需要修改）
|
||
vim .env
|
||
```
|
||
|
||
### 2. 启动基础服务
|
||
|
||
```bash
|
||
# 启动 PostgreSQL 和 Redis
|
||
docker-compose -f docker-compose.dev.yml up -d postgres redis
|
||
|
||
# 查看服务状态
|
||
docker-compose -f docker-compose.dev.yml ps
|
||
```
|
||
|
||
### 3. 数据库初始化
|
||
|
||
```bash
|
||
# 创建数据库表
|
||
make migrate
|
||
|
||
# 或手动执行SQL
|
||
psql -h localhost -U postgres -d tyapi_dev -f scripts/init.sql
|
||
```
|
||
|
||
### 4. 依赖安装
|
||
|
||
```bash
|
||
# 安装Go依赖
|
||
go mod download
|
||
|
||
# 验证依赖
|
||
go mod verify
|
||
```
|
||
|
||
## 生产环境配置
|
||
|
||
### 1. 配置文件准备
|
||
|
||
```bash
|
||
# 复制生产配置模板
|
||
cp config.prod.yaml config.yaml
|
||
|
||
# 修改生产配置
|
||
vim config.yaml
|
||
```
|
||
|
||
### 2. 环境变量设置
|
||
|
||
```bash
|
||
export APP_ENV=production
|
||
export DB_HOST=your-db-host
|
||
export DB_PASSWORD=your-secure-password
|
||
export JWT_SECRET=your-jwt-secret
|
||
export REDIS_HOST=your-redis-host
|
||
```
|
||
|
||
## 服务配置说明
|
||
|
||
### PostgreSQL 配置
|
||
|
||
默认配置：
|
||
|
||
- 端口：5432
|
||
- 数据库：tyapi_dev
|
||
- 用户名：postgres
|
||
- 密码：Pg9mX4kL8nW2rT5y（开发环境）
|
||
|
||
### Redis 配置
|
||
|
||
默认配置：
|
||
|
||
- 端口：6379
|
||
- 无密码（开发环境）
|
||
- 数据库：0
|
||
|
||
### 监控服务配置
|
||
|
||
- **Prometheus**: http://localhost:9090
|
||
- **Grafana**: http://localhost:3000 (admin/Gf7nB3xM9cV6pQ2w)
|
||
- **Jaeger**: http://localhost:16686
|
||
|
||
### 存储服务配置
|
||
|
||
- **MinIO**: http://localhost:9000 (minioadmin/Mn5oH8yK3bR7vX1z)
|
||
- **对象存储控制台**: http://localhost:9001
|
||
|
||
## 常见配置问题
|
||
|
||
### 端口冲突
|
||
|
||
如果遇到端口冲突，可以修改 `docker-compose.dev.yml` 中的端口映射：
|
||
|
||
```yaml
|
||
ports:
|
||
- "15432:5432" # 将 PostgreSQL 映射到本地 15432 端口
|
||
```
|
||
|
||
### 权限问题
|
||
|
||
在 Linux/macOS 系统中，可能需要调整文件权限：
|
||
|
||
```bash
|
||
# 给予脚本执行权限
|
||
chmod +x scripts/*.sh
|
||
|
||
# 修复数据目录权限
|
||
sudo chown -R $(whoami) ./data/
|
||
```
|
||
|
||
### 内存不足
|
||
|
||
如果系统内存不足，可以减少启动的服务：
|
||
|
||
```bash
|
||
# 只启动核心服务
|
||
docker-compose -f docker-compose.dev.yml up -d postgres redis
|
||
```
|