affected:build
Build applications and publishable libraries affected by changes
Usage
nx affected:build
Install nx
globally to invoke the command directly using nx
, or use npm run nx
or yarn nx
.
Examples
Run build in parallel:
nx affected:build --parallel --maxParallel=5
Rerun the build target only for the projects that failed last time:
nx affected:build --only-failed
Run the build target for all projects:
nx affected:build --all
Run the build target for the affected projects and also all the projects the affected projects depend on.:
nx affected:build --with-deps
Run build for all the projects affected by changing the index.ts file:
nx affected:build --files=libs/mylib/src/index.ts
Run build for all the projects affected by the changes between master and HEAD (e.g., PR):
nx affected:build --base=master --head=HEAD
Run build for all the projects affected by the last commit on master:
nx affected:build --base=master~1 --head=master
Run build for all the projects affected by the last commit on master and their dependencies:
nx affected:build --base=master~1 --head=master --with-deps
Options
all
All projects
base
Base of the current branch (usually master)
configuration
This is the configuration to use when performing tasks on projects
exclude
Default: ``
Exclude certain projects from being processed
files
Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
head
Latest commit of the current branch (usually HEAD)
help
Show help
maxParallel
Max number of parallel processes. This flag is ignored if the parallel option is set to false
. (default: 3)
only-failed
Default: false
Isolate projects which previously failed
parallel
Parallelize the command (default: false)
runner
This is the name of the tasks runner configured in nx.json
skip-nx-cache
Default: false
Rerun the tasks even when the results are available in the cache
uncommitted
Uncommitted changes
untracked
Untracked changes
verbose
Print additional error stack trace on failure
version
Show version number