维护模式

Neo4j 支持两种维护模式：在线和离线，您可以使用它们来执行不同的维护任务。

在线维护

在线维护不需要停止 neo4j 进程。它使用 kubectl exec 命令执行。

直接运行任务

kubectl exec <release-name>-0 -- neo4j-admin database info --from-path=/var/lib/neo4j/data/databases --expand-commands

所有 neo4j-admin 命令都需要 --expand-commands 标志才能在 Neo4j 容器中运行。这是因为 Neo4j Helm chart 使用命令扩展来定义 Neo4j 配置，以便在运行时动态解析一些配置参数。

要运行一系列命令，请使用交互式 shell

kubectl exec -it <release-name>-0 -- bash

使用 kubectl exec 执行的进程会计入 Neo4j 容器的内存分配。因此，运行使用大量内存的任务或在内存极度受限的配置中运行 Neo4j 可能会导致 Neo4j 容器被底层操作系统终止。

您可以使用 Neo4j 离线维护模式来执行需要 Neo4j 离线的维护任务。在此模式下，neo4j 进程不运行。但是，Neo4j Pod 会运行，但它永远不会达到 READY 状态。

要将 Neo4j 实例置于离线维护模式，您需要设置 offlineMaintenanceModeEnabled: true 并升级 helm release。
- 您可以通过使用 values.yaml 文件来完成此操作
  1. 打开您的 values.yaml 文件，并将 offlineMaintenanceModeEnabled: true 添加到 neo4j 对象
    
    neo4j: offlineMaintenanceModeEnabled: true
  2. 运行 helm upgrade 以应用更改
    
    helm upgrade <release-name> neo4j/neo4j -f values.yaml
- 或者，您可以在 helm upgrade 命令中将 neo4j.offlineMaintenanceModeEnabled 设置为 true
  helm upgrade neo4j/neo4j --version=2025.05.0 --reuse-values --set neo4j.offlineMaintenanceModeEnabled=true
轮询 kubectl get pods 直到 Pod 重启（STATUS=Running）。
```
kubectl get pod <release-name>-0
```

使用交互式 shell 连接到 Pod

kubectl exec -it "<release-name>-0" -- bash

离线维护任务使用 kubectl exec 命令执行。

直接运行任务

kubectl exec <release-name>-0 -- neo4j-admin database info --from-path=/var/lib/neo4j/data/databases --expand-commands

对于长时间运行的命令，请使用 shell 并使用 nohup 运行任务，这样即使 kubectl exec 连接断开，任务也会继续。

kubectl exec -it <release-name>-0 -- bash
  $ nohup neo4j-admin database check neo4j --expand-commands &>job.out </dev/null &
  $ tail -f job.out

完成维护任务后，将 Neo4j 实例恢复正常运行

您可以通过使用 values.yaml 文件来完成此操作
1. 打开您的 values.yaml 文件，并将 offlineMaintenanceModeEnabled: false 添加到 neo4j 对象
  neo4j: offlineMaintenanceModeEnabled: false
2. 运行 helm upgrade 以应用更改
  helm upgrade <release-name> neo4j/neo4j -f values.yaml

或者，您可以在 helm upgrade 命令中将该标志设置为 false

helm upgrade  neo4j/neo4j-standalone --version=2025.05.0 --reuse-values --set neo4j.offlineMaintenanceModeEnabled=false