Surge 是一个非常强大的工具，用于自动化前端应用的构建、测试和部署。以下是对 Surge 的详细介绍和使用步骤，帮助您快速上手并充分利用其功能

安装 Surge

安装 Surge，你可以使用 npm 或 Yarn。

使用 npm 安装：

npm install surge -g

使用 Yarn 安装：

yarn add surge -g

配置 Surge

初始化项目

在项目根目录下运行以下命令：

surge init

这将创建一个 surge.json 文件。

修改 surge.json

在 surge.json 中配置您的项目信息：

{
  "app": {
    "framework": "React",
    "outDir": "dist",
    "entry": "src/index.js"
  },
  "server": {
    "command": "node server.js"
  },
  "prod": {
    "url": "https://example.com",
    "domain": "example.com",
    "certificate": "cert.pem",
    "private_key": "key.pem"
  }
}

集成项目

添加 Surge 脚本

在 package.json 中添加 Surge 脚本：

{
  "scripts": {
    "pre": "surge prepare",
    "build": "npm run build",
    "surge": "surge publish"
  }
}

配置 CI/CD

在您的 CI/CD 工具（如 Jenkins、GitHub Actions）中添加步骤：

npm run build && surge publish

部署

推送到 Surge

在项目根目录运行：

surge publish

这将构建您的项目并部署到 Surge 平台。

自动化部署

通过集成 CI 工具，自动触发部署流程，GitHub Actions 可以自动运行 npm run surge。

域名和 SSL

配置域名

在 surge.json 中设置域名：

{
  "prod": {
    "url": "https://yourdomain.com",
    "domain": "yourdomain.com",
    "certificate": "path/to/cert.pem",
    "private_key": "path/to/key.pem"
  }
}

SSL 配置

确保在生产环境中使用 HTTPS，Surge 提供了 SSL 证书的管理。

测试

集成测试工具

使用 Sauce Labs 或 BrowserStack 进行自动化测试，确保在不同浏览器和设备上测试应用。

日志和监控

查看日志

在 Surge 平台上查看应用的日志，帮助快速定位问题。

实时监控

使用 LikeCoin 或其他监控工具，实时监控应用状态和性能。

用户权限

管理权限

Surge 提供了细粒度的权限管理，确保团队成员只能访问他们需要的资源。

扩展功能

插件使用

安装插件以扩展 Surge 功能，如 @surgejs/cookie 或 @surgejs/redirect。

常用插件

• @surgejs/cookie：管理 cookies。
• @surgejs/redirect：URL 重定向。

使用案例

静态网站

适合部署静态网站,Jekyll 或 HTML。

动态应用

通过配置 server 端，支持动态路由，如 Express.js。

最佳实践

代码结构

确保您的代码结构清晰,各组件模块化，便于 Surge 构建。

部署流程

自动化构建和测试,确保每次部署都稳定可靠。

通过以上步骤,您可以充分利用 Surge 的功能，简化前端部署流程，提高开发效率。