无头CMS部署和使用指南

Augmunt智能路由2025/8/10大约 5 分钟

无头CMS部署和使用指南

概述

本文档介绍如何部署和使用基于fizz-authorization的无头CMS系统，该系统为pb-website提供内容管理服务。

系统架构

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   pb-website    │    │fizz-authorization│    │fizz-authorization│
│   (官网前端)     │◄───┤   (CMS后端)     │◄───┤    -admin       │
│                 │    │                 │    │   (管理后台)     │
└─────────────────┘    └─────────────────┘    └─────────────────┘
        │                       │                       │
        │                       │                       │
        ▼                       ▼                       ▼
   内容消费端              无头CMS API              内容管理端

部署步骤

1. 数据库迁移

1.1 执行迁移脚本

在fizz-authorization项目中执行数据库迁移脚本：

-- 执行 db/migration/V1.1__extend_content_for_headless_cms.sql
mysql -u username -p database_name < db/migration/V1.1__extend_content_for_headless_cms.sql

1.2 验证迁移结果

检查表结构是否正确创建：

-- 检查blade_content表的新字段
DESCRIBE blade_content;

-- 检查索引是否创建
SHOW INDEX FROM blade_content;

-- 检查视图是否创建
SHOW TABLES LIKE 'v_published_content';

2. 后端部署

2.1 更新fizz-authorization

确保新的Java类已编译：
- ContentTypeEnum.java
- PublicContentController.java
- 扩展的Content.java和ContentVO.java
- SlugUtils.java

重启fizz-authorization服务：

# 停止服务
sudo systemctl stop fizz-authorization

# 启动服务
sudo systemctl start fizz-authorization

# 检查状态
sudo systemctl status fizz-authorization

2.2 验证API接口

测试公开API接口是否正常工作：

# 测试获取内容列表
curl -X GET "http://localhost:8080/client/cms/contents?size=5"

# 测试通过slug获取内容
curl -X GET "http://localhost:8080/client/cms/contents/slug/test-content"

# 测试搜索功能
curl -X GET "http://localhost:8080/client/cms/search?keyword=测试"

3. 管理后台部署

3.1 更新fizz-authorization-admin

确保新的Vue组件已更新：
- content.vue - 扩展的内容管理界面
- dashboard.vue - CMS仪表板
- content.js - 扩展的API调用

重新构建和部署前端：

cd fizz-authorization-admin
npm run build
# 部署到Web服务器

3.2 验证管理功能

登录管理后台
进入CMS -> 内容管理
测试新功能：
- 创建不同类型的内容
- 设置SEO字段
- 发布/取消发布内容
- 生成slug

4. pb-website部署

4.1 配置CMS API

更新VuePress配置中的API地址：

// src/.vuepress/client/cmsApi.js
const CMS_CONFIG = {
  baseURL: 'https://your-cms-api.com', // 更新为实际API地址
  apiPrefix: '/client/cms',
  timeout: 10000
}

4.2 构建和部署

cd pb-website
npm run build
# 部署到CDN或Web服务器

使用指南

1. 内容管理

1.1 创建内容

登录fizz-authorization-admin
进入"CMS" -> "内容管理"
点击"新增"按钮
填写内容信息：
- 标题: 内容标题
- 内容类型: 选择页面、文章、产品、服务等
- URL标识(slug): 留空自动生成，或手动设置
- 语言: 选择中文或英文
- 分类: 选择内容分类
- 内容摘要: 简短描述
- 特色图片: 上传图片
- SEO标题: 搜索引擎显示的标题
- SEO描述: 搜索引擎显示的描述
- SEO关键词: 多个关键词用逗号分隔