App Connect Designer 编写参考

使用此引用可通过使用 IBM® Cloud Pak Platform UI 创建、更新或删除 App Connect Designer 实例、Red Hat® OpenShift® Web 控制台或 CLI,或 Kubernetes环境的 CLI。

小贴士 部署的 IBM Cloud Pak for Integration 平台用户界面 实例可让您访问 IBM Cloud Pak 平台用户界面,您可以从中心位置创建和管理功能实例。

简介

App Connect Designer Authoring API 使您能够创建用于开发,测试和共享集成流的 App Connect Designer 实例。 App Connect Designer 实例提供了用于托管非生产工作负载的编写环境。

使用准则:

可以在名称空间 (项目) 中创建 App Connect Designer 的多个实例,以供个人或团队使用。 然后,此名称空间中的用户可以使用其分配的实例来开发和管理流。

先决条件

Red Hat OpenShiftSecurityContextConstraints要求

IBMApp Connect在默认设置下运行restrictedSecurityContextConstraints。

需要的资源

建议的最低要求:

  • CPU: 1.85 核心
  • 内存: 2.6 GB
  • 存储器: 10 GB
使用映射辅助:
  • CPU: 3.1 核心
  • 内存: 3.8 GB

有关如何配置这些值的信息,请参阅 定制资源值

Storage

App Connect Designer 需要针对 Apache CouchDB 和针对 Mapping Assist 增量学习功能实施的人工智能 (AI) 模型的单独存储卷。

Apache CouchDB 支持的存储类型

IBM App Connect Operator 提供了 CouchDB NOSQL 数据库服务器,用于在容器的文件系统中的卷内存储流定义工件。

在创建 App Connect Designer 实例之前,必须确定要用于 CouchDB 的存储类型,因为您需要在创建实例时指定此存储类型,并且在创建实例后无法更改此设置。

可以使用以下存储类型来分配存储CouchDB:

持久存储器

建议使用持久存储器以实现额外的弹性,因为当 pod 重新启动时将保留 CouchDB 数据库。

注: 删除 12.0.8.0-r1 或更低版本的 Designer 实例时,将自动删除 CouchDB 数据库。 但是,当您删除 12.0.8.0-r2 或更高版本的 Designer 实例时,将保留 CouchDB 数据库,并且需要手动将其删除。 来自Red Hat OpenShift Web 控制台,您可以删除CouchDB数据库,导航至贮存>PersistentVolumeClaims然后删除以以下格式命名的 PVCdata-c-designerName-m-0 。 从 Red Hat OpenShiftKubernetes CLI ,您可以通过运行下列其中一个命令来删除 CouchDB 数据库:
OpenShift-only内容
oc delete pvc pvcName -n namespaceName
Kubernetes-仅内容OpenShift-only内容
kubectl delete pvc pvcName -n namespaceName

必须使用 spec.couchdb.storage.class 参数通过集群上可用的存储类动态供应持久卷。 存储类必须支持以下方式:

  • 动态卷供应
  • ReadWriteOnce(RWO)访问模式
  • volumeBindingMode: WaitForFirstConsumer (区域-本地存储器)
  • POSIX 文件系统兼容性 (例如,不是 NFS)

方式需求映射到公共公共云环境的以下首选选项:

提供程序 类型 存储类 文档
IBM Cloud IBM Block Storage ibm-block- * 文档
AWS Elastic Block Storage 奥斯-埃布斯 文档
Azure Azure Disk 缺省或受管-高级 文档

对于 Google 计算引擎 (GCE) ,可以使用持久磁盘,但必须手动创建 存储类 以支持动态供应。

有关持久卷的更多信息,请参阅 Kubernetes 文档中的 持久卷

如果选择持久存储器,那么需要指定存储类,存储器大小和副本 pod 数。

短暂存储量

使用此存储类型时,将创建临时卷以在 Designer pod 启动时存储 CouchDB 数据库。 ephemeral (emptyDir) 卷仅在 pod 的生存期存在,因此当 pod 重新启动时, CouchDB 数据库将丢失。 如果创建用于演示或测试的环境,那么通常可以选择此存储类型。

要在创建 App Connect Designer 实例时定义 CouchDB 的存储类型,必须通过设置 spec.couchdb.storage.type 参数在定制资源设置中指定首选类型,然后根据所选存储类型的需要填写其他 spec.couchdb.storage.* 参数。

AI 模型支持的存储类型

创建 App Connect Designer 实例时,可以选择启用增量学习功能,该功能使用 AI 建模技术来提高在所有编写的流中提供的源到目标映射建议的准确性。 将使用收集的有关映射首选项的训练数据定期重新训练所提供的 AI 模型。

在创建 App Connect Designer 实例之前,必须确定要用于 AI 模型的存储器类型,因为在创建实例时需要指定此存储器类型和任何关联设置。

注: 仅当 App Connect Designer 定制资源中的 spec.version 值解析为 12.0.1.0-r1 或更高版本时,递增学习才可用。 有关增量学习的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据转换

以下存储类型可用于为 AI 模型分配存储器:

持久存储器

通过此存储类型, AI 模型存储在容器的文件系统中的持久卷中。 可以通过集群上可用的存储类动态供应持久卷,也可以通过声明名称请求持久卷。 通过持久存储器,当 pod 重新启动时, AI 模型将保留在文件系统中,并且仅当您删除 App Connect Designer 实例时才会删除 AI 模型。

注: 仅当 App Connect Designer 定制资源中的 spec.version 值解析为 12.0.1.0-r1 或更高版本时,持久存储器才适用。

增量学习需要具有ReadWriteMany(RWX)功能。 如果使用 IBM Cloud,请使用 ibmc-file-gold-gid 存储类。

如果选择持久存储器,那么将需要指定存储类或现有声明的名称。 (不需要手动指定存储器大小,因为分配的缺省值适合需求。)

简单存储服务 (S3) 存储器

S3 存储器提供了持久存储器的备用选项,并且支持使用对象存储服务通过 S3 REST API 来存储 AI 模型。

仅当 App Connect 设计器 定制资源中的 spec.version 值解析为 12.0.1.0-r4 或更高版本时, 注: S3 存储器才适用。
限制:
  • 在受限网络中安装 IBM App Connect 操作程序 时,不支持 S3 存储器,因为集群需要因特网访问以从 S3 对象存储库读写训练数据。
  • 只有 Amazon S3IBM Cloud Object Storage S3 作为 S3 提供商受支持。

AI 模型将作为具有读/写访问权的对象存储在 S3 实例中的指定存储区中,并且可以在 S3 存储区中查看。 AI 模型以 ZIP 格式存储在存储区中的以下位置,每次重新训练模型时都会覆盖 ZIP 对象 (同名):

/mapping-assist-model/mapping_assist_v1.1.0.zip

警告: 如果 Designer 实例正在使用 AI 模型,那么请勿从 S3 存储区中删除该模型,因为累积数据将丢失。 虽然将自动为 Designer 实例创建新的基本模型,但在将此模型添加到 S3 存储区之前,需要在下一个调度的时间间隔 (仅使用在该时间间隔内整理的数据) 进行训练。
具有 AI 模型的 S3 存储区

如果选择 S3 存储器,那么需要为供应的 S3 实例指定以下存储器设置:

  • 用于存储 AI 模型的现有存储区的名称

    不限制您使用已包含其他对象的 S3 存储区,因为 AI 模型单独存储在专用文件夹 (mapping-assist-model) 中。 如果要在多个 App Connect Designer 实例中为 AI 模型启用 S3 存储器,那么必须对每个实例使用单独的 S3 存储区,以确保一个实例的 AI 模型不会被另一个实例的 AI 模型覆盖。

  • S3 REST API 向其发送读写对象请求的 S3 端点

    您应该能够从 S3 实例中找到可用端点。 例如,在 IBM Cloud Object Storage S3 上,您可以从 Endpoints 页面找到端点。

    为了最大限度减少等待时间,建议您使用与 App Connect Designer 实例位于同一地理区域中的 S3 存储区。 另外,请使用具有与 Designer 部署位置类似的位置或区域的端点。 有关更多信息、请参阅 IBM Cloud Object Storage S3 文档中的 端点和存储位置。以及 Amazon Web Services 文档中的 Amazon Simple Storage Service 端点和配额

  • 用于连接到存储区的 S3 凭证

    您将需要通过创建类型为 S3Credentials的配置来提供这些凭证。 有关更多信息,请参阅 创建类型为 S3Credentials 的配置以用于 App Connect Designer

要在创建 App Connect Designer 实例时定义 AI 模型的存储类型,必须通过设置 spec.designerMappingAssist.incrementalLearning.storage.type 参数在定制资源设置中指定首选类型,然后根据所选存储类型的需要完成其他 spec.designerMappingAssist.incrementalLearning.storage.* 参数。 如果要创建将 S3 存储器用于 AI 模型的 Designer 实例,那么必须首先创建类型为 S3Credentials 的配置对象,以存储用于访问存储区的凭证。

数据加密

为了保护静态存储的数据,支持使用以下选项来启用数据加密:

不支持其他选项,例如网络文件系统 (NFS)。

创建实例

您可以从 IBM Cloud Pak Platform UI 创建 App Connect Designer 实例、Red Hat OpenShift Web 控制台或 CLI,或 Kubernetes环境的 CLI。

配置身份和访问权管理 (IAM):

对于使用 IBM App Connect Operator 11.0.0 或更高版本创建的 App Connect Designer 12.0.10.0-r2 或更高版本的实例,可以使用 IAM 来控制对 Designer 实例的访问。 IAM 通过使用 Keycloak 来实现,以认证用户和授权访问权。 有关 IAM 的先决条件、为 Designer 实例启用 IAM 以及配置Keycloak, 看实施身份和访问管理App Connect设计师和App Connect仪表板实例

开始之前

  • 确保满足 先决条件
  • 如果要创建将 S3 存储器用于 AI 模型的 App Connect Designer 实例,请确保已创建类型为 S3Credentials 的配置对象,如 创建类型为 S3Credentials 的配置以用于 App Connect Designer中所述。
  • 决定在新版本可用时如何控制对实例的升级。 您在创建实例时指定的 spec.version 值将确定在安装后如何升级该实例,以及您是否需要为升级指定其他许可证或版本号。 要帮助您决定是指定允许您预订通道以进行更新的 spec.version 值,还是对实例使用特定版本的值,请在开始此任务之前查看 通道,版本和许可证的升级注意事项


    实例,服务器,配置或跟踪的名称空间限制:

    在其中创建实例或对象的名称空间长度不得超过 40 个字符。

IBM Cloud Pak Platform UI 创建实例

要从 App Connect Designer 实例创建 IBM Cloud Pak Platform UI 实例,请完成以下步骤:

  1. 在浏览器窗口中,登录到 Platform UI
    提示: 您可以使用已部署 IBM Cloud Pak for Integration Platform UI 实例的生成 URL 访问 Platform UI
    • 适用于 IBM App Connect Operator 11.0.0 或更高版本: Platform UI " 实例 " 页面将作为主页打开。 欢迎条幅包含可用于选择与现有系统 UI 匹配的轻主题,深主题或定制主题的主题切换器。
    • 适用于 IBM App Connect 操作员 10.1.1 或更低版本: Platform UI 主页将打开,其中包含提供对您有权创建,管理或使用的实例和其他资源的访问权的卡和导航菜单选项。 有关从该页面完成管理任务(如用户管理或平台自定义)的信息,请参阅 IBM Cloud Pak 基础服务文档中的 Platform UI


      从导航菜单 导航菜单,展开 管理 ,然后单击 集成实例

  2. 从 " 实例 " (或 集成实例) 页面,单击 创建实例
  3. 要从 " 创建实例 " 页面创建 App Connect Designer 实例,请单击 集成设计 磁贴,然后单击 下一步
  4. 创建集成设计实例 页面,单击磁贴以选择要创建的实例类型:
    • 启用 AI 的快速入门: 使用一个副本 pod 部署 App Connect Designer 实例,并启用 AI 支持的映射辅助和变换生成。
      如果您是唯一用户,或者想要快速入门以进行评估,并且还想要试用以下功能,请考虑选择此选项:
      • 映射辅助,提供 "智能映射" ,使您能够使用来自先前节点的最佳匹配项自动填充流中的字段
      • 变换生成,它使用提供的样本数据或下拉列表值来构造复杂 (JSONata) 变换,使您能够轻松地将源数据映射到目标数据
    • 在启用 AI 的情况下进行开发: 部署具有多个副本 pod 的 App Connect Designer 实例以实现弹性和高可用性,并启用 AI 支持的映射辅助和变换生成。
      请考虑选择此选项以创建另外提供以下功能的 开发 部署:
      • 映射辅助,提供 "智能映射" ,使您能够使用来自先前节点的最佳匹配项自动填充流中的字段
      • 变换生成,它使用提供的样本数据或下拉列表值来构造复杂 (JSONata) 变换,使您能够轻松地将源数据映射到目标数据
    • 快速启动: 部署具有一个副本 pod 的 App Connect Designer 实例。

      如果您是唯一的用户,并且希望快速开始进行评估,请考虑选择此选项。 缺省情况下, AI 支持的映射辅助和变换生成已禁用。

    • 开发: 部署具有多个副本 pod 的 App Connect Designer 实例,以实现弹性和高可用性。

      对于工作负载大于 快速启动 部署的多用户环境,请考虑选择此选项,以便能够在副本 pod 之间切换以支持故障转移。 缺省情况下, AI 支持的映射辅助和变换生成已禁用。

    • 从 Automation 资产中选择模板: (适用于 IBM App Connect Operator 11.0.0 或更高版本) 通过从 Automation 资产中选择现有模板来创建 Designer 实例。 有关详细信息,请参阅 IBM Cloud Pak for Integration 文档中的 从模板部署实例
  5. 单击下一步。 此时将打开 UI 表单 视图,其中包含创建实例所需的最低配置。
  6. 完成以下某个步骤:
    • 要快速进入,请完成配置字段的标准集合。 通过将 高级设置 设置为 ,可以在 UI 表单 视图中显示高级设置。 请注意,某些字段可能未在表单中表示。
      注: 缺省情况下,使用 Keycloak 的身份和访问权管理 (IAM) 处于启用状态,尽管认证和授权字段 (用于启用或禁用 IAM) 未显示在 UI 表单 视图中。 有关将 IAM 与您正在创建的实例结合使用的更多信息,请参阅实施身份和访问管理App Connect设计师和App Connect仪表板实例
      • 名称: 输入唯一标识此 Designer 实例的简短独特名称。
      • 名称空间: 输入要在其中创建 Designer 实例的名称空间 (项目) 的名称。 如果 Platform UI 部署在单个名称空间 (namespace-scoped) 中,那么将显示此名称空间,并且无法对其进行更改。
      • 标签: (适用于 IBM App Connect Operator 11.0.0 或更高版本) 添加一个或多个标签作为键/值对,可用于组织和分类 (作用域和选择) 实例。 有关更多信息,请参阅 标签和选择器

        缺省情况下,为标签提供了键 backup.appconnect.ibm.com/component 和值 designerauthoring。 如果需要使用 OpenShift API for Data Protection (OADP) 来运行备份和复原操作,那么将使用此标签,否则将忽略此标签。

      • 通道或版本: 选择 Designer 实例所基于的 App Connect 产品 (修订包) 版本。 您可以选择将解析为该通道上的最新标准版本的通道,或者选择特定标准版本。 如果您正在使用 IBM App Connect Operator 7.1.0 或更高版本,那么受支持的通道或版本将取决于集群中安装的 Red Hat OpenShift 版本。 有关这些值的更多信息,请参阅 spec.version values
      • 接受: 复审所提供链接中的许可证,然后单击此复选框以接受条款和条件。
      • 许可证 LI: 选择与所选通道或标准版本一致的许可证标识。 有关更多信息,请参阅 IBM App Connect 操作程序的许可参考
      • 许可证使用: 选择您有权使用的相应 CloudPakForIntegrationAppConnectEnterprise 许可证类型。
        IAM 权利:
        • 如果购买了 Cloud Pak for Integration,那么您有权使用 CloudPakForIntegration*AppConnectEnterprise* 样式的许可证。 但是,要使用 CloudPakForIntegration* 许可证,必须部署 Platform UI 实例。
        • 如果您购买了IBMApp Connect操作员对于独立部署,您只能AppConnectEnterprise*样式许可证,无论 IAM 是否启用或禁用。 (尽管安装Cloud Pak for Integration如果你想使用托管Keycloak部署以配置 IAM,您无权部署平台用户界面
      • 副本: 指定要为此部署运行的副本 pod 数。
      • 启用映射辅助: 将此开关设置为 on 以启用映射辅助组件。

        考虑是否要为智能映射和数据变换启用映射辅助 (这需要 额外资源)。 您还可以选择启用 映射辅助增量学习 ,以将 AI 建模用于增强的智能映射。 如果启用递增学习,那么需要指定 "学习" 频率,并指示 AI 模型应存储在持久卷还是 S3 存储区中。 如果您正在使用 S3 存储区,那么需要提供用于连接到此存储区的详细信息,包括为存储 S3 凭证而创建的类型为 S3Credentials的配置对象的名称。 在 YAML 视图中,可以使用 spec.designerMappingAssist.enabledspec.designerMappingAssist.incrementalLearning.* 参数来配置映射辅助功能。 有关映射辅助和 S3 存储器的配置对象的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据变换创建类型为 S3Credentials 的配置以用于 App Connect Designer

      • 存储类型: 选择要用于 CouchDB的存储类型。
        • persistent-claim: 选择此选项以存储在容器的文件系统中的持久卷中。 在 pod 重新启动时保留现有配置,日志和持久消息。
        • ephemeral: 对于仅在 Pod 生存期存在的临时卷中的存储器,请选择此选项。
      • 存储类: 为集群选择受支持的存储类,该存储类应用于动态供应属于该类的持久卷。 如果 存储类型 设置为 persistent-claim,那么此值是必需的。
        IAM 需求: Keycloak 需要块存储器以及设置为缺省类的存储类。 有关详细信息,请参阅 KeycloakIBM Cloud Pak for Integration 文档中的 存储选项
      • 大小: 以十进制或二进制格式指定 CouchDB 持久卷所需的最大存储量; 即 Gi 或 G。 如果 存储类型 设置为 persistent-claim,那么此值是必需的。

      如果要从 UI 表单 视图中指定任何高级设置,请将 高级设置 设置为 on

      • 高级: 日志级别: 选择要在 CouchDB 日志中显示的信息级别。 有效值为 infowarningerrordebugnotice
      • 高级: 副本: 指定要在 1-10 之间运行的 CouchDB 副本 pod 数。
      • 高级: 用于拉取映像的私钥: 指定要用于拉取所使用的任何映像的同一名称空间中私钥的引用的可选列表。 如果指定了这些私钥,那么这些私钥将传递给各个拉取器实现以供其使用。 例如,对于 Docker,仅采用 DockerConfig 类型的私钥。 有关更多信息,请参阅 https://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
      • 运行时容器映像名称和标记: 指定运行时容器的 Docker 映像的路径。
      • 运行时容器ImagePullPolicy:指示您是否希望每次都拉取运行时容器的图像、从不拉取,或者仅当它们不存在时才拉取。 有效值为 AlwaysNeverIfNotPresent
      • 运行时容器 (资源需求): 指定运行运行时容器的资源需求。 有关可以指定的值的信息,请参阅 定制资源值中的 spec.integrationServer.containers.runtime.resources.* 参数。
    • 要获取更高级的配置,请单击 YAML 以切换到 YAML 视图,然后使用所需的参数更新编辑器。
      • 有关可用参数及其值的信息,请参阅 定制资源值

        在提供的缺省参数中,当 spec.couchdb.storage.type 设置为 persistent-claim时,请注意 spec.couchdb.storage.class (以及 spec.couchdb.storage.size) 需要值。 spec.couchdb.storage.class 值必须与集群的受支持存储类匹配。 ( UI 表单 视图在下拉列表中显示这些类。)
        spec:
          couchdb:
            storage:
              class: 'storageClassValue'
              size: 10Gi
              type: persistent-claim
  7. 单击创建。 您将重定向到 实例 (或 集成实例) 页面。 该实例的条目显示在表中,初始状态为 Pending,您可以单击该条目以检查部署进度。 部署完成后,状态将更改为 Ready
    具有已部署的 Dashboard 和 Designer 实例的 "实例" (或 "集成实例") 页面

下一步操作

  1. 如果为此实例启用了带有 Keycloak 的 IAM ,请使用 Keycloak 管理控制台通过设置具有已分配角色的用户来管理用户对该实例的访问权。 有关详细信息,请参阅For more information, see实施身份和访问管理App Connect设计师和App Connect仪表板实例
  2. 与已配置的用户共享 Platform UI 的 URL ,并提供他们可用于登录 Platform UI 和 Designer 实例的身份验证凭据。

    授权用户可以通过单击 平台 UI中的名称来访问 Designer (集成设计) 实例,然后 使用该实例来编写流

Red Hat OpenShift Web 控制台创建实例

要使用 Red Hat OpenShift Web 控制台创建 App Connect Designer 实例,请完成以下步骤:

  1. 从浏览器窗口,登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于 " 管理员 " 透视图 Web 控制台的管理员透视图中。
  2. 在导航中,单击 操作程序 > 已安装的操作程序
  3. 如果需要,请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
  4. 从 " 已安装的操作程序 " 页面,单击 IBM App Connect
  5. App Connect OperatorOperator details 页面中,单击 Designer Authoring 选项卡。 任何先前创建的 Designer 实例都会显示在表中。
  6. 单击 创建 DesignerAuthoring

    从 " 操作程序详细信息 " 页面上的 详细信息 选项卡中,您还可以找到 Designer 编写 磁贴,然后单击 创建实例 以指定实例的安装设置。

  7. 要使用 "表单" 视图,请确保选中 表单视图 ,然后填写字段。 请注意,某些字段可能未在表单中表示。
    • 名称: 输入唯一标识此 Designer 实例的简短独特名称。
    • 标签: (适用于 IBM App Connect 操作程序 11.0.0 或更高版本)

      缺省情况下,为标签提供了键 backup.appconnect.ibm.com/component 和值 designerauthoring。 如果需要使用 OpenShift API for Data Protection (OADP) 来运行备份和复原操作,那么将使用此标签,否则将忽略此标签。 有关更多信息,请参阅 在 Red Hat OpenShift上备份和复原 IBM App Connect 资源和持久卷

    • 许可证/接受: 选中此复选框以接受许可证的条款和条件。
    • 许可证/许可证 LI: 选择与所选通道或标准版本一致的许可证标识。 有关更多信息,请参阅 IBM App Connect 操作程序的许可参考
    • 许可证/许可证使用: 选择您有权使用的相应 CloudPakForIntegrationAppConnectEnterprise 许可证类型。
      IAM 权利:
      • 如果购买了 Cloud Pak for Integration,那么您有权使用 CloudPakForIntegration*AppConnectEnterprise* 样式的许可证。 但是,要使用 CloudPakForIntegration* 许可证,必须部署 Platform UI 实例。
      • 如果您购买了IBMApp Connect操作员对于独立部署,您只能AppConnectEnterprise*样式许可证,无论 IAM 是否启用或禁用。 (尽管安装Cloud Pak for Integration如果你想使用托管Keycloak部署以配置 IAM,您无权部署平台用户界面
    • Couch DB/storage/Storage 类型: 选择要用于 CouchDB的存储器类型。
      • persistent-claim: 选择此选项以存储在容器的文件系统中的持久卷中。 在 pod 重新启动时保留现有配置,日志和持久消息。
      • ephemeral: 对于仅在 Pod 生存期存在的临时卷中的存储器,请选择此选项。
    • Couch DB/storage/Storage 类: 为集群选择受支持的存储类,该存储类应用于动态供应属于该类的持久卷。 如果 存储类型 设置为 persistent-claim,那么此值是必需的。
      IAM 需求: Keycloak 需要块存储器以及设置为缺省类的存储类。 有关详细信息,请参阅 KeycloakIBM Cloud Pak for Integration 文档中的 存储选项
    • Couch DB/storage/Log Level: 选择要在 CouchDB 日志中显示的信息级别。 有效值为 infowarningerrordebugnotice
    • Couch DB/storage/Replicas: 指定要在 1-10 之间运行的 CouchDB 副本 pod 的数量。
    • 通道或版本: 选择 Designer 实例所基于的 App Connect 产品 (修订包) 版本。 您可以选择将解析为该通道上的最新标准版本的通道,或者选择特定标准版本。 如果您正在使用 IBM App Connect Operator 7.1.0 或更高版本,那么受支持的通道或版本将取决于集群中安装的 Red Hat OpenShift 版本。 有关这些值的更多信息,请参阅 spec.version values
    • 副本: 指定要为此部署运行的副本 pod 数。
    • Designer 映射辅助/启用映射辅助: 将此开关设置为 true 以启用映射辅助组件。

      考虑是否要为智能映射和数据变换启用映射辅助 (这需要 额外资源)。 您还可以选择启用 映射辅助增量学习 ,以将 AI 建模用于增强的智能映射。 如果启用递增学习,那么需要指定 "学习" 频率,并指示 AI 模型应存储在持久卷还是 S3 存储区中。 如果您正在使用 S3 存储区,那么需要提供用于连接到此存储区的详细信息,包括为存储 S3 凭证而创建的类型为 S3Credentials的配置对象的名称。 在 YAML 视图中,可以使用 spec.designerMappingAssist.enabledspec.designerMappingAssist.incrementalLearning.* 参数来配置映射辅助功能。 有关映射辅助和 S3 存储器的配置对象的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据变换创建类型为 S3Credentials 的配置以用于 App Connect Designer

    如果要在 "表单" 视图中指定任何高级设置,请展开 高级配置 部分。

    • 验证授权:依次展开这些部分以完成允许您使用以下方式控制对 Designer 实例的访问的字段Keycloak实施身份和访问管理 (IAM)。 尽管两个部分都显示同一组字段,但验证字段与用户验证有关,而授权字段与访问权限相关。
      • 要使用 KeycloakIBM Cloud Pak for Integration 上提供的受管 Red Hat OpenShift 解决方案来控制对实例的访问、选择 integrationKeycloak/Enabled复选框以启用 Keycloak。 然后,将所有剩余字段留空。 Keycloak 默认已启用。 有关在创建的实例中使用 IAM 的更多信息,请参阅 通过在 Red Hat OpenShift 上使用托管 Keycloak 解决方案,在 IBM App Connect 中实施身份和访问管理
        限制:您不能使用托管Keycloak部署于Kubernetes环境,因此确保integrationKeycloak/Enabled复选框已清除(以禁用Keycloak) 并将其余字段留空。
      • 使用自我管理的Keycloak独立部署的解决方案IBMApp Connect操作员Red Hat OpenShift ,选择integrationKeycloak/Enabled复选框以启用Keycloak。 然后,填写除以下字段之外的所有剩余字段integrationKeycloak/Tls/Ingress主持人

        还要确保您使用的是AppConnectEnterprise*风格许可。 有关将 IAM 与您正在创建的实例结合使用的更多信息,请参阅实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

      • 使用自我管理的Keycloak独立部署的解决方案IBMApp Connect操作员Kubernetes ,选择integrationKeycloak/Enabled复选框以启用Keycloak。 然后,填写所有剩余的字段。

        还要确保您使用的是AppConnectEnterprise*风格许可。 有关将 IAM 与您正在创建的实例结合使用的更多信息,请参阅实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

      • 如果您不想限制对实例的访问,请清除integrationKeycloak/Enabled复选框并确保所有剩余字段都是空白的。 还要确保您正在使用 AppConnectEnterprise* 样式的许可证。

      填写相关字段以在托管中启用 IAMKeycloak部署或自我管理Keycloak部署:

      • integrationKeycloak/Auth/Client秘密名称:指定Kubernetes存储以下凭据的秘密Keycloak您设置的客户端,用于代表您自行管理的安全设计器实例Keycloak部署。 这些凭证被指定为用户提供的客户端 ID 和生成的客户端密钥当你创建Keycloak客户在里面Keycloak管理控制台。 有关如何创建此机密的信息,请参阅创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步3 )。

        如果integrationKeycloak/Enabled复选框被选中,并且integrationKeycloak/Endpoint值已定义。

      • integrationKeycloak/Enabled:选中验证部分使用 IAM 验证用户身份来控制对 Designer 实例的访问。 选中授权部分使用 IAM 授予访问权限来控制对 Designer 实例的访问。

        如果您不想限制对实例的访问,请将两个复选框留空。

        有关详细信息,请参阅For more information, see实施身份和访问管理IBMApp Connect通过使用托管Keycloak解决方案Red Hat OpenShift或者实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

      • integrationKeycloak/Endpoint: 指定用于在自我管理的 Keycloak 部署中访问 Keycloak 实例的 URL。 有关详细信息,请参阅为 Keycloak 实例定位 URL。 如果选择了 integrationKeycloak/Enabled 复选框,则需要此值。
      • integrationKeycloak/Realm:指定Keycloak你在自我管理的Keycloak部署来管理用户及其对 Designer 实例的访问。 有关详细信息,请参阅For more information, see设置自我管理部署Keycloak

        如果integrationKeycloak/Enabled复选框被选中,并且integrationKeycloak/Endpoint值已定义。

      • integrationKeycloak/Tls/Ca证书:指定密钥/值对中密钥的名称,该密钥定义来自您自行管理的证书颁发机构 (CA) 证书Keycloak部署。 此密钥和证书存储在integrationKeycloak/Tls/Secret姓名

        密钥的名称可以是ca.crt(默认)或您选择的其他名称。 有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例

        如果integrationKeycloak/Enabled复选框被选中,并且integrationKeycloak/Endpoint值已定义。

      • integrationKeycloak/Tls/Ingress主持人:如果你在Kubernetes具有自我管理的环境Keycloak部署,指定入口主机前缀和子域,它们组合起来形成 Designer UI 的主机名或入口路由。 (您需要为已部署的 Designer 实例手动创建入口路由,以定义外部可访问的 URL ,用于访问群集中正在运行的服务)

        入口路由通常在创建 Designer 实例后创建,但您可以预先决定要使用哪个入口主机前缀和子域,然后按照以下格式指定值:

        <designerHostPrefix>.<ingress_subdomain>

        有关详细信息,请参阅For more information, see创建外部访问入口定义IBMApp Connect实例

        如果integrationKeycloak/Enabled复选框被选中,并且integrationKeycloak/Endpoint值已定义。

      • integrationKeycloak/Tls/Secret姓名:指定用于存储您自行管理的 CA 证书的机密的名称Keycloak部署,用于在 Designer 实例和Keycloak实例。 创建机密时,定义一个键/值对,其中:
        • 密钥的默认名称为ca.crt或其他名称。 (您还需要将此键指定为integrationKeycloak/Tls/Ca证书
        • 价值是Base64-encodedCA 证书来自Keycloak

        有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步2 )。

        如果integrationKeycloak/Enabled复选框被选中,并且integrationKeycloak/Endpoint值已定义。

    • 用于拉取映像的私钥: 指定要用于拉取所使用的任何映像的同一名称空间中私钥的引用的可选列表。 如果指定了这些私钥,那么这些私钥将传递给各个拉取器实现以供其使用。 例如,对于 Docker,仅采用 DockerConfig 类型的私钥。 有关详细信息,请参阅For more information, seehttps://kubernetes.io/docs/concepts/containers/images/#specifying-imagepullsecrets-on-a-pod
    • 集成服务器 Pod/容器:
      • Integration Server Pod/容器/运行时/映像名称和标记: 指定运行时容器的 Docker 映像的路径。
      • 集成服务器Pod/containers/runtime/ImagePullPolicy:指示您是否希望每次都拉取运行时容器的图像、从不拉取,或者仅当它们不存在时才拉取。 有效值为 AlwaysNeverIfNotPresent
      • Integration Server Pod/容器/运行时/资源需求: 指定运行运行时容器的资源需求。 有关可以指定的值的信息,请参阅 定制资源值中的 spec.integrationServer.containers.runtime.resources.* 参数。

      有关可以指定的其余值的信息,请参阅 定制资源值中的 spec.integrationServer.containers.* 参数。

    • Pod/containers/container_name: 指定用于运行 Designer 容器的设置。 有关可以指定的值的信息,请参阅 定制资源值中的 spec.pod.containers.* 参数。
    • 交换机服务器/名称: 指定在 Designer 实例中运行可调用流时或在运行与专用网络中的应用程序进行交互的流时启用安全连接的现有交换机服务器的名称。 交换机服务器名称是交换机服务器定制资源中的 metadata.name 值。 有关如何创建交换机服务器的信息,请参阅App Connect切换服务器参考
      注: 如果要在 Designer 实例中创建和运行可调用流,或者要创建与专用网络中的应用程序交互的流,那么必须配置 Designer 实例以使用交换机服务器。
      • 如果命名空间中已部署交换机服务器,请完成切换服务器/名称表单视图中的字段,或添加spec.switchServer.nameDesigner YAML 的参数,其中switchServerName是个metadata.name交换机服务器自定义资源中的值。
        spec:
          switchServer:
            name: switchServerName

        如果交换机服务器的 metadata.name 值设置为 default,那么即使未显式指定 spec.switchServer.name , Designer 实例也会自动配置为使用交换机服务器。 例如:

        apiVersion: appconnect.ibm.com/v1beta1
        kind: SwitchServer
        metadata:
          name: default
        ...
      • 如果尚未在名称空间中部署交换机服务器,那么可以在创建 Designer 实例之后创建交换机服务器。 然后,更新 Designer 定制资源以添加 spec.switchServer.name 设置,如 更新实例的定制资源设置中所述。 (如果交换机服务器的 metadata.name 值设置为 default,那么无需显式添加 spec.switchServer.name 设置。)

        有关如何创建交换机服务器的信息,请参阅App Connect切换服务器参考

      配置为使用交换机服务器的 Designer 实例包含 可调用流 页面和 专用网络连接 页面,可用于配置与可调用流以及专用网络中应用程序的连接。

  8. 可选: 要更精细地控制安装设置,请单击 YAML 视图 以切换到 YAML 视图。 使用此 Designer 实例所需的参数和值更新 YAML 编辑器的内容。

    要查看可用参数和值的完整集合,请参阅 定制资源值

  9. 单击 创建 以启动部署。 Designer 实例的条目显示在 DesignerAuthorings 表中,最初具有 Pending 状态。
  10. 单击 Designer 实例名称以查看有关其定义和当前状态的信息。

    在页面的 详细信息 选项卡上,可以查看以下信息:

    • 条件 部分显示部署的进度。
    • 如果您使用 IBM App Connect Operator 11.2.0 或更高版本创建了 Designer 实例,则 Designer UI 字段会提供用于访问 Designer 实例的 URL。 如果启用了 KeycloakKeycloak UI 字段还会提供 Keycloak 实例的 URL ,您可以使用该 URL 访问 Keycloak 管理控制台。 (这些 URL 在部署完成后显示。) 您还可以在以下位置找到这些 URL联网>航线在控制台导航中。
      Designer UI 和 Keycloak UI 字段中显示的 Designer 和 Keycloak 实例的 URL
    • 如果您使用 IBM App Connect Operator 11.1.0 或更早版本创建了 Designer 实例,则 UI URL 字段提供了用于访问 Designer 实例的 URL。 (此 URL 将在部署完成后显示) 您还可以在控制台导航中的 网络 > 路由下找到此 URL。
      用户界面 URL 字段中显示的设计器实例的 URL

    您可以使用面包屑跟踪返回到 App Connect 操作程序的 (先前) 操作程序详细信息 页面。 部署完成后,状态在 DesignerAuthorings 表中显示为 Ready

下一步操作

  1. 如果为此实例启用了带有 Keycloak 的 IAM ,请使用 Keycloak 管理控制台通过设置具有已分配角色的用户来管理用户对该实例的访问权。 有关详细信息,请参阅For more information, see实施身份和访问管理App Connect设计师和App Connect仪表板实例
  2. 与需要访问设计器实例的用户共享设计器用户界面 (或用户界面 URL ) URL。 如果启用了 IAM ,那么还提供用户可用于登录到实例的认证凭证。

    然后用户可以访问并使用 Designer 实例来创作流程

Red Hat OpenShift CLI 或 Kubernetes CLI 创建实例

要从 Red Hat OpenShift CLI 创建 App Connect Designer 实例,请完成以下步骤。

注: 这些指示信息与 Red Hat OpenShift CLI 相关,但可以通过使用相关命令登录到集群并在适当情况下将 oc 替换为 kubectl 来应用于 Kubernetes 环境。
  1. 在本地计算机上,创建包含要创建的 App Connect Designer 实例配置的 YAML 文件。 包含 metadata.namespace 参数以标识要在其中创建实例的名称空间; 这应该是创建其他 App Connect 实例或资源的名称空间。
    • 要查看可以指定的参数和值的完整集合,请参阅 定制资源值

      在提供的缺省参数中,当 spec.couchdb.storage.type 设置为 persistent-claim时,请注意 spec.couchdb.storage.class (以及 spec.couchdb.storage.size) 需要值。 spec.couchdb.storage.class 值必须与集群的受支持存储类匹配。
      spec:
        couchdb:
          storage:
            class: 'storageClassValue'
            size: 10Gi
            type: persistent-claim
      IAM 需求: Keycloak 需要块存储器以及设置为缺省类的存储类。 有关详细信息,请参阅 KeycloakIBM Cloud Pak for Integration 文档中的 存储选项
      注: 如果要在 Designer 实例中创建和运行可调用流,或者要创建与专用网络中的应用程序交互的流,那么必须配置 Designer 实例以使用交换机服务器。
      • 如果命名空间中已部署交换机服务器,请完成切换服务器/名称表单视图中的字段,或添加spec.switchServer.nameDesigner YAML 的参数,其中switchServerName是个metadata.name交换机服务器自定义资源中的值。
        spec:
          switchServer:
            name: switchServerName

        如果交换机服务器的 metadata.name 值设置为 default,那么即使未显式指定 spec.switchServer.name , Designer 实例也会自动配置为使用交换机服务器。 例如:

        apiVersion: appconnect.ibm.com/v1beta1
        kind: SwitchServer
        metadata:
          name: default
        ...
      • 如果尚未在名称空间中部署交换机服务器,那么可以在创建 Designer 实例之后创建交换机服务器。 然后,更新 Designer 定制资源以添加 spec.switchServer.name 设置,如 更新实例的定制资源设置中所述。 (如果交换机服务器的 metadata.name 值设置为 default,那么无需显式添加 spec.switchServer.name 设置。)

        有关如何创建交换机服务器的信息,请参阅App Connect切换服务器参考

      配置为使用交换机服务器的 Designer 实例包含 可调用流 页面和 专用网络连接 页面,可用于配置与可调用流以及专用网络中应用程序的连接。

      考虑是否要为智能映射和数据变换启用映射辅助 (这需要 额外资源)。 您还可以选择启用 映射辅助增量学习 ,以将 AI 建模用于增强的智能映射。 如果启用递增学习,那么需要指定 "学习" 频率,并指示 AI 模型应存储在持久卷还是 S3 存储区中。 如果您正在使用 S3 存储区,那么需要提供用于连接到此存储区的详细信息,包括为存储 S3 凭证而创建的类型为 S3Credentials的配置对象的名称。 在 YAML 视图中,可以使用 spec.designerMappingAssist.enabledspec.designerMappingAssist.incrementalLearning.* 参数来配置映射辅助功能。 有关映射辅助和 S3 存储器的配置对象的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据变换创建类型为 S3Credentials 的配置以用于 App Connect Designer

    • 要使用身份和访问管理 (IAM) 控制对实例的访问,请指定spec.authentication.integrationKeycloak.*spec.authorization.integrationKeycloak.*参数,用于配置Keycloak。 身份验证参数可以验证用户身份,而授权参数可以授予访问权限。

      您指定的参数取决于Keycloak您正在使用的解决方案。

      • 要使用 KeycloakIBM Cloud Pak for Integration 上提供的受管 Red Hat OpenShift 解决方案来控制对实例的访问、将 spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled 设置为 true 以启用 Keycloak 。 省略所有剩余参数或将其留空。 Keycloak 默认已启用。 有关在创建的实例中使用 IAM 的更多信息,请参阅 通过在 Red Hat OpenShift 上使用托管 Keycloak 解决方案,在 IBM App Connect 中实施身份和访问管理
        限制:您不能使用托管Keycloak解决方案Kubernetes环境,因此确保spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled设置为false禁用Keycloak
      • 使用自我管理的Keycloak独立部署的解决方案IBMApp Connect操作员Red Hat OpenShift , 放spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabledtrue启用Keycloak。 然后,完成除以下之外的所有剩余参数spec.authentication.integrationKeycloak.tls.ingressHostspec.authorization.integrationKeycloak.tls.ingressHost

        还要确保您使用的是AppConnectEnterprise*风格许可。 有关将 IAM 与您正在创建的实例结合使用的更多信息,请参阅实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

      • 使用自我管理的Keycloak独立部署的解决方案IBMApp Connect操作员Kubernetes , 放spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabledtrue启用Keycloak。 然后,完成所有剩余的参数。

        还要确保您使用的是AppConnectEnterprise*风格许可。 有关将 IAM 与您正在创建的实例结合使用的更多信息,请参阅实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

      • 如果您不想限制对实例的访问,请设置spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabledfalse(禁用Keycloak)。 省略所有剩余参数或将其留空。 还要确保您使用的是AppConnectEnterprise*风格许可。
      注: 无法通过从 CR 中省略 spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled 来禁用 IAM。 如果省略,那么缺省情况下会启用 IAM。
    • 有关许可信息,请参阅许可参考IBMApp Connect操作员
      IAM 权利:
      • 如果购买了 Cloud Pak for Integration,那么您有权使用 CloudPakForIntegration*AppConnectEnterprise* 样式的许可证。 但是,要使用 CloudPakForIntegration* 许可证,必须部署 Platform UI 实例。
      • 如果您购买了IBMApp Connect操作员对于独立部署,您只能AppConnectEnterprise*样式许可证,无论 IAM 是否启用或禁用。 (尽管安装Cloud Pak for Integration如果你想使用托管Keycloak部署以配置 IAM,您无权部署平台用户界面

    以下示例 (示例 1 和示例 2) 显示了 Designer CR ,其中包含用于配置 CouchDB 存储器的设置,以及用于配置现有交换机服务器以实现可调用流和专用网络连接的设置。 这些设置还支持使用 AI 模型的 persistent-claim 存储定义进行映射辅助和增量学习。

    OpenShift-only内容示例 1:Keycloak 为托管 Keycloak 部署默认启用 IAM,该 IBM Cloud Pak for Integration 提供
    apiVersion: appconnect.ibm.com/v1beta1
    kind: DesignerAuthoring
    metadata:
      name: des-mapast
      labels:
        backup.appconnect.ibm.com/component: designerauthoring
      namespace: mynamespace
    spec:
      license:
        accept: true
        license: L-XRNH-47FJAW
        use: CloudPakForIntegrationNonProduction
      couchdb:
        storage:
          size: 10Gi
          type: persistent-claim
          class: ocs-storagecluster-cephfs
        replicas: 1
      designerMappingAssist:
        incrementalLearning:
          storage:
            type: persistent-claim
            class: ocs-storagecluster-cephfs
          schedule: Every 15 days
          useIncrementalLearning: true
        enabled: true
      switchServer:
        name: default
      authentication:
        integrationKeycloak:
          enabled: true
      authorization:
        integrationKeycloak:
          enabled: true
      designerFlowsOperationMode: local
      replicas: 3
      version: '12.0'
    Kubernetes-仅内容OpenShift-only内容 示例 2:禁用 Keycloak 用于 IBM Cloud Pak for Integration 提供的受管 Keycloak 部署(不支持 Kubernetes
    apiVersion: appconnect.ibm.com/v1beta1
    kind: DesignerAuthoring
    metadata:
      name: des-mapast
      labels:
        backup.appconnect.ibm.com/component: designerauthoring
      namespace: mynamespace
    spec:
      license:
        accept: true
        license: L-XRNH-47FJAW
        use: AppConnectEnterpriseProduction
      couchdb:
        storage:
          size: 10Gi
          type: persistent-claim
          class: valid-storage-class
        replicas: 1
      designerMappingAssist:
        incrementalLearning:
          storage:
            type: persistent-claim
            class: valid-storage-class
          schedule: Every 15 days
          useIncrementalLearning: true
        enabled: true
      switchServer:
        name: default
      authentication:
        integrationKeycloak:
          enabled: false
      authorization:
        integrationKeycloak:
          enabled: false
      designerFlowsOperationMode: local
      replicas: 3
      version: '12.0'

    以下示例 (示例 3 和示例 4) 显示了 Designer CR ,其中包含用于配置 CouchDB 存储器的设置,以及用于配置现有交换机服务器以实现可调用流和专用网络连接的设置。 这些设置还支持使用 AI 模型的 s3 存储定义进行映射辅助和增量学习。

    OpenShift-only内容示例 3:Keycloak 在托管 Keycloak 部署中默认为 IAM 启用,该 IBM Cloud Pak for Integration 提供了
    apiVersion: appconnect.ibm.com/v1beta1
    kind: DesignerAuthoring
    metadata:
      name: des-mapast
      labels:
        backup.appconnect.ibm.com/component: designerauthoring
      namespace: mynamespace
    spec:
      license:
        accept: true
        license: L-XRNH-47FJAW
        use: CloudPakForIntegrationNonProduction
      couchdb:
        storage:
          size: 10Gi
          type: persistent-claim
          class: ocs-storagecluster-cephfs
        replicas: 1
      designerMappingAssist:
        incrementalLearning:
          storage:
            type: s3
            bucket: appc-operator-e2e
            host: s3.eu-gb.cloud-object-storage.appdomain.cloud
            s3Configuration: s3credentials-ibmcosiam
          schedule: Every 15 days
          useIncrementalLearning: true
        enabled: true
      switchServer:
        name: default
      authentication:
        integrationKeycloak:
          enabled: true
      authorization:
        integrationKeycloak:
          enabled: true
      designerFlowsOperationMode: local
      replicas: 3
      version: '12.0'
    Kubernetes-仅内容OpenShift-only内容 示例 4:禁用 Keycloak 用于 IBM Cloud Pak for Integration 提供的托管 Keycloak 部署(不支持 Kubernetes
    apiVersion: appconnect.ibm.com/v1beta1
    kind: DesignerAuthoring
    metadata:
      name: des-mapast
      labels:
        backup.appconnect.ibm.com/component: designerauthoring
      namespace: mynamespace
    spec:
      license:
        accept: true
        license: L-XRNH-47FJAW
        use: AppConnectEnterpriseProduction
      couchdb:
        storage:
          size: 10Gi
          type: persistent-claim
          class: valid-storage-class
        replicas: 1
      designerMappingAssist:
        incrementalLearning:
          storage:
            type: s3
            bucket: appc-operator-e2e
            host: s3.eu-gb.cloud-object-storage.appdomain.cloud
            s3Configuration: s3credentials-ibmcosiam
          schedule: Every 15 days
          useIncrementalLearning: true
        enabled: true
      switchServer:
        name: default
      authentication:
        integrationKeycloak:
          enabled: false
      authorization:
        integrationKeycloak:
          enabled: false
      designerFlowsOperationMode: local
      replicas: 3
      version: '12.0'

    要查看 Designer CR 的示例,其中包含启用的设置Keycloak对于自我管理Keycloak部署于Red Hat OpenShift或者Kubernetes , 看实施身份和访问管理IBMApp Connect通过使用自我管理Keycloak解决方案Red Hat OpenShift或者Kubernetes

  2. 使用 .yaml 扩展名保存此文件; 例如, designer_cr.yaml
  3. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
  4. 运行以下命令以创建 App Connect Designer 实例。 (使用您创建的 .yaml 文件的名称。)
    oc apply -f designer_cr.yaml
  5. 运行以下命令以检查 App Connect Designer 实例的状态并验证其是否已就绪:
    oc get designerauthorings -n namespace

    IBM App Connect Operator 11.2.0 或更高版本中,输出还会提供 Designer 实例的 URL ,如下例所示。 如果启用了 Keycloak ,则还会显示 Keycloak 实例的 URL ,您可以使用该 URL 访问 Keycloak 管理控制台。

    NAME                     RESOLVEDVERSION   URL                                                                                 KEYCLOAKURL                                                                  CUSTOMIMAGES   STATUS   AGE
    des-fd-keyclk-cp4ilic    12.0.12.5-r1      https://des-fd-keyclk-cp4ilic-ui-ace-fiona.apps.acecc-shared-1120-cd-414-abc.com    https://keycloak-ibm-common-services.apps.acecc-shared-1120-cd-414-abc.com   false          Ready    3h11m

    IBM App Connect Operator 11.1.0 或更早版本上,输出还会提供设计器实例的 URL ;例如:

    NAME         RESOLVEDVERSION   REPLICAS   CUSTOMIMAGES   STATUS    URL                                                                        AGE
    des-mapast   12.0.10.0-r3      3          false          Ready     https://des-mapast-designer-https-mynamespace.apps.acecc-abcde.icp4i.com   50m12s

下一步操作

  1. 如果在 Red Hat OpenShift上针对此实例启用了带有 Keycloak 的 IAM ,请使用 Keycloak 管理控制台通过设置具有已分配角色的用户来管理用户对该实例的访问权。 有关详细信息,请参阅For more information, see实施身份和访问管理App Connect设计师和App Connect仪表板实例
  2. 与需要访问 Designer 实例的用户共享输出中的 URL 值。 如果启用了 IAM ,那么还提供用户可用于登录到实例的认证凭证。

    然后用户可以访问并使用 Designer 实例来创作流程

注: 如果您正在使用 Kubernetes 环境,请确保在创建此实例之后创建入口定义,以使其内部服务公开可用。 有关详细信息,请参阅For more information, see创建外部访问入口定义IBMApp Connect实例

更新实例的定制资源设置

如果要更改现有 App Connect Designer 实例的设置,您可以从 IBM Cloud Pak Platform UI 编辑其自定义资源设置、Red Hat OpenShift Web 控制台或 CLI,或 Kubernetes环境的 CLI。 例如,如果当前已禁用,那么您可能想要启用映射辅助,或者配置实例以将交换机服务器用于可调用流或专用网络连接。

限制: 无法更新标准设置 (例如,资源类型 (kind) ,名称和名称空间 (metadata.namemetadata.namespace) 以及某些系统生成的设置或设置 (例如,某些组件的存储类型)。 尝试保存时将显示错误消息。

确保您具有集群管理员权限或已被授予相应的基于角色的访问控制 (RBAC)。


IBM Cloud Pak Platform UI 更新实例

要从 App Connect Designer 实例更新 IBM Cloud Pak Platform UI,请完成以下步骤:

  1. 在浏览器窗口中,登录到 Platform UI
    提示: 您可以使用已部署 IBM Cloud Pak for Integration Platform UI 实例的生成 URL 访问 Platform UI
    • 适用于 IBM App Connect Operator 11.0.0 或更高版本: Platform UI " 实例 " 页面将作为主页打开。 欢迎条幅包含可用于选择与现有系统 UI 匹配的轻主题,深主题或定制主题的主题切换器。
    • 适用于 IBM App Connect 操作员 10.1.1 或更低版本: Platform UI 主页将打开,其中包含提供对您有权创建,管理或使用的实例和其他资源的访问权的卡和导航菜单选项。 有关从该页面完成管理任务(如用户管理或平台自定义)的信息,请参阅 IBM Cloud Pak 基础服务文档中的 Platform UI


      从导航菜单导航菜单, 扩张行政并点击集成实例

  2. 从 " 实例 " (或 集成实例) 页面中,找到要更新的 App Connect Designer (集成设计) 实例。
  3. 点击选项图标“选项”图标打开选项菜单,然后点击编辑。 将打开该实例的 "编辑" 页面。
  4. 使用 "UI 表单" 视图中的字段或切换到 YAML 视图以更新所需设置。 您可以更新现有值,添加新条目或删除条目。 有关可用参数及其值的信息,请参阅 定制资源值
  5. 单击更新以保存更改。

Red Hat OpenShift Web 控制台更新实例

要使用 Red Hat OpenShift Web 控制台更新 App Connect Designer 实例,请完成以下步骤:

  1. 从浏览器窗口,登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于行政人员看法Web 控制台的管理员透视图
  2. 在导航中,单击运算符>已安装运营商
  3. 如果需要,请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
  4. 从 " 已安装的操作程序 " 页面,单击 IBM App Connect
  5. App Connect OperatorOperator details 页面中,单击 Designer Authoring 选项卡。
  6. 找到并单击要更新的实例的名称。
  7. 单击 YAML 选项卡。
  8. 根据需要更新 YAML 编辑器的内容。 您可以更新现有值,添加新条目或删除条目。 有关可用参数及其值的信息,请参阅 定制资源值
  9. 单击保存以保存更改。

Red Hat OpenShift CLI 或 Kubernetes CLI 更新实例

要从 Red Hat OpenShift CLI 更新 App Connect Designer 实例,请完成以下步骤。

注: 这些指示信息与 Red Hat OpenShift CLI 相关,但可以通过使用相关命令登录到集群并在适当情况下将 oc 替换为 kubectl 来应用于 Kubernetes 环境。
  1. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
  2. 从部署 Designer 实例的名称空间中,运行 oc edit 命令以部分更新实例,其中 instanceName 是实例的名称 (metadata.name 值)。
    oc edit designerauthoring instanceName

    Designer CR 将自动在操作系统的缺省文本编辑器中打开。

  3. 根据需要更新文件内容。 您可以更新现有值,添加新条目或删除条目。 有关可用参数及其值的信息,请参阅 定制资源值
  4. 保存 YAML 定义并关闭文本编辑器以应用更改。
提示:

如果需要,您还可以使用 oc patch 命令对某些 bash shell 功能部件应用补丁,或者将 oc apply 与相应的 YAML 设置配合使用。

例如,可以将 YAML 设置保存到具有 .yaml 扩展名的文件 (例如, updatesettings.yaml) ,然后按如下所示运行 oc patch 以更新实例的设置:

oc patch designerauthoring instanceName --type='merge' --patch "$(cat updatesettings.yaml)"

删除实例

如果不再需要,可以删除 App Connect Designer 实例。 您可以通过 IBM Cloud Pak Platform UIRed Hat OpenShift Web 控制台或 CLI 或 Kubernetes 环境的 CLI 执行此操作。

确保您具有集群管理员权限或已被授予相应的基于角色的访问控制 (RBAC)。

注:

如果您有一个 App Connect Designer 实例,并且已使用 S3 存储器对该实例启用增量学习,那么删除该实例时,关联的 AI 模型 (采用 ZIP 格式) 将保留在 S3 存储区中。 如果不再需要,可以从存储区中删除模型。


IBM Cloud Pak Platform UI 中删除实例

要从 IBM Cloud Pak Platform UI 中删除 App Connect Designer 实例,请完成以下步骤:

  1. 在浏览器窗口中,登录到 Platform UI
    提示: 您可以使用已部署 IBM Cloud Pak for Integration Platform UI 实例的生成 URL 访问 Platform UI
    • 适用于 IBM App Connect Operator 11.0.0 或更高版本: Platform UI " 实例 " 页面将作为主页打开。 欢迎条幅包含可用于选择与现有系统 UI 匹配的轻主题,深主题或定制主题的主题切换器。
    • 适用于 IBM App Connect 操作员 10.1.1 或更低版本: Platform UI 主页将打开,其中包含提供对您有权创建,管理或使用的实例和其他资源的访问权的卡和导航菜单选项。 有关从该页面完成管理任务(如用户管理或平台自定义)的信息,请参阅 IBM Cloud Pak 基础服务文档中的 Platform UI


      从导航菜单导航菜单, 扩张行政并点击集成实例

  2. 从 " 实例 " (或 集成实例) 页面中,找到要删除的 App Connect Designer (集成设计) 实例。
  3. 点击选项图标 (选项菜单 )打开选项菜单,然后点击删除
  4. 确认删除操作。

Red Hat OpenShift Web 控制台中删除实例

要使用 Red Hat OpenShift Web 控制台删除 App Connect Designer 实例,请完成以下步骤:

  1. 从浏览器窗口,登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于行政人员看法Web 控制台的管理员透视图
  2. 在导航中,单击运算符>已安装运营商
  3. 如果需要,请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
  4. 从 " 已安装的操作程序 " 页面,单击 IBM App Connect
  5. App Connect OperatorOperator details 页面中,单击 Designer Authoring 选项卡。
  6. 找到要删除的实例。
  7. 点击选项图标 (选项菜单 )打开选项菜单,然后点击删除选项。
  8. 确认删除操作。

Red Hat OpenShift CLI 或 Kubernetes CLI 删除实例

要从 Red Hat OpenShift CLI 中删除 App Connect Designer 实例,请完成以下步骤。

注: 这些指示信息与 Red Hat OpenShift CLI 相关,但可以通过使用相关命令登录到集群并在适当情况下将 oc 替换为 kubectl 来应用于 Kubernetes 环境。
  1. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
  2. 从部署 Designer 实例的名称空间中,运行以下命令以删除该实例,其中 instanceNamemetadata.name 参数的值。
    oc delete designerauthoring instanceName

验证定制资源值

  • 创建资源时对名称和名称空间长度的限制: 要允许具有从 CR 名称派生的名称的有效路径和子对象,请限制 CR 名称的长度:
    • 如果名称空间名称太长,那么路由将不起作用。 您指定的名称值应小于maxNameLength总是。
    • DesignerAuthoring有一个较小的maxNameLength比其他自定义资源更高效,因为它创建了一个集成服务器。
    • 对于添加到子资源的后缀,允许使用 12 个字符。
    • 如果名称空间名称的长度为 40 个字符,那么对于 DesignerAuthoring的 CR 名称,将有 10 个字符可用。
  • 将持久存储器与 CouchDB配合使用时,必须提供 存储类
  • 创建后无法修改 CouchDB 服务器的副本数,存储类型,存储类或存储大小。

定制资源值

下表列出了定制资源的可配置参数和缺省值。

参数 描述 缺省

apiVersion

用于标识用于此实例的模式的 API 版本。

appconnect.ibm.com/v1beta1

kind

资源类型。

DesignerAuthoring

metadata.name

可用来标识 Designer 实例的唯一短名称。

metadata.namespace

其中安装了 Designer 实例的名称空间 (项目)。

在其中创建实例或对象的名称空间长度不得超过 40 个字符。

spec.authentication.integrationKeycloak.auth.clientSecretName

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

一个Kubernetes存储以下凭据的秘密Keycloak您设立的代表您担保的App Connect设计师实例。 这些凭证被指定为用户提供的客户端 ID 和生成的客户端密钥当你创建Keycloak客户在里面Keycloak管理控制台。

有关如何创建此机密的信息,请参阅创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步3 )。

如果满足以下条件,则需要此值spec.authentication.integrationKeycloak.enabled被设定为true和一个spec.authentication.integrationKeycloak.endpoint值已定义。

spec.authentication.integrationKeycloak.enabled

(仅适用于Red Hat OpenShift如果spec.version决定12.0.10.0-r2或更高版本)

(仅适用于Kubernetes环境如果spec.version决定12.0.12.3-r1或更高版本)

指示是否使用身份和访问权管理 (IAM) 来控制对实例的访问权,该管理是使用 Keycloak实现的。

有效值为truefalse

  • 必须设置为 true 以确保可以验证用户身份。 spec.authorization.integrationKeycloak.enabled 设置也必须设置为 true
  • 如果不希望限制对实例的访问权,那么必须设置为 falsespec.authorization.integrationKeycloak.enabled 设置也必须设置为 false
注: 无法通过从 CR 中省略 spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled 来禁用 IAM。 如果省略,那么缺省情况下会启用 IAM。

有关详细信息,请参阅For more information, see实施身份和访问管理App Connect设计师和App Connect仪表板实例

true

spec.authentication.integrationKeycloak.endpoint

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

用于访问 Keycloak 实例的 URL。 有关详细信息,请参阅为 Keycloak 实例定位 URL。 如果托管自助管理的 Keycloak 部署,且 spec.authentication.integrationKeycloak.enabled 设置为 true ,则需要此值。 如果您托管的是自助管理 Keycloak 部署,则必须同时设置 spec.authentication.integrationKeycloak.endpointspec.authorization.integrationKeycloak.endpoint

spec.authentication.integrationKeycloak.realm

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

Keycloak用于管理用户及其对 Designer 实例的访问的领域。 如果你正在托管自己的自管理Keycloak部署。 有关详细信息,请参阅For more information, see设置自我管理部署Keycloak

如果满足以下条件,则需要此值spec.authentication.integrationKeycloak.enabled被设定为true和一个spec.authentication.integrationKeycloak.endpoint值已定义。

spec.authentication.integrationKeycloak.tls.caCertificate

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

定义证书颁发机构 (CA) 证书的键/值对中的键的名称Keycloak。 此密钥和证书存储在spec.authentication.integrationKeycloak.tls.secretName

密钥的名称可以是ca.crt(默认)或您选择的其他名称。 有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例。 如果你正在使用ca.crt作为键的名称,您可以明确设置spec.authentication.integrationKeycloak.tls.caCertificateca.crt或省略spec.authentication.integrationKeycloak.tls.caCertificate来自 CR。

如果满足以下条件,则需要此值spec.authentication.integrationKeycloak.enabled被设定为true和一个spec.authentication.integrationKeycloak.endpoint值已定义。

ca.crt

spec.authentication.integrationKeycloak.tls.ingressHost

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署于Kubernetes环境)

入口主机前缀和子域组合在一起形成 Designer UI 的主机名或入口路由。 在 Kubernetes 环境中,需要为部署的 Designer 实例手动创建入口路由,以定义外部可访问的 URL ,用于访问集群中运行的服务。

入口路由通常在创建 Designer 实例后创建,但您可以预先决定要使用哪个入口主机前缀和子域,然后按照以下格式指定值:

<designerHostPrefix>.<ingress_subdomain>

有关详细信息,请参阅For more information, see创建外部访问入口定义IBMApp Connect实例

在一个Kubernetes环境,如果需要此值spec.authentication.integrationKeycloak.enabled被设定为true和一个spec.authentication.integrationKeycloak.endpoint值已定义。

spec.authentication.integrationKeycloak.tls.secretName

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

存储 CA 证书的机密名称Keycloak,用于在 Designer 实例和Keycloak实例。 创建机密时,定义一个键/值对,其中:

  • 密钥的默认名称为ca.crt或其他名称。 (您还需要将此键指定为spec.authentication.integrationKeycloak.tls.caCertificate
  • 价值是Base64-encodedCA 证书来自Keycloak

有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步2 )。

如果满足以下条件,则需要此值spec.authentication.integrationKeycloak.enabled被设定为true和一个spec.authentication.integrationKeycloak.endpoint值已定义。

spec.authorization.integrationKeycloak.auth.clientSecretName

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

一个Kubernetes存储以下凭据的秘密Keycloak您设立的代表您担保的App Connect设计师实例。 这些凭证被指定为用户提供的客户端 ID 和生成的客户端密钥当你创建Keycloak客户在里面Keycloak管理控制台。

有关如何创建此机密的信息,请参阅创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步3 )。

如果满足以下条件,则需要此值spec.authorization.integrationKeycloak.enabled被设定为true和一个spec.authorization.integrationKeycloak.endpoint值已定义。

spec.authorization.integrationKeycloak.enabled

(仅适用于Red Hat OpenShift如果spec.version决定12.0.10.0-r2或更高版本)

(仅适用于Kubernetes环境如果spec.version决定12.0.12.3-r1或更高版本)

指示是否使用身份和访问权管理 (IAM) 来控制对实例的访问权,该管理是使用 Keycloak实现的。

有效值为truefalse

  • 必须设置为 true 以确保可以授予访问许可权。 spec.authentication.integrationKeycloak.enabled 设置也必须设置为 true
  • 如果不希望限制对实例的访问权,那么必须设置为 falsespec.authentication.integrationKeycloak.enabled 设置也必须设置为 false
注: 无法通过从 CR 中省略 spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled 来禁用 IAM。 如果省略,那么缺省情况下会启用 IAM。

有关详细信息,请参阅For more information, see实施身份和访问管理App Connect设计师和App Connect仪表板实例

true

spec.authorization.integrationKeycloak.endpoint

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

用于访问 Keycloak 实例的 URL。 有关详细信息,请参阅为 Keycloak 实例定位 URL

如果您托管的是自我管理Keycloak部署和spec.authorization.integrationKeycloak.enabled被设定为true。 如果你正在举办自我管理Keycloak部署,spec.authentication.integrationKeycloak.endpointspec.authorization.integrationKeycloak.endpoint必须同时设置。

spec.authorization.integrationKeycloak.realm

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

Keycloak用于管理用户及其对 Designer 实例的访问的领域。 如果你正在托管自己的自管理Keycloak部署。 有关详细信息,请参阅For more information, see设置自我管理部署Keycloak

如果满足以下条件,则需要此值spec.authorization.integrationKeycloak.enabled被设定为true和一个spec.authorization.integrationKeycloak.endpoint值已定义。

spec.authorization.integrationKeycloak.tls.caCertificate

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

定义证书颁发机构 (CA) 证书的键/值对中的键的名称Keycloak。 此密钥和证书存储在spec.authorization.integrationKeycloak.tls.secretName

密钥的名称可以是ca.crt(默认)或您选择的其他名称。 有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例。 如果你正在使用ca.crt作为键的名称,您可以明确设置spec.authorization.integrationKeycloak.tls.caCertificateca.crt或省略spec.authorization.integrationKeycloak.tls.caCertificate来自 CR。

如果满足以下条件,则需要此值spec.authorization.integrationKeycloak.enabled被设定为true和一个spec.authorization.integrationKeycloak.endpoint值已定义。

ca.crt

spec.authorization.integrationKeycloak.tls.ingressHost

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署于Kubernetes环境)

入口主机前缀和子域组合在一起形成 Designer UI 的主机名或入口路由。 在 Kubernetes 环境中,需要为部署的 Designer 实例手动创建入口路由,以定义外部可访问的 URL ,用于访问集群中运行的服务。

入口路由通常在创建 Designer 实例后创建,但您可以预先决定要使用哪个入口主机前缀和子域,然后按照以下格式指定值:

<designerHostPrefix>.<ingress_subdomain>

有关详细信息,请参阅For more information, see创建外部访问入口定义IBMApp Connect实例

在一个Kubernetes环境,如果需要此值spec.authorization.integrationKeycloak.enabled被设定为true和一个spec.authorization.integrationKeycloak.endpoint值已定义。

spec.authorization.integrationKeycloak.tls.secretName

(仅适用于spec.version决定12.0.12.3-r1或更高版本,并且如果您托管的是自我管理Keycloak部署

存储 CA 证书的机密名称Keycloak,用于在 Designer 实例和Keycloak实例。 创建机密时,定义一个键/值对,其中:

  • 密钥的默认名称为ca.crt或其他名称。 (您还需要将此键指定为spec.authorization.integrationKeycloak.tls.caCertificate
  • 价值是Base64-encodedCA 证书来自Keycloak

有关详细信息,请参阅For more information, see创建App Connect设计师或App Connect已启用 IAM 的仪表板实例(步2 )。

如果满足以下条件,则需要此值spec.authorization.integrationKeycloak.enabled被设定为true和一个spec.authorization.integrationKeycloak.endpoint值已定义。

spec.couchdb.logLevel

CouchDB 日志中显示的信息级别。

有效值为 infowarningerrordebugnotice

info

spec.couchdb.replicas

要在 1-10 之间运行的 CouchDB 副本 pod 的数量。

3

spec.couchdb.resources.requests.cpu

不推荐: (仅当 spec.version 解析为 12.0.4.0-r2 或更低版本时适用)

为运行 CouchDB而分配的最小 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

提示: 如果 spec.version 解析为 12.0.5.0-r1-lts 或更高版本,请改为使用 spec.pod.containers.couchdb.resources.*

100m

spec.couchdb.resources.requests.memory

不推荐: (仅当 spec.version 解析为 12.0.4.0-r2 或更低版本时适用)

为运行 CouchDB分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

提示: 如果 spec.version 解析为 12.0.5.0-r1-lts 或更高版本,请改为使用 spec.pod.containers.couchdb.resources.*

128Mi

spec.couchdb.storage.class

集群支持的存储类,应用于动态供应属于该类的持久卷。 有关持久存储要求的信息CouchDB,看支持的存储类型Apache CouchDB

(如果 spec.couchdb.storage.type 设置为 persistent-claim,那么为必需。)

spec.couchdb.storage.size

CouchDB 的持久卷所需的最大存储量 (十进制或二进制格式); 即 Gi 或 G。

(如果 spec.couchdb.storage.type 设置为 persistent-claim,那么为必需。)

spec.couchdb.storage.type

要用于 CouchDB的存储器类型。 有效值为:

  • persistent-claim: 选择此选项以存储在容器的文件系统中的持久卷中。 在 pod 重新启动时保留现有配置,日志和持久消息。
  • ephemeral: 对于仅在 Pod 生存期存在的临时卷中的存储器,请选择此选项。

有关更多信息,请参阅 Apache CouchDB

spec.designerFlowsOperationMode

local 的缺省值允许在 App Connect Designer 实例中使用本地部署的连接器:

local

spec.designerMappingAssist.enabled

控制映射辅助组件的部署。

有效值为truefalse

有关映射辅助的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据转换

spec.designerMappingAssist.incrementalLearning.schedule

(仅当 spec.version 解析为 12.0.1.0-r1 或更高版本时适用)

确定对 Designer 实例中的映射首选项进行整理并用于重新训练所提供的用于实现增量学习功能的人工智能 (AI) 模型的频率。

有效值为Every 15 daysEvery month

如果 spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true,那么是必需的。

Every 15 days

spec.designerMappingAssist.incrementalLearning.storage.bucket

(仅当 spec.version 解析为 12.0.1.0-r4 或更高版本时适用)

用于简单存储服务 (S3) 实例中对象存储的现有存储区的名称。 您必须具有对此存储区的读/写访问权,该存储区将用于存储增量学习功能的经过训练的 AI 模型。 有关受支持 S3 提供程序的列表以及选择存储区的注意事项,请参阅 AI 模型支持的存储类型

如果 spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true 并且 spec.designerMappingAssist.incrementalLearning.storage.type 设置为 s3,那么为必需。

spec.designerMappingAssist.incrementalLearning.storage.claimName

(仅当 spec.version 解析为 12.0.1.0-r1 或更高版本时适用)

应用于请求持久卷的现有声明的名称(带有ReadWriteMany该接口使用“访问模式”来存储增量学习功能的AI模型。 此声明必须与 App Connect Designer存在于同一名称空间中。

spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true 并且 spec.designerMappingAssist.incrementalLearning.storage.type 设置为 persistent-claim时,需要 spec.designerMappingAssist.incrementalLearning.storage.classspec.designerMappingAssist.incrementalLearning.storage.claimName

spec.designerMappingAssist.incrementalLearning.storage.class

(仅当 spec.version 解析为 12.0.1.0-r1 或更高版本时适用)

集群支持的存储类,应用于动态供应属于该类的持久卷。 增量学习需要持久卷ReadWriteMany用于存储训练好的AI模型的访问模式。 如果使用 IBM Cloud,请将存储类设置为 ibmc-file-gold-gid 以实现最佳性能。 有关持久卷需求的更多信息,请参阅 AI 模型支持的存储类型

spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true 并且 spec.designerMappingAssist.incrementalLearning.storage.type 设置为 persistent-claim时,需要 spec.designerMappingAssist.incrementalLearning.storage.classspec.designerMappingAssist.incrementalLearning.storage.claimName

spec.designerMappingAssist.incrementalLearning.storage.host

(仅当 spec.version 解析为 12.0.1.0-r4 或更高版本时适用)

与简单存储服务 (S3) 系统关联的端点, S3 REST API 将向该系统发送请求,以从 spec.designerMappingAssist.incrementalLearning.storage.bucket中指定的存储区中的 AI 模型进行读写操作。 有关更多信息,请参阅 AI 模型支持的存储类型

如果 spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true 并且 spec.designerMappingAssist.incrementalLearning.storage.type 设置为 s3,那么为必需。

spec.designerMappingAssist.incrementalLearning.storage.s3Configuration

(仅当 spec.version 解析为 12.0.1.0-r4 或更高版本时适用)

类型为 S3Credentials的现有配置对象的名称,用于存储用于访问 spec.designerMappingAssist.incrementalLearning.storage.bucket中指定的存储区的凭证。

将此参数设置为创建配置对象时指定的 metadata.name 值。 有关更多信息,请参阅 创建类型为 S3Credentials 的配置以用于 App Connect Designer

如果 spec.designerMappingAssist.incrementalLearning.useIncrementalLearning 设置为 true 并且 spec.designerMappingAssist.incrementalLearning.storage.type 设置为 s3,那么为必需。

spec.designerMappingAssist.incrementalLearning.storage.type

(仅当 spec.version 解析为 12.0.1.0-r4 或更高版本时适用)

用于存储增量学习功能的 AI 模型的存储类型。

有效值为:
  • persistent-claim: 选择此选项以存储在容器的文件系统中的持久卷中。
  • s3: 对于简单存储服务 (S3) 实例中的存储区中的存储,请选择此选项。

有关更多信息,请参阅 AI 模型支持的存储类型

spec.designerMappingAssist.incrementalLearning.useIncrementalLearning

(仅当 spec.version 解析为 12.0.1.0-r1 或更高版本时适用)

指示是否启用增量学习功能,该功能使用 AI 建模定期分析编写的流中的映射首选项并记忆模式,以提高建议映射的准确性。 此功能部件将使用额外的 3 CPU 和 3Gi 内存。

有效值为truefalse

有关增量学习的更多信息,请参阅 使用 AI 支持的建议简化数据映射和数据转换

false

spec.imagePullSecrets.name

要用于拉取所使用的任何映像的同一名称空间中对私钥的引用的可选列表。 如果指定了这些私钥,那么这些私钥将传递到各个拉取器实现以供其使用。 例如,对于 Docker,仅采用 DockerConfig 类型的私钥。 有关详细信息,请参阅For more information, seehttps://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod

spec.integrationServer.containers.connectors.image

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

Docker 映像的路径。

spec.integrationServer.containers.connectors.imagePullPolicy

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.integrationServer.containers.connectors.resources.limits.cpu

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

CPU 核心数的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

1

spec.integrationServer.containers.connectors.resources.limits.memory

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

内存上限(字节)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

512Mi

spec.integrationServer.containers.connectors.resources.requests.cpu

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

250m

spec.integrationServer.containers.connectors.resources.requests.memory

(仅当 spec.version 解析为 11.0.0.10-r2 或更低版本时适用)

最小内存量(字节)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.integrationServer.containers.designereventflows.image

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

Docker 映像的路径。

spec.integrationServer.containers.designereventflows.imagePullPolicy

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.integrationServer.containers.designereventflows.resources.limits.cpu

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

CPU 核心数的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

1

spec.integrationServer.containers.designereventflows.resources.limits.memory

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

内存上限(字节)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

512Mi

spec.integrationServer.containers.designereventflows.resources.requests.cpu

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

250m

spec.integrationServer.containers.designereventflows.resources.requests.memory

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

最小内存量(字节)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.integrationServer.containers.designerflows.image

Docker 映像的路径。

spec.integrationServer.containers.designerflows.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.integrationServer.containers.designerflows.resources.limits.cpu

CPU 核心数的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

1

spec.integrationServer.containers.designerflows.resources.limits.memory

内存上限(字节)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

512Mi

spec.integrationServer.containers.designerflows.resources.requests.cpu

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

250m

spec.integrationServer.containers.designerflows.resources.requests.memory

最小内存量(字节)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.integrationServer.containers.proxy.image

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

Docker 映像的路径。

spec.integrationServer.containers.proxy.imagePullPolicy

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.integrationServer.containers.proxy.resources.limits.cpu

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

CPU 核心数的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

1

spec.integrationServer.containers.proxy.resources.limits.memory

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

内存上限(字节)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.integrationServer.containers.proxy.resources.requests.cpu

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.integrationServer.containers.proxy.resources.requests.memory

(仅当 spec.version 解析为 11.0.0.10-r3-eus, 11.0.0.11-r1或更高版本时适用)

最小内存量(字节)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.integrationServer.containers.runtime.env

定义将在部署中的运行时容器中设置和使用的自定义环境变量。

此参数公开Kubernetes用于在容器中声明环境变量的 API,因此遵循相同的模式。 为每个环境变量添加一个名称/值对,如下面的示例所示,为容器设置两个环境变量。

spec:
  integrationServer:
    containers:
      runtime:
        env:
          - name: MY_CUSTOM_ENV_VAR
            value: 'true'
          - name: ANOTHER_ENV_VAR
            value: '100'

有关详细信息,请参阅For more information, see定义容器的环境变量在里面Kubernetes文档。

spec.integrationServer.containers.runtime.image

Docker 映像的路径。

spec.integrationServer.containers.runtime.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.integrationServer.containers.runtime.resources.limits.cpu

CPU 核心数的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

1

spec.integrationServer.containers.runtime.resources.limits.memory

内存上限(字节)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1Gi

spec.integrationServer.containers.runtime.resources.requests.cpu

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

200m

spec.integrationServer.containers.runtime.resources.requests.memory

最小内存量(字节)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.license.accept

指示是否应接受许可证。

有效值为truefalse。 要进行安装,此值必须设置为 true

false

spec.license.license

许可参考IBMApp Connect操作员为有效值。

spec.license.use

许可参考IBMApp Connect操作员为有效值。

spec.pod.containers.connectorAuthService.image

Docker 映像的路径。

spec.pod.containers.connectorAuthService.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.connectorAuthService.livenessProbe.failureThreshold

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.connectorAuthService.livenessProbe.initialDelaySeconds

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.connectorAuthService.livenessProbe.periodSeconds

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.connectorAuthService.livenessProbe.timeoutSeconds

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.connectorAuthService.readinessProbe.failureThreshold

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.connectorAuthService.readinessProbe.initialDelaySeconds

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.connectorAuthService.readinessProbe.periodSeconds

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.connectorAuthService.readinessProbe.timeoutSeconds

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.connectorAuthService.resources.limits.cpu

为运行连接器认证服务容器而分配的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可以使用spec.pod.containers.connectorAuthService.resources.limits.cpu设置 CPU 限制,或配置命名空间的 CPU 限制,如中所述为命名空间配置内存和 CPU 配额在里面Kubernetes文档。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.connectorAuthService.resources.limits.memory

为运行连接器认证服务容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.connectorAuthService.resources.requests.cpu

为运行连接器认证服务容器而分配的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.connectorAuthService.resources.requests.memory

为运行连接器认证服务容器而分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.couchdb.image

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

Docker 映像的路径。

spec.pod.containers.couchdb.imagePullPolicy

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.couchdb.livenessProbe.failureThreshold

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

在执行操作之前,活动性探测器 (用于检查 CouchDB 容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.couchdb.livenessProbe.initialDelaySeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

启动活性探测器 (用于检查 CouchDB 容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.couchdb.livenessProbe.periodSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

执行活动性探测器以检查 CouchDB 容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.couchdb.livenessProbe.timeoutSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

活动性探测器 (用于检查 CouchDB 容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.couchdb.readinessProbe.failureThreshold

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

就绪性探测器 (用于检查 CouchDB 容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.couchdb.readinessProbe.initialDelaySeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

在启动就绪性探测器 (用于检查 CouchDB 容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.couchdb.readinessProbe.periodSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

执行就绪性探测器以检查 CouchDB 容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.couchdb.readinessProbe.timeoutSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

就绪性探测器 (用于检查 CouchDB 容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.couchdb.resources.limits.cpu

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

分配用于运行 CouchDB 容器的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可以使用spec.pod.containers.couchdb.resources.limits.cpu设置 CPU 限制,或配置命名空间的 CPU 限制,如中所述为命名空间配置内存和 CPU 配额在里面Kubernetes文档。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.couchdb.resources.limits.memory

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

为运行 CouchDB 容器而分配的内存上限 (以字节为单位)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.couchdb.resources.requests.cpu

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

为运行 CouchDB 容器而分配的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.couchdb.resources.requests.memory

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

为运行 CouchDB 容器分配的最小内存 (以字节为单位)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.couchdb.startupProbe.failureThreshold

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

成功后要视为失败的探测器的最小连续失败数。

有关启动探测的更多信息,请参阅使用启动探测器保护启动缓慢的容器在里面Kubernetes文档。

150

spec.pod.containers.couchdb.startupProbe.initialDelaySeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

在启动活性探测器之前, CouchDB 容器已启动的秒数。

有关详细信息,请参阅For more information, see容器探针

0

spec.pod.containers.couchdb.startupProbe.periodSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

执行探测的频率(以秒计)。

2

spec.pod.containers.couchdb.startupProbe.timeoutSeconds

(仅当 spec.version 解析为 12.0.5.0-r1-lts 或更高版本时适用)

探测器超时的秒数。

有关详细信息,请参阅For more information, see容器探针

1

spec.pod.containers.flowdocAuthoring.image

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

Docker 映像的路径。

spec.pod.containers.flowdocAuthoring.imagePullPolicy

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.flowdocAuthoring.livenessProbe.failureThreshold

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.flowdocAuthoring.livenessProbe.initialDelaySeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.flowdocAuthoring.livenessProbe.periodSeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.flowdocAuthoring.livenessProbe.timeoutSeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.flowdocAuthoring.readinessProbe.failureThreshold

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.flowdocAuthoring.readinessProbe.initialDelaySeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.flowdocAuthoring.readinessProbe.periodSeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.flowdocAuthoring.readinessProbe.timeoutSeconds

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.flowdocAuthoring.resources.limits.cpu

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

为运行流文档编写容器而分配的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可以使用spec.pod.containers.flowdocAuthoring.resources.limits.cpu设置 CPU 限制,或配置命名空间的 CPU 限制,如中所述为命名空间配置内存和 CPU 配额在里面Kubernetes文档。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.flowdocAuthoring.resources.limits.memory

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

为运行流文档编写容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.flowdocAuthoring.resources.requests.cpu

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

所需的最低 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.flowdocAuthoring.resources.requests.memory

(仅当 spec.version 解析为 12.0.12.0-r2 或更低版本时适用)

为运行流文档编写容器而分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.flowTestManager.image

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

Docker 映像的路径。

spec.pod.containers.flowTestManager.imagePullPolicy

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.flowTestManager.livenessProbe.failureThreshold

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.flowTestManager.livenessProbe.initialDelaySeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.flowTestManager.livenessProbe.periodSeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.flowTestManager.livenessProbe.timeoutSeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.flowTestManager.readinessProbe.failureThreshold

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.flowTestManager.readinessProbe.initialDelaySeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.flowTestManager.readinessProbe.periodSeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.flowTestManager.readinessProbe.timeoutSeconds

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.flowTestManager.resources.limits.cpu

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

为运行流测试管理器容器而分配的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可使用 spec.pod.containers.flowTestManager.resources.limits.cpu 设置 CPU 限制,或按照 Kubernetes 文档中 为命名空间配置内存和 CPU 配额 的描述为命名空间配置 CPU 限制。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.flowTestManager.resources.limits.memory

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

为运行流测试管理器容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.flowTestManager.resources.requests.cpu

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

为运行流测试管理器容器而分配的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.flowTestManager.resources.requests.memory

(仅适用于 spec.version 解析为 12.0.12.3-r1 或更早的版本)

为运行流测试管理器容器而分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.mappingAssist.image

Docker 映像的路径。

spec.pod.containers.mappingAssist.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.mappingAssist.livenessProbe.failureThreshold

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.mappingAssist.livenessProbe.initialDelaySeconds

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.mappingAssist.livenessProbe.periodSeconds

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.mappingAssist.livenessProbe.timeoutSeconds

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.mappingAssist.readinessProbe.failureThreshold

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.mappingAssist.readinessProbe.initialDelaySeconds

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.mappingAssist.readinessProbe.periodSeconds

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.mappingAssist.readinessProbe.timeoutSeconds

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.mappingAssist.resources.limits.cpu

为运行映射辅助容器而分配的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可使用 spec.pod.containers.mappingAssist.resources.limits.cpu 设置 CPU 限制,或按照 Kubernetes 文档中 为命名空间配置内存和 CPU 配额 的描述为命名空间配置 CPU 限制。

2300m (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.mappingAssist.resources.limits.memory

为运行映射辅助容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

2765Mi

spec.pod.containers.mappingAssist.resources.requests.cpu

为运行 Mapping Assist 容器而分配的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

800m

spec.pod.containers.mappingAssist.resources.requests.memory

为运行映射辅助容器而分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

900Mi

spec.pod.containers.proxy.image

Docker 映像的路径。

spec.pod.containers.proxy.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.proxy.livenessProbe.failureThreshold

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.proxy.livenessProbe.initialDelaySeconds

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

60

spec.pod.containers.proxy.livenessProbe.periodSeconds

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.proxy.livenessProbe.timeoutSeconds

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.proxy.readinessProbe.failureThreshold

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.proxy.readinessProbe.initialDelaySeconds

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

5

spec.pod.containers.proxy.readinessProbe.periodSeconds

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.proxy.readinessProbe.timeoutSeconds

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.proxy.resources.limits.cpu

为运行 Designer 代理容器而分配的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可使用 spec.pod.containers.proxy.resources.limits.cpu 设置 CPU 限制,或按照 Kubernetes 文档中 为命名空间配置内存和 CPU 配额 的描述为命名空间配置 CPU 限制。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.proxy.resources.limits.memory

为运行 Designer 代理容器分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.proxy.resources.requests.cpu

分配用于运行 Designer 代理容器的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

200m

spec.pod.containers.proxy.resources.requests.memory

为运行 Designer 代理容器而分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.runtime.image

Docker 映像的路径。

spec.pod.containers.runtime.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.runtime.livenessProbe.failureThreshold

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.runtime.livenessProbe.initialDelaySeconds

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

30

spec.pod.containers.runtime.livenessProbe.periodSeconds

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

5

spec.pod.containers.runtime.livenessProbe.timeoutSeconds

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.runtime.readinessProbe.failureThreshold

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.runtime.readinessProbe.initialDelaySeconds

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

30

spec.pod.containers.runtime.readinessProbe.periodSeconds

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

5

spec.pod.containers.runtime.readinessProbe.timeoutSeconds

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

3

spec.pod.containers.runtime.resources.limits.cpu

分配用于运行 Designer 运行时容器的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可使用 spec.pod.containers.runtime.resources.limits.cpu 设置 CPU 限制,或按照 Kubernetes 文档中 为命名空间配置内存和 CPU 配额 的描述为命名空间配置 CPU 限制。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.runtime.resources.limits.memory

为运行 Designer 运行时容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.runtime.resources.requests.cpu

为运行 Designer 运行时容器而分配的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.runtime.resources.requests.memory

为运行 Designer 运行时容器分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.pod.containers.ui.image

Docker 映像的路径。

spec.pod.containers.ui.imagePullPolicy

corev1.PullPolicy

指示是希望每次都拉取图像,从不拉取,还是仅当它们不存在时才拉取。

有效值为 AlwaysNeverIfNotPresent

IfNotPresent

spec.pod.containers.ui.livenessProbe.failureThreshold

在执行操作之前,活动性探测器 (用于检查容器是否仍在运行) 可能失败的次数。

1

spec.pod.containers.ui.livenessProbe.initialDelaySeconds

启动活动性探测器 (用于检查容器是否仍在运行) 之前等待的时间长度 (以秒计)。 如果系统无法在缺省时间段内启动容器,请增大此值。

60

spec.pod.containers.ui.livenessProbe.periodSeconds

执行活动性探测器以检查容器是否仍在运行的频率 (以秒计)。

30

spec.pod.containers.ui.livenessProbe.timeoutSeconds

活动性探测器 (用于检查容器是否仍在运行) 超时之前的时间长度 (以秒计)。

10

spec.pod.containers.ui.readinessProbe.failureThreshold

就绪性探测器 (用于检查容器是否就绪) 在执行操作之前可能失败的次数。

1

spec.pod.containers.ui.readinessProbe.initialDelaySeconds

启动就绪性探测器 (用于检查容器是否就绪) 之前等待的时间长度 (以秒计)。

60

spec.pod.containers.ui.readinessProbe.periodSeconds

执行就绪性探测器以检查容器是否就绪的频率 (以秒计)。

2

spec.pod.containers.ui.readinessProbe.timeoutSeconds

就绪性探测器 (用于检查容器是否就绪) 超时之前的时间长度 (以秒计)。

10

spec.pod.containers.ui.resources.limits.cpu

分配用于运行 Designer UI 容器的 CPU 核心的上限。 指定整数,分数 (例如, 0.5) 或 millicores 值 (例如, 100m,其中 100m 等同于 .1 核心)。

创建 Designer 实例时,如果 spec.version 解析为 12.0.7.0-r1 或更高版本,那么不会对资源设置 CPU 限制。 如果需要,可使用 spec.pod.containers.ui.resources.limits.cpu 设置 CPU 限制,或按照 Kubernetes 文档中 为命名空间配置内存和 CPU 配额 的描述为命名空间配置 CPU 限制。

1 (当 spec.version 为 12.0.6.0-r1 或更低版本时)

spec.pod.containers.ui.resources.limits.memory

为运行 Designer UI 容器而分配的内存上限 (以字节计)。 指定含以下后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

1024Mi

spec.pod.containers.ui.resources.requests.cpu

分配用于运行 Designer UI 容器的最小必需 CPU 核心数。 指定整数,分数 (例如, 0.5) 或 millicore 值 (例如, 100m,其中 100m 等同于 .1 核)。

100m

spec.pod.containers.ui.resources.requests.memory

为运行 Designer UI 容器分配的最小内存 (以字节计)。 指定含以下任一后缀的整数:E、P、T、G、M、K 或等于 2 的幂的值:Ei、Pi、Ti、Gi、Mi、Ki。

256Mi

spec.replicas

要为每个部署运行的副本 pod 数。 1 到 10 之间的数字。

3

spec.switchServer.name

在 Designer 实例中运行可调用流时或在运行与专用网络中的应用程序进行交互的流时启用安全连接的现有交换机服务器的名称。 交换机服务器名称是交换机服务器定制资源中的 metadata.name 值。

有关如何创建交换服务器的信息,请参阅 App Connect 交换服务器参考

default

spec.useCommonServices

注:

已从 IBM App Connect Operator 11.0.0 或更高版本中的所有实例中移除。 要使用 Keycloak启用身份和访问权管理 (IAM) ,请参阅 spec.authentication.integrationKeycloak.enabledspec.authorization.integrationKeycloak.enabled

当仅使用 IBM App Connect 操作员 10.1.1 或更早版本中的实例时,是否启用 IBM Cloud Pak 基础服务 3.x.x 的指示。

有效值为truefalse

  • OpenShift-only内容如果使用 IBM Cloud Pak for Integration 许可证(通过 spec.license.use 指定),则必须设置为 true。 如果使用 App Connect Enterprise 许可证,则可设置为 truefalse
  • Kubernetes-仅内容如果在 Kubernetes环境中运行,且具有受支持的 App Connect Enterprise 许可(通过 spec.license.use 指定),则必须设置为 false

仅当 spec.version 解析为 11.0.0.11-r2 至 12.0.5.0-r3: 设置为 true 时,只请求基本的 IBM Cloud Pak 基础服务,这意味着默认情况下只安装身份和访问管理 (IAM) 服务,以及提供登录页面以安全访问实例的通用 UI 组件。

仅当 spec.version 解析为 12.0.5.0-r4 或更高版本时才适用: 如果设置为 true,则必须确保 IBM Cloud Pak 基础服务 操作符 (3.19.x 或更高版本 3.x.x) 作为 IBM Cloud Pak for Integration 部署的一部分进行安装,或者与 IBM App Connect 操作员 的独立部署手动安装在同一命名空间中。 (有关详细信息,请参阅 安装 IBM Cloud Pak 基础服务) 当 spec.useCommonServices 设置为 true 时,只请求基本的 IBM Cloud Pak 基础服务,这意味着默认情况下只安装身份和访问管理 (IAM) 服务,以及提供登录页面以安全访问实例的通用用户界面组件。

false

spec.version

Designer 实例所基于的产品版本。 可以通过使用通道或作为标准版本来指定。 如果指定通道,那么必须确保许可证与通道中的最新标准版本一致。

如果您正在使用 IBM App Connect Operator 7.1.0 或更高版本,那么受支持的通道或版本将取决于集群中安装的 Red Hat OpenShift 版本。

要查看可供选择的可用值,请参阅 spec.version 值

12.0

支持的平台

Red Hat OpenShift: 支持 amd64ppc64le CPU 体系结构,尽管映射辅助组件在 ppc64le上不受支持。 有关详细信息,请参阅 支持的平台

Kubernetes 环境: 仅支持 amd64 CPU 体系结构。 有关详细信息,请参阅 Kubernetes 支持的运行环境