Snolla - Connect gitlab with bugzilla.
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
config
requirements
snolla
tests
.gitignore
LICENSE
Makefile
README
TODO
run-dev-server

README

Snolla - Connect gitlab with bugzilla.

Author: Florian Preinstorfer <nblock@archlinux.org>
License: AGPLv3

Requirements
============
The list below enumerates the requirements to run snolla. The debian package names are listed second.

  * Python 3.3+: python3 python-virtualenv
  * Nginx: nginx
  * Uwsgi: uwsgi uwsgi-plugin-python3

First time installation
=======================
Below is a list of neccessary steps to get snolla up and running.

Application
-----------

  * Install dependencies from above.
  * Get a copy of snolla.
  * Setup virtualenv
    $ virtualenv --python=python3 --no-site-packages /path/to/venv
    $ source /path/to/venv/bin/activate
    $ cd snolla
    $ pip install -r requirements/minimum.txt  # install minimum snolla dependencies

Uwsgi
-----
  * Create a new profile for snolla in /etc/uwsgi/apps-available/snolla.ini
    [uwsgi]
    uid = www-data
    gid = www-data
    chmod-socket = 666
    master = true
    enable-threads = true
    processes = 2
    lazy = true
    plugins = python3
    chdir = /path/to/snolla
    virtualenv = /path/to/venv
    module = snolla
    callable = create_app()

  * Activate profile:
    $ sudo ln -s /etc/uwsgi/apps-available/snolla.ini /etc/uwsgi/apps-enabled/snolla.ini

Nginx
-----
  * Create a nginx config for snolla in /etc/nginx/sites-available/nginx:
    server {
            listen   80; ## listen for ipv4; this line is default and implied
            listen   [::]:80 default_server ipv6only=on; ## listen for ipv6

            root /usr/share/nginx/www;
            index index.html index.htm;

            # Make site accessible from http://localhost/
            server_name localhost snolla;

            location / { try_files $uri @snolla; }
            location @snolla {
                include uwsgi_params;
                uwsgi_pass unix:/run/uwsgi/app/snolla/socket;
            }
    }

  * Activate config:
    $ sudo ln -s /etc/nginx/sites-available/nginx /etc/nginx/sites-enabled/nginx