使用 Helm 部署 Wikijs

使用 Helm 部署 Wiki.js

📚️ 参考文档:

Wiki.js 官方文档 - 安装 - Kubernetes

Wiki.js 使用 Helm 安装

Wiki.js 官方文档 - 安装 - 侧加载

官方教程

Kubernetes

开始使用 Helm Chart 在 Kubernetes 上安装

先决条件

• Kubernetes 集群
• Helm
• PostgreSQL 数据库

❗️ 重要

• ** 您必须先部署单个实例才能设置应用程序。** 设置完成后，您可以将副本数量增加到任意数量。
• 尽管 wiki.js 支持其他数据库引擎，但多副本要求必须使用 PostgreSQL。

安装 Helm Chart

有关详细的安装说明，请参阅 wiki.js helm repo。

介绍

此图表使用 Helm 包管理器在 Kubernetes 群集上启动 wiki.js 部署。

它还可选地将 PostgreSQL 打包为数据库，但您可以自由携带自己的数据库。

先决条件

• 如果您想要数据持久性，则需要由基础设施中的 PV 供应商支持（启用持久存储）

安装 Chart

要安装带有 my-release 发布名称的 chart，请在此 （helm） 目录运行以下情况：

📚️ 参考文档:

Wiki.js helm chart git 仓库地址

需要先将该 Git 仓库 clone 下来，并跳转到 （helm） 目录，然后执行下面的命令.

使用 Helm3：

$ helm install my-release .

使用 Helm2：

$ helm install --name my-release . 

该命令在 Kubernetes 群集上的 default 租户中部署 wiki.js。[[使用 Helm 部署 Wikijs# 配置]] 部分列出了安装过程中可以配置的参数。

提示： 使用 helm list 列出所有版本

卸载 Chart

卸载 / 删除 my-release 部署：

$ helm delete my-release

命令会删除与 该 Chart 关联的所有 Kubernetes 组件并删除该 release。

警告：数据库的 PVC 不会自动删除。它们需要手动删除

$ kubectl delete pvc/data-wiki-postgresql-0

配置

下表列出了维基图表的可配置参数.js 及其默认值。

参数	描述	默认
image.repository	wiki.js image	requarks/wiki
image.tag	wiki.js image tag	latest
imagePullPolicy	镜像拉取策略	IfNotPresent
replicacount	要运行的 wiki.js 服务 pod 数量	1
resources.limits	wiki.js 服务资源限制	nil
resources.requests	wiki.js 服务资源请求	nil
nodeSelector	wiki.js 的 nodeSelector	{}
affinity	wiki.js pod 分配的亲和力设置	{}
schedulerName	wiki.js pod 备用调度器的名称	nil
tolerations	wiki.js 吊舱分配的容忍标签	[]
ingress.enabled	启用入口控制器资源	false
ingress.annotations	入口注释	{}
ingress.hosts	入口规则列表	[{"host": "wiki.local", "paths": ["/"]}]
ingress.tls	入口 TLS 配置	[]
postgresql.enabled	是否部署 postgresql（见下文）	true
postgresql.postgresqlDatabase	postgresql 数据库名称	wiki
postgresql.postgresqlUser	postgresql 用户名	postgres
postgresql.postgresqlHost	postgresql 主机	nil
postgresql.postgresqlPassword	postgresql 密码	nil
postgresql.postgresqlPort	postgresql 端口	5432
postgresql.persistence.enabled	使用 PVC 启用 postgresql 持久性	true
postgresql.persistence.existingClaim	为 postgresql 提供已有 PersistentVolumeClaim	nil
postgresql.persistence.storageClass	postgresql PVC 存储类（例如：nfs)	nil
postgresql.persistence.size	postgresql PVC 存储大小需求	8Gi

使用 --set key=value[,key=value] 参数指定每个参数来 helm install。例如，

$ helm install --name my-release \
  --set postgresql.persistence.enabled=false \
   . 

或者，在安装 chart 时可以提供指定上述参数值的 YAML 文件。例如，

$ helm install --name my-release -f values.yaml . 

提示：您可以使用默认 values.yaml

PostgreSQL

默认情况下，作为 Chart 的一部分安装 PostgreSQL。

使用外部 PostgreSQL 服务器

要使用外部 PostgreSQL 服务器，设置 postgresql.enabled 为 false 然后设置 postgresql.postgresqlHost 和 postgresql.postgresqlPassword。其他选项 postgresql.postgresqlDatabase、postgresql.postgresqlUser（和）postgresql.postgresqlPort 可能也需要从其默认值中更改。

您还需要在部署中添加以下 Helm 模板：

kind: Secret
apiVersion: v1
metadata:
  name: {{ template "wiki.postgresql.secret" . }}
data:
  {{ template "wiki.postgresql.secretKey" . }}: "{{ .Values.postgresql.postgresqlPassword | b64enc }}"

持久化

PVC 用于在整个部署中保留数据。请参阅 [[使用 Helm 部署 Wikijs# 配置]] 部分以配置 PVC 或禁用持久化。

Ingress

此 Chart 为 Ingress 资源提供支持。如果你有一个可用的 ingress 控制器，如 Nginx 或 Traefik，你可能想设置 ingress.enabled 为真，并为 URL 选择一个 ingress.hostname。然后，您应该能够使用该地址访问安装。

离线环境下使用 Helm 部署 Wiki.js

📚️ 参考文档:

Wiki.js 官方文档 - 安装 - Kubernetes

Wiki.js 使用 Helm 安装

Wiki.js 官方文档 - 安装 - 侧加载

概述

根据官方文档和 GitHub issues 的分析。离线环境下，那么需要将从 internet 下载的数据侧载 (sideload)。

这是通过手动下载一组文件并将它们放置在 wiki 安装中的特定目录来实现的。这些文件将在初始化期间导入。

在 Wiki.js 安装文件夹的 path data/sideload 中创建一个新文件夹。

例如，如果您的 wiki 安装在路径 /wiki (wikijs 的 docker image 里 wiki 的安装路径为 /wiki)，那么您需要在路径 /wiki/data/sideload 创建一个文件夹.

Locales

为了安装 locale 包，您需要主 locale 文件 + 至少一个 locale 包文件。

ℹ️ 信息:

这些文件可以从 https://github.com/Requarks/wiki-localization 下载。这些档案每天晚上都是最新的。

主文件

主文件 locales.json 包含有关所有可用语言的信息，并且必须安装。

将此文件放在先前创建的 sideload 文件夹中。

Locale 包

语言环境软件包文件 xx.json 或 xx-zz.json 包含所选语言的所有翻译。 您可以同时加载任意数量的语言环境。

⚠️ 警告:

英语包 en.json 是必须的，因为这是安装期间的默认语言。 之后您可以更改语言.

将文件放在先前创建的 sideload 文件夹中主文件的旁边。 现在，您的文件夹中应该具有 locales.json，en.json 和任何其他语言。

Sideload

⚠️ 警告:

必须先修改 wiki.js 配置文件: config.yml. 增加如下一行: offline: true

运行 Wiki.js (如果已经在运行，则重新启动进程)，自动加载位于 data/sideload 文件夹中的文件。

步骤

📝 备注:

由于笔者时间不足，就不将额外的步骤整合到 helm chart 中去了.

以下步骤假设:

1. 已安装 helm
2. 已 clone wikijs 的 git 仓库
3. 已 跳转到 helm/ 目录下

1. 通过 helm 安装 wiki.js 和 postgresql:

   helm install wikijs . -n wiki --set image.tag=2,postgresql.persistence.storageClass=nfs-fast

   配置说明如下，创建好了 helm 会有相关成功的提示，此时可以使用，但是加载不到 locale 语言包。下一步需要 通过 sideload 加载语言包.

   1. 在 wiki 租户下进行安装；
   2. wiki.js 的镜像版本 tag 为 2, 保证不会因为选择 latest 标签，导致 wiki.js 突然从 2 升级到 3, 导致服务异常；
   3. postgresql 的持久化存储的 storageClass 为 nfs-fast, 通过它自动申请存储.

2. 因为需要 sideload. 需要修改 config.yml, 通过如下 ConfigMap 的方式修改。步骤如下:

   1. 创建如下 ConfigMap - wiki-config, 相比默认的只增加了一行:

      

   2. 在 wikijs 的 Deployment 中，做如下修改，将上边的 ConfigMap 通过 SubPath 挂载到指定位置

      

3. 因为需要 sideload, 需要创建 data/sideload 文件夹，并将 locales 文件放到该目录。通过 PVC 实现

   1. 申请个 50M 左右的 PVC - sideload-data (步骤略)

   2. 将 PVC 挂载到 wikijs Deployment 指定目录:

      

   3. 再将下载好的 locales.json, en.json 和 zh.json 放到容器中的指定目录: /wiki/data/sideload. 如下:

      

4. 待 wikijs Deployment 重启好之后，就可以进入页面进行安装。分别填入:

   1. 管理员邮箱
   2. 管理员密码，再次确认管理员密码
   3. wikijs 站点的 URL
   4. 就会自动安装配置完成.

5. 进入之后就可以在这里配置中文:

   

6. 至此，离线环境下使用 Helm 部署 Wiki.js 完成. 🎉🎉🎉

总结

相比在线环境，多出了如下步骤:

1. ConfigMap 通过 SubPath 方式挂载 wiki.js 的配置文件 config.yml, 配置文件多了一句: offline: true
2. 申请一个新的 PVC, 挂载到 /wiki/data/sideload, 并将 locales 相关文件放进去.

离线环境下 在 OpenShift 中使用 Helm 部署 Wiki.js

ℹ️ 信息:

OpenShift 4.4+ 版本支持 Helm3

OpenShift 中，对权限要求比较严格，最简单的适配步骤，就是将 wiki.js 所用的 ServiceAccount 权限放开.

相比上一节，多出来的，或者有调整的具体操作如下:

1. 通过 helm3 安装:

   helm install wikijs . -n wiki --set image.tag=2.5,postgresql.serviceAccount.enabled=true,postgresql.serviceAccount.name=wikijs,postgresql.persistence.storageClass=nfs-fast

   ℹ️ 说明如下:

   1. wikijs 安装的时候就是用的 wikijs 这个 ServiceAccount, 为了简化权限步骤，postgresql 也用这个 ServiceAccount
   2. 具体的参数就是: postgresql.serviceAccount.enabled=true,postgresql.serviceAccount.name=wikijs

2. 给 wikijs 这个用户赋权 SCC: anyuid: oc adm policy add-scc-to-user anyuid -z wikijs -n wiki

3. 其他步骤都和上一节一致.

总结

通过这篇文章的介绍，可以看出 Wiki.js 功能还是很强大的，值得一用.

在 Kubernetes 中用 helm 部署，直接使用官方的最简命令即可；

在离线环境下的 Kubernetes 中用 helm 部署，需要多 2 个步骤:

1. ConfigMap 通过 SubPath 方式挂载 wiki.js 的配置文件 config.yml, 配置文件多了一句: offline: true
2. 申请一个新的 PVC, 挂载到 /wiki/data/sideload, 并将 locales 相关文件放进去.

在离线环境下的 OpenShift 中用 helm 部署，由于权限限制严格，需要调整 ServiceAccount 并授予更高权限.

🎉🎉🎉