NX Github Actions

A set of Github Actions for NX workspaces

project	version	description
@e-square/nx-affected-matrix		Uses NX's affected utils to calculate the changes. Outputs a matrix of the distributed tasks
@e-square/nx-distributed-task		Execute each distributed task from the matrix generated from nx-affected-matrix action

Features

✅ Distribution of tasks across multiple parallel jobs
✅ GitHub Cache support
✅ GitHub artifacts support
✅ NX Cloud support

Usage

Here's an example of a workflow file that uses both actions

jobs:
  setup:
    runs-on: ubuntu-latest
    name: Affected Matrix
    outputs:
      hasChanges: ${{ steps.affected.outputs.hasChanges }}
      matrix: ${{ steps.affected.outputs.matrix }}
    steps:
      - name: Calculate affected projects
        uses: e-square-io/nx-affected-matrix@v2
        id: affected
        with:
          targets: 'test,build'
          maxDistribution: 3
          workingDirectory: ''
          args: ''

  execute:
    name: ${{ matrix.target }}
    if: ${{ fromJSON(needs.setup.outputs.hasChanges) }}
    needs: [setup]
    runs-on: ubuntu-latest
    continue-on-error: ${{ matrix.target == 'test' }}
    strategy:
      fail-fast: false
      matrix: ${{ fromJSON(needs.setup.outputs.matrix) }}
    steps:
      # Checkout, cache, install node modules

      - name: Execute
        uses: e-square-io/nx-distributed-task@v2
        id: execute
        with:
          target: ${{ matrix.target }}
          projects: ${{ matrix.projects }}
          uploadOutputs: true
          nxCloud: false
          args: ''