johntitor/bastion

Bastion: Fault-tolerant Runtime for Rust applications

---

Highly-available Distributed* Fault-tolerant Runtime

Latest Release
License
Doc [Bastion]
Doc [Bastion Executor]
Doc [LightProc]
Build Status
Downloads
Discord

---

Bastion is a highly-available, fault-tolerant runtime system with dynamic, dispatch-oriented, lightweight process model. It supplies actor-model-like concurrency with a lightweight process implementation and utilizes all of the system resources efficiently guaranteeing of at-most-once message delivery.

---

Usage

Bastion comes with a default one-for-one strategy root supervisor. You can use this to launch automatically supervised tasks.

Features

• Message-based communication makes this project a lean mesh of actor system.
  • Without web servers, weird shenanigans, forced trait implementations, and static dispatch.
• Runtime fault-tolerance makes it a good candidate for distributed systems.
  • If you want the smell of Erlang and the powerful aspects of Rust. That's it!
• Completely asynchronous runtime with NUMA-aware and cache-affine SMP executor.
  • Exploiting hardware locality wherever it is possible. It is designed for servers.
• Supervision system makes it easy to manage lifecycles.
  • Kill your application in certain condition or restart you subprocesses whenever a certain condition is met.

Guarantees

• At most once delivery for all messages.
• Completely asynchronous system design.
• Asynchronous program boundaries with fort.
• Dynamic supervision of supervisors (adding a subtree later during the execution)
• Lifecycle management both at futures and lightproc layers.
• Faster middleware development.
• Fault tolerance above all.

Why Bastion?

If you answer any of the questions below with yes, then Bastion is just for you:

• Do I need fault-tolerance in my project?
• Do I hate to implement weird Actor traits?
• I shouldn't need a webserver to run an actor system, right?
• Do I want to make my existing code unbreakable?
• Do I have some trust issues with orchestration systems?
• Do I want to implement my own application lifecycle?

Get Started

Check the getting started example in bastion/examples

Examples cover possible use cases of the crate.

Include bastion to your project with:

bastion = "0.3"

For more information please check Bastion Documentation

Architecture of the Runtime

Runtime is structured by the user. Only root supervision comes in batteries-included fashion. Worker code, worker group redundancy, supervisors and their supervision strategies are defined by the user.

You can see architecture of the framework HERE.

Projects using Bastion

If you are using Bastion open a PR so we can include it in our showcase.

• Various proprietary Rust database implementations are using Bastion.
• In AWS Lambdas we have used Bastion to enable retry mechanism and try different parsing strategies for data to be processed.
• SkyNet (a Discord bot which is resending deleted messages)
  • Skynet is running since 0.1.3 release of Bastion on the cloud and haven't killed yet.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Documentation

Official documentation is hosted on docs.rs.

Getting Help

Please head to our Discord or use StackOverflow

Discussion and Development

We use Discord for development discussions. Also please don't hesitate to open issues on GitHub ask for features, report bugs, comment on design and more! More interaction and more ideas are better!

Contributing to Bastion

All contributions, bug reports, bug fixes, documentation improvements, enhancements and ideas are welcome.

A detailed overview on how to contribute can be found in the CONTRIBUTING guide on GitHub.

License

---

^{_{* Currently, we are working on distributed properties and protocol.}}