Bravetools provides a simple and consistent interface to declare, build, and deploy system containers.
- Build, version control, and share reproducible application and environment images.
- Compose multi-container systems in a simple and declarative way.
- Deploy your systems locally or remotely.
The steps to build and deploy an image are configured using a Bravefile.
View sample Bravefiles on GitHub to explore common use cases.
Build new images or layer existing ones using brave build
Resulting image can be stored locally or remotely
System containers can be deployed to a variety of environments with brave deploy, including local development machines, test environments, and remote production systems.
Manage images with multiple versions and architectures
Systems with multiple units can be declared in a brave compose file.
Build and deploy the system defined in a compose file with the brave compose command.
Prerequisites:
- Mac/Windows: Multipass
- Linux:
- LXD
- Ensure your user belongs to the
lxdgroup:sudo usermod --append --groups lxd $USER - You may also need
zfsutils:sudo apt install zfsutils-linux
-
Download the latest stable release for your host platform and add it to your
$PATH. -
Run
brave initto get started.
git clone https://github.com/bravetools/bravetools
cd bravetools
make [ubuntu]/[darwin]git clone https://github.com/bravetools/bravetools
cd bravetools
go build -ldflags="-s -w" -o brave.exe -trimpath main.goRun brave init to start if you haven't yet.
brave init
...Create an example Bravefile
brave templateThis creates a file named "Bravefile" in the current working directory. The contents should look like this:
image: example-image/v1.0
base:
image: alpine/3.16
packages:
manager: apk
system:
- curl
run:
- command: echo
args:
- hello world
copy:
- source: ./Bravefile
target: /root/
service:
name: example-container
ports:
- 8888:8888
resources:
ram: 2GB
cpu: 2
disk: 10GBCreate an image using the Bravefile
brave build
...Check images
brave images
IMAGE VERSION ARCH CREATED SIZE HASH
example-image v1.0 x86_64 just now 4MB ef28b49bf36f0b4b9cbad89ff67ef0eeDeploy image as container
brave deployCheck running units
brave units
NAME STATUS IPV4 MOUNTS PORTS
example-container Running 10.148.59.45 8888:8888Add a remote
brave remote add example-remote https://20.0.0.20:8443 --password [PASSWORD]
Certificate fingerprint: ...Deploy to remote
brave deploy --name example-remote:example-containerbrave units
NAME STATUS IPV4 MOUNTS PORTS
example-remote:example-container Running 20.0.0.7 8888:8888
example-container Running 10.148.59.45 8888:8888A complete System Container management platform
Usage:
brave [command]
Available Commands:
base Pull a base image from LXD Image Server or public Github Bravefile
build Build an image from a Bravefile
compose Compose a system from a set of images
configure Configure local host parameters
deploy Deploy Unit from image
help Help about any command
images List images
import Import LXD image tarballs into local Bravetools image repository
info Display workspace information
init Create a new Bravetools host
mount Mount a directory to a Unit
publish Publish deployed Units as images
remote Manage remotes
remove Remove Units or Images
start Start Units
stop Stop Units
template Generate a template Bravefile
umount Unmount <disk> from UNIT
units List Units
version Show current bravetools version
Flags:
-h, --help help for brave
Use "brave [command] --help" for more information about a command.