Jump to: navigation, search

Difference between revisions of "MagnetoDB"

(Improve MagnetoDB)
(How can I start?)
Line 168: Line 168:
  
 
=== How can I start? ===
 
=== How can I start? ===
 +
It is extremetly simple to participate in different MagnetoDB development lines. [https://launchpad.net/magnetodb MagnetoDB Launchpad page] contains a wide range of tasks perfectly suited for you to start contributing to MagnetoDB. You can choose any unassigned [https://bugs.launchpad.net/magnetodb bug] or [https://blueprints.launchpad.net/magnetodb blueprint]. As soon as you have chosen a bug, just assign it to you, and you can start fixing it. If you would like chose a blueprint, please contact core team at the <code><nowiki>#openstack-rally</nowiki></code> IRC channel on '''irc.freenode.net'''.
 +
 +
The most bugs and blueprints contain basic descriptions of what is to be done there; in case you have questions or want to share your ideas, be sure to contanct us in IRC.
  
 
=== What are Code Review Guidelines? ===
 
=== What are Code Review Guidelines? ===

Revision as of 11:30, 24 April 2014

Status

Scope

Document describes the idea and technical concept of DB service for OpenStack like Amazon DynamoDB. There is no implementation yet.

What is MagnetoDB?

MagnetoDB is Amazon DynamoDB API implementation for OpenStack world.

What is DynamoDB?

DynamoDB is a fast, fully managed NoSQL database service that makes it simple and cost-effective to store and retrieve any amount of data, and serve any level of request traffic. With DynamoDB, you can offload the administrative burden of operating and scaling a highly available distributed database cluster

DynamoDB tables do not have fixed schemas, and each item may have a different number of attributes. Multiple data types add richness to the data model. Local secondary indexes add flexibility to the queries you can perform, without impacting performance. [1]

Why it is needed?

In order to provide hight level database service with DynamoDB API interface for OpenStack users.

Just simply create the table and start working with your data. No vm provisioning, database software setup, configuration, patching, monitoring and other administrative routine.

Integration with Trove?

Initially suggested as blueprint, it separated out as project having different from Trove program mission.

MagnetoDB is not one more database, which can be provisioned and managed by Trove. It is one more OpenStack service with own API, keystone based authentication, quota management.

However, the underlaying database will be provisioned and managed by Trove, in order to reuse existing Openstack components and avoid duplication of functionality.

Overall architecture

The shape of the architecture based on Cassandra storage is below. It is the classic 2 layer web application, where each layer is horizontally scalable. Requests are routed by load balancer to web application layer, and processed there.

Magnetodb architecture.png

In projection to existing OpenStack components

Magnetodb components by layers.png

API

The DynamoDB API documented very well here Operations in Amazon DynamoDB However, the key aspects are mentioned below.

The API present HTTP request/responce, where JSON is used as data transfer model. The request body contains the payload, and HTTP headers are used for metadata.

Example of such request

POST / HTTP/1.1
host: dynamodb.us-west-2.amazonaws.com
x-amz-date: 20130112T092034Z
x-amz-target: DynamoDB_20120810.CreateTable
Authorization: AWS4-HMAC-SHA256 Credential=AccessKeyID/20130112/us-west-2/dynamodb/aws4_request,SignedHeaders=host;x-amz-date;x-amz-target,Signature=145b1567ab3c50d929412f28f52c45dbf1e63ec5c66023d232a539a4afd11fd9
content-type: application/x-amz-json-1.0
content-length: 23
connection: Keep-Alive

As you can see the operation name and authorization data is sent in HTTP request headers.

Authorization

It is HMAC based on EC2 Credentials, which is sent in a header of HTTP request as in example above.

Table CRUD operations

With following methonds you can create, list, delete tables. In the first implementation the througput configuration parameters can be ignored. So UpdateTable operation turns making no effect, because of that.

Item CRUD operations

With items operation you can apply CRUD operation on your data. In addition to that your request can be conditional, means will be executed if item is in a state you defiened in the request

The GetItem operation consistency can be eventual or strong per request.

More detailes can be found below

Data quering

In order to search the data there are two ways query and scan operations.

Query operation searches only primary key attribute values and supports a subset of comparison operators on key attribute values to refine the search process. A Query operation always returns results, but can return empty results.

Scan operation examines every item in the table. You can specify filters to apply to the results to refine the values returned to you, after the scan has finished. [2]

Batch operations

The batch operations are also supported.

Implementation

The technical concept is still in progress, but the shape is pretty clear and key things are mentioned below

Datasource pluggability

For backend storage provisioning and management OpenStack DBaaS Trove will be used. The backend database should be pluggable to provide flexibility around choosing the solution which matches the best the existing or planned OpenStack installation technology stack. MySQL is one of the obvious options, being de-facto standard for being used with OpenStack and being supported by Trove right away.

Apache Cassandra looks very suitable for that case due to having tunable consistency, easy scalability, key-value data model, ring topology and other features what gives us predictable high performance and fault tolerance. Cassandra data model perfectly fits MagnetoDB needs.

OpenStack component reusage

Being the OpenStack service MagnetoDB must and will use its infrastructure wherever it possible. For most of the core modules the corresponding OpenStack modules are defined in the table below.

Purpose OS component
Provisioning of web tier Heat, Mistral (Convection)
Load balancer LBaaS, Neutron
Autoscaling of web tier Heat autoscaling, Ceilometer
Data Source provisioning and management Trove
Monitoring Ceilometer
Authentication Keystone

Autoscaling

MagnetoDB should scale accoring to the load and data it handle. Heat autoscaling group is gonna be used to achive it.

The autoscaling of datasource expected to be implemened in Trove.

CI/CD

CI/CD concept

There are several ways to integrate with OpenStack Infra:

  • Adding own public cloud to Infra's NodePool as new provider which will be used to provide the specific environment (jenkins slaves) for MagnetoDB project. Adding own Jenkins job and script to Infra for this. For all tasks use Openstack Infra infrastructure (Jenkins, Zuul etc.)
  • Adding own Jenkins to Infra's Gearman (Zuul) via Jenkins Gearman plugin. This Jenkins will be contain jobs and slaves for MagnetoDB project. Infra's Zull will be used for the orchestration.
  • Gerrit layer integration. Use Jenkins Gerrit Trigger Plugin or Zuul for integration with OpenStack Gerrit and own envoronment for CI. Described here http://ci.openstack.org/third_party.html.
  • Full integration. Adding own job to Jenkins Job Builder and some changes to layout.yaml (Zull). Use Infra's slaves for running own job.
Below is a diagram describing the method of full integration
Concept OpenStack Infra integration


Diagram shows standard Openstack Infra workflow for main components (Jenkins, Zuul, Nodepool). Red rectangles describes the necessary steps for Infra integration:

  • Preparing and adding new Jenkins job to Jenkins Job Builder in .yaml format
  • Modify layout.yaml (Zuul) for adding new job in some pipeline.

Useful links

Improve MagnetoDB

Where can I discuss & propose changes?

  1. Our IRC channel: IRC server #magnetodb on irc.freenode.net;
  2. Openstack mailing list: openstack-dev@lists.openstack.org (see subscription and usage instructions);
  3. MagnetoDB team on Launchpad: Questions&Answers/Bugs/Blueprints.

How can I start?

It is extremetly simple to participate in different MagnetoDB development lines. MagnetoDB Launchpad page contains a wide range of tasks perfectly suited for you to start contributing to MagnetoDB. You can choose any unassigned bug or blueprint. As soon as you have chosen a bug, just assign it to you, and you can start fixing it. If you would like chose a blueprint, please contact core team at the #openstack-rally IRC channel on irc.freenode.net.

The most bugs and blueprints contain basic descriptions of what is to be done there; in case you have questions or want to share your ideas, be sure to contanct us in IRC.

What are Code Review Guidelines?

Code Review Guidelines

Sub pages