Generate Buildkite pipelines from code.
npm install @jameslnewell/buildkite-pipelinesGenerate Buildkite pipelines from code.
NPM:
``bash`
npm install @jameslnewell/buildkite-pipelines
Yarn:
`bash`
yarn add --dev @jameslnewell/buildkite-pipelines
Define your pipeline in code.
./.buildkite/pipeline.js
`ts
const {Pipeline, CommandStep} = require('@jameslnewell/buildkite-pipelines');
module.exports = new Pipeline().addStep(
new CommandStep().setLabel('👋 Greeting').addCommand('echo "Hello World!"'),
);
`
Generate and upload your pipeline in a Buildkite step.
./.buildkite/pipeline.yml
`yaml`
steps:
- commands:
- buildkite-pipelines ./.buildkite/pipeline.js | buildkite-agent pipeline upload
plugins:
- docker#v3.11.0:
image: jameslnewell/buildkite-pipelines
Define your pipeline in code.
./.buildkite/pipeline.ts
`ts
import {Pipeline, CommandStep} from '@jameslnewell/buildkite-pipelines';
export default new Pipeline().addStep(
new CommandStep().setLabel('👋 Greeting').addCommand('echo "Hello World!"'),
);
`
Generate and upload your pipeline in a Buildkite step.
./.buildkite/pipeline.yml
`yaml`
steps:
- commands:
- yarn global add ts-node
- buildkite-pipelines -r ts-node/register ./.buildkite/pipeline.ts | buildkite-agent pipeline upload
plugins:
- docker#v3.11.0:
image: jameslnewell/buildkite-pipelines
This library is a very thin wrapper around Buildkite's yaml syntax for defining a pipeline. As such the value of this library is unlikely to be realised for simple one-file pipelines.
Consider using this library when:
- you're dynamically generating the pipeline and you require a programming language
- your pipeline is split across multiple yaml files and you're unable to use yaml` anchors and aliases for composition across them
- you can't possibly live without typings
- https://hasura.io/blog/what-we-learnt-by-migrating-from-circleci-to-buildkite/
- https://docs.sourcegraph.com/dev/background-information/ci/development
1. Setup a pipeline - use the command for setting up a docker agent here