多租户 SaaS 应用(CAP) · 案例导读
项目 |
内容 |
|---|---|
官方仓库 |
|
业务场景 |
把 CAP 应用做成多租户 SaaS:租户订阅、租户隔离、租户级配置 |
技术栈 |
CAP(Node.js/Java)、mtxs、SaaS Registry、XSUAA、Cloud Foundry / Kyma |
对应课程 |
|
对应路径 |
第 2 条、第 7 条 |
为什么值得做:多租户是 SaaS 产品的分水岭。本案例实现了租户开通、数据隔离与升级机制,用一个应用即可服务众多客户。
动手要点:
理解 SaaS Registry 与租户感知(tenant-aware)应用之间的关系。
研读
mta.yaml与租户部署描述文件——大部分复杂度都集中在这里。
本页内容抓取自官方仓库 SAP-samples/btp-cap-multitenant-saas,共收录 1 篇官方文档(README 与 docs)。原仓库内容版权归 SAP SE,遵循其许可证。
使用 CAP 在 SAP BTP 上开发多租户软件即服务(SaaS)应用(Kyma + Cloud Foundry)
说明
**Sustainable SaaS(SusaaS)**示例应用是在合作伙伴协作中构建的,旨在帮助有兴趣的开发者、合作伙伴和客户使用 CAP 开发多租户软件即服务应用,并将其部署到 SAP Business Technology Platform(SAP BTP)。本用例选择了 SAP BTP, Cloud Foundry 和 Kyma Runtime。不过,你也可以在 SAP BTP, ABAP environment 中开发类似的 SaaS 应用(更多细节请点击此处)。
该示例着重介绍如何利用标准框架和 SAP BTP 服务来开发、部署和监控解决方案,例如 Cloud Application Programming Model(CAP)、SAP API Management、Alert Notification 等。
该示例应用聚焦可持续发展(sustainability)主题,因此得名 Sustainable SaaS(Susaas)。它允许 SaaS 应用的客户(消费方租户)使用 SaaS 供应商(提供方)开发的附加功能来扩展其 SAP S/4HANA 等 SAP 解决方案。
鉴于该主题在技术和理论上的复杂性,本示例应用不应被视为可用于任何生产场景,也不得以任何方式用于生产场景。它的目的是为把你的场景付诸实践提供思路和方法。我们的目标是尽可能覆盖更多主题,但并不追求足以支撑生产可用性的深度。
下面给出示例应用的解决方案架构图。可以看到,Kyma 与 Cloud Foundry 两种架构都包含你在本教程中会用到的许多服务和工具(点击可放大)。
Kyma
Cloud Foundry
内容
开始之前,建议先**认识(Discover)**一些基本技能与知识。以下文档内容将介绍本场景的基础知识、多租户概念以及软件即服务应用。
1 - 认识教程目标
2 - SAP BTP、Cloud Foundry、Kyma 与 CAP 基础
3 - SAP BTP 生态系统中的合作伙伴
4 - 了解 SaaS 应用
5 - 理解 SAP BTP 多租户
6 - 最新变化
接下来,先为提供方子账户分配所需权利(entitlements),再把 SaaS 示例应用的基础版本部署到你的 SAP BTP、Cloud Foundry 或 Kyma 环境。了解此刻正运行在你环境中的完整 SaaS 示例应用所用的各个组件,并订阅第一个消费方租户。
0 - 基础版本简介
1 - 了解仓库结构
2 - 准备提供方子账户
3 - 构建并部署应用
构建并部署应用(仅 Cloud Foundry)
构建容器镜像(仅 Kyma)
部署 SaaS 应用(仅 Kyma)
4 - 订阅消费方子账户
5 - 向 SaaS API 推送数据
6 - 测试 SaaS 应用
7 - 探索应用技术细节
探索应用组件
了解 Helm 与 Kyma 资源(仅 Kyma)
8 - 取消订阅消费方子账户
9 - 取消部署 SaaS 应用
一旦你成功将 SaaS 示例应用的基础功能部署到 Cloud Foundry 环境或 Kyma 集群,就可以通过高级版本为其添加更多功能。例如,使用 SAP API Management 集成来监控和管理 SaaS API 端点,或使用 SAP Identity Authentication 提供集中用户管理,而无需依赖 SAP ID service。此外,你还会了解并看到一个示例:如何从 SaaS 消费方的角度集成 SAP S/4HANA 等后端系统。
0 - 高级版本简介
1 - 准备提供方子账户
2 - 使用 SAP IAS 进行集中用户管理
3 - 从 SAP S/4HANA 系统推送数据
4 - 让 API 达到企业级要求
将 Cloud Foundry 与 SAP API Management 集成(仅 Cloud Foundry)
将 Kyma 与 SAP API Management 集成(仅 Kyma)
5 - 使用云日志服务实现可观测性
在 Cloud Foundry 上启用可观测性(仅 Cloud Foundry)
在 Kyma 上启用可观测性(仅 Kyma)
添加部分或全部高级特性后,下面的专家特性涵盖多种不同主题,可让你的应用以及你作为 SaaS 开发者的日常工作更加轻松。你将了解租户数据库容器的管理与备份、SaaS 应用的多区域部署,以及如何处理自定义域名使用等主题。大多数高级特性可在 Cloud Foundry 和 Kyma 两种运行时上测试,而部分特性(截至目前)仅适用于特定运行时。
重要 - 部分专家特性仍在开发中(Work-in-Progress)。代码和文档可能会变更。
本地与混合开发
使用 Terraform 开通租户
为 SAP IAS 使用自定义域名
使用 Microsoft Graph 发送电子邮件
功能开关(Feature Toggles)
SaaS 消费方可扩展性
管理租户数据库容器
HDI 容器管理
备份数据库容器
集成消费方 IdP
更新租户数据库容器
Cloud Foundry(仅限)
使用自定义域名
多个 SAP HANA Cloud 实例
部署到多个区域
设置持续集成场景
使用 SAP Theme Designer
配置 SAP Transport Management
Kyma(仅限)
使用自定义域名
设置持续集成场景
前提条件
如果尚未完成,我们建议为本示例应用设置一个 Pay-As-You-Go(PAYG) 或 CPEA 账户,并使用文中提到的 Free (Tier) 服务计划。有关如何设置 PAYG 账户(允许你使用所有 Free Tier 服务计划)的教程,可在 Tutorial Navigator 中找到。
提示 - 本示例场景(基础版本和高级版本)也可以部署到 Trial 账户中的 Cloud Foundry 和 Kyma 环境,但我们建议使用上述两种账户类型之一。如果使用 Trial 账户,请务必选择 us10 区域,以便访问 SAP HANA Cloud。
基础版本
示例应用的基础版本需要在提供方子账户中具备以下一组 SAP BTP 权利,这些权利可使用 PAYG 和 CPEA 账户的 Free (Tier) 服务计划获得。
Kyma
服务 / 订阅 |
免费层 /(试用)计划 |
|---|---|
Lite |
|
Free / (Trial: Lite) |
|
Lite |
|
Broker |
|
Free / (Trial: Trial) |
|
Central |
|
App-host |
|
Application |
|
hana-free (Trial: hana) |
|
hdi-shared |
|
Container |
Cloud Foundry
提示 - 对于本用例,1 GB 的 Cloud Foundry 运行时已经足够。
服务 / 订阅 |
免费层 /(试用)计划 |
|---|---|
Standard |
|
Lite |
|
Free / (Trial: Lite) |
|
Lite |
|
Broker |
|
Free / (Trial: MEMORY) |
|
Central |
|
Free / (Trial: Trial) |
|
App-host |
|
Application |
|
hana-free / (Trial: hana) |
|
hdi-shared |
|
Container |
如果需要协助为提供方子账户分配权利,可在此处找到相关信息。
高级特性
高级特性需要一些额外的服务和软件组件,具体如下。请注意,SAP Identity Authentication Service 仅在 Pay-As-You-Go(PAYG) 和 CPEA 账户中可用。
服务 |
免费层 /(试用)计划 |
|---|---|
Free (Application) |
|
default (Application) |
|
SAP S/4HANA 2021 (or newer) |
|
请查看下文关于高级版本所需额外权利的详细信息。尤其是在使用 Cloud Identity Services 时,务必理解其许可模型,以确保不超出免费使用范围!
SAP Integration Suite
免费服务计划仅可使用 90 天。90 天后你的租户将被停用;如需继续验证,需要重新设置新的租户。
Cloud Identity Services
注册 PAYG 或 CPEA 账户时,你有权获得一个免费的测试及生产用 SAP Identity Authentication Service(SAP IAS) 租户。使用 Cloud Identity Services 的 default (Application) 计划,可在你的环境中创建这样一个实例。任何后续新增的租户均可作为**附加租户(Additional Tenant)**获得许可,并将根据你的账户类型计费。也请查看 SAP 官方帮助文档(点击此处),以及下面的博客文章(点击此处),以了解更多信息。请先检查是否已存在 SAP IAS 租户,以确保符合免费服务提供范围。
使用 SAP Identity Authentication Service 时,请务必遵守许可模型,该模型在很大程度上取决于在 SAP IAS 中创建的应用注册类型。将 SAP IAS 用于涉及第三方解决方案的认证场景会产生费用!SAP Cloud 到 SAP Cloud 的登录通常包含在你的整体 SAP BTP 合同中,但在将 SAP IAS 作为整体架构的一部分大量使用之前,请务必理解许可模型。更多信息可在 SAP Help(点击此处)中找到。
服务计划 application 允许你在 SAP BTP 内创建相应服务实例,这些实例会自动在你子账户配置的受信任 SAP IAS 租户中注册一个应用。
SAP S/4HANA
SAP S/4HANA 系统实际上并不属于你的 SAP BTP 提供方子账户,但如果你想测试从现有 SAP On-Premise 解决方案自动推送数据的功能,则需要它。虽然我们建议至少使用 SAP S/4HANA 2021 版本,但只需少量编码工作,你也应能集成更早的版本。本教程假定你至少有权访问 SAP S/4HANA 2021 版本。欢迎查看 SAP Cloud Appliance Library(https://cal.sap.com/)以获取免费测试许可。
已知问题
未解决(Open)
自动凭据轮换(已有变通方案 - 2023/06/09)
问题现象:在 One-Domain 概念下,用户通过 SAP IAS 成功登录后会遇到回调认证错误。
原因:启用 SAP BTP Service Operator 的自动凭据轮换会更新相应 SAP IAS 服务绑定的 X.509 证书。由于 Application Router 出于性能考虑会缓存绑定详细信息,轮换后缓存的 X.509 证书不再有效。这会导致 Application Router 与 SAP IAS 之间出现认证错误。
变通方案:凭据轮换后重启 Application Router 即可解决此问题,并会缓存最新的 X.509 证书。可以在 Kubernetes/Kyma CronJob 中按凭据轮换周期自动执行此重启,触发新的 Deployment 滚动发布。结合用于 Application Router 会话管理的外部 Redis 缓存,可将停机时间降至最低甚至完全消除!请确保新旧 X.509 证书有足够的重叠时间(rotatedBindingTTL: 24h 与 rotationFrequency: 48h),使缓存的凭据在重启发生前仍然有效!
解决方案:该问题已处理,未来可能会通过某种通知机制触发 Application Router 缓存的自动更新(该方案可能变更)。
消费方扩展 API 问题(已有变通方案 - 2022/12/19)
问题现象:应用消费方扩展后,扩展后的租户目前无法再使用 Push API。
原因:当前实现在读取和处理扩展后的 SaaS CAP 服务的 CSN 文件时存在问题。该服务是 API CAP 服务的基础。
变通方案:已暂时禁用 CAP API Service 的可扩展性。
解决方案:已与 CAP 产品管理团队沟通该问题,将研究可能的解决方案。
如何获得支持
如果发现缺陷或对内容有疑问,请在本仓库中提交 issue。
如需更多帮助,请在 SAP 社区提问。
参与贡献
如果你希望贡献代码、提供修复或改进,请提交 Pull Request。请查看我们的贡献指南。出于法律原因,贡献者在为此项目创建第一个 Pull Request 时,需要接受 DCO。该过程在提交过程中自动完成。SAP 采用Linux 基金会标准的 DCO 文本。
行为准则
请遵守我们的行为准则。
许可证
Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved. 除 LICENSE 文件中另有说明外,本项目遵循 Apache Software License, version 2.0 许可。
- 多租户 SaaS 应用(CAP) · 1 · 认识多租户 SaaS
- 多租户 SaaS 应用(CAP) · 2 · 基础实现(1/4)
- 多租户 SaaS 应用(CAP) · 2 · 基础实现(2/4)
- 多租户 SaaS 应用(CAP) · 2 · 基础实现(3/4)
- 多租户 SaaS 应用(CAP) · 2 · 基础实现(4/4)
- 多租户 SaaS 应用(CAP) · 3 · 进阶主题(1/2)
- 多租户 SaaS 应用(CAP) · 3 · 进阶主题(2/2)
- 多租户 SaaS 应用(CAP) · 4 · 专家主题(1/3)
- 多租户 SaaS 应用(CAP) · 4 · 专家主题(2/3)
- 多租户 SaaS 应用(CAP) · 4 · 专家主题(3/3)
- 多租户 SaaS 应用(CAP) · 5 · 全量部署

