openstack
/
zaqar
Code Issues Proposed changes
OpenStack Messaging (Zaqar)
824 Commits 9 Branches 41 Tags 45 MiB
Python 96.5%
PHP 1.4%
Shell 1.1%
HTML 0.7%
Lua 0.2%
Go to file
Victoria Martínez de la Cruz ddabc98a99 Drop pylint due to the huge amount of false positives 
Given that pylint is raising a lot of false positives
and that we have alternative static code checkers,
we decided to remove pylint from the tox envlist.

This patch also fix some pylint true positives
and cleans up the disabled pylint tests in the codebase.

Change-Id: I6fb4b9b4c80af452796032736e39ef064b9bcd03
Closes-Bug: #1297994
 		2014-07-13 20:03:52 -03:00
doc Rename shard to pool 2014-06-24 14:19:37 +08:00
etc Rename shard to pool 2014-06-24 14:19:37 +08:00
marconi Drop pylint due to the huge amount of false positives 2014-07-13 20:03:52 -03:00
tests Drop pylint due to the huge amount of false positives 2014-07-13 20:03:52 -03:00
tools/config Rename shard to pool 2014-06-24 14:19:37 +08:00
.coveragerc Suppress some Coverage report output 2013-03-29 16:07:20 -04:00
.gitignore adds docs directory with dev guide 2014-03-18 14:48:54 -04:00
.gitreview Update .gitreview for incubation org move 2013-09-14 17:44:26 +00:00
.testr.conf Use testr instead of nosetest 2014-01-17 15:43:49 +01:00
AUTHORS.rst refactor: Rename AUTHORS so that it doesn't keep getting overwritten 2013-03-19 16:33:43 -04:00
HACKING.rst Dedup HACKING.rst and remove any pep8 or OpenStack hacking rules 2014-04-02 16:36:16 -07:00
LICENSE Include full license text 2014-03-21 10:16:28 +01:00
MANIFEST.in Initial import. 2012-11-01 09:52:20 +01:00
README.rst Fix broken wiki link 2014-07-04 10:28:33 +05:30
babel.cfg Prepare marconi for localization 2014-06-04 22:31:55 +02:00
doc-test.conf adds docs directory with dev guide 2014-03-18 14:48:54 -04:00
openstack-common.conf Synced jsonutils from oslo-incubator 2014-05-27 12:16:28 +02:00
requirements-py3.txt Updated from global requirements 2014-07-11 10:49:29 -07:00
requirements.txt Updated from global requirements 2014-07-11 10:49:29 -07:00
setup.cfg Rename shard to pool 2014-06-24 14:19:37 +08:00
setup.py Updated from global requirements 2014-04-30 02:40:38 +00:00
test-requirements-py3.txt Updated from global requirements 2014-07-11 10:49:29 -07:00
test-requirements.txt Updated from global requirements 2014-07-11 10:49:29 -07:00
tox.ini Drop pylint due to the huge amount of false positives 2014-07-13 20:03:52 -03:00

README.rst

Marconi

Message queuing service for OpenStack. To find more information read our wiki.

Running a local Marconi server with MongoDB

Note: These instructions are for running a local instance of Marconi and not all of these steps are required. It is assumed you have MongoDB installed and running.

  1. From your home folder create the ~/.marconi folder and clone the repo:

    $ cd
$ mkdir .marconi
$ git clone https://github.com/openstack/marconi.git

  2. Copy the Marconi config files to the directory ~/.marconi:

    $ cp marconi/etc/marconi.conf.sample ~/.marconi/marconi.conf
$ cp marconi/etc/logging.conf.sample ~/.marconi/logging.conf

  3. Find [drivers] section in ~/.marconi/marconi.conf and specify to use mongodb storage:

    storage = mongodb

    Then find the [drivers:storage:mongodb] section and modify the URI to point to your local mongod instance:

    uri = mongodb://$MONGODB_HOST:$MONGODB_PORT

    By default, you will have:

    uri = mongodb://127.0.0.1:27017

  4. For logging, find the [DEFAULT] section in ~/.marconi/marconi.conf and modify as desired:

    log_file = server.log

  5. Change directories back to your local copy of the repo:

    $ cd marconi

  6. Run the following so you can see the results of any changes you make to the code without having to reinstall the package each time:

    $ pip install -e .

  7. Start the Marconi server with logging level set to INFO so you can see the port on which the server is listening:

    $ marconi-server -v

  8. Test out that Marconi is working by creating a queue:

    $ curl -i -X PUT http://127.0.0.1:8888/v1/queues/samplequeue -H
"Content-type: application/json"

You should get an HTTP 201 along with some headers that will look similar to this:

HTTP/1.0 201 Created
Date: Fri, 25 Oct 2013 15:34:37 GMT
Server: WSGIServer/0.1 Python/2.7.3
Content-Length: 0
Location: /v1/queues/samplequeue

Running tests

First install additional requirements:

pip install tox

And then run tests:

tox -e py27

You can read more about running functional tests in separate TESTS_README.