第 2 章 配置外部 PostgreSQL 数据库

流程

1. 可选：创建一个证书 secret 来使用 TLS 连接配置 PostgreSQL 实例：

   cat <<EOF | oc -n my-rhdh-project create -f -
   apiVersion: v1
   kind: Secret
   metadata:
    name: my-rhdh-database-certificates-secrets 

   1

   
   type: Opaque
   stringData:
    postgres-ca.pem: |-
     -----BEGIN CERTIFICATE-----
     <ca-certificate-key> 

   2

   
    postgres-key.key: |-
     -----BEGIN CERTIFICATE-----
     <tls-private-key> 

   3

   
    postgres-crt.pem: |-
     -----BEGIN CERTIFICATE-----
     <tls-certificate-key> 

   4

   
     # ...
   EOF

   Copy to Clipboard Toggle word wrap

   1

   提供证书 secret 的名称。

   2

   提供 CA 证书密钥。

   3

   可选：提供 TLS 私钥。

   4

   可选：提供 TLS 证书密钥。

2. 创建凭证 secret 以与 PostgreSQL 实例连接：

   cat <<EOF | oc -n my-rhdh-project create -f -
   apiVersion: v1
   kind: Secret
   metadata:
    name: my-rhdh-database-secrets 

   1

   
   type: Opaque
   stringData: 

   2

   
    POSTGRES_PASSWORD: <password>
    POSTGRES_PORT: "<db-port>"
    POSTGRES_USER: <username>
    POSTGRES_HOST: <db-host>
    PGSSLMODE: <ssl-mode> # for TLS connection 

   3

   
    NODE_EXTRA_CA_CERTS: <abs-path-to-pem-file> # for TLS connection, e.g. /opt/app-root/src/postgres-crt.pem 

   4

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   提供凭证 secret 的名称。

   2

   提供用于连接 PostgreSQL 实例的凭证数据。

   3

   可选：根据所需的 安全套接字层(SSL)模式提供值。

   4

   可选： 只有在需要 PostgreSQL 实例的 TLS 连接时才提供值。

3. 创建 Backstage 自定义资源(CR)：

   cat <<EOF | oc -n my-rhdh-project create -f -
   apiVersion: rhdh.redhat.com/v1alpha3
   kind: Backstage
   metadata:
     name: <backstage-instance-name>
   spec:
     database:
       enableLocalDb: false 

   1

   
     application:
       extraFiles:
         mountPath: <path> # e g /opt/app-root/src
         secrets:
           - name: my-rhdh-database-certificates-secrets 

   2

   
             key: postgres-crt.pem, postgres-ca.pem, postgres-key.key # key name as in my-rhdh-database-certificates-secrets Secret
       extraEnvs:
         secrets:
           - name: my-rhdh-database-secrets 

   3

   
           # ...

   Copy to Clipboard Toggle word wrap

   1

   将 enableLocalDb 参数的值设置为 false，以禁用创建本地 PostgreSQL 实例。

   2

   如果您配置了 TLS 连接，请提供证书 secret 的名称。

   3

   提供您创建的凭证 secret 的名称。

   注意

   Backstage CR 中列出的环境变量与 Operator 默认配置一起工作。如果更改了 Operator 默认配置，您必须相应地重新配置 Backstage CR。

4. 将 Backstage CR 应用到已部署 Developer Hub 实例的命名空间。