Fundamentals

Fundamentals

This chapter explains how Beez works and how a project is typically laid out. It is independent of which phases, scopes, or workflows you choose to define later.

Contents

Core concepts

• Core Concepts - Steps, tasks, and workflows: the three building blocks of every pipeline
• Phases and Scopes - how phase+scope selects steps (full chapter)
• Parallel Execution and Dependencies - what runs in parallel and what order() controls

Project layout

• Project Layout - which files a Beez project has and what they are for

Hands-on

• First Pipeline - from an empty build.lua to a working pipeline

Suggested reading order

1. Core Concepts - understand what you are working with
2. Phases and Scopes - understand how steps are organized
3. Project Layout - know where things live
4. First Pipeline - try it yourself

After that, see Configuration, CLI, Lua DSL, and Caching.