Bravetools is an end-to-end System Container management utility. Bravetools makes it easy to configure, build, and deploy reproducible environments either on single machines or large clusters.
Configurable system images have many advantages, but their use has been limited. In our own development practice, we found that there were either no existing tools to automate the full lifecycle of a System Container or they had a steep learning curve. Here are some improvements that our team has noticed when using Bravetools in development and production:
-
Improved Stability. All software and configurations are installed into your images at build-time. Once your image is launched and tested, you can be confident that any environment launched from that image will function properly.
-
No overheads of a VM. Bravetools runs on LXD. LXD uses Linux containers to offer a user experience similar to virtual machines, but without the expensive overhead. You can run either single images on a local machines or scale to thousands of compute nodes.
-
Focus on code not infrastructure. Maintaining and configuring infrastructure is difficult! With any application built and deployed using Bravetools infrastructure and environment have to be configured just once. Developers can spend more time on creating and improving software and less time on managing production environments.
To get started using Bravetools:
-
Download a platform-specific binary, rename it to
brave, and add it to your PATH -
Add your user to
lxd group:
sudo usermod --append --groups lxd $USER- Run
brave init
Bravetools can be built from source on any platform that supports Go and LXD.
Minimum Requirements
- Operating System
- Ubuntu 18.04 (64-bit)
- Hardware
- 2GB of Memory
- Software
git clone https://github.com/bravetools/bravetools
cd bravetools
make ubuntuAdd your user to lxd group:
sudo usermod --append --groups lxd $USERYou may also need to install zfsutils:
sudo apt install zfsutils-linuxIf this is your first time setting up Bravetools, run brave init to initialise the required profile, storage pool, and LXD bridge.
Minimum Rquirements
- Hardware
- 2GB of Memory
- Software
git clone https://github.com/bravetools/bravetools
cd bravetools
make linuxAdd your user to lxd group:
sudo usermod --append --groups lxd $USERDepending on your Linux distribution, you may also need to install zfs tools to enable storage pool management in Bravetools.
If this is your first time setting up Bravetools, run brave init to initialise the required profile, storage pool, and LXD bridge.
Minimum Requirements
git clone https://github.com/bravetools/bravetools
cd bravetools
make darwinIf this is your first time setting up Bravetools, run brave init to initialise the required profile, storage pool, and LXD bridge.
Minimum Requirements
- Operating System
- Windows 8 (64-bit)
- Hardware
- 8GB of Memory
- Software
git clone https://github.com/beringresearch/bravetools
cd bravetools
go build -ldflags=“-s -X github.com/bravetools/bravetools/shared.braveVersion=VERSION” -o brave.exeWhere VERSION reflects the latest stable release of Bravetools e.g shared.braveVersion=1.53
- Start Vagrant VM:
cd vagrant
vagrant up
vagrant ssh
// execute inside Vagrant VM
cd $HOME/workspace/src/github.com/bravetools/bravetools
make ubuntu
brave initTo update existing installation of Bravetools for your platform:
git clone https://github.com/bravetools/bravetools
cd bravetools
make [darwin][ubuntu][linux]When Bravetools is installed for the first time, it will set up all required components to connect your host to LXD. This is achieved by running:
$ brave initbrave init will:
- Create
~/.bravetoolsdirectory that stores all your local images, configurations, and a live Unit database
On Mac and Windows platforms:
- Create a new Multipass instance of Ubuntu 18.04
- Install snap LXD
- Enable mounting between host and Multipass
On Linux distributions:
- Set up a new LXD profile
{$USER$ - Create a new LXD bridge
{$USER}br0 - Create a new storage pool
{$USER}-TIMESTAMP
These steps ensure that Bravetools establishes a connection with LXD server and runs a self-contained LXD environment that doesn't interfere with any potentially existing user profiles and LXD bridges.
Usage:
brave [command]
Available Commands:
base Build a base unit
build Build an image from a Bravefile
configure Configure local host parameters such as storage
deploy Deploy Unit from image
help Help about any command
images List images
import Import a tarball into local Bravetools image repository
info Display workspace information
init Create a new Bravetools host
mount Mount a directory to a Unit
remove Remove a Unit or an Image
start Start Unit
stop Stop Unit
umount Unmount <disk> from UNIT
units List Units
version Show current bravetools version
Flags:
-h, --help help for brave
To get help on any on specific command, run:
brave COMMAND -hHere's a toy example showing how to create a simple container configuration, add some useful packages to it, and deploy your image as a service.
Configuration instructions are stored in a Bravefile. Let's crate a simple Bravefile that uses Alpine Edge image and installs python3:
$ touch BravefilePopulate this Bravefile with basic configuration, adding python3 package through apk manager:
base:
image: alpine/edge/amd64
location: public
packages:
manager: apk
system:
- python3
service:
image: alpine-example-1.0
name: alpine-example
docker: "no"
version: "1.0"
ip: ""
ports: []
resources:
ram: 4GB
cpu: 2
gpu: "no"To create an image from this configuration, run:
$ brave build
[alpine-example] IMPORT: alpine/edge/amd64
[alpine-example] RUN: [apk update]
fetch http://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz
...
OK: 56 MiB in 30 packages
Exporting image alpine-example
9691e2cf3a58abd4ca411e8085c3117aList all local images and confirm successful build:
$ brave images
IMAGE CREATED SIZE HASH
alpine-example-1.0 just now 19MB 9691e2cf3a58abd4ca411e8085c3117aFinally, we can deploy this image as a container:
$ brave deploy
Importing alpine-example-1.0.tar.gzConfirm that the service is up and running:
NAME STATUS IPV4 DISK PROXY
alpine-example Running 10.0.0.117 Because this is just an LXD container, you can access it through the usual lxc exec command:
$ lxc exec alpine-example python3
Python 3.8.6 (default, Oct 5 2020, 00:23:48)
[GCC 10.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> This is a very basic example - Bravertools makes it easy to create very complex System Container environments, abstracting configuration options such as GPU support, Docker integration, and seamless port-forwarding, just to name a few. To learn more about using Bravetools, please refer to our Bravetools Documentation.
Follow installation instructions for Jekyll on your platform. To serve documentation locally run:
cd docs
bundle exec jekyll serve --traceand point your browser to http://127.0.0.1:4000/bravetools/.