docker/mobywebsite

Moby Website 镜像文档

1. 镜像概述和主要用途

Moby Website镜像是Moby项目官方网站的Docker化实现，基于Jekyll静态站点生成器构建，用于展示Moby项目的文档、新闻、项目信息及用户资源。该镜像支持本地开发调试、测试环境验证及生产环境部署，提供完整的网站生命周期管理能力。

2. 核心功能和特性

• Jekyll构建支持：集成Jekyll工具链，自动将Markdown源文件转换为静态HTML网站
• 本地开发优化：支持文件变更自动刷新，实时预览网站效果
• GitHub API集成：动态拉取GitHub项目数据和用户信息，丰富网站内容
• API速率限制控制：通过环境变量配置GitHub OAuth凭证，提升API调用配额
• 多环境部署：支持本地开发、测试（Staging）和生产环境的自动化构建与部署流程
• 生产级性能：基于Nginx运行，结合CloudFront缓存和SSL终止，确保高可用性

3. 使用场景和适用范围

• 开发人员：本地开发调试网站内容、样式和功能
• 设计团队：在测试环境验证网站改版效果，无需影响生产环境
• 运维团队：通过标准化流程实现生产环境的自动构建、部署和更新
• Moby项目：作为官方网站的生产运行载体，对外展示项目信息

4. 详细使用方法和配置说明

4.1 本地开发

4.1.1 基础开发环境启动

在项目docs目录下执行以下命令，启动本地开发服务器，网站可通过localhost:4000访问，文件修改后自动刷新：

bash
docker run -ti -v "$PWD":/usr/src/app -p "4000:4000" starefossen/github-pages

4.1.2 测试未来日期博客文章

如需测试包含未来发布日期的博客文章，使用以下命令启用未来日期内容预览：

bash
docker run -ti -v "$PWD":/usr/src/app -p "4000:4000" starefossen/github-pages \
  jekyll serve -d /_site --watch --force_polling -H 0.0.0.0 -P 4000 --future true

4.2 处理GitHub API速率限制

网站通过GitHub API动态获取数据时，未认证请求存在60次/时段的速率限制。若日志中出现API rate limit exceeded错误，需配置GitHub OAuth凭证提升至5000次/时段：

1. 在https://github.com/settings/developers%E5%88%9B%E5%BB%BAOAuth%E5%BA%94%E7%94%A8%EF%BC%8C%E8%8E%B7%E5%8F%96%60Client ID和Client Secret`
2. 通过环境变量传入凭证启动容器：

bash
docker run -ti -v "$PWD":/usr/src/app -p "4000:4000" \
  -e "GITHUB_CLIENT_ID=<your_client_id>" \
  -e "GITHUB_CLIENT_SECRET=<your_client_secret>" \
  starefossen/github-pages

4.3 Docker Compose配置示例

创建docker-compose.yml文件，简化本地开发环境管理：

yaml
version: '3'
services:
  moby-website:
    image: starefossen/github-pages
    volumes:
      - ./docs:/usr/src/app  # 挂载本地源码目录
    ports:
      - "4000:4000"
    environment:
      - GITHUB_CLIENT_ID=<your_client_id>  # 可选，API速率限制时配置
      - GITHUB_CLIENT_SECRET=<your_client_secret>  # 可选，与CLIENT_ID配合使用
    command: jekyll serve -d /_site --watch --force_polling -H 0.0.0.0 -P 4000

启动命令：docker-compose up

5. 环境变量说明

6. 部署流程

6.1 测试环境（Staging）

触发条件：

向项目仓库的theme-start分支推送代码

部署流程：

1. 自动构建私有镜像docker/mobywebsite
2. 部署至密码保护的测试网站：[***]
3. 访问控制：Docker员工通过docker.com账号登录验证

6.2 生产环境（Production）

触发条件：

向master分支推送代码或合并PR至master分支

构建流程：

1. 预构建阶段：执行https://github.com/moby/mobywebsite/blob/master/docs/hooks/pre_build%E9%92%A9%E5%AD%90%EF%BC%8C%E4%BD%BF%E7%94%A8%60starefossen/github-pages%60%E7%94%9F%E6%88%90HTML%E5%86%85%E5%AE%B9
2. 镜像构建：基于项目https://github.com/moby/mobywebsite/blob/master/docs/Dockerfile%EF%BC%8C%E5%B0%86%E7%94%9F%E6%88%90%E7%9A%84HTML%E6%B7%BB%E5%8A%A0%E5%88%B0Nginx%E9%95%9C%E5%83%8F%EF%BC%8C%E5%B9%B6%E9%9B%86%E6%88%90%E8%87%AA%E5%AE%9A%E4%B9%89https://github.com/moby/mobywebsite/blob/master/docs/nginx/default.conf%EF%BC%8C%E7%94%9F%E6%88%90%E9%95%9C%E5%83%8F%60docker/mobywebsite:latest%60

部署流程：

1. Docker Cloud管理的Docker Stack监控镜像变更，自动重新部署至：[***]
2. 网络架构：
   • DNS由Amazon Route53管理
   • 前端通过Amazon CloudFront分发，提供缓存和SSL终止
   • 镜像推送后执行https://github.com/moby/mobywebsite/blob/master/docs/hooks/post_push%E9%92%A9%E5%AD%90%EF%BC%8C%E6%B8%85%E9%99%A4CloudFront%E7%BC%93%E5%AD%98%E7%A1%AE%E4%BF%9D%E5%86%85%E5%AE%B9%E6%9B%B4%E6%96%B0

7. 问题反馈渠道

• 网站设计或内容问题：在项目GitHub仓库提交issue
• 生产环境运行问题：联系website@mobyproject.org