From d9c89a232ddf268e5f50ea4ac4e9b13e34032c4e Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Tue, 10 Mar 2026 15:42:16 +0100 Subject: [PATCH] Document `cds up --overlay` --- guides/deploy/to-cf.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/guides/deploy/to-cf.md b/guides/deploy/to-cf.md index d1d6c09a9..4955aa785 100644 --- a/guides/deploy/to-cf.md +++ b/guides/deploy/to-cf.md @@ -331,6 +331,27 @@ It is **essential to regularly update dependencies** to consume latest bug fixes We recommend setting up [Dependabot](https://docs.github.com/en/code-security/dependabot), [Renovate](https://docs.renovatebot.com/) or similar automated solutions to update dependencies **one-by-one** to easily identify breaking changes, minimize risks, and ensure continuous compatibility and **stability of your application**. +### Use MTA Extensions with `cds up` + +For Cloud Foundry deployments, you can pass an [MTA extension descriptor](https://help.sap.com/docs/btp/sap-business-technology-platform/defining-mta-extension-descriptors) to `cds up` using `--overlay`: + +```sh +cds up --overlay .deploy/eu10-prod.mtaext +``` + +This allows you to keep landscape-specific deployment settings outside your base _mta.yaml_, for example, scaling parameters: + +```yaml [eu10-prod.mtaext] +_schema-version: 3.3.0 +ID: bookshop-eu10-prod +extends: bookshop + +modules: + - name: bookshop-srv + parameters: + instances: 2 +``` + ## Upgrade Tenants {.java} The CAP Java SDK offers `main` methods for Subscribe/Unsubscribe in the classes `com.sap.cds.framework.spring.utils.Subscribe/Unsubscribe` that can be called from the command line. This way, you can run the tenant subscribe/unsubscribe for the specified tenant. This triggers your custom handlers, which is useful for local testing scenarios.