|
5 | 5 | <strong>SYNOPSIS</strong> |
6 | 6 | <em>cds debug</em> [<app>] |
7 | 7 |
|
8 | | - Debug applications running locally or remotely on Cloud Foundry. |
9 | | - Local applications will be started in debug mode, while remote applications |
10 | | - are put into debug mode. |
| 8 | + Debug applications running locally or remotely on Cloud Foundry or Kubernetes. |
11 | 9 |
|
12 | | - If <app> is given, it's assumed to be running on the currently logged-in |
13 | | - Cloud Foundry space (check with 'cf target'). |
14 | | - SSH access to the app is required (check with 'cf ssh-enabled'). |
15 | | - Chrome DevTools are opened automatically for Node.js applications. |
| 10 | + If <app> is given, it's assumed to be running on a remote system. The command defaults |
| 11 | + to Kubernetes if Helm deployment descriptors are present, otherwise Cloud Foundry. |
| 12 | + |
| 13 | + For Cloud Foundry, the currently targeted space is used (check with 'cf target'). |
| 14 | + For Kubernetes, the current context and namespace are used (check with 'kubectl config get-contexts'). |
| 15 | + |
| 16 | + SSH access to the app is required (check with 'cf ssh-enabled' on Cloud Foundry). |
16 | 17 |
|
17 | 18 | If no <app> is given, the app in the current working directory is started |
18 | 19 | (with 'cds watch --debug' for Node.js and 'mvn spring-boot:run' for Java). |
19 | 20 |
|
| 21 | + For Node.js, Chrome DevTools are opened automatically unless <em>--no-devtools</em> is set. |
| 22 | + |
20 | 23 | <strong>OPTIONS</strong> |
21 | 24 | <em>-h</em> | <em>--host</em> |
22 | 25 |
|
23 | | - the debug host (default: '127.0.0.1') |
| 26 | + The debug host (default: '127.0.0.1'). |
24 | 27 |
|
25 | 28 | <em>-p</em> | <em>--port</em> |
26 | 29 |
|
27 | | - the debug port (default: '9229' for Node.js, '8000' for Java) |
| 30 | + The debug port (default: '9229' for Node.js, '8000' for Java). |
| 31 | + |
| 32 | + <em>--cf</em> |
| 33 | + |
| 34 | + Force Cloud Foundry mode. |
| 35 | + |
| 36 | + <em>--k8s</em> |
| 37 | + |
| 38 | + Force Kubernetes mode. Use env vars KUBE_NAMESPACE or NAMESPACE to select a namespace. |
28 | 39 |
|
29 | 40 | <em>--no-devtools</em> |
30 | 41 |
|
31 | | - don't open developer tools automatically |
| 42 | + Don't open developer tools automatically (Node.js only). |
32 | 43 |
|
33 | 44 | <em>-f</em> | <em>--force</em> |
34 | 45 |
|
35 | | - if necessary, automatically enable ssh for the app and restart it |
| 46 | + If necessary, automatically enable SSH for the app and restart it. |
36 | 47 |
|
37 | 48 | <strong>EXAMPLES</strong> |
38 | 49 | <em>cds debug</em> |
39 | 50 | <em>cds debug</em> bookshop-srv --port 8001 |
40 | 51 | <em>cds debug</em> bookshop-srv --host 0.0.0.0 |
| 52 | + <em>cds debug</em> --k8s bookshop-srv |
41 | 53 | </pre> |
0 commit comments