SAP Cloud Transport Management 是 SAP BTP 上的一项服务，用于在不同环境的账户之间管理软件交付物，通过在各种运行时之间传输这些交付物实现跨环境交付。它提升了变更审计轨迹的透明度，并支持开发团队与运维团队之间的关注点分离。
支持的运行环境：Cloud Foundry、Kyma、Neo（已弃用）。支持的内容类型包括：MTA（多目标应用，Cloud Foundry 部署用的 .mtar 文件）、BTP ABAP（Git 仓库中 ABAP 对象的引用）、应用内容（应用特定的格式，如 .zip、.rar）、XSC DU（SAP HANA XS classic 交付单元）。
适用场景：搭建传输蓝图、创建传输节点/路由、管理导入队列、跨环境部署 MTA、为部署传输配置目标（destination）、将传输集成到 CI/CD，以及排查 TMS 导入/部署错误。
初始设置流程：前提条件包括全局账户管理员访问权限、至少一个 SAP BTP 子账户、启用 Cloud Foundry 环境。设置步骤为：1. 配置授权（Global Account > Entitlements > Entity Assignments > Add Service Plans，选择 Cloud Transport Management，应用类计划有 standard、free、build-runtime，用于 UI 访问；实例类计划有 standard、export、transport_operator，用于 API/编程访问，实例计划需有活跃的应用计划，export 计划用于 CI/CD 流水线）；2. 订阅服务（Services > Service Marketplace，搜索 Cloud Transport Management，Actions 菜单选择 Create，选择订阅计划 standard、free 或 build-runtime，确认状态为 Subscribed）；3. 设置角色集合（预置角色集合 TMS_LandscapeOperator_RC、TMS_Viewer_RC，角色包括 Administrator、LandscapeOperator、TransportOperator、ImportOperator、ImportSelectedOperator、ExportOperator、Viewer，在 Security > Role Collections 分配）；4. 创建服务实例与密钥（Cloud Foundry 空间，Services > Instances and Subscriptions > Create，服务 Cloud Transport Management，计划 standard 实例类型，运行时 Cloud Foundry，创建服务密钥后获得 uaa clientid、clientsecret、url 及 uri 等凭据）。
蓝图配置：传输节点代表部署流程的源或目标端点，分物理节点（实际部署端点，如 Cloud Foundry 空间）和虚拟节点（用于聚合/分发的占位符，不做实际部署）。关键配置字段包括名称（大小写敏感，针对 Content Agent 须与 sourceSystemId 匹配）、允许上传到节点、转发模式（Pre-Import 默认、Post-Import、On Success、Manual）、内容类型（MTA、BTP ABAP、应用内容、XSC DU）、目标（目标部署端点）、部署策略（default 或 blue-green，后者仅限 CF 上的 MTA）。传输路由连接传输节点，约束为：一个节点只能作为一个路由的目标，但可作为多个路由的源。传输蓝图向导适用于简单的 2-3 节点蓝图：选择模板、配置每个节点、自定义路由名称、检查并完成。
目标（Destination）配置：所有目标都要求 HTTPS，在 SAP BTP Cockpit > Connectivity > Destinations 配置。包括指向 TMS 服务的目标（供应用直接向 TMS 导出内容，需 sourceSystemId 附加属性）、MTA 部署目标（Cloud Foundry，可用 BasicAuthentication 或支持自定义 IdP 的 OAuth2Password，需正确填写 CF 域与 org/space，必要时使用空间 GUID 并对特殊字符做 URL 编码）、BTP ABAP 环境目标（使用 SAP_COM_0948 的通信用户做基本认证）。
导入队列操作：导入方式包括 Import All（按顺序导入队列中所有请求，适用所有内容类型）、Import Selected（导入指定请求，可能造成不一致，不适用于 BTP ABAP）、Import Upto（导入到所选请求为止，仅 BTP ABAP）。可导入状态为 Initial、Fatal、Repeatable。文件上传最大 1 GB（免费计划 500 MB），存储配额 standard 为 50 GB、free 为 500 MB，最终状态后保留 30 天（免费 7 天），格式支持 .mtar、.tgz、.zip。调度支持每日或每周模式，连续 3 次致命失败且持续 3 周以上会自动停用。自动导入可按节点启用，立即处理所有可导入请求并在新请求到达时触发。
状态说明：导入状态包括 Initial、Running、Succeeded、Warning、Error、Fatal、Skipped、Repeatable、Deleted、Transient；生命周期状态包括 Modifiable、Released、Deleted、Archived。故障排查涵盖常见错误（Not Found、Forbidden、连接被拒绝、导入卡住等）及 MTA 部署错误（域名错误、org/space 名称特殊字符未编码、用户缺少 SpaceDeveloper 角色、身份提供方错误等）。SAP 支持组件为 BC-CP-LCM-TMS，提报事件需提供区域、子账户 ID、复现步骤、传输操作日志、截图等。
安全方面：API 访问计划中 standard 有完整 API 访问、export 仅导出（CI/CD）、transport_operator 仅导入/重置/转发/删除；可用属性将角色限制到特定节点（TmsNodesTransportOperator、TmsNodesImport、TmsNodesExport）。TMS 不执行恶意软件扫描，由目标应用负责，例外是 MTA 部署描述符会被校验。集成方面：CI/CD 可使用 SAP Continuous Integration and Delivery 或 Project Piper 配合 export 服务计划；可为 TmsImportFinished/TmsImportStarted、TmsTransportRequestAdded、TmsNodeImportJobDeactivated、TmsStorageQuotaUsage（85% 阈值）配置 ALERT_NOTIFICATION_SERVICE 目标；API 操作包括文件上传、节点导出、节点上传及需用 Get transport action 监控的异步导入操作。
相关技能：sap-btp-cloud-platform（子账户、角色集合、Cloud Foundry 运行时）、sap-btp-developer-guide（应用交付与 CI/CD 模式）、sap-btp-service-manager（服务实例、服务密钥、API/服务生命周期）、sap-abap（传输流包含 ABAP 环境或 gCTS 管理内容时）。参考文档链接：GitHub Docs https://github.com/SAP-docs/sap-btp-cloud-transport-management ，SAP Help Portal https://help.sap.com/docs/cloud-transport-management ，API Reference https://api.sap.com/package/TmsForCloudPub/rest 。最后更新于 2025-11-22。