wiliwili项目Pages部署资源优化实践

背景介绍

在开源项目wiliwili的持续集成过程中，发现Github Pages部署环节存在资源浪费问题。该项目使用Github Actions自动部署文档页面时，默认配置会部署整个仓库内容，但实际上只需要部署部分必要的文档和资源文件。

问题分析

通过性能监测发现，原始部署配置存在两个主要问题：

1. 部署内容冗余：虽然实际只需要部署README.md等文档文件，但工作流却部署了整个仓库内容，包括大量与文档无关的代码和资源。

2. 资源链接不规范：文档中的链接大多使用绝对路径而非相对路径，这可能影响页面在不同环境下的可访问性。

这些问题导致每次部署时：

• 存储空间浪费：部署包大小从优化前的15.4MB降至4.73MB
• 构建时间延长：CI/CD流程从55秒缩短至42秒

解决方案

针对上述问题，我们实施了以下优化措施：

1. 精准文件部署策略

修改.github/workflows/pages.yml配置文件，采用正则表达式匹配机制，仅部署必要的文件类型：

# 优化后的文件过滤配置
paths:
  - '**.md'       # 所有Markdown文档
  - '**.png'      # PNG图片
  - '**.jpg'      # JPG图片
  - '**.gif'      # GIF图片
  - '**.woff2'    # 网页字体
  - '**.mp4'      # 视频文件

这种配置方式确保只部署真正需要的文档和媒体资源，避免了无关代码和文件的传输。

2. 链接规范化处理

将所有文档中的链接从绝对路径改为相对路径：

• 修复图标引用路径
• 统一内部文档链接格式
• 确保资源引用路径与部署结构匹配

实施效果

优化后取得了显著成效：

1. 资源占用降低：

   • 部署包体积减少69%
   • 服务器存储空间利用率显著提升

2. 构建效率提升：

   • CI/CD流程时间缩短24%
   • 降低了Github Actions的分钟数消耗

3. 可维护性增强：

   • 部署内容更加清晰明确
   • 减少了未来可能出现的路径问题

经验总结

通过这次优化，我们获得了以下宝贵经验：

1. 精细化部署：即使是自动化部署，也需要根据实际需求精确控制部署内容，避免"一刀切"的全量部署。

2. 资源规范化：项目文档中的资源引用应尽量使用相对路径，确保在不同环境下的一致性。

3. 持续监控：建立部署资源占用监控机制，及时发现并解决潜在的资源浪费问题。

这种优化思路不仅适用于wiliwili项目，对于其他使用Github Pages的项目同样具有参考价值，特别是在资源敏感型项目中，此类优化可以带来显著的性能提升和成本节约。