webgradus/kms

webgradus/kms 镜像文档

镜像概述和主要用途

webgradus/kms是一个基于Ruby on Rails框架的内容管理系统(CMS)镜像，设计简洁且功能强大，专为开发者打造。通过与Postgres数据库容器集成，配合简单的配置即可快速部署和使用，大幅降低CMS搭建的复杂度。

核心功能和特性

• 基于Ruby on Rails框架开发，具备稳定可靠的技术基础
• 支持与Postgres数据库无缝集成，实现数据持久化
• 提供Docker Compose配置示例，简化部署流程
• 轻量级设计，易于扩展和定制，满足开发者个性化需求

使用场景和适用范围

适用于需要快速构建内容管理系统的开发者，可用于个人博客、小型企业网站后台、内部管理系统等场景，尤其适合熟悉Ruby on Rails技术栈的开发团队或个人使用。

详细使用方法和配置说明

基本使用流程

1. 拉取镜像
2. 部署Postgres数据库容器
3. 链接数据库并执行数据库创建和迁移操作
4. 启动应用服务

Docker Compose部署（推荐）

通过Docker Compose可一键完成服务部署，配置示例如下：

yaml
version: '3'
services:
  db:
    image: postgres  # 使用Postgres官方镜像作为数据库服务
  web:
    image: webgradus/kms  # 当前CMS镜像
    command: bundle exec rails s -p 3000 -b '0.0.0.0'  # 启动Rails服务器，绑定3000端口
    environment:
      SECRET_TOKEN: abc  # 应用安全令牌，需替换为实际安全随机字符串
    volumes:
      - .:/kms  # 将本地目录挂载到容器内/kms路径，便于代码修改和数据持久化
    ports:
      - "3000:3000"  # 端口映射，主机3000端口映射到容器3000端口
    depends_on:
      - db  # 依赖db服务，确保Postgres先启动

环境变量说明

• SECRET_TOKEN: 应用安全令牌，用于加密会话和敏感数据，必须设置为高强度随机字符串，确保应用安全

注意事项

• 首次启动后需在运行的web容器内执行数据库初始化命令：

  bash
  docker exec -it [容器ID] bundle exec rake db:create  # 创建数据库
  docker exec -it [容器ID] bundle exec rake db:migrate  # 执行数据库迁移
  

• 确保Postgres容器正常运行且网络可被web容器访问
• 生产环境中建议修改SECRET_TOKEN为安全随机值，并配置数据卷持久化Postgres数据