目录

• 背景
• 准备 storageclass
• 部署 PostgreSQL 数据库
• 准备用户名密码配置
• 准备数据库初始化脚本
• 准备存储
• 部署 PostgreSQL 数据库
• 创建供其他 Pod 访问的 Service
• 完成 PostgreSQL 部署
• 部署 wiki.js
• 准备用户名密码配置
• 准备数据库连接配置
• 创建数据库用户和数据库
• 准备 wiki.js 的 yaml 部署文件
• 创建集群内访问 wiki.js 的 Service
• 创建集群外访问的 Ingress
• 执行部署
• 配置 wiki.js 支持中文全文检索
• 授予 wikijs 用户临时超管权限
• 启用数据库的中文分词能力
• 取消 wikijs 用户的临时超管权限
• 创建支持中文分词的配置 ConfigMap
• 更新 wikijs 的 Deployment
• 配置 wiki.js ，启用基于 PostgreSQL 的全文检索
• 总结

背景 wiki.js 是优秀的开源 Wiki 系统，相较于 xwiki ，功能目前性上比 xwiki 不够完善，但也在不断进步。 Wiki 写作、分享、权限管理功能还是有的，胜在 UI 设计很漂亮，能满足小团队的基本知识管理需求。
以下工作是在 KubeSphere 3.2.1 + Helm 3 已经部署好的情况下进行的。
部署 KuberSphere 的方法官网有很详细的文档介绍，这里不再赘叙。 kubesphere.com.cn/docs/instal…

准备 storageclass 我们使用 OpenEBS 作为存储，OpenEBS 默认安装的 Local StorageSlass 在 Pod 销毁后自动删除，不适合用于我的 MySQL 存储，我们在 Local StorageClass 基础上稍作修改，创建新的 StorageClass，允许 Pod 销毁后，PV 内容继续保留，手动决定怎么处理。

apiVersion: v1items:- apiVersion: storage.k8s.io/v1kind: StorageClassmetadata:annotations:cas.openebs.io/config: |- name: StorageTypevalue: "hostpath"- name: BasePathvalue: "/var/openebs/localretain/"openebs.io/cas-type: localstorageclass.beta.kubernetes.io/is-default-class: "false"storageclass.kubesphere.io/supported-access-modes: '["ReadWriteOnce"]'name: localretainprovisioner: openebs.io/localreclaimPolicy: RetainvolumeBindingMode: WaitForFirstConsumerkind: Listmetadata:resourceVersion: ""selfLink: ""

部署 PostgreSQL 数据库 我们团队其他项目中也需要使用 PostgreSQL, 为了提高 PostgreSQL 数据库的利用率和统一管理，我们独立部署 PostgreSQL，并在安装 wiki.js 时，配置为使用外部数据库。


准备用户名密码配置
我们使用 Secret 保存 PostgreSQL 用户密码等敏感信息。

kind: SecretapiVersion: v1metadata:name: postgres-proddata:POSTGRES_PASSWORD: xxxxtype: Opaque

以上 POSTGRES_PASSWORD 自行准备，为 base64 编码的数据。

准备数据库初始化脚本
使用 ConfigMap 保存数据库初始化脚本，在 数据库创建时，将 ConfigMap 中的数据库初始化脚本挂载到 /docker-entrypoint-initdb.d, 容器初始化时会自动执行该脚本。

apiVersion: v1kind: ConfigMapmetadata:name: wikijs-postgres-initdata:init.sql: |-CREATE DATABASE wikijs; CREATE USER wikijs with password 'xxxx'; GRANT CONNECT ON DATABASE wikijs to wikijs; GRANT USAGE ON SCHEMA public TO wikijs; GRANT SELECT,update,INSERT,delete ON ALL TABLES IN SCHEMA public TO wikijs; ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO wikijs;

以上 wikijs 用户的密码自行准备，明文保存。

准备存储
我们使用 KubeSphere 默认安装的 OpenEBS 来提供存储服务。可以通过创建 PVC 来提供持久化存储。
这里声明一个 10G 的 PVC。

kind: PersistentVolumeClaimapiVersion: v1metadata:name: postgres-prod-datafinalizers:- kubernetes.io/pvc-protectionspec:accessModes:- ReadWriteOnceresources:requests:storage: 10GistorageClassName: localretainvolumeMode: Filesystem

部署 PostgreSQL 数据库
在前面的步骤准备好各种配置信息和存储后，就可以开始部署 PostgreSQL 服务了。
我们的 Kubernetes 没有配置存储阵列，使用的是 OpenEBS 作为存储，采用 Deployment 方式部署 PostgreSQL。

apiVersion: apps/v1kind: Deploymentmetadata:labels:app: postgres-prodname: postgres-prodspec:replicas: 1selector:matchLabels:app: postgres-prodtemplate:metadata:labels:app: postgres-prodspec:containers:- name: dbimagePullPolicy: IfNotPresentimage: 'abcfy2/zhparser:12-alpine'ports:- name: tcp-5432protocol: TCPcontainerPort: 5432envFrom:- secretRef:name: postgres-prodvolumeMounts:- name: postgres-prod-datareadOnly: falsemountPath: /var/lib/postgresql/data- name: wikijs-postgres-initreadOnly: truemountPath: /docker-entrypoint-initdb.dvolumes:- name: postgres-prod-datapersistentVolumeClaim:claimName: postgres-prod-data- name: wikijs-postgres-initconfigMap:name: wikijs-postgres-init

创建供其他 Pod 访问的 Service

apiVersion: v1kind: Servicemetadata:name: postgres-prodspec:selector:app: postgres-prodports:- protocol: TCPport: 5432targetPort: tcp-5432

完成 PostgreSQL 部署
测试略

部署 wiki.js 准备用户名密码配置
我们使用 Secret 保存 wiki.js 用于连接数据库的用户名密码等敏感信息。

apiVersion: v1kind: Secretmetadata:name: wikijsdata:DB_USER: d2lraWpzDB_PASS: xxxxtype: Opaque

以上 DB_PASS 自行准备，为 base64 编码的数据。

准备数据库连接配置
我们使用 ConfigMap 保存 wiki.js 的数据库连接信息。

apiVersion: v1kind: ConfigMapmetadata:name: wikijsdata:DB_TYPE: postgresDB_HOST: postgres-prod.infraDB_PORT: "5432"DB_NAME: wikijsHA_ACTIVE: "true"

创建数据库用户和数据库
如果 PostgreSQL 数据库里没有创建 wikijs 用户和数据 ，需要手工完成一下工作：
通过『数据库工具』连接 PostgreSQL 数据库，执行一下 SQL 语句，完成数据库和用户的创建、授权。

CREATE DATABASE wikijs; CREATE USER wikijs with password 'xxxx'; GRANT CONNECT ON DATABASE wikijs to wikijs; GRANT USAGE ON SCHEMA public TO wikijs; GRANT SELECT,update,INSERT,delete ON ALL TABLES IN SCHEMA public TO wikijs; ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO wikijs;

以上 wikijs 的密码自行修改。

准备 wiki.js 的 yaml 部署文件
采用 Deployment 方式 部署 wiki.js 的 yaml 文件如下：

# wikijs-deploy.yamlapiVersion: apps/v1kind: Deploymentmetadata:labels:app: wikijsname: wikijsspec:replicas: 1selector:matchLabels:app: wikijstemplate:metadata:labels:app: wikijsspec:containers:- name: wikijsimage: 'requarks/wiki:2'ports:- name: http-3000protocol: TCPcontainerPort: 3000envFrom:- secretRef:name: wikijs- configMapRef:name: wikijs

创建集群内访问 wiki.js 的 Service

# wikijs-svc.yamlapiVersion: v1kind: Servicemetadata:name: wikijsspec:selector:app: wikijsports:- protocol: TCPport: 3000targetPort: http-3000

创建集群外访问的 Ingress

# wikijs-ing.yamlkind: IngressapiVersion: networking.k8s.io/v1metadata:name: wikijsspec:ingressClassName: nginxrules:- host: wiki.xxxx.cnhttp:paths:- path: /pathType: ImplementationSpecificbackend:service:name: wikijsport:number: 3000

以上 host 域名需要自行配置。

执行部署

$ kubectl apply -f wikijs-deploy.yaml$ kubectl apply -f wikijs-svc.yaml$ kubectl apply -f wikijs-ing.yaml

配置 wiki.js 支持中文全文检索 wiki.js 的全文检索支持基于 PostgreSQL 的检索，也支持 Elasticsearch 等，相对来说, PostgreSQL 比较轻量级，本项目中，我们使用 PostgreSQL 的全文检索。
但是，因为 PostgreSQL 不支持中文分词，需要额外安装插件并配置启用中文分词，下面描述了为 wiki.js 启动基于 PostgreSQL 数据库中文分词的全文检索。

授予 wikijs 用户临时超管权限
通过数据库管理工具登录有超管权限的 PostgreSQL 用户，临时授予 wiki.js 用户临时超管权限，便于启动中文分词功能。

ALTER USER wikijs WITH SUPERUSER;

启用数据库的中文分词能力
使用数据库管理工具登录 PostgreSQL 数据库的 wikijs 用户，执行以下命令，启动数据库的中文分词功能。

CREATE EXTENSION pg_trgm; CREATE EXTENSION zhparser; CREATE TEXT SEARCH CONFIGURATION pg_catalog.chinese_zh (PARSER = zhparser); ALTER TEXT SEARCH CONFIGURATION chinese_zh ADD MAPPING FOR n,v,a,i,e,l WITH simple; -- 忽略标点影响ALTER ROLE wikijs SET zhparser.punctuation_ignore = ON; -- 短词复合ALTER ROLE wikijs SET zhparser.multi_short = ON; -- 测试一下select ts_debug('chinese_zh', '青春是最美好的年岁，青春是最灿烂的日子。每一个人的青春都无比宝贵，宝贵的青春只有与奋斗为伴才最闪光、最出彩。');

取消 wikijs 用户的临时超管权限
登录 PostgreSQL 数据库 wikijs 用户，取消 wikijs 用户的超管权限。

ALTER USER wikijs WITH NOSUPERUSER;

创建支持中文分词的配置 ConfigMap

# zh-parse.yamlkind: ConfigMapapiVersion: v1metadata:name: wikijs-zhparserdata:definition.yml: |-key: postgrestitle: Database - PostgreSQLdescription: Advanced PostgreSQL-based search engine.author: requarks.iologo: https://static.requarks.io/logo/postgresql.svgwebsite: https://www.requarks.io/isAvailable: trueprops:dictLanguage:type: Stringtitle: Dictionary Languagehint: Language to use when creating and querying text search vectors.default: englishenum:- simple- danish- dutch- english- finnish- french- german- hungarian- italian- norwegian- portuguese- romanian- russian- spanish- swedish- turkish- chinese_zhorder: 1engine.js: |-const tsquery = require('pg-tsquery')()const stream = require('stream')const Promise = require('bluebird')const pipeline = Promise.promisify(stream.pipeline)/* global WIKI */module.exports = {async activate() {if (WIKI.config.db.type !== 'postgres') {throw new WIKI.Error.SearchActivationFailed('Must use PostgreSQL database to activate this engine!')}},async deactivate() {WIKI.logger.info(`(SEARCH/POSTGRES) Dropping index tables...`)await WIKI.models.knex.schema.dropTable('pagesWords')await WIKI.models.knex.schema.dropTable('pagesVector')WIKI.logger.info(`(SEARCH/POSTGRES) Index tables have been dropped.`)},/*** INIT*/async init() {WIKI.logger.info(`(SEARCH/POSTGRES) Initializing...`)// -> Create Search Indexconst indexExists = await WIKI.models.knex.schema.hasTable('pagesVector')if (!indexExists) {WIKI.logger.info(`(SEARCH/POSTGRES) Creating Pages Vector table...`)await WIKI.models.knex.schema.createTable('pagesVector', table => {table.increments()table.string('path')table.string('locale')table.string('title')table.string('description')table.specificType('tokens', 'TSVECTOR')table.text('content')})}// -> Create Words Indexconst wordsExists = await WIKI.models.knex.schema.hasTable('pagesWords')if (!wordsExists) {WIKI.logger.info(`(SEARCH/POSTGRES) Creating Words Suggestion Index...`)await WIKI.models.knex.raw(`CREATE TABLE "pagesWords" AS SELECT word FROM ts_stat('SELECT to_tsvector(''simple'', "title") || to_tsvector(''simple'', "description") || to_tsvector(''simple'', "content") FROM "pagesVector"')`)await WIKI.models.knex.raw('CREATE EXTENSION IF NOT EXISTS pg_trgm')await WIKI.models.knex.raw(`CREATE INDEX "pageWords_idx" ON "pagesWords" USING GIN (word gin_trgm_ops)`)}WIKI.logger.info(`(SEARCH/POSTGRES) Initialization completed.`)},/*** QUERY** @param {String} q Query* @param {Object} opts Additional options*/async query(q, opts) {try {let suggestions = []let qry = `SELECT id, path, locale, title, descriptionFROM "pagesVector", to_tsquery(?,?) queryWHERE (query @@ "tokens" OR path ILIKE ?)`let qryEnd = `ORDER BY ts_rank(tokens, query) DESC`let qryParams = [this.config.dictLanguage, tsquery(q), `%${q.toLowerCase()}%`]if (opts.locale) {qry = `${qry} AND locale = ?`qryParams.push(opts.locale)}if (opts.path) {qry = `${qry} AND path ILIKE ?`qryParams.push(`%${opts.path}`)}const results = await WIKI.models.knex.raw(`${qry}${qryEnd}`, qryParams)if (results.rows.length < 5) {const suggestResults = await WIKI.models.knex.raw(`SELECT word, word <-> ? AS rank FROM "pagesWords" WHERE similarity(word, ?) > 0.2 ORDER BY rank LIMIT 5; `, [q, q])suggestions = suggestResults.rows.map(r => r.word)}return {results: results.rows,suggestions,totalHits: results.rows.length}} catch (err) {WIKI.logger.warn('Search Engine Error:')WIKI.logger.warn(err)}},/*** CREATE** @param {Object} page Page to create*/async created(page) {await WIKI.models.knex.raw(`INSERT INTO "pagesVector" (path, locale, title, description, "tokens") VALUES (?, ?, ?, ?, (setweight(to_tsvector('${this.config.dictLanguage}', ?), 'A') || setweight(to_tsvector('${this.config.dictLanguage}', ?), 'B') || setweight(to_tsvector('${this.config.dictLanguage}', ?), 'C')))`, [page.path, page.localeCode, page.title, page.description, page.title, page.description, page.safeContent])},/*** UPDATE** @param {Object} page Page to update*/async updated(page) {await WIKI.models.knex.raw(`UPDATE "pagesVector" SETtitle = ?,description = ?,tokens = (setweight(to_tsvector('${this.config.dictLanguage}', ?), 'A') ||setweight(to_tsvector('${this.config.dictLanguage}', ?), 'B') ||setweight(to_tsvector('${this.config.dictLanguage}', ?), 'C'))WHERE path = ? AND locale = ?`, [page.title, page.description, page.title, page.description, page.safeContent, page.path, page.localeCode])},/*** DELETE** @param {Object} page Page to delete*/async deleted(page) {await WIKI.models.knex('pagesVector').where({locale: page.localeCode,path: page.path}).del().limit(1)},/*** RENAME** @param {Object} page Page to rename*/async renamed(page) {await WIKI.models.knex('pagesVector').where({locale: page.localeCode,path: page.path}).update({locale: page.destinationLocaleCode,path: page.destinationPath})},/*** REBUILD INDEX*/async rebuild() {WIKI.logger.info(`(SEARCH/POSTGRES) Rebuilding Index...`)await WIKI.models.knex('pagesVector').truncate()await WIKI.models.knex('pagesWords').truncate()await pipeline(WIKI.models.knex.column('path', 'localeCode', 'title', 'description', 'render').select().from('pages').where({isPublished: true,isPrivate: false}).stream(),new stream.Transform({objectMode: true,transform: async (page, enc, cb) => {const content = WIKI.models.pages.cleanHTML(page.render)await WIKI.models.knex.raw(`INSERT INTO "pagesVector" (path, locale, title, description, "tokens", content) VALUES (?, ?, ?, ?, (setweight(to_tsvector('${this.config.dictLanguage}', ?), 'A') || setweight(to_tsvector('${this.config.dictLanguage}', ?), 'B') || setweight(to_tsvector('${this.config.dictLanguage}', ?), 'C')), ?)`, [page.path, page.localeCode, page.title, page.description, page.title, page.description, content,content])cb()}}))await WIKI.models.knex.raw(`INSERT INTO "pagesWords" (word)SELECT word FROM ts_stat('SELECT to_tsvector(''simple'', "title") || to_tsvector(''simple'', "description") || to_tsvector(''simple'', "content") FROM "pagesVector"')`)WIKI.logger.info(`(SEARCH/POSTGRES) Index rebuilt successfully.`)}}

更新 wikijs 的 Deployment
wiki.js 的基于 PostgreSQL 的全文检索引擎配置位于 /wiki/server/modules/search/postgres ，我们将前面配置的 ConfigMap 加载到这个目录。

# wikijs-zh.yamlkind: DeploymentapiVersion: apps/v1metadata:name: wikijslabels:app: wikijsspec:replicas: 1selector:matchLabels:app: wikijstemplate:metadata:labels:app: wikijsspec:volumes:- name: volume-dysh4fconfigMap:name: wikijs-zhparserdefaultMode: 420containers:- name: wikijsimage: 'requarks/wiki:2'ports:- name: http-3000containerPort: 3000protocol: TCPenvFrom:- secretRef:name: wikijs- configMapRef:name: wikijsvolumeMounts:- name: volume-dysh4freadOnly: truemountPath: /wiki/server/modules/search/postgres

配置 wiki.js ，启用基于 PostgreSQL 的全文检索

• 重新 apply 新的 Delployment 文件后

$ kubectl apply -f zh-parse.yaml$ kubectl apply -f wikijs-zh.yaml

• 打开 wiki.js 管理
• 点击搜索引擎
• 选择 Database - PostgreSQL
• 在 Dictionary Language 的下拉菜单里选择 chinese_zh。
• 点击应用，并重建索引。
• 完成配置。

总结 本文介绍的 wiki.js 部署方式支持中文全文检索的支持，集成了 PostgreSQL 和 zhparser 中文分词插件。
相对于标准的 wiki.js 安装部署过程，主要做了以下配置：

• PostgreSQL 镜像采用了 abcfy2/zhparser:12-alpine ，这个镜像自带 zhparser 中文分词插件。
• wiki.js 镜像外挂了 ConfigMap ，用于修改原 Docker 镜像里关于 PostgreSQL 搜索引擎配置的信息，以支持 chinese_zh 选项。

【KubeSphere中部署Wiki系统wiki.js并启用中文全文检索】以上就是KubeSphere中部署Wiki系统wiki.js并启用中文全文检索的详细内容，更多关于KubeSphere部署wiki.js并启用的资料请关注脚本之家其它相关文章！

推荐阅读

• 

  特别淘气的孩子怎么教育
• 

  怎么样在股市里买定投基金 如何购买基金定投
• 

  国足为什么输球不暴怒,却因为一句玩笑而暴怒呢？
• 

  山东省教育云服务平台官方入口 山东省教育云服务平台官网入口
• 

  核酸检测igg阳性能转阴吗 核酸检测igg阳性是什么意思
• 

  小孩夏季适合吃什么鱼 小孩夏季适合吃什么鱼好
• 

  2023年春运购票日历表图片 2023年春运购票日历表
• 

  男模特培训班大约多少钱 模特的风格包括几种类型
• 

  小天才|小米米兔儿童手表5X测评：延续高配低价，挑战小天才“霸主”地位
• 

  Day8（21天|Day8：21天 | 罗马巴黎在行动《见识》4）
• 

  全球疫情8月份能结束吗？
• 

  帅康热水器质量怎么样 帅康热水器服务24小时热线电话
• 

  百身何赎是什么意思 百身难赎是什么意思
• 

  平安福主险和重疾共用保额吗
• 

  支付宝APP中将蚂蚁庄园关掉具体操作步骤
• 

  蜜蜂喜欢吃什么食物，蜜蜂喜欢吃什么食物啊
• 

  舔狗是什么意思梗
• 

  有哪些超级好听,时尚的纯音乐,英文曲,轻音乐？
• 

  商品的概念及与产品的区别
• 

  “银河补习班”是每位父母都得补上的“爱的必修课”

• IDEA中一个项目的.idea文件夹，.iml文件，src文件夹，out文件夹
• HMS|HMS Core机器学习服务实现同声传译，支持中英文互译和多种音色语音播报
• C/C++|在 Linux 程序中使用 breakpad
• Python 中几种属性访问的区别
• 这几个默认路由静态路由的配置部署都不会，还算什么网工！
• python中几个常用函数
• python中几个常用小技巧
• python随机生成中文字符的方法
• KubeSpace最简流水线之部署
• 投稿|出国，是中年程序员的解药吗？