如何在OpenShift中配置Thorntail应用连接内置PostgreSQL数据源？

我之前在Thorntail+OpenShift内置PostgreSQL的场景里踩过类似的坑，给你梳理下关键的解决步骤：

1. 先确认OpenShift内置PostgreSQL的基础信息 #

首先要确保你的应用和PostgreSQL在同一个OpenShift项目（namespace）里，这样才能通过服务名直接访问。

• 执行oc get svc查看PostgreSQL的服务名称，默认情况下内置的PostgreSQL服务名是postgresql，如果不是，你需要把连接URL里的主机名改成实际的服务名。
• 执行oc describe secret postgresql查看存储数据库凭证的Secret，里面会有database-name、username、password这几个关键字段，这些是我们后续配置需要的凭证来源。

2. 确保应用Pod能获取到数据库凭证环境变量 #

OpenShift不会自动把PostgreSQL的Secret值注入到你的应用Pod里，你需要手动在应用的DeploymentConfig/Deployment中配置环境变量，从Secret中读取值：

# 在你的应用DeploymentConfig的spec.template.spec.containers[0].env下添加
- name: POSTGRESQL_DATABASE
  valueFrom:
    secretKeyRef:
      name: postgresql
      key: database-name
- name: POSTGRESQL_USER
  valueFrom:
    secretKeyRef:
      name: postgresql
      key: username
- name: POSTGRESQL_PASSWORD
  valueFrom:
    secretKeyRef:
      name: postgresql
      key: password

这样应用启动时就能拿到这些环境变量了。

3. 调整project-defaults.yml的配置 #

Thorntail配置中环境变量的引用推荐用${变量名}的格式（部分版本可能不兼容$变量名），同时建议加上连接池的验证配置，避免连接失效问题：

thorntail:
  datasources:
    data-sources:
      postgres_tenancy:
        driver-name: mypostgres
        connection-url: postgresql://postgresql:5432/${POSTGRESQL_DATABASE}
        user-name: ${POSTGRESQL_USER}
        password: ${POSTGRESQL_PASSWORD}
        # 新增连接池优化配置
        min-pool-size: 5
        max-pool-size: 20
        validate-on-match: true
        valid-connection-checker-class-name: org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker
        exception-sorter-class-name: org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter
    jdbc-drivers:
      mypostgres:
        driver-class-name: org.postgresql.Driver
        xa-datasource-name: org.postgresql.xa.PGXADataSource
        driver-module-name: org.postgresql

4. 确保PostgreSQL驱动正确引入 #

如果你的应用没有打包PostgreSQL驱动，需要在pom.xml中添加依赖：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.2.23</version> <!-- 选择适配你Thorntail版本的驱动版本 -->
</dependency>

如果使用Thorntail的模块方式，要确保org.postgresql模块已经在应用中正确配置。

5. 验证与排错 #

部署应用后，通过oc logs <你的应用Pod名称>查看日志：

• 如果出现"unknown host"错误，检查PostgreSQL服务名称是否正确，或者应用和PostgreSQL是否在同一个项目里（跨项目需要用postgresql.<项目名>.svc.cluster.local作为主机名）。
• 如果出现认证失败，检查Secret的key是否对应正确，环境变量是否成功注入（可以进入Pod执行echo ${POSTGRESQL_USER}验证）。
• 如果出现连接超时，检查PostgreSQL的服务端口是否为5432（通过oc describe svc postgresql确认），以及Pod之间的网络策略是否允许通信。

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