What is a Task Pipeline
If you have a monorepo workspace (or modularized app), you rarely just run one task. Almost certainly there are relationships among the projects in the workspace and hence tasks need to follow a certain order.
As you can see in the graph visualization below, the myreactapp
project depends on other projects. Therefore, when running the build for myreactapp
, these dependencies need to be built first so that myreactapp
can use the resulting build artifacts.
While you could manage these relationships on your own and set up custom scripts to build all projects in the proper order (e.g. first build shared-ui
, then feat-products
and finally myreactapp
), that kind of approach is not scalable and would need constant maintenance as you keep changing and adding projects to your workspace.
This becomes even more evident when you run tasks in parallel. You cannot just naively run all of them at the same time. Instead, the task orchestrator needs to respect the order of the tasks so that it builds libraries first and then resumes building the apps that depend on those libraries in parallel.
Nx allows you to define task dependencies in the form of "rules", which are then followed when running tasks. There's a detailed recipe but here's the high-level overview:
1{
2 ...
3 "targetDefaults": {
4 "build": {
5 "dependsOn": ["^build", "prebuild"]
6 },
7 "test": {
8 "dependsOn": ["build"]
9 }
10 }
11}
12
Older versions of Nx used targetDependencies instead of targetDefaults. targetDependencies
was removed in version 16, with targetDefaults
replacing its use case.
When running nx test myproj
, the above configuration would tell Nx to
- Run the
test
command formyproj
- But since there's a dependency defined from
test
tobuild
(see"dependsOn" :["build"]
), Nx runsbuild
formyproj
first. build
itself defines a dependency onprebuild
(on the same project) as well asbuild
of all the dependencies. Therefore, it will run theprebuild
script and will run thebuild
script for all the dependencies.
Note, Nx doesn't have to run all builds before it starts running tests. The task orchestrator will run as many tasks in parallel as possible as long as the constraints are met.
These rules can be defined globally in the nx.json
file or locally per project in the package.json
or project.json
files.
Configure It for Your Own Project
Learn about all the details of how to configure task pipelines in the according recipe section.