btp-service-bindings

用途：在 SAP BTP 环境中处理 CAP 或 Node.js 应用的服务绑定，帮助开发者理解并正确配置服务凭据，避免泄漏或解析错误。主要能力：CAP 会按服务名、binding_name、tags、kind 与 label、kind 与 type 的顺序，将绑定匹配到 cds.requires 条目；支持 Cloud Foundry 的 VCAP_SERVICES 结构以及 Kyma 上由 SAP BTP Service Operator 创建的绑定。常用方式：本地开发推荐使用 cds bind 指令，例如 cds bind -2 my-app-auth 绑定单个实例，cds bind -2 my-app-destination:my-destination-key 指定服务密钥，cds bind -2 a,b,c 绑定多个服务，再以 cds watch --profile hybrid 以混合模式运行；生成的 .cdsrc-private.json 必须加入 .gitignore。也可用 cds bind --exec 在填充 VCAP_SERVICES 后运行任意命令，例如 cds bind --exec -- npm start --prefix app/router。default-env.json 仅作旧式备选，同样不得提交。Kyma 中使用 ServiceBinding 自定义资源，并通过 SERVICE_BINDING_ROOT 指定绑定根目录。访问凭据应始终从绑定中读取，例如 cds.requires['my-remote-service'].credentials 或 @sap/xsenv。限制与注意：绑定歧义时需用 vcap.name 明确实例；不要在代码中硬编码凭据，不要提交敏感文件，CI/CD 中应使用环境变量或密钥管理；本地测试应使用专用的开发/测试实例；Kyma 部署不要遗漏 SERVICE_BINDING_ROOT。资料未提供具体版本与平台限制。