solace/solace-pubsub-connector-salesforce

Solace PubSub+ Salesforce连接器

概述

基于gRPC的Solace PubSub+ Salesforce集成连接器，用于实现Solace PubSub+事件代理与Salesforce之间的集成。修订版本：3.2.0，修订日期：2025-07-14。

目录

• 概述
• 快速开始
  • 前提条件
  • 连接主机服务
  • 配置健康检查
• 提供配置
• 端口
• 卷
  • 卷：Spring配置文件
  • 卷：库
  • 卷：类路径文件
  • 卷：输出文件
• 配置JVM
  • 支持
• 许可证

快速开始

前提条件

• https://www.docker.com/ 或 https://podman.io/
• https://solace.com/products/event-broker/
• Salesforce (SFDC)

连接主机服务

如果服务（例如PubSub+事件代理）在本地主机上暴露，可使用容器平台的特殊DNS名称通过SOLACE_JAVA_HOST引用，该名称解析为主机使用的内部IP地址。

Docker示例：

bash
docker run -d --name my-connector \
  -v `pwd`/libs/:/app/external/libs/:ro \
  -v `pwd`/config/:/app/external/spring/config/:ro \
  --env SOLACE_JAVA_HOST=host.docker.internal:55555 \
  docker.xuanyuan.run/solace/solace-pubsub-connector-salesforce:3.2.0

Podman示例：

bash
podman run -d --name my-connector \
  -v `pwd`/libs/:/app/external/libs/:ro \
  -v `pwd`/config/:/app/external/spring/config/:ro \
  --env SOLACE_JAVA_HOST=host.containers.internal:55555 \
  solace/solace-pubsub-connector-salesforce:3.2.0

配置健康检查

可配置健康检查执行以下任务：

• 创建名为healthcheck的常规只读用户，密码通过SOLACE_CONNECTOR_SECURITY_USERS_0_NAME和SOLACE_CONNECTOR_SECURITY_USERS_0_PASSWORD设置。
• 使用healthcheck用户轮询容器的healthcheck命令中的管理健康端点，若连接器不健康则检查失败。

Docker健康检查示例：

bash
docker run -d --name my-connector \
  -v `pwd`/libs/:/app/external/libs/:ro \
  -v `pwd`/application.yml:/app/external/spring/config/application.yml:ro \
  --env SOLACE_CONNECTOR_SECURITY_USERS_0_NAME=healthcheck \
  --env SOLACE_CONNECTOR_SECURITY_USERS_0_PASSWORD=healthcheck \
  --healthcheck-command="curl -X GET -u healthcheck:healthcheck --fail localhost:8090/actuator/health" \
  docker.xuanyuan.run/solace/solace-pubsub-connector-salesforce:3.2.0

Podman健康检查示例：

bash
podman run -d --name my-connector \
  -v `pwd`/libs/:/app/external/libs/:ro \
  -v `pwd`/application.yml:/app/external/spring/config/application.yml:ro \
  --env SOLACE_CONNECTOR_SECURITY_USERS_0_NAME=healthcheck \
  --env SOLACE_CONNECTOR_SECURITY_USERS_0_PASSWORD=healthcheck \
  --healthcheck-command="curl -X GET -u healthcheck:healthcheck --fail localhost:8090/actuator/health" \
  solace/solace-pubsub-connector-salesforce:3.2.0

提供配置

可通过以下方式向容器提供Spring配置属性：

1. 使用https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.typesafe-configuration-properties.relaxed-***ding.environment-variables%E3%80%82
2. 使用包含Spring配置文件的卷（以及其他卷）。

端口

容器需要以下端口：

卷

以下是支持创建卷和绑定挂载的目录：

卷：Spring配置文件

Spring配置文件卷用于添加Spring配置文件（如application.yml等），添加只读卷或绑定挂载到/app/external/spring/config/。

此目录遵循https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files%E7%9A%84%E8%AF%AD%E4%B9%89%EF%BC%8C%E8%BF%9E%E6%8E%A5%E5%99%A8%E5%90%AF%E5%8A%A8%E6%97%B6%E4%BC%9A%E8%87%AA%E5%8A%A8%E4%BB%8E%E4%BB%A5%E4%B8%8B%E4%BD%8D%E7%BD%AE%E6%9F%A5%E6%89%BE%E5%B9%B6%E5%8A%A0%E8%BD%BDSpring%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%9A

1. /app/external/spring/config/的根目录。
2. /app/external/spring/config/的直接子目录。

提示

若要在同一config目录中为不同环境（如开发、生产）的多个不同连接器配置文件，建议使用https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.profile-specific%E8%80%8C%E9%9D%9E%E5%AD%90%E7%9B%AE%E5%BD%95%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%9A

• 推荐配置：
  • /app/external/spring/config/application-prod.yml
  • /app/external/spring/config/application-dev.yml
• 不推荐：
  • /app/external/spring/config/prod/application.yml
  • /app/external/spring/config/dev/application.yml

子目录用于合并来自多个配置属性源的配置。有关何时可能需要使用多个子目录组合应用配置的更多信息和示例，请参见https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.wildcard-locations%E3%80%82

卷：库

库卷用于添加额外库，添加只读卷或绑定挂载到/app/external/libs/。

此目录用于存放仅在使用连接器某些功能时所需的Java库依赖项（外部JAR文件）（例如，在连接器配置中使用指标导出到Prometheus功能时的Prometheus库）。

有关更多信息，请参见ZIP文件中连接器的libs目录提供的文档。

卷：类路径文件

类路径文件卷用于添加任意文件的位置（非JAR库或Spring Boot配置文件），添加只读卷或绑定挂载到/app/external/classpath/。

注意

此目录不得包含库的JAR文件或Spring Boot配置文件，否则可能导致库在连接器部署期间无法被正确加载，或覆盖连接器的内部配置。

卷：输出文件

输出文件卷用于支持写入输出文件的某些功能（如文件日志）。要捕获这些文件，添加读写卷或绑定挂载到/app/external/output/目录。

重要

使用生成文件的功能时，必须将功能配置为将文件生成到/app/external/output/目录。生成文件到其他目录不受支持。

配置JVM

可在容器上设置JDK_JAVA_OPTIONS环境变量来配置Java虚拟机（JVM）。

有关更多信息，请参见https://docs.oracle.com/en/java/javase/17/docs/specs/man/java.html#using-the-jdk_java_options-launcher-environment-variable%E3%80%82

提示

此容器作为示例提供，并已使用以下参数测试：

• 两个活动处理器（使用-XX:ActiveProcessorCount=2指定）。
• 最大堆内存为2 GB（使用-Xmx2048m指定）。

支持

通过Solace开发者社区提供尽力支持。

提供高级支持选项，请https://solace.com/contact-us%E3%80%82

许可证

本项目采用Solace社区许可证1.0版。详情参见容器/licenses目录下的LICENSE文件。