Kubernetes中Citus从10.2升级至11.2失败求助

方法一：临时修改Pod启动命令，跳过Citus扩展加载并执行升级 #

• 编辑你的Citus StatefulSet/Deployment：

  kubectl edit statefulset <你的citus状态集名称>
  

  （如果使用Deployment，替换为kubectl edit deployment <你的citus部署名称>）

• 在容器的command字段替换原启动命令，改为先禁用Citus预加载再启动PostgreSQL：

  command:
    - bash
    - -c
    - |
      sed -i 's/shared_preload_libraries = .*citus.*/shared_preload_libraries = ""/' /var/lib/postgresql/data/postgresql.conf
      exec postgres -c config_file=/var/lib/postgresql/data/postgresql.conf
  

  注意：/var/lib/postgresql/data需与你的Pod中PostgreSQL数据目录一致，根据实际情况调整。

• 保存配置后，K8s会重新创建Pod，此时PostgreSQL将不加载Citus扩展，正常启动。

• 进入启动后的Pod执行升级命令：

  kubectl exec -it <citus-pod名称> -- psql -U <数据库用户名> -d <数据库名称>
  

  在psql终端中执行：

  ALTER EXTENSION citus UPDATE TO '11.2';
  

  （默认数据库名、用户名为postgres，可根据实际情况修改）

• 恢复原启动命令：再次编辑StatefulSet/Deployment，将command改回初始内容，保存后Pod会重启，Citus即可正常加载。

方法二：通过临时容器挂载数据卷执行升级 #

• 创建临时Pod配置文件temp-citus-upgrade.yaml，挂载Citus数据卷并使用目标版本镜像：

  apiVersion: v1
  kind: Pod
  metadata:
    name: citus-upgrade-temp
  spec:
    containers:
    - name: citus-temp
      image: citusdata/citus:11.2-pg14
      command: ["sleep", "3600"]
      volumeMounts:
      - name: citus-data
        mountPath: /var/lib/postgresql/data
    volumes:
    - name: citus-data
      persistentVolumeClaim:
        claimName: <你的citus数据PVC名称>
  

  创建临时Pod：

  kubectl apply -f temp-citus-upgrade.yaml
  

• 进入临时Pod，启动PostgreSQL单用户模式执行升级：

  kubectl exec -it citus-upgrade-temp -- bash
  

  在容器内依次执行：

  su - postgres
  postgres --single -D /var/lib/postgresql/data <数据库名称>
  

  在单用户模式下执行升级命令：

  ALTER EXTENSION citus UPDATE TO '11.2';
  

  完成后按Ctrl+D退出单用户模式。

• 删除临时Pod并重启原Citus Pod：

  kubectl delete pod citus-upgrade-temp
  kubectl delete pod <原citus-pod名称>
  

  此时原Pod即可正常启动。

注意事项 #

• 操作前务必备份数据，避免意外导致数据丢失。
• 确认Citus升级路径合规：10.2到11.2支持基于PG14的直接升级。
• 若为Citus集群，需先升级协调器节点，再按相同步骤升级工作节点。

内容的提问来源于stack exchange，提问作者Devaddy