1. Resources
  2. /
  3. Examples
  4. /
  5. Starter pipeline

Buildkite Starter Pipeline Example

This repository is a friendly starting point for learning how Buildkite pipelines work.

See the full Getting Started Guide for step-by-step instructions on how to get this running.

Screenshot of example pipeline build page

📸 Screenshot 1: A simple 3-step pipeline in action - building, testing, and deploying your rocket 🚀

Screenshot of example pipeline build page

📸 Screenshot 2: The final deploy step adds a success annotation to your build - and yes, you can add GIFs too!

🛠 How it works

The pipeline is platform agnostic, which means it can run on any infrastructure. Its behavior is defined in .buildkite/pipeline.yml, including steps to build, test, and deploy. These steps describe launching a shiny new rocket to the moon. 🚀🌕

This pipeline demonstrates a typical Buildkite flow:

  1. Build step - placeholder command to “build the rocket”
  2. Test step - placeholder test stage, depends on build
  3. Deploy step - echoes a launch message and uses buildkite-agent annotate to display an annotation

You can replace each of these steps with real commands suited to your own project.

Create a pipeline

If you need help setting up Buildkite, see Getting started.

With Buildkite setup, you can quickly create a new pipeline by selecting Add to Buildkite. This prefills the pipeline details using template.yml and includes a command to upload the pipeline definition in pipeline.yml.

Requirements

None! This example runs on Buildkite-hosted agents, so there’s nothing to install or configure.

Just click Add to Buildkite above and you’re ready to go.

💡 If you’d like to run this on your own infrastructure instead, see Buildkite Agent setup.

License

See LICENSE (MIT)

More examples

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Public pipelines
  3. Test Engine
  4. Package Registries
  5. Mobile Delivery Cloud
  6. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Example pipelines
  5. Plugins
  6. Webinars
  7. Case studies
  8. Events
  9. Migration Services
  10. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Security
  5. Brand assets
  6. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025