6.4. 服务绑定入门

流程

1. 在 shell 中运行以下命令来在 my-petclinic 命名空间中创建 PostgresCluster CR：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: postgres-operator.crunchydata.com/v1beta1
   kind: PostgresCluster
   metadata:
     name: hippo
   spec:
     image: registry.developers.crunchydata.com/crunchydata/crunchy-postgres-ha:centos8-13.4-0
     postgresVersion: 13
     instances:
       - name: instance1
         dataVolumeClaimSpec:
           accessModes:
           - "ReadWriteOnce"
           resources:
             requests:
               storage: 1Gi
     backups:
       pgbackrest:
         image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbackrest:centos8-2.33-2
         repos:
         - name: repo1
           volume:
             volumeClaimSpec:
               accessModes:
               - "ReadWriteOnce"
               resources:
                 requests:
                   storage: 1Gi
         - name: repo2
           volume:
             volumeClaimSpec:
               accessModes:
               - "ReadWriteOnce"
               resources:
                 requests:
                   storage: 1Gi
     proxy:
       pgBouncer:
         image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbouncer:centos8-1.15-2
   EOD

   此 PostgresCluster CR 中的注解启用服务绑定连接并触发 Operator 协调。

   输出会验证数据库实例是否已创建：

   输出示例

   postgrescluster.postgres-operator.crunchydata.com/hippo created

2. 创建数据库实例后，确保 my-petclinic 命名空间中的所有 pod 都在运行：

   $ oc get pods -n my-petclinic

   输出（需要几分钟）验证是否创建并配置了数据库：

   输出示例

   NAME                               READY   STATUS    RESTARTS   AGE
   hippo-backup-nqjg-2rq94            1/1     Running   0          35s
   hippo-instance1-nw92-0             3/3     Running   0          112s
   hippo-pgbouncer-57b98f4476-znsk5   2/2     Running   0          112s
   hippo-repo-host-0                  1/1     Running   0          112s

   配置了数据库后，您可以部署示例应用程序并将其连接到数据库服务。

流程

1. 在 shell 中运行以下命令，使用 PostgresCluster 自定义资源(CR)部署 spring-petclinic 应用程序：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: spring-petclinic
     labels:
       app: spring-petclinic
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: spring-petclinic
     template:
       metadata:
         labels:
           app: spring-petclinic
       spec:
         containers:
           - name: app
             image: quay.io/service-binding/spring-petclinic:latest
             imagePullPolicy: Always
             env:
             - name: SPRING_PROFILES_ACTIVE
               value: postgres
             ports:
             - name: http
               containerPort: 8080
   ---
   apiVersion: v1
   kind: Service
   metadata:
     labels:
       app: spring-petclinic
     name: spring-petclinic
   spec:
     type: NodePort
     ports:
       - port: 80
         protocol: TCP
         targetPort: 8080
     selector:
       app: spring-petclinic
   EOD

   输出会验证 Spring PetClinic 示例应用是否已创建并部署：

   输出示例

   deployment.apps/spring-petclinic created
   service/spring-petclinic created

   注意

   如果要在 web 控制台的 Developer 视角中使用 容器镜像 部署应用程序，则必须在高级选项的 Deployment 部分输入以下环境变量：

   • 名称：SPRING_PROFILES_ACTIVE
   • 值： postgres

2. 运行以下命令，验证应用程序是否还没有连接到数据库服务：

   $ oc get pods -n my-petclinic

   显示 CrashLoopBackOff 状态需要几分钟时间 ：

   输出示例

   NAME                                READY   STATUS             RESTARTS      AGE
   spring-petclinic-5b4c7999d4-wzdtz   0/1     CrashLoopBackOff   4 (13s ago)   2m25s

   在这个阶段，pod 无法启动。如果您尝试与应用交互，它会返回错误。

流程

1. 创建 ServiceBinding CR 以项目绑定数据：

   $ oc apply -n my-petclinic -f - << EOD
   ---
   apiVersion: binding.operators.coreos.com/v1alpha1
   kind: ServiceBinding
   metadata:
     name: spring-petclinic-pgcluster
   spec:
     services: 1
       - group: postgres-operator.crunchydata.com
         version: v1beta1
         kind: PostgresCluster 2
         name: hippo
     application: 3
       name: spring-petclinic
       group: apps
       version: v1
       resource: deployments
   EOD

   1

   指定服务资源列表。

   2

   数据库的 CR。

   3

   示例应用程序，指向带有嵌入式 PodSpec 的 Deployment 或任何其他类似资源。

   输出会验证是否已创建 ServiceBinding CR 以将绑定数据项目到示例应用程序中。

   输出示例

   servicebinding.binding.operators.coreos.com/spring-petclinic created

2. 验证服务绑定的请求是否成功：

   $ oc get servicebindings -n my-petclinic

   输出示例

   NAME                         READY   REASON              AGE
   spring-petclinic-pgcluster   True    ApplicationsBound   7s

   默认情况下，来自数据库服务的绑定数据的值作为运行示例应用程序的工作负载容器中的文件进行投射。例如，Secret 资源中的所有值都投射到 bindings/spring-petclinic-pgcluster 目录中。

   注意

   另外，您还可以通过打印出目录内容来验证应用程序中的文件是否包含投射绑定数据：

   $ for i in username password host port type; do oc exec -it deploy/spring-petclinic -n my-petclinic -- /bin/bash -c 'cd /tmp; find /bindings/*/'$i' -exec echo -n {}:" " \; -exec cat {} \;'; echo; done

   输出示例：使用来自 secret 资源的所有值

   /bindings/spring-petclinic-pgcluster/username: <username>
   /bindings/spring-petclinic-pgcluster/password: <password>
   /bindings/spring-petclinic-pgcluster/host: hippo-primary.my-petclinic.svc
   /bindings/spring-petclinic-pgcluster/port: 5432
   /bindings/spring-petclinic-pgcluster/type: postgresql

3. 设置应用程序端口的端口转发，以便从本地环境访问示例应用程序：

   $ oc port-forward --address 0.0.0.0 svc/spring-petclinic 8080:80 -n my-petclinic

   输出示例

   Forwarding from 0.0.0.0:8080 -> 8080
   Handling connection for 8080

4. 访问 http://localhost:8080/petclinic。

   现在，您可以在 localhost:8080 远程访问 Spring PetClinic 示例应用程序，并查看应用程序现在连接到数据库服务。