f08cd4cae3
<!-- Please make sure you have read the submission guidelines before posting an PR --> <!-- https://github.com/nrwl/nx/blob/master/CONTRIBUTING.md#-submitting-a-pr --> <!-- Please make sure that your commit message follows our format --> <!-- Example: `fix(nx): must begin with lowercase` --> <!-- If this is a particularly complex change or feature addition, you can request a dedicated Nx release for this pull request branch. Mention someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they will confirm if the PR warrants its own release for testing purposes, and generate it for you if appropriate. --> ## Current Behavior <!-- This is the behavior we have today --> This was changed in the generated ci workflow but not on the docs. ## Expected Behavior <!-- This is the behavior we should expect with the changes in this PR --> This is changed in the docs as well so it's not confusing. ## Related Issue(s) <!-- Please link the issue being fixed so it gets closed when this is merged. --> Fixes #
53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
# Configuring CI Using Jenkins and Nx
|
|
|
|
Below is an example of a Jenkins setup, building and testing only what is affected.
|
|
|
|
```groovy
|
|
pipeline {
|
|
agent none
|
|
environment {
|
|
NX_BRANCH = env.BRANCH_NAME.replace('PR-', '')
|
|
}
|
|
stages {
|
|
stage('Pipeline') {
|
|
parallel {
|
|
stage('Main') {
|
|
when {
|
|
branch 'main'
|
|
}
|
|
agent any
|
|
steps {
|
|
// This line enables distribution
|
|
// The "--stop-agents-after" is optional, but allows idle agents to shut down once the "e2e-ci" targets have been requested
|
|
// sh "npx nx-cloud start-ci-run --distribute-on='3 linux-medium-js' --stop-agents-after='e2e-ci'"
|
|
sh "npm ci"
|
|
sh "npx nx-cloud record -- nx format:check"
|
|
sh "npx nx affected --base=HEAD~1 -t lint test build e2e-ci"
|
|
}
|
|
}
|
|
stage('PR') {
|
|
when {
|
|
not { branch 'main' }
|
|
}
|
|
agent any
|
|
steps {
|
|
// This line enables distribution
|
|
// The "--stop-agents-after" is optional, but allows idle agents to shut down once the "e2e-ci" targets have been requested
|
|
// sh "npx nx-cloud start-ci-run --distribute-on='3 linux-medium-js' --stop-agents-after='e2e-ci'"
|
|
sh "npm ci"
|
|
sh "npx nx-cloud record -- nx format:check"
|
|
sh "npx nx affected --base origin/${env.CHANGE_TARGET} -t lint test build e2e-ci"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Get the Commit of the Last Successful Build
|
|
|
|
Unlike `GitHub Actions` and `CircleCI`, you don't have the metadata to help you track the last successful run on `main`. In the example below, the base is set to `HEAD~1` (for push) or branching point (for pull requests), but a more robust solution would be to tag an SHA in the main job once it succeeds and then use this tag as a base. See the [nx-tag-successful-ci-run](https://github.com/nrwl/nx-tag-successful-ci-run) and [nx-set-shas](https://github.com/nrwl/nx-set-shas) (version 1 implements tagging mechanism) repositories for more information.
|
|
|
|
We also have to set `NX_BRANCH` explicitly.
|