Node module for parsing screwdriver.yaml configurations
npm install screwdriver-config-parser> Node module for validating and parsing screwdriver.yaml configurations
- Validates a screwdriver.yaml for structural and functional specification
- Outputs the pipeline's workflowGraph configuration
- Generates a list of jobs to execute, including:
- build permutations
- environment variables to set
- steps to execute
- container image to use
``yaml
shared:
environment:
NODE_ENV: test
settings:
email: foo@bar.com
jobs:
main:
image: node:18
steps:
- init: npm install
- test: npm test
requires:
- ~pr
- ~commit
publish:
environment:
NODE_TAG: latest
image: node:4
steps:
- bump: npm run bump
- publish: npm publish --tag $NODE_TAG
- tag: git push origin --tags
secrets:
- NPM_TOKEN
- GIT_KEY
requires:
- main
`
`bash`
npm install screwdriver-config-parser
Parse in Node.js:
`javascript
const parser = require('screwdriver-config-parser');
// Configuration (in YAML form)
parser(fs.readFileSync('screwdriver.yaml')).then((pipeline) => {
// Workflow for the pipeline
// pipeline.workflowGraph
// All the main jobs with the steps to execute and environment variables to set
// pipeline.jobs.main[].commands
// pipeline.jobs.main[].environment
// pipeline.jobs.main[].image
// All the publish jobs with the steps to execute and environment variables to set
// pipeline.jobs.publish[].commands
// pipeline.jobs.publish[].environment
// pipeline.jobs.publish[].image
});
`
`bash``
npm test
Code licensed under the BSD 3-Clause license. See LICENSE file for terms.
[npm-image]: https://img.shields.io/npm/v/screwdriver-config-parser.svg
[npm-url]: https://npmjs.org/package/screwdriver-config-parser
[downloads-image]: https://img.shields.io/npm/dt/screwdriver-config-parser.svg
[license-image]: https://img.shields.io/npm/l/screwdriver-config-parser.svg
[issues-image]: https://img.shields.io/github/issues/screwdriver-cd/screwdriver.svg
[issues-url]: https://github.com/screwdriver-cd/screwdriver/issues
[status-image]: https://cd.screwdriver.cd/pipelines/18/badge
[status-url]: https://cd.screwdriver.cd/pipelines/18