No description, website, or topics provided.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci [circleci] Remove troubleshooting step Jul 19, 2018
.forestry Update from Forestry.io - laconsultation.html Apr 23, 2018
_data add links Dec 6, 2018
_includes update accompagnement page Dec 6, 2018
_layouts add links Dec 6, 2018
_outil add engagment letters to criteres page Dec 6, 2018
_sass update accompagnement page Dec 6, 2018
_sources first commit Apr 4, 2017
_usage remove accent at Etalab Dec 5, 2018
admin Merge branch 'master' of https://github.com/consultation-gouv/consult… Jul 26, 2017
css update accompagnement page Dec 6, 2018
img replace ugap img Dec 6, 2018
js first commit Apr 4, 2017
outil/v1 first commit Apr 4, 2017
uploads add engagment letters to criteres page Dec 6, 2018
.gitignore Add vendor/bundle to .gitignore Mar 27, 2018
.ruby-version first commit Apr 4, 2017
404.html remove ui Dec 5, 2018
Dockerfile Modify Dockerfile to use versions from Gemfile.lock Apr 13, 2018
Gemfile update nokogiri Nov 12, 2018
Gemfile.lock add gemfile.lock Nov 13, 2018
LICENSE first commit Apr 4, 2017
Procfile first commit Apr 4, 2017
README.md Document MEP procedure, and remove Forestry references Oct 26, 2018
_config.yml change title Oct 19, 2017
accompagnement.html update content page Dec 6, 2018
app.json first commit Apr 4, 2017
catalogue.html refacto page outil Dec 5, 2018
cgu.html remove accent at Etalab Dec 5, 2018
contact.html update contact page style Dec 5, 2018
criteres.html add engagment letters to criteres page Dec 6, 2018
deploy.sh deploy.sh Nov 13, 2018
docker-compose.yml first commit Apr 4, 2017
index.html wording Dec 6, 2018
laconsultation.html suppression de l'image "typologie des consultations" Dec 11, 2018
leprojet.html remove "a propos" Dec 5, 2018
lesoutils.html update accompagnement page Dec 6, 2018
mentions.html update style home and remove div in mentions legales Dec 5, 2018
support.html change email address Dec 6, 2018
trophes.html Merge branch 'pprod' of https://github.com/consultation-gouv/consulta… Nov 22, 2018

README.md

Build Status

consultation.gouv.fr catalogue les outils de consultations offerts aux administrations. À chaque outil est associée une courte description fonctionnelles, une documentation technique, d'éventuelles ressources supplémentaires et des cas d'usages.

Public visé

consultation.gouv.fr s'adresse avant tout aux administrations française susceptibles de lancer des consulations NG.md#ajouter-un-service) !

Sous-domaines

Le nom de domaine consultation.gouv.fr héberge un catalogue d'outils et de cas d'usage.

Les sous-domaines en *.consultation.gouv.fr hébergent les outils catalogués sur consultation.gouv.fr et maintenus par la DINSIC.

Installation locale

Il est nécessaire de récupérer les sources avec la commande :

git clone https://github.com/consultation-gouv/consultation.gouv.fr
cd consultation.gouv.fr

Il existe ensuite deux manières de lancer le site sur sa machine :

  • Utiliser Jekyll directement.
  • Utiliser Docker.

Ces deux méthodes sont indépendantes et détaillées ci-dessous.

Jekyll

Le site utilise Jekyll, un générateur de site statique en Ruby.

Dépendances

  • Ruby. Il est recommandé d'utiliser un système de virtualisation comme RVM ou RbEnv. La version à utiliser est : 2.3
  • bundle. La commande a lancer est : gem install bundle

Commandes

  • bundle install pour installer toutes les dépendances nécessaires
  • bundle exec jekyll serve pour lancer un serveur de développement. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.
  • bundle exec jekyll build pour générer le site dans le répertoire _site.
  • bundle update pour mettre à jour les dépendances et le Gemfile.lock

Docker

Dépendances

Commandes

  • docker-compose up. Il suffit de se rendre sur l'URL indiquée à l'exécution de la commande.

Hébergement

Le site est hébergé sur un VPS.

Déploiement

La gestion du contenu du site se fait manuellement, en clonant le dépôt et en éditant les fichiers nécessaires (l'outil en ligne Forestry.io ne supporte plus, depuis mi-2018, l'édition en ligne de contenu HTML).

Les déploiements sont quant à eux automatisés via CircleCI: ce dernier démarre un build dès qu'une modification est poussée sur GitHub. Après avoir construit le site statique, il est potentiellement déployé :

  • si la branche est pprod ou production, CircleCI déploie aussi le site sur la machine correspondante
  • si la branche est master, le site est uniquement construit mais aucun déploiement n'est effectué

Les modifications centrales, n'ayant pas trait à du contenu, doivent donc être préférentiellement réalisées sur master, afin de bénéficier de la validation automatique.

Une fois le contenu et l'aspect du site validés sur le site de pré-production, les mises en production s'effectuent simplement en créant une PullRequest GitHub, depuis la branche pprod vers la branche production :

  1. Ouvrir https://github.com/consultation-gouv/consultation.gouv.fr
  2. Choisir la branche "pprod"
  3. Cliquer sur "New pull request"
  4. Dans la page qui s'ouvre, laisser "pprod" à droite de la flèche (origine de la pull request), et choisir "production" à gauche (destination de la pull request), puis valider
  5. Laisser l'intégration continue CircleCI se terminer
  6. Une fois qu'elle est validée, vous pouvez cliquer sur "Merge" pour finaliser la pull request
  7. CircleCI va lancer le déploiement en production, ce qui prendra quelques minutes