WSO2 API Manager部署K8s：Carbon_DB转PostgreSQL的数据库部署疑问

核心结论 #

WSO2 API Manager的所有节点完全可以共享同一个PostgreSQL数据库实例，不需要为每个节点单独部署数据库。Carbon_DB存储的是APIM的核心配置、用户数据、权限等共享型数据，多节点共享同一数据库是生产环境的标准做法，能保证全局数据一致性。

具体实施步骤 #

• 部署PostgreSQL实例到K8s集群
  用StatefulSet或官方Helm Chart部署高可用PostgreSQL，创建专属数据库（如carbon_db）和用户（如wso2_apim），并授予该用户数据库的全部操作权限。

• 修改APIM配置文件（deployment.toml）
  替换默认的H2数据库配置为PostgreSQL，示例配置如下：

  # 替换APIM核心数据库配置
  [database.apim_db]
  type = "postgresql"
  url = "jdbc:postgresql://postgresql-service:5432/carbon_db"
  username = "wso2_apim"
  password = "your-secure-password"
  driver = "org.postgresql.Driver"
  
  # 替换共享数据库配置（部分APIM版本直接使用carbon_db节点，需根据实际版本调整）
  [database.shared_db]
  type = "postgresql"
  url = "jdbc:postgresql://postgresql-service:5432/carbon_db"
  username = "wso2_apim"
  password = "your-secure-password"
  driver = "org.postgresql.Driver"
  

  注：postgresql-service替换为K8s中PostgreSQL服务的实际名称。

• 确保PostgreSQL JDBC驱动存在
  如果使用的WSO2 APIM镜像未包含PostgreSQL驱动，需构建自定义镜像，将postgresql-<version>.jar放入镜像内的<APIM_HOME>/repository/components/lib目录。

• 挂载配置到K8s APIM部署
  将修改后的deployment.toml通过K8s ConfigMap挂载到每个APIM容器的对应配置路径（如/home/wso2carbon/wso2am-4.2.0/repository/conf/deployment.toml），确保所有节点使用统一的数据库配置。

关键注意事项 #

• 生产环境必须为PostgreSQL配置高可用（如主从复制、自动故障转移），避免单点故障。
• 放弃H2数据库的选择完全正确：H2是嵌入式数据库，不支持多节点共享，且PVC存储方式存在数据一致性和持久化风险，绝不适合生产环境。
• 部署前需初始化数据库：执行WSO2 APIM安装包内<APIM_HOME>/dbscripts/postgresql目录下的初始化脚本，创建所需表结构和初始数据。

内容的提问来源于stack exchange，提问作者Иван Атлас