部署KubeSphere中Wiki系统wiki.js并启用中文全文检索,大致需要如下几步:
- 创建并配置Kubernetes集群
- 部署Mongodb实例
- 部署Wiki.js实例
- 配置并启用中文全文检索
下面我将为您介绍详细的步骤:
1. 创建并配置Kubernetes集群
这里假定您已经准备好了一台云服务器并且已经安装好了Kubernetes集群。如果不知道如何创建Kubernetes集群,可以通过这个教程创建。
2. 部署Mongodb实例
wiki.js的数据将存储在Mongodb中,因此我们需要先安装Mongodb的实例。
我们可以使用Helm来在Kubernetes集群中快速部署Mongodb实例,执行以下命令为部署Mongodb实例的Helm Chart安装命名空间:
$ kubectl create namespace mongodb
接着执行以下命令安装Mongodb实例:
$ helm install -n mongodb stable/mongodb \
--set mongodbRootPassword=<password> \
--set mongodbUsername=<username> \
--set mongodbPassword=<password> \
--set mongodbDatabase=<database>
其中:
<password>
为您自己设置的Mongodb管理员账户密码<username>
为您自己设置的Mongodb管理员用户账户名称<password>
为您自己设置的Mongodb用户密码<database>
为您自己设置的Mongodb数据库名称
您也可以根据自己的需要更改其他Mongodb配置选项。要了解有关此Helm Chart的更多信息,请参阅这里。
3. 部署Wiki.js实例
现在我们可以部署Wiki.js实例了。同样使用Helm快速部署。
首先我们还需创建存储Wiki.js数据的持久存储卷。执行以下命令:
$ kubectl apply -f https://raw.githubusercontent.com/kubesphere-sigs/wikis/main/wikijs/pvc.yaml
接着执行以下命令为部署Wiki.js实例的Helm Chart安装命名空间:
$ kubectl create namespace wikijs
接着执行以下命令安装Wiki.js实例:
$ helm install wikijs kubesphere/wikis \
--namespace wikijs \
--set mongodb.uri=mongodb://<username>:<password>@mongodb-mongodb-replicaset-0.mongodb-mongodb-replicaset-headless.mongodb.svc.cluster.local:27017,<username>:<password>@mongodb-mongodb-replicaset-1.mongodb-mongodb-replicaset-headless.mongodb.svc.cluster.local:27017,<username>:<password>@mongodb-mongodb-replicaset-2.mongodb-mongodb-replicaset-headless.mongodb.svc.cluster.local:27017/?replicaSet=rs0 \
--set persistence.enabled=true
其中:
<username>
为您在Mongodb中创建的管理员用户账户名称<password>
为您在Mongodb中创建的管理员密码
确保将上面的Mongodb URI配置项替换为您的Mongodb实例的正确URI。
安装完毕后,可以通过以下命令检查是否正常运行:
$ kubectl get pods -n wikijs
4. 配置并启用中文全文检索
如果需要使用中文全文搜索功能,我们还需要将Wiki.js的默认搜索引擎切换为Elasticsearch。这里以中文全文检索为例,具体步骤如下:
4.1 部署Elasticsearch
执行以下命令为部署Elasticsearch实例的Helm Chart安装命名空间:
$ kubectl create ns elasticsearch
接着执行以下命令安装Elasticsearch实例:
$ helm install elasticsearch stable/elasticsearch \
--version 7.10.0 \
--namespace elasticsearch \
--set persistence.enabled=true \
--set service.type=LoadBalancer
4.2 配置Wiki.js
在Wiki.js的配置文件中激活Elasticsearch插件并且设置服务器地址.
首先,使用“kubectl port-forward”命令将Elasticsearch转接到本地端口。执行以下命令:
$ kubectl port-forward svc/elasticsearch-master 9200
接着,进入Wiki.js的管理后台。单击“设置”,然后单击“插件”。激活“全文检索”插件,然后单击“配置”。
在配置窗口中,更新以下配置:
{
"enabled": true,
"skinny": false,
"register": true,
"options": {
"host": "http://localhost:9200"
}
}
在配置中,将“host”更改为Elasticsearch实例的正确URI。
4.3 启用中文全文检索
到此,Wik.js以及Elasticsearch的部署和配置工作都完成了。接下来,我们需要在Wiki.j的设置中启用中文全文检索。
在Wiki.js的管理后台中,单击“设置”然后单击“全文检索”。
在全文检索的配置页面中,选择“Elasticsearch”为搜索引擎。
随后,单击资产库,将Wiki.js中所有内容索引到Elasticsearch中。
完成后,您的Wiki.js已经部署完成了,并且已经启用了中文全文检索功能。
简单的使用例子请参考下面的内容:
例1:安装完毕后默认语言为英文
如果在Wiki.js安装完成后,默认的语言为英文,可以按照以下步骤进行更改。
首先在Wiki.js的管理后台中,单击“设置”,然后在“常规”选项卡中选择默认语言为中文。
接着,单击“保存”以应用更改。
例2:为Wiki.js添加一个页面
在Wiki.js中添加页面很简单。只需在左侧菜单栏中选择“目录”选项卡,在任何一个目录中,可以点击“+”按钮以添加新页面。
在新页面编辑器中,您可以输入页面的内容。编辑页面时,Wiki.js会自动保存您的内容。保存后,您可以在Wiki.js的搜索框中搜索新页面的关键字并查找到该页面。
希望这给您指导如何在KubeSphere中部署Wiki系统wiki.js并启用中文全文检索提供了有用的指导。
本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:KubeSphere中部署Wiki系统wiki.js并启用中文全文检索 - Python技术站