зеркало из https://github.com/microsoft/AMBROSIA.git
153 строки
9.6 KiB
Markdown
153 строки
9.6 KiB
Markdown
Ambrosia: Robust Distributed Programming Made Easy and Efficient
|
||
=======================================================================
|
||
|
||
Windows Build (net461/netcore3.1): [](https://msrfranklin.visualstudio.com/Franklin/_build/latest?definitionId=40)
|
||
|
||
Linux Build (netcore3.1): [](https://msrfranklin.visualstudio.com/Franklin/_build/latest?definitionId=43)
|
||
|
||
|
||
[](https://gitter.im/AMBROSIA-resilient-systems/)
|
||
|
||
|
||
Ambrosia is a programming language independent approach for authoring
|
||
and deploying highly robust distributed applications. Ambrosia
|
||
dramatically lowers development and deployment costs and time to
|
||
market by automatically providing recovery and high availability.
|
||
|
||
Today's datacenter oriented applications, which include most popular
|
||
services running in the cloud today, are composed of highly complex,
|
||
distributed software stacks. For instance, they typically incorporate
|
||
Event Hub or Kafka to robustly journal input and interactions for
|
||
recoverability, log important information to stores like Azure blobs
|
||
for debuggability, and use extremely expensive mechanisms like
|
||
distributed transactions, and stateless functions with distributed
|
||
persistent back-ends, in order to ensure exactly once execution of
|
||
service code.
|
||
|
||
In contrast, Ambrosia automatically gives programmers recoverability,
|
||
high availability, debuggability, upgradability, and exactly once
|
||
execution, without requiring developers to weave together such complex
|
||
systems, or use overly expensive mechanisms.
|
||
|
||
To learn more about Ambrosia's implementation and performance you can read our [VLDB paper](http://www.vldb.org/pvldb/vol13/p588-goldstein.pdf/).
|
||
|
||
We invite developers wishing to build on or contribute to AMBROSIA to join our [gitter community](https://gitter.im/AMBROSIA-resilient-systems/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link).
|
||
|
||
Table of Contents
|
||
-----------
|
||
* [AMBROSIA Concepts](#ambrosia-concepts)
|
||
* [How it works](#how-it-works)
|
||
* [Features](#features)
|
||
* [Quick start for application developers](#quick-start-for-application-developers)
|
||
* [Quick start for AMBROSIA contributors](#quick-start-for-ambrosia-contributors)
|
||
* [Reference](#reference)
|
||
* [Dependencies](#dependecies)
|
||
* [Language support](#language-support)
|
||
* [Usage](#usage)
|
||
* [Secure communication between services](#secure-communication-between-services)
|
||
* [Comparison to](#comparison-to)
|
||
|
||
## AMBROSIA Concepts
|
||
|
||
### Virtual Resiliency
|
||
> *Virtual Resiliency* is a mechanism in a (possibly distributed) programming and execution environment, typically employing a log, which exploits the replayably deterministic nature and serializability of an application to automatically mask failure.
|
||
|
||
We use the term virtual resiliency to describe the mechanism in AMBROSIA that allows programmers to write their applications in a failure oblivious way, removing the need for application writers to write logic for recovery or state protection. Data processing systems, which typically express their queries in SQL variants, have provided their query writers virtual resiliency for decades. Map-reduce systems, which don’t necessarily use SQL, also provide this capability. Note that in all these cases, this feature leverages the ability to deterministically replay, like AMBROSIA.
|
||
|
||
### Deterministic Replayability
|
||
In order to achieve virtual resiliency through AMBROSIA, applications must uphold the following contract: from some initial state, any execution of the same requests in the same order results in both the *same final state*, as well as the *same outgoing requests in the same order*.
|
||
|
||
### Immortals
|
||
The basic building blocks of AMBROSIA are *Immortals*, reliable distributed objects that communicate through RPCs. An Immortal defines a set of persistent state and a set of RPC handlers that operate on that state. An *instance* of an Immortal is a named entity that maintains state and executes RPC handlers according to the Immortal's definition. An AMBROSIA application often has multiple instances of the same Immortal; for example, an application may define a single "job" Immortal for running a data-processing job and run multiple instances of that job operating on different data sets.
|
||
|
||
## How it works
|
||
The figure below outlines the basic architecture of an AMBROSIA application, showing two communicating AMBROSIA services, called Immortals. The inner boxes in the figure represent code which can run in either 2 separate processes, or in the case of C#, can run in one integrated process. Each instance of an Immortal exists as a software object and thread of control running inside of the application process. An Immortal instance communicates with other Immortal instances through the *Immortal Coordinator*, which durably logs the instance's RPCs and encapsulates the low-level networking required to send RPCs. The position of requests in the log determines the order in which they are submitted to the application process for execution and then re-execution upon recovery.
|
||
|
||
|
||
|
||
In addition, the language specific AMBROSIA binding provides a state serializer. To avoid replaying from the start of the service during recovery, the Immortal Coordinator occasionally checkpoints the state of the Immortal, which includes the application state. The way this serialization is provided can vary from language to language, or even amongst bindings for the same language.
|
||
|
||
## Features
|
||
Here is a list of features that AMBROSIA provides to application developers and deployers:
|
||
|
||
* Define a new service to run on AMBROSIA
|
||
* Deploy services on AMBROSIA
|
||
* Debug service instance
|
||
* Active Active
|
||
* Live Upgrades, Test Upgrades
|
||
* RPC
|
||
* Asynchronous RPC (alpha)
|
||
|
||
## Quick start for application developers
|
||
Start with one of our [samples](https://github.com/Microsoft/AMBROSIA/tree/master/Samples) to get a service up and running on AMBROSIA.
|
||
|
||
## Quick start for AMBROSIA contributors
|
||
|
||
### Build from source
|
||
Build the Ambrosia Immortal coordinator and C# client code generator
|
||
with this Bash script:
|
||
|
||
./build_dotnetcore_bindist.sh
|
||
|
||
Given a .NET Core SDK, this will work on Windows, Mac OS, or Linux.
|
||
After that, you have an AMBROSIA binary distribution built inside the
|
||
`./bin` directory within your working copy.
|
||
|
||
Also check out our [contributing guide](https://github.com/Microsoft/AMBROSIA/tree/master/CONTRIBUTING).
|
||
|
||
## Reference
|
||
|
||
### Dependencies
|
||
AMBROSIA currently requires an Azure subscription to write its logs to replicated storage. In the future, we anticipate abstracting this component out to be able to use other storage options for logs.
|
||
|
||
### Language Support
|
||
AMBROSIA currently supports C# on both .NET Core and .NET Framework. As of the 2.0.0.0 release, AMBROSIA also supports Node.js using TypeScript. We hope to add support for other languages in the future.
|
||
|
||
### Usage
|
||
```
|
||
Usage: dotnet Ambrosia.dll RegisterInstance [OPTIONS]
|
||
Options:
|
||
-i, --instanceName=VALUE The instance name [REQUIRED].
|
||
-rp, --receivePort=VALUE The service receive from port [REQUIRED].
|
||
-sp, --sendPort=VALUE The service send to port. [REQUIRED]
|
||
-l, --log=VALUE The service log path.
|
||
-cs, --createService=VALUE [A - AutoRecovery | N - NoRecovery | Y -
|
||
AlwaysRecover].
|
||
-ps, --pauseAtStart Is pause at start enabled.
|
||
-npl, --noPersistLogs Is persistent logging disabled.
|
||
-lts, --logTriggerSize=VALUE Log trigger size (in MBs).
|
||
-aa, --activeActive Is active-active enabled.
|
||
-cv, --currentVersion=VALUE The current version #.
|
||
-uv, --upgradeVersion=VALUE The upgrade version #.
|
||
-h, --help show this message and exit
|
||
Usage: dotnet Ambrosia.dll AddReplica [OPTIONS]
|
||
Options:
|
||
-r, --replicaNum=VALUE The replica # [REQUIRED].
|
||
-i, --instanceName=VALUE The instance name [REQUIRED].
|
||
-rp, --receivePort=VALUE The service receive from port [REQUIRED].
|
||
-sp, --sendPort=VALUE The service send to port. [REQUIRED]
|
||
-l, --log=VALUE The service log path.
|
||
-cs, --createService=VALUE [A - AutoRecovery | N - NoRecovery | Y -
|
||
AlwaysRecover].
|
||
-ps, --pauseAtStart Is pause at start enabled.
|
||
-npl, --noPersistLogs Is persistent logging disabled.
|
||
-lts, --logTriggerSize=VALUE Log trigger size (in MBs).
|
||
-aa, --activeActive Is active-active enabled.
|
||
-cv, --currentVersion=VALUE The current version #.
|
||
-uv, --upgradeVersion=VALUE The upgrade version #.
|
||
-h, --help show this message and exit
|
||
Usage: dotnet Ambrosia.dll DebugInstance [OPTIONS]
|
||
Options:
|
||
-i, --instanceName=VALUE The instance name [REQUIRED].
|
||
-rp, --receivePort=VALUE The service receive from port [REQUIRED].
|
||
-sp, --sendPort=VALUE The service send to port. [REQUIRED]
|
||
-l, --log=VALUE The service log path.
|
||
-c, --checkpoint=VALUE The checkpoint # to load.
|
||
-cv, --currentVersion=VALUE The version # to debug.
|
||
-tu, --testingUpgrade Is testing upgrade.
|
||
-h, --help show this message and exit
|
||
```
|
||
|
||
### Secure communication between services
|
||
Read about how to secure communications between distributed components deployed on AMBROSIA [here](https://github.com/Microsoft/AMBROSIA/blob/master/docs/SecuringComms.md).
|