marblerun

module
v0.3.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 14, 2021 License: MPL-2.0

README ΒΆ

Marblerun

logo

GitHub Actions Status GitHub license Go Report Card PkgGoDev Discord Chat

Marblerun is a framework for creating distributed confidential-computing apps.

Build your confidential microservices with EGo or another runtime, distribute them with Kubernetes on an SGX-enabled cluster, and let Marblerun take care of the rest. Deploy end-to-end secure and verifiable AI pipelines or crunch on sensitive big data in the cloud.

Confidential computing at scale has never been easier. Marblerun guarantees that the topology of your distributed app adheres to a Manifest specified in simple JSON. Marblerun verifies the integrity of services, bootstraps them, and sets up encrypted connections between them. If a node fails, Marblerun will seamlessly substitute it with respect to the rules defined in the Manifest.

To keep things simple, Marblerun issues one concise remote attestation statement for your whole distributed app. This can be used by anyone to verify the integrity of your distributed app.

Key features
  • Authentication and integrity verification of microservices with respect to a Manifest written in simple JSON πŸ”’
  • Secrets management for microservices πŸ”‘
  • Provisioning of certificates, configurations, and parameters for microservices πŸ“¦
  • Remote attestation of the entire cluster 🌐
Overview
overview
Supported Runtimes

Marblerun supports services built with one of the following frameworks:

More are coming soon.

Quickstart and documentation

See the Getting Started Guide to set up a distributed confidential-computing app in a few simple steps. See the documentation for details.

Working in this repo

BUILD.md includes general information on how to work in this repo.

Get involved

Examples

Hello World

We provide basic examples on how to build confidential apps with Marblerun.

Confidential Emoji Voting

The popular Linkerd service mesh uses the simple and scalable emojivoto app as its default demo. You can find our confidential variant here. Your emoji votes have never been more secure! πŸ˜‰

Directories ΒΆ

Path Synopsis
cli
cmd
cmd
coordinator command
marble-injector command
marble-test command
coordinator
config
Package config defines the environment variables expected by the Coordinator for configuration settings.
Package config defines the environment variables expected by the Coordinator for configuration settings.
core
Package core provides the core functionality for the Coordinator object including state transition, APIs for marbles and clients, handling of manifests and the sealing functionalities.
Package core provides the core functionality for the Coordinator object including state transition, APIs for marbles and clients, handling of manifests and the sealing functionalities.
quote
Package quote provides the quoting functionialty for remote attestation on both Coordinator and Marble site.
Package quote provides the quoting functionialty for remote attestation on both Coordinator and Marble site.
rpc
server
Package server contains the ClientAPI HTTP-REST and MarbleAPI gRPC server.
Package server contains the ClientAPI HTTP-REST and MarbleAPI gRPC server.
marble
config
Package config defines the environment variables expected by the Marble for configuration settings.
Package config defines the environment variables expected by the Marble for configuration settings.
premain
Package premain contains the logic invoked before the applications actual main-function, that authenticates to the coordinator and pulls configurations and secrets which are subsequently passed to the application.
Package premain contains the logic invoked before the applications actual main-function, that authenticates to the coordinator and pulls configurations and secrets which are subsequently passed to the application.
samples
helloworld command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL