https://github.com/YunoHost/Kremlin

YunoHost VPS deployer for comrades
https://github.com/YunoHost/Kremlin

yunohost

Last synced: 5 days ago
JSON representation

YunoHost VPS deployer for comrades

• Host: GitHub
• URL: https://github.com/YunoHost/Kremlin
• Owner: YunoHost
• Archived: true
• Created: 2014-03-14T22:11:57.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-06-08T16:34:57.000Z (over 10 years ago)
• Last Synced: 2024-08-02T12:48:45.087Z (3 months ago)
• Topics: yunohost
• Language: Python
• Size: 250 KB
• Stars: 6
• Watchers: 12
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starred - YunoHost/Kremlin - YunoHost VPS deployer for comrades (others)

README

        
# Kremlin

Kremlin is the homemade YunoHost VPS deployer based on [Docker](https://www.docker.io/) and [Django](https://www.djangoproject.com/).

### How to install

**Tested on Ubuntu 12.04.4 64bit (kernel 3.11, docker 0.9.0)**

 1. [Install Docker](http://docs.docker.io/en/latest/installation/ubuntulinux/#ubuntu-precise-12-04-lts-64-bit)

 2. Clone the Kremlin repository

   ```bash

    git clone https://github.com/YunoHost/Kremlin /root/Kremlin

   ```

   

 3. Build the YunoHost container

 

   ```bash

    cd /root/Kremlin/docker

    docker build -t yunohost .

   ```

 4. Install and run virtualenv

 

   ```bash

    apt-get install python-pip

    pip install virtualenv

    cd /root/docker

    virtualenv ve

    source ve/bin/activate

   ```

 5. Install Kremlin's dependencies and synchronize database (SQLite by default)

 

   ```bash

    pip install -r requirements.txt

    python manage.py syncdb

   ```

 6. Edit public IP range to allow to containers

   ```bash

    vim kremlin/settings.py   # Parameter called "AVAILABLE_PUBLIC_IPS"

   ```

### Development workflow

 1. Clean database, stop docker containers and flush iptables

   ```bash

    gulag() {

      rm db.sqlite3

      python manage.py syncdb --noinput

      docker ps | grep yunohost | awk '{print $1}' | xargs -l docker stop &> /dev/null &

      iptables -t nat -F

    }

    gulag

   ```

 2. Start Django development server

   ```bash

    python manage.py runserver 0.0.0.0:8000

   ```

 3. Debug & go to 1 :)