Surge配置文件指南

Surge是一个简洁高效的静态文件部署工具,通过配置文件（surge.yaml或surge.json）定义应用的部署配置，以下是使用Surge配置文件的详细指南。

1. 安装Surge工具：

   • 使用包管理工具安装Surge,

     npm install -g surge

   • 或者通过Docker镜像运行：

     docker pull surge/surge
     docker run -it surge/surge

2. 创建配置文件：

   • 新建一个surge.yaml或surge.json文件。
   • 配置文件内容示例：

     # surge.yaml
     app: myapp
       container:
         image: node:16
         command: npm run build
         ports:
           - "300:80"
       volumes:
         - ./: /app

3. 配置文件结构：

   • 应用信息：
     • app: 应用名称。
     • image: 使用的镜像（默认为node:16）。
     • command: 执行的命令（默认为npm start）。
   • 端口映射：
     • ports: 指定端口映射，如"300:80"表示将本地300端口映射到服务80端口。
   • 存储与挂载：
     • volumes: 挂载本地目录到容器内，如- ./:/app。
   • 环境变量：
     • env: 设置环境变量，例如{"NODE_ENV": "production"}。
   • 网络配置：
     • networks: 定义容器网络，如["app-network"]。
     • labels: 添加标签，用于容器识别。

4. 使用Surge配置文件：

   • 初始化项目：

     surge init

   • 生成配置文件：

     surge generate surge.yaml

   • 部署应用：

     surge deploy

5. 常见配置示例：

   • 单容器部署：

     app: myapp
       image: myapp:latest
       command: ["start"]
       ports:
         - "808:80"

   • 多容器部署：

     app: myapp
       service: web
         image: web:latest
         ports:
           - "80:80"
         volumes:
           - .:/app
       service: db
         image: db:latest
         ports:
           - "3306:3306"
         volumes:
           - ./db:/var/lib/mysql

   • 路由规则：

     app: myapp
       routes:
         /api/*:
           - service: web
             path: /api
         /admin:
           - service: admin
             path: /

6. 优化与扩展：

   • 环境变量：

     app: myapp
       env:
         - NODE_ENV=production
         - CONFIG_KEY=yourkey

   • 日志配置：

     app: myapp
       logging:
         driver: "json-file"
         options:
           max-size: "128M"
           max-log-size: "256M"

   • 资源限制：

     app: myapp
       resources:
         limits:
           cpus: 2
           memory: 4G

7. 错误处理与故障排除：

   • 配置文件语法错误：
     • 使用surge validate检查配置文件语法。
   • 权限问题：

     确保配置文件和相关目录权限正确。

   • 版本问题：

     查看Surge文档或社区获取最新配置示例。

8. 安全建议：

   • 不要在配置文件中暴露敏感信息。
   • 定期备份配置文件,避免数据丢失。

通过合理配置Surge配置文件,你可以轻松部署和管理多容器应用，充分发挥Surge的高效性和灵活性。