dsavell/grav

dsavell/grav

Grav是一个快速、简单、灵活的文件型Web平台，无需安装。虽然Grav遵循与其他平面文件CMS平台类似的原则，但其设计理念与大多数平台不同。

Grav的底层架构采用成熟的一流技术构建，确保使用简单且易于扩展。其中一些关键技术包括：

• Twig模板引擎：用于强大的用户界面控制
• Markdown：用于轻松创建内容
• YAML：用于简单配置
• Parsedown：提供快速的Markdown和Markdown Extra支持
• Doctrine Cache：用于性能优化
• Pimple依赖注入容器：用于可扩展性和可维护性
• Symfony事件调度器：用于插件事件处理
• Symfony Console：用于CLI界面
• Gregwar图像库：用于动态图像处理

支持的架构

我们利用Docker清单实现多平台支持。更多信息可参考Docker文档https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list。

直接拉取dsavell/grav:admin会自动获取适合您架构的镜像，也可通过标签拉取特定架构镜像。

此镜像支持的架构如下：

版本标签

此镜像提供多种版本，可通过标签获取。

应用设置

Web界面可通过http://<你的IP>访问。

更多信息请参阅官方文档https://learn.getgrav.org/17/basics/installation#webservers。

使用方法

以下是帮助您创建容器的示例代码片段。

docker-compose

yaml
---
version: '2.1'
services:
  grav:
    image: docker.xuanyuan.run/dsavell/grav:<TAG>
    container_name: grav
    restart: unless-stopped
    environment:
      - DUID=1000
      - DGID=1000
      - TZ=Europe/London # 可选
      - GRAV_MULTISITE=subdirectory # 可选
      - ROBOTS_DISALLOW=false # 可选
      - GRAV_PLUGINS=devtools,precache # 可选
    volumes:
      - /data/containers/grav/backup:/var/www/grav/backup
      - /data/containers/grav/logs:/var/www/grav/log
      - /data/containers/grav/user:/var/www/grav/user
    ports:
      - 80:80

docker cli（https://docs.docker.com/engine/reference/commandline/cli/）

bash
docker create \
  --name=grav \
  --restart unless-stopped \
  -e DUID=1000 \
  -e DGID=1000 \
  -p 80:80 \
  -e TZ=Europe/London `# 可选` \
  -e GRAV_MULTISITE=subdirectory `# 可选` \
  -e ROBOTS_DISALLOW=false `# 可选` \
  -e GRAV_PLUGINS=devtools,precache `# 可选` \
  -v /data/containers/grav/backup:/var/www/grav/backup \
  -v /data/containers/grav/logs:/var/www/grav/logs \
  -v /data/containers/grav/user:/var/www/grav/user \
  dsavell/grav:<TAG>
docker start grav

参数

容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数以冒号分隔，表示<外部>:<内部>。例如，-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。

用户/组标识符

使用卷（-v标志）时，主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。

确保主机上的任何卷目录都归您指定的用户所有，权限问题将迎刃而解。

此处PUID=1000和PGID=1000，可通过id user命令获取您的ID：

bash
  $ id username
    uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

问题

• 界面中调度器提示cron不可用，但实际可正常工作。相关issue已提交：https://github.com/getgrav/grav-plugin-admin/issues/1744

更新日志

• 2023年10月3日：
  • 移除繁琐的DevOps步骤。
  • 使用nodejs 20.x更新GitHub工作流。
  • 更新pre-commit钩子。
  • 将操作系统从bullseye更新至bookworm。
  • 将PHP 7.4更新至8.2。感谢https://github.com/funilrys https://github.com/dsavell/docker-grav/pull/56
  • 更新安装步骤相关文档。
  • 添加插件安装功能。感谢https://github.com/tyzbit https://github.com/dsavell/docker-grav/pull/64
• 2022年7月24日：
  • 从master branch迁移至main分支。
  • 添加commitlint功能以验证提交消息格式。
  • 添加.editorconfig确保IDE间标准统一。
  • 添加.gitattributes确保Git CLI标准统一。
  • 添加NPM/YARN构建以本地验证代码和提交消息。
  • 移除构建shell脚本。
  • 添加GitHub Actions CI/CD工作流
    • 每日凌晨1:00构建。
    • 主分支有新更改时构建。
    • 代码标准检查。
    • Docker lint检查。
    • Docker构建检查。
  • 添加prettier代码格式化。
  • 添加pre-commit yaml以验证代码语法/格式。
  • 添加MIT许可证。
  • 添加pre-commit husky工具，用于本地开发时触发pre-commit、commitlint和prettier。
  • 修正Dockerfile中的hadolint错误。
• 2022年5月18日：
  • 为GRAV_MULTISITE添加subdomain选项。
  • 添加NGINX_CLIENT_MAX_BODY_SIZE以指定nginx配置中的client_max_body_size。
  • 更新至Grav 1.7.33。
• 2021年10月16日：
  • 更新至Grav 1.7.23。
  • 更新Dockerfile中的curl脚本以正确拉取最新版Grav。
  • 更新至Debian 11.x（bullseye）。
  • 更改crontab逻辑，虽在界面中提示错误但可正常工作，属于admin插件已知bug（见上文）。
  • 在启动输出中添加bin/grav/ scheduler -i检查。
  • 在启动输出中添加crontab -l检查。
• 2021年4月15日：
  • 更新至Grav 1.7.12。
  • 在镜像中添加nano文本编辑器。
• 2021年4月10日：
  • 更新至Grav 1.7.10。
  • 更新至PHP 7.4.x。
  • 修复启动时的权限问题（因主题名称含空格）。感谢https://github.com/Miroka96 https://github.com/dsavell/docker-grav/pull/23
  • 添加多站点子目录支持。感谢https://github.com/hughbris https://github.com/dsavell/docker-grav/pull/21
  • 修复CMS上传功能，临时目录设为/var/www/grav/tmp。
• 2020年10月11日：
  • 更新至Grav 1.6.28。
• 2020年8月2日：
  • 更新至Grav 1.6.26。
• 2020年6月1日：
  • 更新至Grav 1.6.25。
• 2020年4月22日：
  • 修复cron和GRAV调度器的权限。感谢https://github.com/SykieChen https://github.com/dsavell/docker-grav/pull/19
• 2020年4月12日：
  • 更新至Grav 1.6.23。
• 2020年2月20日：
  • 更新至Grav 1.6.21。
• 2019年12月9日：
  • 修复admin标签缺少php7.3-mbstring的问题。感谢https://github.com/Miroka96 https://github.com/dsavell/docker-grav/pull/13
• 2019年12月8日：
  • 更新至Grav 1.6.19。
  • 修复crontab计划任务。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/11
• 2019年11月30日：
  • 将基础镜像从stretch更新至buster。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/10
  • 添加cron及cronjob以支持周期性任务（GRAV依赖此功能）。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/10
  • 添加php7.3-intl以支持Twig工具的多语言功能。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/10
  • 启用Nginx缓存以支持性能分析工具（如gtmetrix）。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/10
  • 启动脚本现在启用cron。感谢https://github.com/coldestheart https://github.com/dsavell/docker-grav/pull/10
• 2019年11月15日：
  • 修复工作目录，现在设置为/var/www/grav，可直接使用bin/grav和bin/gpm命令。感谢https://github.com/aptonline https://github.com/dsavell/docker-grav/issues/9
• 2019年8月10日：
  • 修复重建容器时GRAV用户目录被覆盖的问题。感谢https://github.com/Miroka96 https://github.com/dsavell/docker-grav/issues/6
• 2019年6月18日： 更好的发布？
  • 更好的文件/卷控制。
  • 更好的GRAV Core标签/版本控制。
  • 更好的用户/组管理。
  • 更好的文档。
• 2019年6月10日： 重构发布
  • 转换为minideb以获得更好的包管理。
  • 更新至PHP 7.3。
  • 构建时拉取最新版本的逻辑优化。
  • 更好的日志记录。
  • 移除blog镜像。
  • 目前仅提供GRAV Core和GRAV Core+Admin插件镜像。
  • 更小的Docker分层。
  • 修复nginx配置。感谢https://github.com/esapy https://github.com/dsavell/docker-grav/issues/1
• 2018年4月10日： 卷发布
  • /var/www卷现在可挂载。
• 2018年1月2日： 2018发布
  • 代码改进。
  • 现在使用GitHub API拉取最新GRAV版本。
• 2017年7月27日： 自动化发布
  • 更新"blog"标签，现在使用GitHub API下载最新http://demo.getgrav.org/blog-skeleton zip文件。
  • 改进所有标签的代码。
  • 修正README.md中的拼写错误。
• 2017年6月29日： 博客发布
  • 添加blog标签，基于http://demo.getgrav.org/blog-skeleton骨架。
• 2017年6月28日： 更小的发布
  • 现在使用ej52/alpine-nginx-php镜像。
  • 大小从657MB减少到267MB（带admin插件为277MB）。
• 2017年6月22日： 更好的发布
  • 现在使用php:7.0-apache镜像。
  • 大小从1.2GB减少到657MB（带admin插件为682MB）。
  • 修正GRAV权限。
  • 构建期间安装更少的包并清理。
• 2017年6月21日： 初始发布
  • 首次发布。
  • 未优化。
  • 使用完整的centos操作系统。
  • 无自定义功能。