Le logiciel PIA / The PIA Software
Le logiciel PIA est un outil distribué librement par la CNIL afin de faciliter la réalisation d’analyses d’impact sur la protection des données prévues par le RGPD.
PIA-BACK est développé avec le framework RubyOnRails mettant à disposition une API RESTful à destination des outils PIA et PIA-APP.
The PIA software is a free tool published by the CNIL which aims to help data controllers build and demonstrate compliance to the GDPR. PIA-BACK is developped with RubyOnRails providing a RESTful API for the PIA and PIA-APP applications.
Installation
You can follow this runbook for a full installation of pia (back-end) and pia (front-end) applications on a ubuntu 17.10 server.
Requirements
- pia (front-end) application and/or pia (stand-alone) application
- Ruby 2.3.x
- Rails 5.0.x
- PostgreSQL 9.4+
System requirements
- CPU : i5
- Ram: 4Go
- Disk Space : 20Go
- OS : preferably Linux but other OS works as well
PostgreSQL installation
Basic installation on Debian you can use the following documentation: wiki.debian.org/PostgreSql on Ubuntu you can use: help.ubuntu.com/community/PostgreSQL
Also, you need to create a new user with password.
Clone the repository
git clone https://github.com/atnos/pia-back.git
Create and fill the file database.yml
cp config/database.example.yml config/database.yml
Fill the fields username
and password
with the PostgreSQL username and password created in the previous step.
Create and fill the file application.yml
cp config/application.example.yml config/application.yml
Generate the SECRET_KEY_BASE with: bin/rake secret
and paste the secret key in the file.
Install all dependencies
bundle install
Create database
bin/rake db:create
Create tables
bin/rake db:migrate
Run the application
-
bin/rails s
your server will be accessible with the URLlocalhost:3000
-
You can specify the option
-b
to bind to a public IP address or domain name and-p
to use a different port.For example:
bin/rails s -b 123.456.789.101 -p 8080
your server will be accessible with the URL123.456.789.101:8080
-
Then, in the pia (front-end) application, use this URL to enable the server mode.
-
Fill the field in "Tools" > "Settings"
Run the application in production mode
- Fill the
production
section in thedatabase.yml
file. - Create the database:
RAILS_ENV=production bin/rake db:create
- Create the tables:
RAILS_ENV=production bin/rake db:migrate
- Run the server:
RAILS_ENV=production bin/rails s
Update the application
Update the repository : git pull
Update the database : bin/rake db:migrate
Run the test
bin/rake
Contributions
- Docker set-up (Kosmas Schütz): a Docker-Compose configuration for production purpose. Everything is automated from creating containers to setting up the database.
- Installation runbook (ylachgar): runbook to install the pia tool server version on a ubuntu 17.10 server.