329 lines
5.7 KiB
Markdown
329 lines
5.7 KiB
Markdown
# AWS EC2 价格计算器
|
||
|
||
这是一个基于Vue.js和Python FastAPI开发的AWS EC2价格计算器网站，可以帮助用户计算和比较不同EC2实例的价格。
|
||
|
||
## 功能特点
|
||
|
||
1. 价格计算器
|
||
- 选择实例类型、区域、操作系统和购买选项
|
||
- 实时计算价格
|
||
- 显示详细的价格信息
|
||
|
||
2. 价格对比
|
||
- 支持多个配置的价格对比
|
||
- 表格和图表展示
|
||
- 导出对比结果
|
||
|
||
3. 预算估算
|
||
- 支持自定义和预设使用时长
|
||
- 显示月度成本趋势
|
||
- 详细的成本明细
|
||
|
||
## 技术栈
|
||
|
||
- 前端：Vue.js 3 + Element Plus + ECharts
|
||
- 后端：Python FastAPI + Boto3
|
||
- 数据源：AWS API
|
||
|
||
## 系统要求
|
||
|
||
- Docker 20.10+
|
||
- Docker Compose 2.0+
|
||
- Node.js 14+
|
||
- npm 6+
|
||
|
||
## 快速开始
|
||
|
||
1. 克隆项目并进入项目目录：
|
||
```bash
|
||
git clone <repository-url>
|
||
cd calc
|
||
```
|
||
|
||
2. 创建环境变量文件：
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
然后编辑 `.env` 文件，填入必要的环境变量。
|
||
|
||
3. 运行安装脚本：
|
||
```bash
|
||
chmod +x install.sh
|
||
./install.sh
|
||
```
|
||
|
||
安装脚本会自动：
|
||
- 检查必要的命令是否已安装
|
||
- 创建必要的目录结构
|
||
- 构建前端项目
|
||
- 检查环境变量配置
|
||
- 检查 SSL 证书（如果有）
|
||
- 启动所有服务
|
||
- 检查服务状态
|
||
|
||
## 访问应用
|
||
|
||
安装完成后，可以通过以下地址访问应用：
|
||
- 前端界面：http://localhost
|
||
- 后端 API：http://localhost:8000
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── backend/ # 后端服务
|
||
├── frontend/ # 前端项目
|
||
├── nginx/ # Nginx 配置
|
||
│ ├── conf.d/ # Nginx 配置文件
|
||
│ └── ssl/ # SSL 证书目录
|
||
├── docker-compose.yml
|
||
├── install.sh
|
||
└── README.md
|
||
```
|
||
|
||
## 开发说明
|
||
|
||
### 前端开发
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run serve
|
||
```
|
||
|
||
### 后端开发
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
python manage.py runserver
|
||
```
|
||
|
||
## 部署说明
|
||
|
||
### 使用 SSL 证书
|
||
|
||
1. 将 SSL 证书文件放在 `nginx/ssl/` 目录下：
|
||
- `cert.pem`：SSL 证书文件
|
||
- `key.pem`：SSL 私钥文件
|
||
|
||
2. 修改 `nginx/conf.d/default.conf` 中的 `server_name` 为你的域名。
|
||
|
||
### 环境变量
|
||
|
||
在 `.env` 文件中配置以下环境变量：
|
||
```
|
||
AWS_ACCESS_KEY_ID=your_access_key
|
||
AWS_SECRET_ACCESS_KEY=your_secret_key
|
||
AWS_DEFAULT_REGION=your_region
|
||
```
|
||
|
||
## 常见问题
|
||
|
||
1. 如果遇到权限问题，请确保使用 `sudo` 运行安装脚本：
|
||
```bash
|
||
sudo ./install.sh
|
||
```
|
||
|
||
2. 如果服务启动失败，可以查看日志：
|
||
```bash
|
||
docker-compose logs
|
||
```
|
||
|
||
3. 如果需要重新构建前端：
|
||
```bash
|
||
cd frontend
|
||
npm run build
|
||
```
|
||
|
||
## 维护说明
|
||
|
||
### 更新应用
|
||
```bash
|
||
git pull
|
||
./install.sh
|
||
```
|
||
|
||
### 停止服务
|
||
```bash
|
||
docker-compose down
|
||
```
|
||
|
||
### 查看日志
|
||
```bash
|
||
docker-compose logs -f
|
||
```
|
||
|
||
## 安装说明
|
||
|
||
### 开发环境部署
|
||
|
||
#### 后端设置
|
||
|
||
1. 创建虚拟环境：
|
||
```bash
|
||
python -m venv venv
|
||
source venv/bin/activate # Linux/Mac
|
||
venv\Scripts\activate # Windows
|
||
```
|
||
|
||
2. 安装依赖：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. 配置AWS凭证：
|
||
创建`.env`文件并添加以下内容：
|
||
```
|
||
AWS_ACCESS_KEY_ID=your_access_key
|
||
AWS_SECRET_ACCESS_KEY=your_secret_key
|
||
AWS_DEFAULT_REGION=your_region
|
||
```
|
||
|
||
4. 运行后端服务：
|
||
```bash
|
||
cd backend
|
||
uvicorn main:app --reload
|
||
```
|
||
|
||
#### 前端设置
|
||
|
||
1. 安装依赖：
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
```
|
||
|
||
2. 运行开发服务器：
|
||
```bash
|
||
npm run serve
|
||
```
|
||
|
||
### 生产环境部署
|
||
|
||
#### 后端部署
|
||
|
||
1. 安装生产环境依赖：
|
||
```bash
|
||
pip install -r requirements.txt
|
||
pip install gunicorn
|
||
```
|
||
|
||
2. 使用 Gunicorn 启动后端服务：
|
||
```bash
|
||
cd backend
|
||
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000
|
||
```
|
||
|
||
3. 配置 Nginx 反向代理（可选）：
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your_domain.com;
|
||
|
||
location /api {
|
||
proxy_pass http://localhost:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 前端部署
|
||
|
||
1. 构建生产版本：
|
||
```bash
|
||
cd frontend
|
||
npm run build
|
||
```
|
||
|
||
2. 配置 Nginx 服务静态文件：
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name your_domain.com;
|
||
|
||
root /path/to/frontend/dist;
|
||
index index.html;
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.html;
|
||
}
|
||
|
||
location /api {
|
||
proxy_pass http://localhost:8000;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
}
|
||
}
|
||
```
|
||
|
||
### Docker 部署
|
||
|
||
1. 构建后端镜像：
|
||
```bash
|
||
cd backend
|
||
docker build -t aws-calc-backend .
|
||
```
|
||
|
||
2. 构建前端镜像：
|
||
```bash
|
||
cd frontend
|
||
docker build -t aws-calc-frontend .
|
||
```
|
||
|
||
3. 使用 Docker Compose 启动服务：
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
4. 查看服务状态：
|
||
```bash
|
||
docker-compose ps
|
||
```
|
||
|
||
## 环境变量配置
|
||
|
||
### 后端环境变量
|
||
```env
|
||
AWS_ACCESS_KEY_ID=your_access_key
|
||
AWS_SECRET_ACCESS_KEY=your_secret_key
|
||
AWS_DEFAULT_REGION=your_region
|
||
CORS_ORIGINS=http://localhost:8080,https://your_domain.com
|
||
ENVIRONMENT=production
|
||
```
|
||
|
||
### 前端环境变量
|
||
```env
|
||
VUE_APP_API_URL=http://localhost:8000
|
||
VUE_APP_ENV=production
|
||
```
|
||
|
||
## 使用说明
|
||
|
||
1. 访问 http://localhost:8080 打开应用
|
||
2. 使用导航菜单切换不同的功能页面
|
||
3. 在表单中选择所需的配置
|
||
4. 点击计算按钮查看结果
|
||
|
||
## 注意事项
|
||
|
||
- 确保已配置有效的AWS凭证
|
||
- 后端服务默认运行在 http://localhost:8000
|
||
- 前端开发服务器默认运行在 http://localhost:8080
|
||
- 生产环境部署时请确保：
|
||
- 使用 HTTPS
|
||
- 配置适当的安全头部
|
||
- 启用 CORS 保护
|
||
- 设置适当的缓存策略
|
||
- 配置错误监控和日志记录
|
||
|
||
## 贡献指南
|
||
|
||
1. Fork 项目
|
||
2. 创建特性分支
|
||
3. 提交更改
|
||
4. 推送到分支
|
||
5. 创建 Pull Request
|
||
|
||
## 许可证
|
||
|
||
MIT License |