Builder is a tool that implements the builder specification. It is the specification to build and deploy software projects with agents. It focuses on speed and simplicity.
🤹♀️ This is inspired by quick from Shopify and Magic by WealthSimple.
- 👨🎨 Design
- 🏗️ Build
- 🚢 Ship
builder helpbrew install zeiss/builder-tap/builder- 🏛️ Static site hosting
- 🧭 Spec-driven building
- ...
The configuration for the authentication provider and
the API can be served on a .well-known/builder-configuration endpoint.
GET /.well-known/builder-configuration
{
"oidc_issuer": "http://builder.internal:5556/dex",
"api_url": "http://builder.internal:5556"
}
This is a way to simplify the configuration.
The builder authenticates to the server using OpenID Connect. The authentication flow is handled by the server. It supports dex as an OpenID Connect provider.
To authenticate, the builder uses a dex client ID and secret. These are configured in the builder tool.
builder account login --url <builder-server>This logs you in to the builder server.
builder --helpThere are a couple of basic features.
builder
USAGE
builder [command] [--flags]
COMMANDS
account [command] Manage accounts
completion [command] Generate the autocompletion script for the specified shell
help [command] Help about any command
init Initialize a new config
reset Reset the configuration
sites [command] Manages sites
task [command] [--flags] Manage tasks
FLAGS
-c --config Config file (.builder.yml)
-d --dry Dry run
-f --force Force init
-h --help Help for builder
-p --plugin Plugin
-r --root Run as root
-u --url Url (http://builder.internal:3000)
--var Variables
-v --verbose Verbose output
--version Version for builderThe server implements the deployment features of the builder specification.
Using Helm to run the builder on Kubernetes.
helm repo add builder https://zeiss.github.io/builder
helm repo update
helm search repo builder