Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

5.3. 管理支持服务

本节概述 OpenShift Serverless Logic 所必需的支持服务。它专门用于使用 OpenShift Serverless Logic Operator 配置和部署数据索引服务和作业服务支持服务。

在典型的 OpenShift Serverless Logic 安装中，您必须部署这两个服务来确保成功执行工作流。Data Index 服务允许高效的数据管理，而作业服务则可确保可靠的作业处理。

5.3.1. 支持服务和工作流集成
复制链接

当您在给定命名空间中部署支持服务时，您可以选择启用或禁用的部署。启用的部署会向 OpenShift Serverless Logic Operator 发出信号，以使用命名空间中的 preview 或 gitops 配置集自动截获工作流部署，并将它们配置为与服务连接。

例如，当启用 Data Index 服务时，工作流会自动配置为向它发送状态更改事件。同样，启用作业服务可确保每当工作流需要超时时创建作业。OpenShift Serverless Logic Operator 还配置作业服务，将事件发送到 Data Index 服务，从而促进服务间的无缝集成。

OpenShift Serverless Logic Operator 不仅部署支持服务，它还管理其他必要的配置，以确保工作流成功执行。所有这些配置都会自动处理。您只需要在 SonataFlowPlatform CR 中提供支持服务配置。

注意

仅部署其中一个支持服务或使用禁用的部署是高级用例。在标准安装中，您必须启用这两个服务来确保平稳执行工作流。

5.3.2. 使用 SonataFlowPlatform CR 支持服务部署
复制链接

要部署支持服务，请在 SonataFlowPlatform 自定义资源(CR)的 spec.services 部分中配置 dataIndex 和 jobService 子字段。此配置指示 OpenShift Serverless Logic Operator 在应用 SonataFlowPlatform CR 时部署每个服务。

服务的每个配置都独立处理，允许您自定义这些设置以及 SonataFlowPlatform CR 中的其他配置。

有关部署支持服务，请参阅以下构建示例配置： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  services:
    dataIndex:
1 

      enabled: true
2 

      # Specific configurations for the Data Index Service
      # might be included here
    jobService:
3 

      enabled: true
4 

      # Specific configurations for the Job Service
      # might be included here
Copy to Clipboard Toggle word wrap
1
数据索引服务配置字段。
2
设置 enabled: true 部署 Data Index 服务。如果设置为 false 或 omitted，则部署将被禁用。默认值为 false。
3
Job Service 配置字段。
4
设置 enabled: true 部署作业服务。如果设置为 false 或 omitted，则部署将被禁用。默认值为 false。

5.3.3. 支持服务范围
复制链接

SonataFlowPlatform 自定义资源(CR)启用在特定命名空间中部署支持服务。这意味着所有自动配置的支持服务和工作流通信都仅限于所部署平台的命名空间。

当不同版本的工作流需要单独的支持服务实例时，此功能特别有用。例如，您可以使用其工作流和支持服务以隔离方式部署应用程序，确保它们与其他部署保持相互独立。

5.3.4. 支持服务持久性配置
复制链接

OpenShift Serverless Logic 中支持服务的持久性配置可以是临时的，也可以是 PostgreSQL，具体取决于您的环境的需求。临时持久性是开发和测试的理想选择，而 PostgreSQL 持久性则用于生产环境。

5.3.4.1. 临时持久性配置
复制链接

临时持久性使用专用于每个服务的嵌入式 PostgreSQL 数据库。OpenShift Serverless Logic Operator 使用每个服务重启重新创建此数据库，使其仅适用于开发和测试目的。您不需要以下 SonataFlowPlatform CR 以外的任何其他配置： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  services:
    dataIndex:
      enabled: true
      # Specific configurations for the Data Index Service
      # might be included here
    jobService:
      enabled: true
      # Specific configurations for the Job Service
      # might be included here
Copy to Clipboard Toggle word wrap

5.3.4.2. 数据库迁移配置
复制链接

数据库迁移指的是将给定的 Data Index 或 Jobs Service 数据库初始化到其相应的模式，或者在发布新版本时应用数据或模式更新。您必须使用 dataIndex.persistence.dbMigrationStrategy 和 jobService.persistence.dbMigrationStrategy 可选字段为每个支持服务单独配置数据库迁移策略。如果没有配置迁移策略，系统将使用 service 作为默认值。

注意

只有在使用 PostgreSQL 持久性配置时，才支持数据库迁移。

您可以配置以下数据库迁移策略：

5.3.4.2.1. 基于作业的数据库迁移策略
复制链接

当您配置基于作业的策略时，OpenShift Serverless Logic Operator 使用专用的 Kubernetes 作业 来管理整个迁移过程。该作业 在支持服务部署之前运行，确保仅在对应的迁移成功完成时才启动服务。您通常在生产环境中使用此策略。

5.3.4.2.2. 基于服务的数据库迁移策略
复制链接

当您配置基于服务的策略时，数据库迁移直接由每个支持服务管理。迁移作为服务启动序列的一部分执行。在最糟糕的情况中，如果迁移失败，服务可能会因为失败而启动。当您未指定任何配置时，基于服务的数据库迁移是默认的策略。

5.3.4.2.3. none 迁移策略
复制链接

当您配置 none 策略时，Operator 和服务都不会尝试执行迁移。您通常在数据库管理员(DBA)手动执行所有数据库迁移的环境中使用此策略。

5.3.4.3. PostgreSQL 持久性配置
复制链接

对于 PostgreSQL 持久性，您必须在集群中设置 PostgreSQL 服务器实例。此实例的管理保留独立于 OpenShift Serverless Logic Operator 控制。要将支持服务与 PostgreSQL 服务器连接，您必须配置适当的数据库连接参数。

您可以使用以下示例在 SonataFlowPlatform CR 中配置 PostgreSQL 持久性：

PostgreSQL 持久性配置示例

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  services:
    dataIndex:
      enabled: true
      persistence:
        dbMigrationStrategy: job
1 

        postgresql:
          serviceRef:
            name: postgres-example
2 

            namespace: postgres-example-namespace
3 

            databaseName: example-database
4 

            databaseSchema: data-index-schema
5 

            port: 1234
6 

          secretRef:
            name: postgres-secrets-example
7 

            userKey: POSTGRESQL_USER
8 

            passwordKey: POSTGRESQL_PASSWORD
9 

    jobService:
      enabled: true
      persistence:
        dbMigrationStrategy: job
        postgresql:
        # Specific database configuration for the Job Service
        # might be included here.
Copy to Clipboard Toggle word wrap

1
可选：要使用的数据库迁移策略。默认为 service。
2
与 PostgreSQL 数据库服务器连接的服务名称。
3
可选：定义 PostgreSQL Service 的命名空间。默认为 SonataFlowPlatform 命名空间。
4
定义用于存储支持服务数据的 PostgreSQL 数据库的名称。
5
可选：指定存储支持服务数据的模式。默认值为 SonataFlowPlatform 名称，后缀为 with -data-index-service or -jobs-service。例如，s onataflow-platform-example-data-index-service。
6
可选：与 PostgreSQL 服务连接的端口号。默认值为 5432。
7
定义包含数据库访问的用户名和密码的机密名称。
8
定义机密中的密钥名称，其中包含要与数据库连接的用户名。
9
定义机密中的密钥名称，其中包含要与数据库连接的密码。
注意

您可以使用对应的 persistence 字段独立配置每个服务的持久性。

运行以下命令，创建 secret 以访问 PostgreSQL： 

$ oc create secret generic <postgresql_secret_name> \
  --from-literal=POSTGRESQL_USER=<user> \
  --from-literal=POSTGRESQL_PASSWORD=<password> \
  -n <namespace>
Copy to Clipboard Toggle word wrap

5.3.4.4. 常见的 PostgreSQL 持久性配置
复制链接

OpenShift Serverless Logic Operator 会自动将支持服务连接到 spec.persistence 字段中配置的通用 PostgreSQL 服务器。

对于规则，以下优先级适用：

  • 如果您为支持服务配置特定的持久性，如 services.dataIndex.persistence，它会使用该配置。
  • 如果没有为服务配置持久性，系统将使用当前平台的通用持久性配置。
注意

使用通用 PostgreSQL 配置时，每个服务模式会自动设置为 SonataFlowPlatform 名称，后缀为 with -data-index-service 或 -jobs-service，例如 sonataflow-platform-example-data-index-service。

5.3.4.5. 平台范围内的 PostgreSQL 持久性配置
复制链接

您可以使用 SonataFlowPlatform 自定义资源(CR)中的 spec.persistence.postgresql 字段为所有支持服务配置通用 PostgreSQL 服务和数据库。配置此字段时，OpenShift Serverless Logic Operator 会将支持服务连接到指定的数据库。任何使用 preview 或 gitops 配置集部署到同一命名空间中的工作流，没有指定自定义持久性配置，也会连接到此数据库。

在配置平台范围持久性时应用以下规则：

  • 如果支持服务有自己的持久性配置，例如，如果设置了 services.dataIndex.persistence.postgresql，则该配置将具有优先权。
  • 如果支持服务没有自定义持久性配置，则配置将继承在当前平台中。
  • 如果支持服务需要特定的数据库迁移策略，请使用 dataIndex.persistence.dbMigrationStrategy 和 jobService.persistence.dbMigrationStrategy 字段进行配置。

以下 SonataFlowPlatform CR 片段演示了如何配置平台范围 PostgreSQL 持久性： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  persistence:
    postgresql:
      serviceRef:
        name: postgres-example
1 

        namespace: postgres-example-namespace
2 

        databaseName: example-database
3 

        port: 1234
4 

      secretRef:
        name: postgres-secrets-example
5 

        userKey: POSTGRESQL_USER
6 

        passwordKey: POSTGRESQL_PASSWORD
7 

    dataIndex:
      enabled: true
      persistence:
        dbMigrationStrategy: job
8 

    jobService:
      enabled: true
      persistence:
        dbMigrationStrategy: service
9
Copy to Clipboard Toggle word wrap
1
用于连接到 PostgreSQL 数据库服务器的 Kubernetes 服务的名称。
2
（可选） 包含 PostgreSQL 服务的命名空间。默认为 SonataFlowPlatform 命名空间。
3
用于存储支持服务和工作流数据的 PostgreSQL 数据库的名称。
4
（可选）连接到 PostgreSQL 服务的端口。默认值为 5432。
5
包含数据库凭证的 Kubernetes Secret 名称。
6
存储数据库用户名的机密密钥。
7
存储数据库密码的机密密钥。
8
（可选） Data Index 的数据库迁移策略。默认为 service。
9
（可选）作业服务的数据库迁移策略。默认为 service。如果需要，您可以为每个服务配置不同的策略。

5.3.5. 支持服务事件系统配置
复制链接

对于 OpenShift Serverless Logic 安装，会生成以下类型的事件：

  • 与工作流业务逻辑相关的传出和传入事件。
  • 从工作流发送到 Data Index 和 Job Service 的事件。
  • 从作业服务发送到数据索引服务的事件。

OpenShift Serverless Logic Operator 利用 Knative Eventing 系统来管理这些事件和服务之间的所有事件通信，确保事件处理高效且可靠的事件处理。

5.3.5.1. 平台范围内的事件系统配置
复制链接

要配置平台范围内的事件系统，您可以使用 SonataFlowPlatform CR 中的 spec.eventing.broker.ref 字段来引用 Knative Eventing Broker。此配置指示 OpenShift Serverless Logic Operator 自动链接支持服务，以使用指定的代理生成和使用事件。

使用 preview 或 gitops 配置集部署到同一命名空间中的工作流，且没有自定义事件系统配置，会自动链接到指定的代理。

重要

在生产环境中，使用生产环境就绪的代理（如 Knative Kafka Broker）来提高可扩展性和可靠性。

以下示例演示了如何为平台范围事件系统配置 SonataFlowPlatform CR： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  eventing:
    broker:
      ref:
        name: example-broker
1 

        namespace: example-broker-namespace
2 

        apiVersion: eventing.knative.dev/v1
        kind: Broker
Copy to Clipboard Toggle word wrap
1
指定 Knative Eventing Broker 名称。
2
可选：定义 Knative Eventing Broker 的命名空间。如果没有指定值，则参数默认为 SonataFlowPlatform 命名空间。考虑在与 SonataFlowPlatform 相同的命名空间中创建 Broker。

5.3.5.2. 系统范围的事件系统配置
复制链接

系统范围的事件系统配置允许对事件系统进行精细的控制，特别是 Data Index 或 Job Service。

注意

对于 OpenShift Serverless Logic 安装，请考虑使用平台范围事件系统配置。服务级别配置仅用于高级用例。

5.3.5.3. 数据索引事件系统配置
复制链接

要为 Data Index 配置服务范围事件系统，您必须使用 SonataFlowPlatform CR 中的 spec.services.dataIndex.source.ref 字段来引用特定的 Knative Eventing Broker。此配置指示 OpenShift Serverless Logic Operator 自动链接 Data Index，以使用来自该代理的 SonataFlow 系统事件。

重要

在生产环境中，使用生产环境就绪的代理（如 Knative Kafka Broker）来提高可扩展性和可靠性。

以下示例显示了 Data Index 事件系统配置： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
spec:
  services:
    dataIndex:
      source:
        ref:
          name: data-index-source-example-broker
1 

          namespace: data-index-source-example-broker-namespace
2 

          apiVersion: eventing.knative.dev/v1
          kind: Broker
Copy to Clipboard Toggle word wrap
1
指定 Data Index 使用事件的 Knative Eventing Broker。
2
可选：定义 Knative Eventing Broker 的命名空间。如果没有指定值，则参数默认为 SonataFlowPlatform 命名空间。考虑在与 SonataFlowPlatform 相同的命名空间中创建代理。

5.3.5.4. 作业服务事件系统配置
复制链接

要为作业服务配置服务范围事件系统，您必须使用 SonataFlowPlatform CR 中的 spec.services.jobService.source.ref 和 spec.services.jobService.sink.ref 字段。这些字段指示 OpenShift Serverless Logic Operator 根据提供的配置自动链接作业服务以使用和生成 SonataFlow 系统事件。

重要

在生产环境中，使用生产环境就绪的代理（如 Knative Kafka Broker）来提高可扩展性和可靠性。

以下示例显示了作业服务事件系统配置： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
spec:
  services:
    jobService:
      source:
        ref:
          name: jobs-service-source-example-broker
1 

          namespace: jobs-service-source-example-broker-namespace
2 

          apiVersion: eventing.knative.dev/v1
          kind: Broker
      sink:
        ref:
          name: jobs-service-sink-example-broker
3 

          namespace: jobs-service-sink-example-broker-namespace
4 

          apiVersion: eventing.knative.dev/v1
          kind: Broker
Copy to Clipboard Toggle word wrap
1
指定作业服务消耗事件的 Knative Eventing Broker。
2
可选：定义 Knative Eventing Broker 的命名空间。如果没有指定值，则参数默认为 SonataFlowPlatform 命名空间。考虑在与 SonataFlowPlatform 相同的命名空间中创建 Broker。
3
指定作业服务在其上生成事件的 Knative Eventing Broker。
4
可选：定义 Knative Eventing Broker 的命名空间。如果没有指定值，则参数默认为 SonataFlowPlatform 命名空间。考虑在与 SonataFlowPlatform 相同的命名空间中创建 Broker。

当您部署集群范围的支持服务时，支持服务会自动链接到 SonataFlowPlatform CR 中指定的 Broker，该代理由 SonataFlowClusterPlatform CR 引用。

OpenShift Serverless Logic Operator 按照定义的优先级顺序为支持服务配置事件系统。

Eventing 系统配置优先级规则如下：

  1. 如果支持服务有自己的事件系统配置，则使用 Data Index 事件系统或作业服务事件系统配置，则支持服务配置具有优先权。
  2. 如果 SonataFlowPlatform CR 认为支持服务配置了平台范围事件系统，则该配置具有优先权。
  3. 如果当前集群配置了集群范围的事件系统，则该配置将具有优先权。
  4. 如果以前配置没有存在，支持服务通过直接 HTTP 调用来提供事件。

5.3.5.7. Eventing 系统链接配置
复制链接

OpenShift Serverless Logic Operator 会自动创建 Knative Eventing、SinkBindings 和触发器，以使用事件系统链接支持服务。这些对象通过支持服务实现事件的生产和消费。

以下示例显示了为 SonataFlowPlatform CR 创建的 Knative Native 事件对象： 

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  eventing:
    broker:
      ref:
        name: example-broker
1 

        apiVersion: eventing.knative.dev/v1
        kind: Broker
  services:
    dataIndex:
2 

      enabled: true
    jobService:
3 

      enabled: true
Copy to Clipboard Toggle word wrap
1
数据索引、作业服务和工作流使用，除非被覆盖。
2
数据索引临时部署，配置 Data Index 服务。
3
作业服务临时部署，配置作业服务。

以下示例演示了如何配置用于 SonataFlowPlatform CR 的 Knative Kafka Broker：

SonataFlowPlatform CR 使用的 Knative Kafka Broker 示例

apiVersion: eventing.knative.dev/v1
kind: Broker
metadata:
  annotations:
    eventing.knative.dev/broker.class: Kafka
1 

  name: example-broker
  namespace: example-namespace
spec:
  config:
    apiVersion: v1
    kind: ConfigMap
    name: kafka-broker-config
    namespace: knative-eventing
Copy to Clipboard Toggle word wrap

1
使用 Kafka 类创建 Kafka Knative Broker。

以下命令显示为 Data Index 和 Job Service 事件设置的触发器列表，显示哪些服务订阅事件： 

$ oc get triggers -n example-namespace
Copy to Clipboard Toggle word wrap

输出示例

NAME                                                        BROKER           SINK                                                       AGE   CONDITIONS   READY   REASON
data-index-jobs-fbf285df-c0a4-4545-b77a-c232ec2890e2        example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-definition-e48b4e4bf73e22b90ecf7e093ff6b1eaf   example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-error-fbf285df-c0a4-4545-b77a-c232ec2890e2   example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-instance-mul35f055c67a626f51bb8d2752606a6b54   example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-node-fbf285df-c0a4-4545-b77a-c232ec2890e2      example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-state-fbf285df-c0a4-4545-b77a-c232ec2890e2     example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
data-index-process-variable-ac727d6051750888dedb72f697737c0dfbf   example-broker   service:sonataflow-platform-example-data-index-service     106s  7 OK / 7    True    -
jobs-service-create-job-fbf285df-c0a4-4545-b77a-c232ec2890e2    example-broker   service:sonataflow-platform-example-jobs-service         106s  7 OK / 7    True    -
jobs-service-delete-job-fbf285df-c0a4-4545-b77a-c232ec2890e2    example-broker   service:sonataflow-platform-example-jobs-service         106s  7 OK / 7    True    -
Copy to Clipboard Toggle word wrap

要查看作业服务的 SinkBinding 资源，请使用以下命令： 

$ oc get sources -n example-namespace
Copy to Clipboard Toggle word wrap

输出示例

NAME                                          TYPE          RESOURCE                           SINK                    READY
sonataflow-platform-example-jobs-service-sb   SinkBinding   sinkbindings.sources.knative.dev   broker:example-broker   True
Copy to Clipboard Toggle word wrap

5.3.6. 高级支持服务配置
复制链接

如果需要为支持服务应用高级配置，请在 SonataFlowPlatform 自定义资源(CR)中使用 podTemplate 字段。此字段允许您通过指定副本数、环境变量、容器镜像和初始化选项等配置来自定义服务 pod 部署。

您可以使用以下示例为服务配置高级设置：

Data Index 服务的高级配置示例

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowPlatform
metadata:
  name: sonataflow-platform-example
  namespace: example-namespace
spec:
  services:
    # This can be either 'dataIndex' or 'jobService'
    dataIndex:
      enabled: true
      podTemplate:
        replicas: 2
1 

        container:
2 

          env:
3 

            - name: <any_advanced_config_property>
              value: <any_value>
          image:
4 

        initContainers:
5
Copy to Clipboard Toggle word wrap

注意

您可以根据您的要求，将 'services' 字段设置为 'dataIndex' 或 'jobService'。其余的配置保持不变。

1
定义副本数量。默认值为 1。如果是 jobService，则该值始终被覆盖到 1，因为它作为单例服务运行。
2
包含运行该服务的容器的具体配置。
3
允许您通过指定环境变量来微调服务属性。
4
为服务配置容器镜像，如果您需要更新或自定义镜像，则很有用。
5
为 pod 配置 init 容器，有助于在主容器启动前设置先决条件。
注意

podTemplate 字段提供定制每个支持服务部署的灵活性。它遵循标准 PodSpec API，即相同的 API 验证规则适用于这些字段。

5.3.7. 集群范围内的支持服务
复制链接

您可以使用 SonataFlowClusterPlatform 自定义资源(CR)定义一组集群范围的支持服务，供不同命名空间中的工作流使用。通过引用特定于命名空间的 SonataFlowPlatform CR，您可以对集群范围内扩展这些服务。

您可以使用以下基本配置示例，它允许在任何命名空间中部署的工作流使用在特定命名空间中部署的支持服务，如 example-namespace ：

SonataFlowClusterPlatform CR 示例

apiVersion: sonataflow.org/v1alpha08
kind: SonataFlowClusterPlatform
metadata:
  name: cluster-platform
spec:
  platformRef:
    name: sonataflow-platform-example
1 

    namespace: example-namespace
2
Copy to Clipboard Toggle word wrap

1
指定已安装的 SonataFlowPlatform CR 的名称，用于管理支持服务。
2
指定管理支持服务的 SonataFlowPlatform CR 的命名空间。
注意

您可以通过在 SonataFlowPlatform.spec.services 中配置该命名空间来覆盖任何命名空间中的这些集群范围的服务。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat