miel.truyen/nx
1
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

docs(core): improve custom commands doc

Browse Source
This commit is contained in:
Juri 2022-12-01 09:27:02 +01:00 committed by Juri Strumpflohner
parent 08689b03be
commit 04e56f6386
1 changed files with 20 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
docs/shared/running-custom-commands.md
View File

@ -1,10 +1,8 @@
# Running Custom Commands # Running Custom Commands
This recipe will show how to run any terminal command within the nx build-chain. You can easily run any command with the Nx toolchain. The main benefit is to make the [operation cacheable](/concepts/how-caching-works), [distributeable](/core-features/distribute-task-execution) as well as being able to use it [with Nx's affected commands](/concepts/affected).
## Steps ## 1. Define the terminal command to be run
##### 1. Define the terminal command to be run
The command we want to run for each project is: The command we want to run for each project is:
@ -19,7 +17,7 @@ hello:
echo "Hello, world!" echo "Hello, world!"
``` ```
##### 2. Update `project.json` ## 2. Update `project.json`
For each project for which you want to enable `make`, add a target in its `project.json`: For each project for which you want to enable `make`, add a target in its `project.json`:
@ -27,33 +25,36 @@ For each project for which you want to enable `make`, add a target in its `proje
// ... // ...
"targets": { "targets": {
"make": { "make": {
"executor": "nx:run-commands",
"options": {
"commands": [
{
"command": "make hello" "command": "make hello"
} }
]
}
}
// ... // ...
} }
``` ```
For more information, see the [run-commands api doc](/packages/nx/executors/run-commands). For more information (e.g. how to forward arguments), see the [run-commands api doc](/packages/nx/executors/run-commands).
##### 3. Trigger the executor from the terminal ## 3. Run the command
To run the executor for a single project: To run the command, use the usual Nx syntax:
```shell ```shell
nx run my-app:make nx run my-app:make
``` ```
To run the executor for all affected projects: or
```shell
nx make my-app
```
You can also run the `make` command for all projects it has been defined on:
```shell
nx run-many --target=make
```
Or just on a subset of projects that are [affected by a given change](/concepts/affected):
```shell ```shell
nx affected --target=make nx affected --target=make
``` ```
For more information, see the [nx affected](/nx/affected).