服务绑定

1. 使用 从 OpenShift Container Platform Web UI 安装 Service Binding Operator 过程安装 Service Binding Operator 版本 1.3.3 和更高版本。

   1. 验证安装：

      oc get csv -w

      Copy to Clipboard Toggle word wrap

      当 Service Binding Operator 的 阶段 设置为 Succeeded 时，继续下一步。

2. 使用 Web 控制台或 CLI 从 OperatorHub 安装 Crunchy PostgreSQL Operator。

   1. 验证安装：

      oc get csv -w

      Copy to Clipboard Toggle word wrap

      当 Operator 的 阶段 设置为 Succeeded 时，继续下一步。

3. 创建 PostgreSQL 集群：

   1. 创建新的 OpenShift Container Platform 命名空间，它将用于创建集群并在以后部署应用程序。此命名空间将在整个流程中称为 demo。

      oc new-project demo

      Copy to Clipboard Toggle word wrap

   2. 创建以下自定义资源，并将它保存为 pg-cluster.yml ：

      apiVersion: postgres-operator.crunchydata.com/v1beta1
      kind: PostgresCluster
      metadata:
        name: hippo
      spec:
        openshift: true
        image: registry.developers.crunchydata.com/crunchydata/crunchy-postgres:ubi8-14.2-1
        postgresVersion: 14
        instances:
          - name: instance1
            dataVolumeClaimSpec:
              accessModes:
              - "ReadWriteOnce"
              resources:
                requests:
                  storage: 1Gi
        backups:
          pgbackrest:
            image: registry.developers.crunchydata.com/crunchydata/crunchy-pgbackrest:ubi8-2.38-0
            repos:
            - name: repo1
              volume:
                volumeClaimSpec:
                  accessModes:
                  - "ReadWriteOnce"
                  resources:
                    requests:
                      storage: 1Gi

      Copy to Clipboard Toggle word wrap
      注意

      此 YAML 已从 Service Binding Operator Quickstart 重复使用。

   3. 应用创建的自定义资源：

      oc apply -f ~/pg-cluster.yml

      Copy to Clipboard Toggle word wrap
      注意

      此命令假设您将 pg-cluster.yml 文件保存到 HOME 目录中。

   4. 检查 pod 以验证安装：

      oc get pods -n demo

      Copy to Clipboard Toggle word wrap
      • 等待 Pod 进入 READY 状态，表示安装已完成。

4. 创建一个绑定到 PostgreSQL 数据库的 Quarkus 应用程序。

   您要创建的应用程序是一个基本的 todo 应用程序，它使用 Hibernate 和 Panache 连接到 PostgreSQL。

   1. 生成应用程序：

      mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:create \
        -DplatformGroupId=com.redhat.quarkus.platform \
        -DplatformVersion=3.2.12.SP1-redhat-00003 \
        -DprojectGroupId=org.acme \
        -DprojectArtifactId=todo-example \
        -DclassName="org.acme.TodoResource" \
        -Dpath="/todo"

      Copy to Clipboard Toggle word wrap

   2. 添加连接到 PostgreSQL 所需的所有扩展，生成所有必需的资源，并为应用程序构建容器镜像：

      ./mvnw quarkus:add-extension -Dextensions="resteasy-reactive-jackson,jdbc-postgresql,hibernate-orm-panache,openshift,kubernetes-service-binding"

      Copy to Clipboard Toggle word wrap

   3. 如以下示例所示，创建一个简单的实体：

      package org.acme;
      
      import jakarta.persistence.Column;
      import jakarta.persistence.Entity;
      
      import io.quarkus.hibernate.orm.panache.PanacheEntity;
      
      @Entity
      public class Todo extends PanacheEntity {
      
          @Column(length = 40, unique = true)
          public String title;
      
          public boolean completed;
      
          public Todo() {
          }
      
          public Todo(String title, Boolean completed) {
              this.title = title;
          }
      
      }

      Copy to Clipboard Toggle word wrap

   4. 公开实体：

      package org.acme;
      
      import jakarta.transaction.Transactional;
      import jakarta.ws.rs.*;
      import jakarta.ws.rs.core.Response;
      import jakarta.ws.rs.core.Response.Status;
      import java.util.List;
      
         @Path("/todo")
         public class TodoResource {
      
             @GET
             @Path("/")
             public List<Todo> getAll() {
               return Todo.listAll();
             }
      
             @GET
             @Path("/{id}")
             public Todo get(@PathParam("id") Long id) {
                 Todo entity = Todo.findById(id);
                 if (entity == null) {
                     throw new WebApplicationException("Todo with id of " + id + " does not exist.", Status.NOT_FOUND);
                 }
                 return entity;
             }
      
             @POST
             @Path("/")
             @Transactional
             public Response create(Todo item) {
                 item.persist();
                 return Response.status(Status.CREATED).entity(item).build();
             }
      
             @GET
             @Path("/{id}/complete")
             @Transactional
             public Response complete(@PathParam("id") Long id) {
                 Todo entity = Todo.findById(id);
                 entity.id = id;
                 entity.completed = true;
                 return Response.ok(entity).build();
             }
      
      
             @DELETE
             @Transactional
             @Path("/{id}")
             public Response delete(@PathParam("id") Long id) {
                 Todo entity = Todo.findById(id);
                 if (entity == null) {
                     throw new WebApplicationException("Todo with id of " + id + " does not exist.", Status.NOT_FOUND);
                 }
                 entity.delete();
                 return Response.noContent().build();
             }
      
         }

      Copy to Clipboard Toggle word wrap

5. 通过生成 ServiceBinding 资源来绑定到目标 PostgreSQL 集群。

   1. 提供服务协调来生成绑定并配置数据源：

      • apiVersion: postgres-operator.crunchydata.com/v1beta1
      • kind: PostgresCluster

      • 名称： pg-cluster

        这可以通过设置 quarkus.kubernetes-service-binding.services.<id>. 前缀来实现，如下例所示。id 用于将属性分组到一起，并可分配任何值。

        quarkus.kubernetes-service-binding.services.my-db.api-version=postgres-operator.crunchydata.com/v1beta1
        quarkus.kubernetes-service-binding.services.my-db.kind=PostgresCluster
        quarkus.kubernetes-service-binding.services.my-db.name=hippo
        
        quarkus.datasource.db-kind=postgresql
        quarkus.hibernate-orm.database.generation=drop-and-create
        quarkus.hibernate-orm.sql-load-script=import.sql

        Copy to Clipboard Toggle word wrap

   2. 创建一个带有一些初始数据的 import.sql 脚本：

      INSERT INTO todo(id, title, completed) VALUES (nextval('hibernate_sequence'), 'Finish the blog post', false);

      Copy to Clipboard Toggle word wrap

6. 部署应用程序，包括 ServiceBinding 并将其应用到集群：

   mvn clean install -Dquarkus.kubernetes.deploy=true -DskipTests

   Copy to Clipboard Toggle word wrap

   等待部署完成。

验证

1. 验证部署：

   oc get pods -n demo -w

   Copy to Clipboard Toggle word wrap

2. 验证安装：

   1. 端口转发至本地 HTTP 端口，然后访问 /setuptools 端点。

      oc port-forward service/todo-example 8080:80

      Copy to Clipboard Toggle word wrap

   2. 在网页浏览器中打开以下 URL：

      http://localhost:8080/todo

      Copy to Clipboard Toggle word wrap