Jump to: navigation, search

Difference between revisions of "Zaqar/home"

(First draft)
m (Malini moved page Marconi/home to Zaqar/home: Project Rename)
 
(28 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Messaging Service ("Marconi") =
+
#REDIRECT [[Marconi]]
 
 
Marconi is a cloud messaging and notification service for developers building applications on top of OpenStack. The service features a web-friendly HTTP API, which developers can use to send messages between the various components of their SaaS and mobile applications, using a variety of communication patterns. Underlying the API is an efficient messaging engine designed with scalability and security in mind.
 
 
 
== Design ==
 
 
 
Donald A. Norman:
 
 
 
<blockquote>The value of a well-designed object is when it has such a rich set of affordances that the people who use it can do things with it that the designer never imagined.</blockquote>
 
 
 
At first glance, Marconi's RESTful API may seem a bit out of the ordinary. Message brokers typically rely on a custom binary protocol and often assume a reliable, 1st-party network between server and client. However, many of today's developers prefer an HTTP-based API. They value the simplicity and transparency of the protocol, its firewall-friendly nature, and its huge ecosystem of tools, load balancers and proxies.
 
 
 
Marconi caters to developers looking for this type of experience.
 
 
 
Marconi's API provides a basic set of semantics that, when combined, afford a variety of messaging patterns, such as pub-sub, task distribution, and point-to-point. Messages can be consumed as feeds, queues, or a combination of the two. This can be a little confusing at first, since the API uses the term "queues" to represent a hybrid feeds-queues resource.
 
 
 
When interacting with the API, a client can choose to read a queue in a similar manner to an Atom feed, where any client can read any message, and is responsible for keeping track of its own marker (its position in the feed). This provides for messaging patterns such as pub-sub and point-to-point.
 
 
 
Alternatively, an application can implement task distribution by creating a pool of workers that simply claim messages off the front of the queue. Once a message is claimed, it becomes invisible to other workers in the pool to prevent messages from being processed more than once.
 
 
 
Finally, a client can use both feed and claim semantics simultaneously to create hybrid messaging patterns. For example, while workers are busy claiming messages from a task queue, an auditor can passively sample those same messages as they flow by.
 
 
 
== Program Status ==
 
 
 
Marconi is an incubated OpenStack program, preparing to graduate at the end of the Juno release cycle (fall 2014). With the close of the Icehouse cycle, the team achieved a number of exciting milestones:
 
 
 
* Marconi's first official, production-ready "1.0" release is now [http://tarballs.openstack.org/marconi/marconi-2014.1.tar.gz available for download]. This first release includes a battle-tested MongoDB driver, and production-ready drivers for additional backends are in the works.
 
* Marconi's v1.0 API is stable and ready to code against.
 
* User and operator docs are now available in the Marconi repo, and we will be publishing them soon
 
* A reference client library (written in Python) is [https://pypi.python.org/pypi/python-marconiclient now available on PyPI]. This library supports the entire v1.0 API. Support for other languages is available through [http://developer.rackspace.com/#home-sdks Rackspace-supported SDKs].
 
 
 
== Resources ==
 
 
 
The Marconi team hangs out in #openstack-marconi on Freenode, and we are always happy to hear your ideas and answer any questions you might have. If you run into a bug, you can report it using on our [https://bugs.launchpad.net/marconi issue tracker]. Source code is available on GitHub for both the [https://github.com/openstack/marconi server] and [https://github.com/openstack/python-marconiclient client].
 
 
 
==== Releases ====
 
 
 
<!-- TODO(kgriffs): Add release notes -->
 
 
 
**Completed**
 
 
 
* 2014.1 (Icehouse) - [http://tarballs.openstack.org/marconi/marconi-2014.1.tar.gz download]
 
 
 
**Next**
 
 
 
* 2014.2 (Juno) - [[Marconi/releases/juno|Plans]]
 
 
 
==== Talks ====
 
 
 
* Alejandro Cabrera. Rackspace Atlanta. Introducing Openstack Marconi. July 17, 2013. [http://www.youtube.com/watch?v=b-IWDG7kKGQ Youtube] [https://speakerdeck.com/cabrera/introducing-openstack-marconi Speaker Deck]
 
* Flavio Percoco. EuroPython 2013. Marconi: Queuing and Notification Service for Openstack. July 2, 2013. [http://www.youtube.com/watch?v=iNOd7-_TdDo YouTube]
 
* Kurt Griffiths, Allan Metts. Openstack Summit April 2013. Project Overview: OpenStack Queuing and Notification Service ("Marconi""). April 2013. [http://www.youtube.com/watch?feature=player_embedded&v=henTTZWtt2k YouTube]
 
* Kurt Griffiths, Flavio Percoco, Allan Metts. Openstack Summit November 2013. Openstack Queuing and Notification Service Marconi. November 2013. [http://www.youtube.com/watch?v=IgE3Jskqtek YouTube]
 
 
 
==== Articles ====
 
 
 
* Oz Akan. Rackspace Devops Blog. July 25, 2013. [http://developer.rackspace.com/blog/openstack-marconi-api.html Openstack Marconi API].
 
* Flavio Percoco. Developer's Black Hole. March 2014. [http://blog.flaper87.com/post/531cd585d987d24e83f082a5 People don't like to queue up].
 
 
 
== User Guide ==
 
 
 
*Coming soon...*
 
 
 
== Operator Guide ==
 
 
 
*Coming soon...*
 
 
 
== Contributor Guide ==
 
 
 
*Coming soon...*
 

Latest revision as of 18:42, 7 August 2014

Redirect to: