Commit eeb5ee75 authored by MAUPETIT Charly's avatar MAUPETIT Charly
Browse files

add Vagrantfile and provisioning script

parent c775b8ff
......@@ -29,4 +29,6 @@ bin/rake
db/backup/*
public/datastore
delete_cascade.sql
.settings/
\ No newline at end of file
.settings/
.vagrant/
deploy/.vagrant/
......@@ -33,6 +33,7 @@ gem 'devise'
#database
gem 'mysql2'
#gem 'pg'
#to delay jobs
gem 'sidekiq', '~>3.3'
......
File mode changed from 100755 to 100644
What is Allgo?
---
How to (re)install the application?
-- Production
- Woody (rails)
Ruby 2.2.2-dev
Nginx, mariadb, ruby + rails via rvm, rails app (via capistrano), redis, docker, git, zip
curl,sudo
install libmariadbd-dev on debian, mariadb-devel on fedora, for gem mysql2
- WorkerX - docker 1.5
sudo
su -c "adduser allgo sudo"
curl
curl -sSL https://test.docker.com/ | sh #to get last docker version
_
_ | | _____ ____
/\ | | | | / ____|/ __ \
/ \ | | | | | | __| | | |
/ /\ \ | | | | | | |_ | | | |
/ ____ \| |____ | | | |__| | |__| |
/_/ \_\______| | | \_____|\____/
|_|
#What is Allgo (A||Go)
A||Go est une infrastructure web pour mettre en ligne le plus rapidement et simplement
possible des logiciels ou prototypes scientifiques. L'objectif est de réduire le coût du transfert de
l'ordinateur du chercheur vers les utilisateurs finaux (membre de l’équipe, communauté
scientifique,Startup PME, grand public).
Le déploiement des applications, et surtout leurs utilisations, s'en retrouvent simplifiés. On peut les exécuter via l'interface web ou une API HTTP.
Techniquement, A||Go est basé sur le framework Ruby on Rails pour offrir une interface web
et des services HTTP REST, ainsi que l’utilisation de Docker pour la gestion des images applicatives.
Docker fournit des conteneurs Linux pour gérer / stocker / utiliser les applications que nous
hébergeons.
Un job est l'action d'exécuter une application, avc un ou plusieurs fichier(s) qui retournera un résultat.
#Architecture
![](doc/allgo.jpg)
## Woody (web server) - Debian 8
### What
Allgo frontend via the web application in RoR. We also have the datastore on Woody, to store files from jobs, and the SQL database.
### Need
Ruby 2.2.2-dev, Nginx, mariadb, ruby + rails via rvm, rails app (via capistrano), redis, git, zip, curl, sudo
### How
su -c "adduser allgo"
su -c "usermod -aG sudo allgo"
su allgo
Use RVM to install the correct version of Ruby
```zsh
\curl -sSL https://get.rvm.io | bash
rvm install ruby-2.2.2-dev
rvm --default use ruby-2.2.2-dev
```
Install the gem bundler to download the dependancies
```zsh
gem install bundler
```
```zsh
sudo apt-get install mariadb-devel redis -y
sudo service redis enable (to launch at boot)
sudo service redis start
sudo service mariadb enable
sudo service mariadb start
```
To run the project you need to migrate the project's database, there are backup in db/backup
```zsh
rake db:create ( RAILS_ENV=production )
rake db:migrate ( RAILS_ENV=production )
```
Then launch the project and check if there is no error message in the correct port:
```zsh
rails s
```
We also need to run sidekiq separately :
```zsh
bundle exec sidekiq (-e production)
```
##WorkerX
### What
The worker are server that will execute job created by users in Allgo.
we sent the command through ssh from Woody and send a docker pull request to cargo (see below)
the datastore from woody is mount through ssh so Worker can write in.
### Need
Docker 1.6, openssh-server
### How
```zsh
su -c "apt-get update && apt-get install sudo openssh-server -y"
su -c "adduser allgo"
su -c "usermod -aG sudo allgo"
su allgo
```
Install the last docker version docker :
```zsh
curl + curl -sSL https://test.docker.com/ | sh
sudo usermod -aG docker allgo
if docker not working :
sudo chown allgo /home/allgo/.docker/
sudo chown allgo /home/allgo/.docker/key.json
end
sudo systemctl enable docker.service, to launch docker at boot
to add or private registry, nano /etc/default/docker and line DOCKER_OPTS="--insecure-registry cargo.irisa.fr:5000"
because we don't access to the registry through https, yet
If not working, modify /etc/default/docker won't allow the access to the registry.
Instead, change /lib/systemd/system/docker.service with :
ExecStart=/usr/bin/docker --insecure-registry myregistry:5000 -d -H fd://
(Issue with debian8 & systemd?)
- Sid (sandbox) - docker 1.3
Idem as worker
Docker 1.3 because the install of docker 1.5 is not working (?)
- Cargo - docker 1.5
Docker + docker registry
data store in /mnt/nas/docker
docker run -d -p 5000:5000 -e SETTING_FLAVOR=dev -e STORAGE_PATH=/the_folder_of/your_choice_on_container/
-v /the_folder_of/your_choice/on_host:/the_folder_of/your_choice_on_container/ registry:0.9.1
- WorkerX & SID
Share the NAS datastore from woody with sshfs, VirtualBox -> Settings -> Shared repository
Todo : scheduling
-- Development environement
- Virtualbox VM, to reproduce Worker0 & sid & cargo
same install as production environment
set up an host-only adapter (with dhcp)
in settings, network, 2 network : host-only & nat
/etc/init.d/docker start
```
Try a Docker command to see if it works:
```zsh
docker ps
```
If it is not the case:
```zsh
sudo chown allgo /home/allgo/.docker/
sudo chown allgo /home/allgo/.docker/key.json
```
*Allowing insecure registry*
As we do not have an HTTPS certification yet, you need to allow an insecure registry in cargo server (see below) :
####Debian < v8
```zsh
sudo nano /etc/default/docker
```
Then modify the line concerning DOCKER_OPTS to have: ```DOCKER_OPTS="--insecure-registry cargo.irisa.fr:5000"```.
(or myregistry:5000 if development or other server)
#####Debian >= v8
```zsh
sudo nano /lib/systemd/system/docker.service
```
Change one line to have ```ExecStart=/usr/bin/docker --insecure-registry myregistry:5000 -d -H fd://```
```zsh
sudo systemctl daemon-reload
sudo /etc/init.d/docker restart
```
##Sid - Sandbox
It's the same as worker, but we use it when an user install an application/algorithm.
We create the docker image and push it to the registry
##Cargo
Cargo run the docker image registry, which allow us to store our own docker images.
We use a NAS to replicate the created images, it's safer.
Install docker (same as above)
*To run the registry, with external storage*
```zsh
docker pull registry
docker run -d -p 5000:5000 -e SETTING_FLAVOR=dev -e STORAGE_PATH=/the_folder_of/your_choice_on_container/ -v /the_folder_of/your_choice/on_host:/the_folder_of/your_choice_on_container/ registry:latest
```
It's unsecure for the moment.
#The development environment :
You can use the Vagrantfile for Virtualbox (no provisioning yet)
Or follow those instructions :
Create 4 or 5 VM (depends of if you want to use your host as web server)
Add in VirtualBox second host-only adapter in the Network tab, with DHCP.
Relaunch your VM and modify the network interfaces:
```zsh
sudo nano /etc/network/interfaces
```
Add in the opened file:
```zsh
auto eth0
iface eth0 inet dhcp
auto eth1
iface eth1 inet dhcp
sudo nano /etc/init.d/networking restart
ifconfig to get the ip
```
Once you've done the modifications, use the command ``sudo /etc/init.d/networking restart`` to restart the network card of your VM.
When duplicating the first worker don't forget to check the option to change the MAC address. Run a ```sudo ifconfig``` on each machine to get the IP address and copy-paste them into ``config/environments/development.rb`` in the corresponding line of rails-allgo.
###Installing ssh
You'll use ssh a lot on the workers thus we need to install it on the workers and aloow Woody to do a ssh without having to enter a password. First, install openssh-server:
```zsh
sudo apt-get install openssh-server
```
Then on Woody, assuming that you already have a ssh key, do this for the workers and Sid:
```zsh
ssh allgo@192.168.56.<machine number> mkdir -p .ssh
cat ~/.ssh/id_rsa.pub | ssh allgo@192.168.56.<machine number> 'cat >> .ssh/authorized_keys'
```
###Change the hostname of your machines
After cloning your machines, they'll all have the name worker 0. To change that:
```zsh
sudo nano /etc/hostname
```
Change the name and then:
```zsh
sudo /etc/init.d/hostname.sh start
```
_
_ | | _____ ____
/\ | | | | / ____|/ __ \
/ \ | | | | | | __| | | |
/ /\ \ | | | | | | |_ | | | |
/ ____ \| |____ | | | |__| | |__| |
/_/ \_\______| | | \_____|\____/
|_|
#What is Allgo (A||Go)
A||Go est une infrastructure web pour mettre en ligne le plus rapidement et simplement
possible des logiciels ou prototypes scientifiques. L'objectif est de réduire le coût du transfert de
......@@ -17,7 +27,7 @@ Un job est l'action d'exécuter une application, avc un ou plusieurs fichier(s)
### What
Allgo frontend via the web application in RoR. We also have the datastore on Woody, to store files from jobs, and the SQL database.
### Need
Ruby 2.2.2-dev, Nginx, mariadb, ruby + rails via rvm, rails app (via capistrano), redis, docker, git, zip, curl, sudo
Ruby 2.2.2-dev, Nginx, mariadb, ruby + rails via rvm, rails app (via capistrano), redis, git, zip, curl, sudo
### How
su -c "adduser allgo"
su -c "usermod -aG sudo allgo"
......@@ -148,7 +158,7 @@ iface eth0 inet dhcp
auto eth1
iface eth1 inet dhcp
```
```
Once you've done the modifications, use the command ``sudo /etc/init.d/networking restart`` to restart the network card of your VM.
When duplicating the first worker don't forget to check the option to change the MAC address. Run a ```sudo ifconfig``` on each machine to get the IP address and copy-paste them into ``config/environments/development.rb`` in the corresponding line of rails-allgo.
......@@ -173,4 +183,4 @@ sudo nano /etc/hostname
Change the name and then:
```zsh
sudo /etc/init.d/hostname.sh start
```
\ No newline at end of file
```
== README
This README would normally document whatever steps are necessary to get the
application up and running.
Things you may want to cover:
* Ruby version
* System dependencies
* Configuration
* Database creation
* Database initialization
* How to run the test suite
* Services (job queues, cache servers, search engines, etc.)
* Deployment instructions
* ...
Please feel free to use a different markup language if you do not plan to run
<tt>rake doc:app</tt>.
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
File mode changed from 100755 to 100644
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment