Benjamin V

Docker et Python doivent être installés sur vos machines :

• https://docs.docker.com/engine/install/
• https://www.python.org/downloads/

❗ Attention : on veut faire un fork du dépôt et pas juste le cloner, de sorte que chacun puisse faire toutes les manipulations. ❗

On commence par faire un fork du dépôt :

On clique sur le bouton indiqué sur l'image, puis on choisit de faire le fork dans son propre espace.

On obtient un dépôt similaire au dépôt original, mais dans ses propres dépôts git :

Avant de cloner ce dépôt, il est nécessaire d'activer les GitHub Actions sur celui-ci. Cela se fait en cliquant sur ce bouton :

Puis en les activant ici :

On peut ensuite cloner ce dépôt comme d'habitude :

On récupère le lien vers le dépôt ici :

Puis dans une console :

mkdir info909
cd info909
git clone <lien du dépôt perso> .

Le but est ici de mettre en place un serveur local qui fera tourner l'application présente dans ce dépôt (une calculatrice web).

Pour que le serveur soit autorisé à récupérer ce qui est poussé sur le dépôt git, il faut qu'il ait un token d'accès GitHub

1️⃣ Sur github: Settings / Developer settings / Personal access tokens

• Cliquez ici

2️⃣ Generate new token

❗ Attention ❗ Assurez-vous que le token créé possède les droits de lecture de package

3️⃣ Sélectionnez read:packages

Créez un fichier .env dans le répertoire automatisation, où se trouve le script

Le fichier devrait ressembler à ça :

GITHUB_USER=<github username>
GITHUB_TOKEN=<github token>

À noter que le 'github username' doit être écrit en minuscules.

Dans le dossier automatisation, on installe les librairies python nécessaires.

pip install -r requirements.txt

Puis on peut exécuter le script qui démarre le serveur de l'application (docker doit être lancé sur la machine au préalable). Attention, ce script va récupérer une image docker automatiquement construite à chaque push sur la branche main. Cela ne fonctionnera donc pas s'il n'y a eu aucun commit/pull request sur la branche principale après avoir fork le projet (une image n'a pas encore été construite).

python script.py

Lorque le script pull une image, il lance automatiquement un conteneur pour l'exécuter. La calculatrice est alors accessible en 127.0.0.1:8080.

Comme vous avez pu le voir, l'application est une calculatrice simple avec l'addition, la soustraction et la multiplication. Ce premier exercice consiste à intégrer une fonctionnalité, la division. Il existe donc une branche "division" sur le dépôt git, avec une fonction division et des tests associés déjà mis en place. Pour ce premier exercice, créez une pull request de la branche division vers la branche master de VOTRE dépôt (attention, par défaut elle sera créée vers le dépôt de base que vous avez fork). Depuis github, pouvez-vous repérer pourquoi cette pull request n'est pas valide ?

Faites ensuite les modifications appropriées pour pouvoir merge la fonctionnalité de division. Une fois les changements fusionnés à la branche principal, et si le script python est toujours actif, alors vous devriez pouvoir voir les changements ajoutés automatiquement à l'application (http://127.0.0.1:8080).

Pour cette deuxième activité, le but sera d'ajouter une nouvelle fonctionnalité à la calculatrice : élever un nombre à une puissance choisie. Pour cela, il faudra écrire d'abord le test unitaire de cette fonction, puis implémenter la fonction en tant que telle. Il faudra également modifier l'interface pour pouvoir faire appel à cette fonction ! N'oubliez pas de créer une branche, afin de pouvoir ensuite réaliser une pull request.

Fichiers concernés : Fonction : app/server.js Test : app/tests.js Interface : app/views/index.ejs

Pour cette dernière activité, le but sera de mettre en place une branche "dev" où les pushs déclencheront les tests afin de valider les changements importés. Pour cela, une solution possible est de vous inspirer du fichier ".github/workflows/docker-image.yml" et de créer un nouveau workflow (un nouveau fichier .yml). Dans l'idéal, seuls les tests seront exécutés sur la branche dev (pas la construction de l'image docker). Créez la branche dev et mettez en place le lancement automatique des tests sur celle-ci. Vérifiez qu'ils sont bien exécutés à chaque push.