InfiniteCloud/DEPLOYMENT.md

182 lines
2.9 KiB
Markdown
Raw Permalink Normal View History

2025-09-15 14:52:27 +08:00
# Pinnovate Cloud 部署指南
## 快速部署
### 使用 PowerShell 脚本(推荐)
```powershell
# 静态网站部署
.\deploy.ps1 -Platform static
# Vercel 部署
.\deploy.ps1 -Platform vercel
# Netlify 部署
.\deploy.ps1 -Platform netlify
# GitHub Pages 部署
.\deploy.ps1 -Platform github
# Docker 部署
.\deploy.ps1 -Platform docker
```
### 手动部署
#### 1. 静态网站部署
```bash
# 安装依赖
npm ci
# 构建静态网站
npm run build:static
# 部署 out/ 目录到任何静态文件服务器
```
#### 2. Vercel 部署
```bash
# 安装 Vercel CLI
npm i -g vercel
# 部署
vercel --prod
```
#### 3. Netlify 部署
```bash
# 安装 Netlify CLI
npm i -g netlify-cli
# 构建并部署
npm run build:static
netlify deploy --prod --dir=out
```
#### 4. Docker 部署
```bash
# 构建镜像
docker build -t pinnovate-cloud .
# 运行容器
docker run -p 80:80 pinnovate-cloud
# 或使用 Docker Compose
docker-compose up -d
```
#### 5. GitHub Pages 部署
1. 推送代码到 GitHub 仓库
2. 启用 GitHub Pages
3. 选择 GitHub Actions 作为源
4. 工作流将自动构建和部署
## 部署前检查
### 1. 环境要求
- Node.js 18+
- npm 8+
- Git
### 2. 构建测试
```bash
# 类型检查
npx tsc --noEmit
# 构建测试
npm run build
# 静态构建测试
npm run build:static
```
### 3. 本地预览
```bash
# 开发模式
npm run dev
# 生产模式预览
npm run build
npm run start
```
## 部署配置
### 环境变量
创建 `.env.local` 文件:
```env
NEXT_PUBLIC_SITE_URL=https://yourdomain.com
NEXT_PUBLIC_CONTACT_EMAIL=support@pinnovatecloud.com
NEXT_PUBLIC_WHATSAPP=+19174029875
NEXT_PUBLIC_TELEGRAM=@pinnovatecloud
```
### 域名配置
1. **自定义域名**:在部署平台配置自定义域名
2. **SSL 证书**:大多数平台自动提供 SSL
3. **DNS 设置**:配置 CNAME 或 A 记录
## 监控和维护
### 1. 性能监控
- 使用 Vercel Analytics
- 配置 Google Analytics
- 设置 Core Web Vitals 监控
### 2. 错误监控
- 集成 Sentry 错误监控
- 设置错误告警
- 定期检查日志
### 3. 内容更新
- 新闻内容:编辑 `content/news/` 目录下的 Markdown 文件
- 联系信息:更新 `components/Contact.tsx`
- 公司信息:更新 `components/About.tsx`
## 故障排除
### 常见问题
1. **构建失败**
- 检查 TypeScript 错误:`npx tsc --noEmit`
- 检查依赖版本兼容性
- 清理缓存:`npm run clean`
2. **部署失败**
- 检查环境变量配置
- 验证构建输出
- 查看部署日志
3. **页面无法访问**
- 检查域名配置
- 验证 SSL 证书
- 检查 CDN 缓存
### 获取帮助
- 📧 邮箱support@pinnovatecloud.com
- 💬 WhatsApp+1 917-402-9875
- 📱 Telegram@pinnovatecloud
## 更新日志
- v1.0.0 - 初始版本,支持静态网站生成
- 支持多种部署平台
- 完整的响应式设计
- 集成表单处理
- 内容管理系统