第4章 外部 PostgreSQL データベースの設定

手順

1. オプション: 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

   1

   証明書シークレットの名前を指定します。

   2

   CA 証明書の鍵を指定します。

   3

   オプション: TLS 秘密鍵を指定します。

   4

   オプション: TLS 証明書の鍵を指定します。

2. 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

   1

   認証情報シークレットの名前を指定します。

   2

   PostgreSQL インスタンスに接続するための認証情報データを指定します。

   3

   オプション: 必要な Secure Sockets Layer (SSL) モード に応じて値を指定します。

   4

   オプション: PostgreSQL インスタンスに TLS 接続が必要な場合にのみ値を指定します。

3. Backstage カスタムリソース (CR) を作成します。

   cat <<EOF | oc -n my-rhdh-project create -f -
   apiVersion: rhdh.redhat.com/v1alpha5
   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

   
           # ...

   1

   enableLocalDb パラメーターの値を false に設定して、PostgreSQL のローカルインスタンスの作成を無効にします。

   2

   TLS 接続を設定した場合は、証明書シークレットの名前を指定します。

   3

   作成した認証情報シークレットの名前を指定します。

   注記

   Backstage CR にリストされている環境変数は、Operator のデフォルト設定を使用します。Operator のデフォルト設定を変更した場合は、それに応じて Backstage CR を再設定する必要があります。

4. Backstage CR を Developer Hub インスタンスをデプロイした namespace に適用します。