heuliad

h1. Installation pour le développeur

h2. Installation RVM

Pour installer la dernière version stable de RVM utiliser la commande suivante : 

: \curl -sSL https://get.rvm.io | bash -s stable

h2. Installation Ruby

h3. Installation d'une version de Ruby

La commande pour installer la version *** de Ruby à l'aide de RVM :

: rvm install ***

Par exemple : 

: rvm install-2.3.0

h3. Choisir et afficher une version

h4. Choisir la version a utiliser

: rvm ruby -v 2.0

h4. Afficher la version utilisé actuellement

: ruby -v

h4. Lister toutes les versions installées sur le poste

: rvm list

h2. Création et configuration du Gemset

h3. Création

rvm gemset create gemset_name

h3. Liaison de la version de Ruby au gemset

rvm ruby_version@gemset_name  # specify Ruby version and our new gemset

h2. Clonage du projet heuliad

h3. Prérequis

Configurer git pour l'accès au serveur gitiuem + "Tutoriel git":https://www-iuem.univ-brest.fr/feiri/soutiens-scientifique/calcul-scientifique/wiki/utilisation-de-git

h3. Clonage

: git clone gitiuem:heuliad

h3. Installer l'environnement Ruby et ses gems

Si bundler n'est pas installé

: gem install bundler

Installation des gems listées dans le Gemfile

: bundle install

h2. Installer la base de données

h3. Installation postgis et postgresql

: apt-get install postgis

: apt-get install posgresql

h3. Création compte

Une fois posgresql installé, un compte administrateur "postgres" est défini par défaut, 

il faut donc changer d'utilisateur pour gérer postgresql et se créer son propre compte.

Commande pour changer d'utilisateur :

: sudo -i -u postgres

Charger la console postgres :

: psql

Commande pour créer un nouvel utilisateur (en mode postgres) :

: CREATE USER <nom_utilisateur>;

Donner le droit de créer une base de donnée à celui ci :

: ALTER ROLE <nom_utilisateur> WITH CREATEDB;

h3. Création base de données personelle (utiliser le nom nom_utilisateur pour la base permet une connexion automatique)

: CREATE DATABASE <nom_base_de_donnee> OWNER <nom_utilisateur>;

Sécuriser l'accès à la base par un mot de passe :

: ALTER USER <nom_utilisateur> WITH ENCRYPTED PASSWORD 'mon_mot_de_passe';

Quitter le mode postgres :

: \q

Quitter l'utilisateur "postgres" :

: exit

Ouvrir la base de donnée :

: psql -U <nom_utilisateur> -h localhost -W

* entrer son mot de passe

Créer base de donnée pour heuliad

: CREATE DATABASE heuliad;

h2. /config/database.yml

h3. Configurer l'environnement

Dans le dossier config se trouve un fichier exemple de configuration de base de donnée nommé "database.yml.example"

Vous pouvez donc copier ce texte et changer le nom du fichier en database.yml ( il faut remplacer les champs en fonction du compte postgres ) 

bc.. default: &default

  adapter: sqlite3

  pool: 5

  timeout: 5000

development: &local

  adapter: postgis

  host: localhost

  port: 5432

  password: 'mon_mot_de_passe'

  username: <nom_utilisateur>

  database: heuliad

#  schema_search_path: "public,postgis"

  script_dir: /usr/share/postgresql/9.1/contrib/postgis-1.5

test:

  <<: *local

  database: heuliad_test

p. <!-- protecting the space after the dot -->

h2. Console et Serveur

h3. Mise en place de la base de données

Premièrement il est nécessaire d'installer le package "postgresql-9.3-postgis-scripts" afin que tout le code soit reconnu

: apt install postgresql-9.3-postgis-scripts

Ensuite on peut effectuer les migrations, permettant d'initialiser la base de donnée en fonction des modèles Ruby

: rake db:migrate

h3. Connexion à la base de données

Maintenant il est possible de se connecter à la base

: rails db

ou de lancer la console pour effectuer des tests

: rails c

ou encore de lancer le serveur

: rails s