React Standalone Tutorial - Part 4: Task Pipelines

Running Dependent Tasks

Let's build the store application:

~/store❯

npx nx build store


   ✔    2/2 dependent project tasks succeeded [0 read from cache]

   Hint: you can run the command with --verbose to see the full dependent project outputs

 ————————————————————————————————————————————————————————————————————————————————————————————————————————


> nx run store:build:production


vite v3.2.4 building for production...
✓ 43 modules transformed.
dist/store/index.html                  0.46 KiB
dist/store/assets/index.50de2671.css   0.03 KiB / gzip: 0.05 KiB
dist/store/assets/index.f18c2b19.js    157.69 KiB / gzip: 51.26 KiB
dist/store/assets/index.f18c2b19.js.map 565.79 KiB

 ————————————————————————————————————————————————————————————————————————————————————————————————————————

 >  NX   Successfully ran target build for project store and 2 task(s) they depend on (6s)

Notice this line:

   ✔    2/2 dependent project tasks succeeded [0 read from cache]

When you run a task, Nx will run all the task's dependencies before running the task you specified. This ensures all the needed artifacts are in place before the task is run.

Configuring Task Pipelines

Nx can infer how projects depend on each other by examining the source code, but Nx doesn't know which tasks depend on each other.

In the nx.json file you can see the default set up:

{
  "targetDefaults": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["production", "^production"]
    }
  }
}

The "dependsOn": ["^build"] line says that every build task depends on the build tasks for its project dependencies. You can override the dependsOn setting for individual projects in the project.json files.

Skip Repeated Tasks

Why does Nx always run the dependent tasks? Doesn't that waste time repeating the same work?

It would, if Nx didn't have a robust caching mechanism to take care of that problem for you. Let's build the store app again.

~/store❯

npx nx build store


   ✔    2/2 dependent project tasks succeeded [2 read from cache]

   Hint: you can run the command with --verbose to see the full dependent project outputs

 ————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————


> nx run store:build:production  [local cache]


vite v3.2.4 building for production...
✓ 43 modules transformed.
dist/store/index.html                  0.46 KiB
dist/store/assets/index.50de2671.css   0.03 KiB / gzip: 0.05 KiB
dist/store/assets/index.f18c2b19.js    157.69 KiB / gzip: 51.26 KiB
dist/store/assets/index.f18c2b19.js.map 565.79 KiB


 ————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————

 >  NX   Successfully ran target build for project store and 2 task(s) they depend on (42ms)

   Nx read the output from the cache instead of running the command for 3 out of 3 tasks.

This time the build only took 42 ms. Also, if you delete the dist folder and run the command again, the build output will be recreated.

More Task Caching Details

See the documentation for more information on caching.

Cache Inputs and Outputs

How does Nx know when to replace a cached task result? And how does Nx know what should be cached?

Nx determines if a project has been modified by looking at the task's defined inputs. And then when the task is completed, it caches the terminal output and all the defined file outputs.

Inputs

When you run a task, Nx uses the inputs for your task to create a hash that is used as an index for the task results. If the task has already been run with the same inputs, Nx replays the results stored in the cache.

If this index does not exist, Nx runs the command and if the command succeeds, it stores the result in the cache.

Outputs

Outputs of the cache include the terminal output created by the task, as well as any files created by the task - for example: the artifact created by running a build task.

Here are the outputs defined for the shared-ui project:

shared/ui/project.json
{
  "name": "shared-ui",
  "targets": {
    "build": {
      "executor": "@nx/vite:build",
      "outputs": ["{options.outputPath}"],
      "options": {
        "outputPath": "dist/shared/ui"
      }
    },
    "lint": {
      "executor": "@nx/linter:eslint",
      "outputs": ["{options.outputFile}"],
      "options": {
        "lintFilePatterns": ["shared/ui/**/*.{ts,tsx,js,jsx}"]
      }
    },
    "test": {
      "executor": "@nx/vite:test",
      "outputs": ["{projectRoot}/coverage"],
      "options": {
        "passWithNoTests": true
      }
    }
  }
}
Nx 15 and lower use @nrwl/ instead of @nx/

Outputs are stored in the cache so that terminal output can be replayed, and any created files can be pulled from your cache, and placed where they were created the original time the task was run.

Testing Affected Projects

Another way that Nx saves you from unnecessary work is the affected command. affected is a mechanism that relies on your git metadata to determine the projects in your workspace that were affected by a given commit.

Run the command:

git add . ; git commit -m "commiting to test affected"

Then make a change to the styles of your cart project:

cart/src/lib/cart.module.css
.container {
  color: blue;
}

You can visualize how our workspace is affected by this change using the command:

npx nx affected:graph

The change made to the cart project is also affecting the store project. This can be leveraged to run tasks only on the projects that were affected by this commit.

To run the test targets only for affected projects, run the command:

npx nx affected -t test

This can be particularly helpful in CI pipelines for larger repos, where most commits only affect a small subset of the entire workspace.

Affected Documentation

Checkout Affected documentation for more details

What's Next

Continue to 5: Summary