jenkins
# Jenkins
Interact with Jenkins CI/CD server through REST API.
## Required environment variables
- `JENKINS_URL` (example: `https://jenkins.example.com`)
- `JENKINS_USER` (your Jenkins username)
- `JENKINS_API_TOKEN` (API token from Jenkins user settings)
## List jobs
```bash
node {baseDir}/scripts/jenkins.mjs jobs
node {baseDir}/scripts/jenkins.mjs jobs --pattern "deploy-*"
```
## Trigger build
```bash
node {baseDir}/scripts/jenkins.mjs build --job "my-job"
node {baseDir}/scripts/jenkins.mjs build --job "my-job" --params '{"BRANCH":"main","ENV":"dev"}'
```
## Check build status
```bash
node {baseDir}/scripts/jenkins.mjs status --job "my-job"
node {baseDir}/scripts/jenkins.mjs status --job "my-job" --build 123
node {baseDir}/scripts/jenkins.mjs status --job "my-job" --last
```
## View console output
```bash
node {baseDir}/scripts/jenkins.mjs console --job "my-job" --build 123
node {baseDir}/scripts/jenkins.mjs console --job "my-job" --last --tail 50
```
## Stop build
```bash
node {baseDir}/scripts/jenkins.mjs stop --job "my-job" --build 123
```
## View queue
```bash
node {baseDir}/scripts/jenkins.mjs queue
```
## View nodes
```bash
node {baseDir}/scripts/jenkins.mjs nodes
```
## Notes
- URL and credentials are variables by design for cross-environment deployment.
- API responses are output as JSON.
- For parameterized builds, use `--params` with JSON string.
标签
skill
ai
