Skip to content

cocaine/cocaine-core

Repository files navigation

What the hell is it? Build Status

If you wanna hang out you've got to take her out; cocaine.
If you wanna get down, down on the ground; cocaine.
She don't lie, she don't lie, she don't lie; cocaine.

-- J. J. Cale, cover version by Eric Clapton

Your personal app engine. Technically speaking, it's an open-source cloud platform enabling you to build your own PaaS clouds using simple yet effective dynamic components.

Notable features:

  • You are not restricted by a language or a framework. Similiar to Heroku model, Cocaine simply spawns whatever you tell it to spawn. The only requirement is that these newly spawned apps must connect to their app controller for request load balancing. But we plan to get rid of this last requirement as well.
  • We got services: this concept is similiar to Google App Engine's services. Simply speaking, services are privileged apps running in the same cloud. These apps can be anything ranging from a distributed storage access service or a publish-subscribe notification service to specially-crafted service for your own personal needs. Your app can seamlessly use those services however it wants.
  • We got dynamic self-managing worker pools for each app with a rich but simple configuration and resource usage control to scale with the app needs. Yeah, it's scales automatically, you don't need to think about it. As of now, we got support for pure CGroups and Docker for isolation.
  • Even more, it scales automatically across your server cluser via automatic node discovery and smart peer-to-peer balancing. You can use a simple adhoc round-robin balancing for simple setups or a hardcore IPVS-based realtime balancer.
  • If your startup idea is about processing terabytes of pirated video, we got data streaming and pipelining for you as well, enjoy.

At the moment, Cocaine Core supports the following languages and specifications:

  • C++
  • Go
  • Java
  • Node.js
  • Python
  • Ruby
  • [In development] Racket

We have the following services:

  • Logging
  • Node-local file storage
  • MongoDB storage
  • Elliptics storage
  • Node-local in-memory cache
  • Distributed in-memory cache
  • URL Fetch
  • Jabber
  • [In development] Notifications
  • [In development] Distributed time service

A motivating example

Here's some extremely useful Cocaine app written in Python.

#!/usr/bin/env python

from cocaine.services import Service
from cocaine.worker import Worker

storage = Service("storage")

def process(value):
    return len(value)

def handle(request, response):
    key = yield request.read()
    value = yield storage.read("collection", key)

    response.write(process(value))
    response.close()

Worker().run({
    'calculate_length': handle
})

Okay, I want to try it!

Hey kids, don't try cocaine! For serious web developers only.

Check out our wiki for installation instructions, reference manuals and cookies! We also got a bit outdated docs for v0.9, but worry not, up-to-date documentation is on its way!

Also you can find us on Freenode IRC, we're available for a chat on the #cocaine channel.