Mongrey - Installation¶

Introduction¶

Vous avez le choix entre plusieurs méthodes d’installation.

La plus simple étant la version binaire adaptée au backend que vous utiliserez (MongoDB, PostgreSQL, ...).

Les binaires sont des versions compilés à l’aide de l’outil PyInstaller et n’ont aucunes dépendances externes.

Tous ces binaires ont été testés avec :

Ubuntu 14.04 (Trusty) - 64 bits
Debian 8 (jessie) - 64 bits
CentOS 7 - 64 bits
Fedora 20 - 64 bits
OpenSuse 13.1 (bottle)
Python 2.7.6

Le processus de génération des binaires est visible sur Mongrey Build:

Exemples¶

Version en cours: 0.4.4

Remplacez [RELEASE] et [BACKEND] par la version et le backend souhaité.

http://download.mongrey.io/[RELEASE]/mongrey-server-[BACKEND]

Pour la version la plus récente avec un backend MongoDB, utilisez latest:

http://download.mongrey.io/latest/mongrey-server-mongo

Mongrey Serveur¶

Sqlite (par défaut)¶

$ curl -L http://download.mongrey.io/latest/mongrey-server-sqlite > /usr/local/bin/mongrey-server

$ chmod +x /usr/local/bin/mongrey-server

$ /usr/local/bin/mongrey-server --version

Le plus simple pour la configuration initiale:

$ export MONGREY_SERVER_SETTINGS=/etc/mongrey/server.yml
$ export MONGREY_DB=sqlite:////var/lib/mongrey/mongrey.db

$ mkdir -vp /var/lib/mongrey

$ /usr/local/bin/mongrey-server config-install

Editez si nécessaire le fichier /etc/mongrey/server.yml

Affichez la configuration en cours:

$ /usr/local/bin/mongrey-server config

Configurez Postfix:

Note

Ajoutez warn_if_reject, devant le check_policy_service pour evaluez Mongrey sans risque.

Si Mongrey renvoi une action de rejet pour un mail, il sera transformé en simple warning dans les logs.

Le contenu et l’ordre des entrées dans smtpd_recipient_restrictions dépend de votre installation. L’example ci-après n’est qu’une des nombreuses possibilités de Postfix.

$ vi /etc/postfix/main.cf

smtpd_recipient_restrictions = reject_unauth_destination, warn_if_reject, check_policy_service inet:127.0.0.1:9999

$ postfix reload

Ou en mode commande:

$ postconf -e 'smtpd_recipient_restrictions = reject_unauth_destination, warn_if_reject, check_policy_service inet:127.0.0.1:9999'

$ postfix reload

Démarrez Mongrey:

$ /usr/local/bin/mongrey-server start

Pour un démarrage en mode background:

$ /usr/local/bin/mongrey-server --pid /var/run/mongrey-server.pid start &

Pour arrêter Mongrey:

$ kill -TERM `cat /var/run/mongrey-server.pid`

MongoDB¶

$ curl -L http://download.mongrey.io/latest/mongrey-server-mongo > /usr/local/bin/mongrey-server

$ chmod +x /usr/local/bin/mongrey-server

$ /usr/local/bin/mongrey-server --version

PostgreSQL¶

$ curl -L http://download.mongrey.io/latest/mongrey-server-postgresql > /usr/local/bin/mongrey-server

$ chmod +x /usr/local/bin/mongrey-server

$ /usr/local/bin/mongrey-server --version

MySQL¶

$ curl -L http://download.mongrey.io/latest/mongrey-server-mysql > /usr/local/bin/mongrey-server

$ chmod +x /usr/local/bin/mongrey-server

$ /usr/local/bin/mongrey-server --version

Docker¶

Docker - MongoDB¶

Installez la version binaire de mongrey pour MongoDB

$ docker pull mongo

# Lancement du server MongoDB
$ docker run --name mongodb1 -d mongo mongod --smallfiles --directoryperdb

# Lancement de mongrey
$ docker run -it --rm --link mongodb1:mongodb \
   -e MONGREY_DB=mongodb://mongodb/mongrey \
   -e MONGREY_HOST=0.0.0.0 \
   -e MONGREY_PORT=9999 \
   -p 127.0.0.1:9999:9999 \
   -v /usr/local/bin/mongrey-server:/usr/local/bin/mongrey-server \
   ubuntu:14.04 /usr/local/bin/mongrey-server start

Docker - PostgreSQL¶

Installez la version binaire de mongrey pour PostgreSQL

$ docker pull postgres

# Lancement du server PostgreSQL
$ docker run --name pgsql1 -e POSTGRES_PASSWORD=secret -d postgres

# Création de la DB
$ docker exec -it pgsql1 sh -c 'exec psql -c "create database mongrey;" -U postgres'

# Lancement de mongrey
$ docker run -it --rm --link pgsql1:pgsql \
   -e MONGREY_DB=postgresql://postgres:secret@pgsql/mongrey \
   -e MONGREY_HOST=0.0.0.0 \
   -e MONGREY_PORT=9999 \
   -p 127.0.0.1:9999:9999 \
   -v /usr/local/bin/mongrey-server:/usr/local/bin/mongrey-server \
   ubuntu:14.04 /usr/local/bin/mongrey-server start

Docker - MySQL¶

Installez la version binaire de mongrey pour MySQL

$ docker pull mysql

# Lancement du server
$ docker run --name mysql1 -e MYSQL_ROOT_PASSWORD=secret -d mysql

# Création de la DB
$ docker exec -it mysql1 sh -c 'exec mysql -e "create database mongrey;" -uroot -p"secret"'

# Lancement de mongrey
$ docker run -it --rm --link mysql1:mysql \
   -e MONGREY_DB=mysql://root:secret@mysql/mongrey \
   -e MONGREY_HOST=0.0.0.0 \
   -e MONGREY_PORT=9999 \
   -p 127.0.0.1:9999:9999 \
   -v /usr/local/bin/mongrey-server:/usr/local/bin/mongrey-server \
   ubuntu:14.04 /usr/local/bin/mongrey-server start

Docker - Cache Redis¶

Pour utiliser un cache Redis dans mongrey, utiliser la variable d’environnement MONGREY_CACHE

$ docker pull redis

# Lancement du server
$ docker run -d --name redis1 -m 512m redis redis-server --appendonly yes

Exemple d’utilisation avec Mongrey dans Docker/Mongodb:

$ docker run -it --rm \
   --link mongodb1:mongodb \
   --link redis1:redis \
   -e MONGREY_CACHE=redis://redis:6379/0 \
   -e MONGREY_DB=mongodb://mongodb/mongrey \
   -e MONGREY_HOST=0.0.0.0 \
   -e MONGREY_PORT=9999 \
   -p 127.0.0.1:9999:9999 \
   -v /usr/local/bin/mongrey-server:/usr/local/bin/mongrey-server \
   ubuntu:14.04 /usr/local/bin/mongrey-server start

Docker - Build¶

Pour intégrer et personnaliser l’installation de Mongrey dans Docker, vous pouvez utiliser le modèle suivant.

Exemple avec la version binaire de Mongrey Server PostgreSQL:

# Dockerfile

FROM ubuntu:14.04

RUN apt-get update -y

RUN DEBIAN_FRONTEND=noninteractive \
    apt-get install -y --no-install-recommends \
    ca-certificates git curl language-pack-en

RUN curl -L http://download.mongrey.io/latest/mongrey-server-postgresql > /usr/local/bin/mongrey-server

RUN chmod +x /usr/local/bin/mongrey-server

CMD /usr/local/bin/mongrey-server start

# Build du contenair

$ docker build -t mongrey-server-postgresql .

Mongrey Web¶

Authentification¶

Le login et mot de passe de l’utilisateur par défaut sont: admin / mongrey

Vous pouvez les modifier par les variables d’environnement avant de lancer l’application:

MONGREY_WEB_USERNAME=monlogin

MONGREY_WEB_PASSWORD=monpassword

Pour créer le compte admin, utilisez la commande:

$ /usr/local/bin/mongrey-web default-user

MongoDB¶

$ curl -L http://download.mongrey.io/latest/mongrey-web-mongo > /usr/local/bin/mongrey-web

$ chmod +x /usr/local/bin/mongrey-web

$ /usr/local/bin/mongrey-web --help

$ /usr/local/bin/mongrey-web server -p 8081 -h 127.0.0.1

# Ouvrez le navigateur à l'adresse http://127.0.0.1:8081

PostgreSQL¶

$ curl -L http://download.mongrey.io/latest/mongrey-web-postgresql > /usr/local/bin/mongrey-web

$ chmod +x /usr/local/bin/mongrey-web

$ /usr/local/bin/mongrey-web --help

Installation par PIP¶

Requis :

Linux récent (Ubuntu 14+, CentOS+)
Librairie de compilation
Python 2.7+ (python 3 non supporté pour l’instant)
Python Setuptools/Pip
Librairies optionnelles selon le backend (mysql, postgresql, ...)

# Serveur et Web - Tous les backend
$ pip install mongrey[full]

# Serveur - Backend MongoDB
$ pip install mongrey[server_mongodb]

# Serveur - Tous les backend
$ pip install mongrey[server]

$ mongrey-server --help

$ mongrey-web --help

APT¶

À faire

RPM¶

À faire

Table des Matières

Sujet précédent

Sujet suivant

Cette page

Mongrey - Installation¶

Introduction¶

Exemples¶

Mongrey Serveur¶

Sqlite (par défaut)¶

MongoDB¶

PostgreSQL¶

MySQL¶

Docker¶

Docker - MongoDB¶

Docker - PostgreSQL¶

Docker - MySQL¶

Docker - Cache Redis¶

Docker - Build¶

Mongrey Web¶

Authentification¶

MongoDB¶

PostgreSQL¶

Installation par PIP¶

APT¶

RPM¶