CLarification des Aides pour le Retour à l'Activité.

$> docker -v
Docker version 17.12.0-ce

$> docker-compose -v
docker-compose version 1.18.0

Toute version supérieure devrait fonctionner.

Vérifiez que le port 5432 n'est pas utilisé par ailleurs

sudo lsof -i -P -n | grep 5432

puis faire un kill du process qui utilise ce port.

Attention, les commandes ci-dessous peuvent supprimer des données de vos autres projets docker.

docker stop $(docker ps -a -q)
docker rm $(docker ps -a -q)
docker rmi $(docker images -q) -f
docker volume prune -f

Il faut disposer des droits d'accès sur GitHub et Gitlab pour cloner le projet.

~$> cd workspace
~/workspace$> mkdir repo && cd repo
~/workspace/repo$> git clone [email protected]:StartupsPoleEmploi/clara.git

Cloner le projet "private" du Gitlab de Clara au même endroit

~/workspace/repo$> cd clara
~/workspace/repo/clara$> docker-compose -f docker-compose-local.yml up --build

puis ouvrir un navigateur à l'adresse http://localhost:3000/

la page d'accueil de Clara s'affiche.

Le site web fonctionne "à minima", car les données de références et les variables d'environnement sont chargées.

Toutefois, il est très compliqué d'effectuer des développements sur une application quasiment vide de données.

Il est conseillé de travailler soit avec les données de production, soit avec un jeu de données simplifié de la base de production (voir ci-dessous)

Vérifiez que les conteneurs docker sont lancés

docker-compose -f docker-compose-local.yml run --rm web-srv bash
root@0ac2cfcb2722:/railsapp# bundle exec rails --version
Rails 5.2.4.2

Toutes les commandes classiques de migration, de console Rails, de lancement de tests unitaires, etc, peuvent ainsi être lancées.

Vérifiez que les conteneurs docker sont démarrés

docker-compose -f docker-compose-local.yml run --rm --no-deps db-srv bash -c "pg_restore --verbose --clean --no-acl --no-owner -U ara -h db-srv -d ara_dev /latest.dump"

Vérifiez que les conteneurs docker sont stoppés

Une version simplifiée de la base de données donne beaucoup de confort de développement : temps de réponse plus rapide, charge mentale du développeur réduite. Cette version permet également de lancer la suite de test d'intégration, c'est donc celle à privilégier au quotidien lors des développements.

Une fois les données de production chargées en local, vous pouvez effectuer la commande suivante.

docker-compose -f docker-compose-local.yml run --rm web-srv bash -c "bundle exec rails minidb:recreate"

Lancer la commande une deuxième fois pour s'assurer de l'absence d'effets de bords.

• Télécharger la version desktop de Cypress https://download.cypress.io/desktop
• choisissez le répertoire "/workspace/repo/clara/rails"
• cliquez sur "Run all specs" en haut à droite

~/workspace/repo$> docker-compose -f docker-compose-local.yml run --rm web-srv bash
root@0ac2cfcb2722:/railsapp# bundle exec rails t
# Running:
...........................................................................................................................................................................................................................................................................................................................................................................................................................................................................
Finished in 3.649742s, 125.7623 runs/s, 146.3117 assertions/s.

Ouvrir le navigateur à l'adresse http://localhost:3000/teaspoon/default

Une autre possibilité consiste à lancer la commande suivante :

~/workspace/repo$> docker-compose -f docker-compose-local.yml run --rm web-srv bash
root@0ac2cfcb2722:/railsapp# bundle exec rails teaspoon

Vous aurez besoin du VPN interne à Pôle Emploi pour déployer en recette

~/workspace/repo/private$> ./.execute.sh deploy recette

Mettre à jour latest.dump dans le répertoire "private" du Gitlab et pusher les modifications sur la master.

Puis

~/workspace/repo/private$> ./.execute.sh majbd recette

~/workspace/repo/private$> ./.execute.sh -h

Vous aurez besoin d'une clé SSH pour déployer en production

~/workspace/repo/private$> ./.execute.sh deploy production

Aller sur la production, puis

~$> cd /home/docker/clara
/home/docker/clara$> sudo su
/home/docker/clara$> docker-compose exec -T clara_db bash -c "pg_dump -Fc -U ara --role=ara --dbname=ara_production" > /tmp/clara_dump.dump

~/workspace/repo/private$> ./.execute.sh -h

~$> scp dboureau@<addresse-IP-de-la-prod>:/tmp/clara_dump.dump /Users/me/workspace/ 

Faire une recherche "plain text" sur le texte suivant

FROM ruby:

Et remplacer l'ancien numéro de version du Ruby par le nouveau, sur toutes les occurences.

Changez le numéro de version à l'intérieur du fichier .ruby-version

Changez le numéro de version à l'intérieur du fichier Gemfile

ruby '2.7.2' # <----- Changez le numéro de version correspondant

Puis n'oubliez pas le bundle install pour mettre à jour le Gemfile.lock

Changez le numéro de version à l'intérieur du fichier .circleci/config.yml

  - image: circleci/ruby:2.7.2-node-browsers-legacy

En recette

~/workspace/repo/private$> ./.execute.sh rebuild recette

En production

~/workspace/repo/private$> ./.execute.sh rebuild production

Sur la machine distante

a@b:/home/docker/clara$> docker-compose exec clara_rails bash -c "cd clara/rails; bundle exec mina production2 deploy:force_unlock"