From a94c3beffab1ba13fa52754b4d39c2e6ee161660 Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Thu, 21 May 2026 14:37:57 +0200 Subject: [PATCH 1/2] Add warning for HTTP health check scenarios --- tools/cds-cli.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/tools/cds-cli.md b/tools/cds-cli.md index 0e968484ca..d286130a6d 100644 --- a/tools/cds-cli.md +++ b/tools/cds-cli.md @@ -643,6 +643,25 @@ If you scale out to more instances, only some of your requests will hit the inst However, it's possible to [route a request to a specific instance](https://docs.cloudfoundry.org/devguide/deploy-apps/routes-domains.html#surgical-routing), which is useful if you can't reduce the number of app instances. ::: +::: warning HTTP health checks kill paused containers +While paused at a breakpoint, the Node.js event loop is frozen and the app cannot respond to Cloud Foundry's `http` health probe. CF will mark the container unhealthy and destroy it within seconds. + +Switch the health check to `process` for the duration of the debug session: + +```sh +cf set-health-check process +cf restart +``` + +Restore it afterwards: + +```sh +cf set-health-check http +``` + +`cds debug` detects this situation and prompts you to confirm before continuing. Note that the setting is overwritten on the next `cf push` unless persisted in `manifest.yml` / `mta.yaml`. +::: + ### Node.js Applications #### Remote Applications From 1005db6cb770662b452a38306ad0d4a94efff634 Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Thu, 21 May 2026 14:47:44 +0200 Subject: [PATCH 2/2] Update cds-cli.md --- tools/cds-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/cds-cli.md b/tools/cds-cli.md index d286130a6d..e895144647 100644 --- a/tools/cds-cli.md +++ b/tools/cds-cli.md @@ -659,7 +659,7 @@ Restore it afterwards: cf set-health-check http ``` -`cds debug` detects this situation and prompts you to confirm before continuing. Note that the setting is overwritten on the next `cf push` unless persisted in `manifest.yml` / `mta.yaml`. +`cds debug` detects this situation and prompts you to confirm before continuing. Note that the setting is overwritten on the next `cds up` unless persisted in `mta.yaml`. ::: ### Node.js Applications