Wiki du LAMA (UMR 5127) - Contributions [fr]

VISI201 CMI : visite de laboratoire

2020-05-20T09:44:14Z

Rnegro : /* Sujets réalisés (2019-2020) */

* Cours du semestre 2 du parcours CMI Informatique (licence INFO).

* Responsable pour 2019--2020: Jacques-Olivier Lachaud
* Responsable pour 2018--2019: Jacques-Olivier Lachaud
* Responsable pour 2017--2018: Jacques-Olivier Lachaud
* Responsable pour 2016--2017: Jacques-Olivier Lachaud

= Descriptif =

L'objectif du module est de faire découvrir les laboratoires, le monde de la recherche et les enseignants-chercheurs et chercheurs, ainsi que la réflexion scientifique. Cela se fait de deux manières.

D'abord, une partie de ce module consiste à assister à des séminaires dédiés aux étudiants CMI Informatique et Mathématique (1 fois par mois, les jeudi après-midi). [[http://www.lama.univ-savoie.fr/index.php?use=seminaires&&lang=fr&equipe=cmi&annee=1&lang=fr Planning des séminaires CMI]]

Ces séminaires "grand public" portent sur des sujets variées en informatique et mathématiques.

Les étudiants choisissent ensuite d'approfondir un sujet proposé par les enseignants, ou un sujet motivé de leur choix (en accord avec le responsable du module). Ce travail se fait en interaction avec un tuteur académique (5-6 contacts au moins). Ce travail personnel tuteuré donne lieu à la rédaction d'une synthèse sur le sujet sous forme d'une page wiki/web, ainsi que d'un mini-exposé.

= Sujets réalisés (2019-2020) =

* [https://www.lama.univ-savoie.fr/mediawiki/index.php/Transform%C3%A9e_Burrows_Wheeler Compression et transformée de Burrow-Wheeler], Simon Léonard (Tuteur : Pierre Hyvernat)
* Backtracking, Simon Pichenot (Tuteur : Pierre Hyvernat)
* [https://www.lama.univ-savoie.fr/mediawiki/index.php/Transport_optimal_par_coupe_1D_et_transfert_de_couleurs_entre_images_avec_numpy Transfert de couleur (version 2)], Florian Dufaure (Tuteur : Jacques-Olivier Lachaud)
* [[Génération fractale de terrains]], Hugo Rey (Tuteur : Jacques-Olivier Lachaud)
* [https://www.lama.univ-savoie.fr/mediawiki/index.php/Architectures_Orient%C3%A9es_Micro-Services#Architecture_orient.C3.A9e_micro-services Architectures Orientées Micro-Services], Romain Negro (David Télisson)
* [[Apprentissage automatique]], Evan L'Huissier (Tuteur : Tom Hirschowitz)
* [[Algorithmes probabilistes/déterministes pour tester la primalité d'un entier]], Juliette Neyrat (Tuteur : Sébastien Tavenas)
* [[Base de données orientées Graphe et similarité]], Romain Pajean (Gérald Cavallini)
* [[Modèles d'évolution de populations]], Théo Guesdon (Tuteur : Jimmy Garnier)

= Sujets proposés (2019-2020) =

* Compression et transformée de Burrow-Wheeler
* Backtracking
* Transfert de couleur (version 2)
* Génération fractale de terrains
* Architectures Orientées Micro-Services
* Apprentissage automatique
* Algorithmes probabilistes/déterministes pour tester la primalité d'un entier
* Base de données orientées Graphe, similarité et modèles prédictifs

== Compression et transformée de Burrow-Wheeler ==

* Tuteur : Pierre Hyvernat
* Résumé : La transformée de Burrow-Wheeler est l'étape clé de l'algorithme de compression bzip2. C'est une transformation de texte (suite d'octet) qui ne modifie pas la taille, mais ajoute suffisamment de motifs redondants pour améliorer un autre algorithme de compression (algorithme de Huffman dans le cas de bzip2)
* Objectif : L'objectif est de comprendre le fonctionnement de cette transformation (et de son inverse) et d'implémenter une version naïve de l'algorithme de compression / décompression et de tester sur quelques exemples. Les améliorations de l'algorithme seront ensuite abordées.
* Liens : Burrows, Michael; Wheeler, David J. (1994), A block sorting lossless data compression algorithm, Technical Report 124, Digital Equipment Corporation [[https://www.hpl.hp.com/techreports/Compaq-DEC/SRC-RR-124.pdf PDF]]

== Backtracking ==

* Tuteur : Pierre Hyvernat
* Résumé et objectif : La notion de "backtracking" est fondamentale en algorithmique : il s'agit essentiellement de tester des solutions partielles à un problème, en revenant en arrière dès qu'une incohérence est découverte. Le point de départ sera le fascicule 4.5b de D. Knuth "Introduction to backtracking" et permettra de se familiariser avec les concepts, la terminology et des exemples, qu'il faudra implémenter. Une suite possible sera la notion de réduction de problèmes et l'algorithme-X qui permet de "factoriser" de nombreux problèmes de backtracking en un seul algorithme.
* Liens : D. Knuth, "the art of computer programming introduction to backtracking" [[https://www-cs-faculty.stanford.edu/~knuth/fasc5b.ps.gz PS]]

== Transfert de couleur (version 2) ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: Le transfert de couleurs de l'image Y vers l'image X consiste à repeindre "au mieux" l'image X avec la palette de couleurs de l'image Y. L'image repeinte X' a alors les mêmes couleurs que l'image Y (mais les pixels ne sont pas répartis pareils). Voir l'exemple de transfert ci-dessous. Il existe plusieurs techniques de transfert de couleurs, mais nous étudierons une technique basée sur le transport optimal. Comme c'est un problème assez difficile dans le cas général, nous étudierons une variante dite par coupe 1D, qui simplifiera considérablement le problème de transport.
{| class="wikitable alternance center"
|+ Transfert de couleur
|----
! scope="col" | Input !! scope="col" | Output
|----
| [[Fichier:horseshoe.jpg|200px]] || [[Fichier:horseshoe-fjord-n40.jpg|200px]]
|----
| [[Fichier:fjord.jpg|200px]] || [[Fichier:fjord-horseshoe-n40.jpg|200px]]
|}
* Objectifs:
*# Comprendre la version 1 fait par [[https://www.lama.univ-savoie.fr/mediawiki/index.php/Transport_optimal_par_coupe_1D_et_transfert_de_couleurs_entre_images Lucas Chardonnet]], comprendre les qualités et limites de l'approche (sur quelle type d'image ça marche assez bien par exemple)
*# Adapter l'algorithme pour qu'il puisse traiter des images de tailles différentes
*# Réécrire le code en utilisant la bibliothèque python NUMPY pour accélérer les calculs
*# Changer les espaces de couleurs utilisés: RGB ne convient pas très bien pour mesurer le coût du transport. Transformer le code pour qu'il puisse utiliser plutôt l'espace [[https://fr.wikipedia.org/wiki/L*a*b*_CIE_1976 L*a*b*]] mieux adapté pour calculer des distances entre couleurs.
* Liens:
** la page de [[https://www.lama.univ-savoie.fr/mediawiki/index.php/Transport_optimal_par_coupe_1D_et_transfert_de_couleurs_entre_images Lucas Chardonnet]]
** [[https://en.wikipedia.org/wiki/Color_mapping Transfert de couleur Wikipedia]]
** [[https://hal.archives-ouvertes.fr/tel-01246096/file/hdr_hal2.pdf Habilitation de N. Papadakis]] (regardez les images plutôt).

== Génération fractale de terrains ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: La génération procédurale de terrain est très utilisée en modélisation 3D et dans les jeux vidéos, afin de générer rapidement des paysages pseudo-réalistes que l'on étoffera ensuite de façon plus manuelle. On propose d'étudier et d'implémenter un algorithme classique, dit "algorithme Diamant-Carré". Cet algorithme récursif permet de générer une carte d'élévation. Selon les paramètres données, le résultat peut ressembler aux cartes d'altitude de haute montagne ou des collines plus douces.
{| class="wikitable alternance center"
|+ Génération fractale de terrain par algorithme diamand carré
|----
! scope="col" | Elévations générées !! scope="col" | Colorisation !! scope="col" | Visualisation 3D
|----
| [[Fichier:Diamond-Square_texture.png|200px]] || [[Fichier:Diamond-Square_heightmap.png|200px]] || [[Fichier:Terragen.jpg|200px]]
|}

* Objectifs:
*# Comprendre et implémenter l'algorithme Diamant-Carré
*# Comprendre comment paramétrer cet algorithme pour qu'il génère des montagnes bien abrupte à haute altitude ou des collines à basse altitude.
*# Fabriquer une image de couleur/texture qui va associer des couleurs aux altitudes générées (e.g. forcer du bleu sous l'altitude zero, ajouter de la neige, des lacs, de la forêt)
*# Générer un fichier 3D (par exemple OBJ) à partir de ces deux images (l'image des hauteurs et l'image des couleurs) pour pouvoir faire de beau rendu 3D (sous blender par exemple)
* Liens:
** La page [[https://fr.wikipedia.org/wiki/Algorithme_Diamant-Carr%C3%A9 Wikipedia]] de l'algorithme
** La page [[https://en.wikipedia.org/wiki/Wavefront_.obj_file Wikipedia]] du format OBJ

== Architectures Orientées Micro-Services ==

* Tuteur : David Télisson
* Résumé : Les architectures des applications logicielles distribuées de grandes envergures ont évolué à partir du début des années 2000, d’une application molithique déployée sur un serveur d’application (JEE, TomCat, etc.) vers des solutions fortement répartis déployées sous formes de services. On parle alors d’architectures orientées services qui se traduisent par le développement et le déploiement de services logiciels interrogeables via des protocoles dédiés (par exemple SOAP) et des API (REST). Cette tendance, corrélée aux nouvelles méthodes de management des projets informatiques (méthodes agiles, intégration continue, DevOps1), s’est accentué ces dernières années et a fait émergé un « nouveau » paradigme : le micro-service. Plusieurs aspects caractérisent un micro-service :
** fonctionnalité unique
** flexibilité technologie
** équipe de développement réduite
** déploiement ciblé
** support de la montée en charge (scalabilité)
** tests facilités et intégrés au processus de développement (TDD2)
* Objectifs du projet :
*# Etudier et comprendre les concepts liés aux micro-services (API, conteneurisation, framework, etc.)
*# Implémentez un PoC (proof of concept) qui démontre qu’une application peut se construire dynamiquement par agrégation de micro-services développés avec des langages différents (Python, JS et Java), déployés sur des plateformes différentes (Django, Node et Glassfish) et disponibles sous formes de conteneurs dans le cloud (Azure)
*# Livrable attendu : un tutoriel « à la OpenClassRooms »
* Liens pour démarrer :
** https://mbaron.developpez.com/cours/microservices/introduction-generalites
** https://openclassrooms.com/fr/courses/4668056-construisez-des-microservices

== Apprentissage automatique ==

* Tuteur : Tom Hirschowitz
* Résumé : L'apprentissage automatique est un ensemble de techniques algorithmiques visant à écrire des programmes qui améliorent leurs performances au cours du temps. Le sujet consiste en une initiation à cette idée par l'exemple, à base de ressources telles que https://colah.github.io/posts/2015-08-Backprop et http://neuralnetworksanddeeplearning.com .

== Algorithmes probabilistes/déterministes pour tester la primalité d'un entier ==

* Tuteur : Sébastien Tavenas
* Pouvoir tester si un entier est un nombre premier semble être une brique de base si l'on souhaite faire de l'arithmétique sur un ordinateur. Le crible d'Érathostène enseigné dans les petites classes se montre beaucoup trop lent en pratique. L'algorithme probabiliste utilisé le plus rapide est le test de Fermat. Or, si on regarde les algorithmes des librairies "génériques", on peut s'apercevoir que la fonction 'mpz_probab_prime_p' de la librairie 'gmp' sur c++ utilise un test probabiliste de Miller-Rabin, la fonction 'isPrime' de la classe 'Prime' dans java utilise aussi un test de Miller-Rabin mais qui est déterminisé, alors que la fonction 'isprime' de la librairie 'sympy' dans python effectue un test de Miller-Rabin si l'entier est plus petit que 2^64 et un test BPSW fort si l'entier est plus grand. Ainsi, une fonction déjà implémentée de test de primalité peut se tromper ou non, être instantanée ou moins. Que dire alors de l'algorithme polynomial déterministe et toujours correct proposé par AKS?
* Objectifs :
*# Comprendre quelques tests de primalité et comment l'aléatoire est utilisé dans ces algorithmes
*# Comprendre la notion de nombre pseudopremier qui explique, entre autre, quand il vaut mieux utiliser le test de Fermat ou celui de Miller-Rabin
*# Programmer quelques uns des ces tests et les comparer
*# Essayer de dérandomiser ces tests à l'aide de hitting-sets précalculés

* Liens pour commencer
** [[https://en.wikipedia.org/wiki/Primality_test Tests de primalité]]

== Base de données orientées Graphe, similarité et modèles prédictifs ==

* Tuteur : Gérald Cavallini
* Résumé : Avec l’avènement du BigDatas, dans bien des cas le choix d’un produit, d’un média, d’un voyage ... ne peut plus être direct. Il s’appuie sur des systèmes de recommandations. L’importance financière de ces systèmes est énorme Amazon estime à 30% les ventes supplémentaires dues à son système de recommandation. Ces systèmes s’appuient sur des calculs statistiques et des algorithmes de recherche de similarité. Ces algorithmes expriment la distance entre des objets, ce qui permet par exemple d’identifier des utilisateurs(consommateurs, électeur ...) similaire et de recommander leurs choix.
* Objectifs :
*# Mettre en œuvre différents algorithmes de recherche de similarité ( similarité de Jaquard, similarité cosinus...) dans une base de donnée orientées Graphe Neo4j.
*# Proposer un système de recommandation de film à partir de la base MovieLens (Notation de films par des utilisateurs).
*# Proposer un une validation du modèle prédictif.
* Liens pour commencer
** https://fr.wikipedia.org/wiki/Indice_et_distance_de_Jaccard
** https://www.machinelearningplus.com/nlp/cosine-similarity/
** https://neo4j.com/
** https://movielens.org/

[[Fichier:Neo4j.jpg|400px]]

= Sujets réalisés (2018-2019) =

* [[Transport optimal par coupe 1D et transfert de couleurs entre images]] (Lucas CHARDONNET)
* [[Génération et résolution de labyrinthes II]] (Romain THEODET)
* [[Rest & Pub-Sub : protocole hybride pour l'IoT]] (Ewan RAKOTOANOSY)
* [[La suite de Conway et la classification périodique des "éléments"]] (Yohann THEPAUT)
* [[Initiation à la démonstration sur ordinateur et certification de logiciel]] (Loïc DORNET)
* [[Dilemme du prisonnier]] (Christophe CARMAGNAC)

= Sujets proposés (2018-2019) =

* Transport optimal par coupe 1D et transfert de couleurs entre images
* Génération et résolution de labyrinthes II
* REST + Pub/Sub : protocole hybride pour l’IoT
* La suite de Conway et la classification périodique des "éléments"
* Initiation à la démonstration sur ordinateur et certification de logiciel
* Algorithmes probabilistes/déterministes pour tester la primalité d'un entier
* Dilemme du prisonnier

== Transport optimal par coupe 1D et transfert de couleurs entre images ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: Le transfert de couleurs de l'image Y vers l'image X consiste à repeindre "au mieux" l'image X avec la palette de couleurs de l'image Y. L'image repeinte X' a alors les mêmes couleurs que l'image Y (mais les pixels ne sont pas répartis pareils). Voir l'exemple de transfert ci-dessous. Il existe plusieurs techniques de transfert de couleurs, mais nous étudierons une technique basée sur le transport optimal. Comme c'est un problème assez difficile dans le cas général, nous verrons une variante dite par coupe 1D, qui simplifiera considérablement le problème de transport.

[[Fichier:Ex-transfert-couleur-OT.png]]

* Objectifs:
*# comprendre ce qu'est une image niveaux couleur, et ce qu'on appelle le transfert de couleurs.
*# comprendre le principe du transport optimal (discret).
*# comprendre et décrire le principe du transport optimal par coupe 1D, et comment se fait le calcul du meilleur transport dans ce cas.
*# Coder un programme de transfert de couleur, qui prend deux images couleurs et réalise le transfert de couleurs.
*# On pourra ensuite réfléchir à quelques améliorations simples (espace couleur YUV, grouper les pixels).
* Liens pour démarrer
** Le vrai "Transport Optimal" est vite très mathématique (ce sont des mesures qui sont transportées), mais on peut l'aborder beaucoup plus simplement dans le cas discret (un nombre fini de valeurs) comme une simple assignation entre deux ensembles.
** [[https://en.wikipedia.org/wiki/Color_mapping Transfert de couleur Wikipedia]]
** [[https://hal.archives-ouvertes.fr/tel-01246096/file/hdr_hal2.pdf Habilitation de N. Papadakis]] (regardez les images plutôt).

== Génération et résolution de labyrinthes II ==

* Tuteur: François Boussion
* Résumé: On veut générer des labyrinthes aussi grands et complexes que possible, avec des murs dans une grille carré voire d'autres domaines. Comment faire pour qu'il y ait toujours un chemin de l'entrée à la sortie ? Comment faire pour qu'il n'y ait qu'un chemin ? Ensuite, comment trouver la sortie quand on est perdu dans le labyrinthe.
* Objectifs:
*# Comprendre comment représenter un labyrinthe avec une structure de données simple
*# Voir le lien avec la théorie des graphes et voir que le problème se résout de la même façon pour des grilles carrées, hexagonales ou autres.
*# Comprendre l'algorithme d'arbre couvrant minimum
*# Comprendre le principe du parcours en profondeur et de la récursivité
* Pour aller plus loin
*# coder la génération d'un labyrinthe et sa visualisation
*# introduire des poids pour varier le labyrinthe
*# comment faire un labyrinthe sur grille hexagonale avec des tableaux.
* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Mod%C3%A9lisation_math%C3%A9matique_d%27un_labyrinthe Wikipedia]]
** [[https://en.wikipedia.org/wiki/Maze_generation_algorithm Version anglaise plus complète]]

== REST + Pub/Sub : protocole hybride pour l’IoT ==

* Tuteur: David Télisson
* Résumé: L’avènement de l’Internet des Objets (IoT) depuis une dizaine d’années a fait apparaitre des problématiques propres aux protocoles de communications liées à ces objets. En effet, l’échange de données dans ce contexte nécessite de tenir compte (au moins) des paramètres suivant :
*# Autonomie énergétique souvent limitée
*# Faible puissance des processeurs et taille réduite de la mémoire
*# Disponibilité « aléatoire » de l’accès aux réseaux de communication

De nombreux protocoles cohabitent et la littérature du domaine foisonne d’exemples autour des réseaux dédiées (LORA, Sigfox, etc.) et des protocoles applicatifs (OPC-UA, MQTT, CoaP, XMPP) mais force est de constater que dans la réalité, ces solutions ne répondent pas toujours aux besoins des concepteurs qui leurs préfèrent encore le protocole HTTP. Celui-ci offre l’avantage d’implémenter un protocole applicatif (REST) en même temps qu’un protocole de transport de haut niveau (TCP/IP) permettant de passer les pare-feu. Cependant, la version actuel d’HTTP ne répond pas vraiment aux critères énoncés précédemment.
Depuis quelques années émerge donc l’idée d’enrichir HTTP pour créer un protocole hybride qui mêlerait les avantages de REST avec ceux proposés par les mécanismes de type Publish/Subscribe (MQTT, AMQP, JMS, etc.). En attendant cette éventuelle évolution, peut-on envisager de mettre en place un mécanisme de type Pub/Sub avec le protocole Websocket au-dessus d’HTTP ?

* Objectifs:
*# Etudier et faire une synthèse des deux approches : REST et Pub/Sub
*# Implémentez un PoC (proof of concept) d’une solution hybride qui met en œuvre un mécanisme de Pub/Sub sur Websocket. .
*# Présenter un protocole de test pour valider ou invalider cette solution

* Liens pour démarrer :
** https://nsrc.org/workshops/2018/apricot/iot/presentations/mqttvsrest_v4.pdf
** http://www.tigli.fr/lib/exe/fetch.php?media=cours:tutorial_mqtt_mit_2015_2016.pdf
** https://openclassrooms.com/fr/courses/3449001-utilisez-des-api-rest-dans-vos-projets-web
** http://www.lirmm.fr/~tibermacin/ens/ws/expose.pdf

== La suite de Conway et la classification périodique des "éléments" ==

* Tuteur : Pierre Hyvernat
* La suite de Conway est la suite suivante : 1 ; 11 ; 21 ; 1211 ; 111221 ; ... Chaque terme est obtenu en "lisant" le terme précédent.
** "1" : un "1" -> 11
** "11" : deux "1" -> 21
** "21" : un "2", un "1" -> 1211
** "1211" : un "1", un "2", deux "1" -> 111221
** etc.
Cette suite possède des propriétés étonantes données par le théorème "chimique", le théorème "arithmétique" et le théorème "cosmologique".
* Objectifs :
*# comprendre les énoncés de ces théorèmes, et l'idée de la preuve du premier.
*# programmer la suite de Conway pour retrouver la classification des "atomes"
*# écrire un programme pour calculer expérimentalement une approximation de la constante "lambda" ainsi que des fréquences respectives des différents atomes.
*# écrire un programme pour calculer la suite de Robinson, une variante plus simple de la suite de Conway

* Liens pour commencer
** [[https://fr.wikipedia.org/wiki/Suite_de_Conway suite de Conway]]
** [[https://fr.wikipedia.org/wiki/Suite_de_Robinson suite de Robinson]]

== [[Initiation à la démonstration sur ordinateur et certification de logiciel]] ==

* Tuteur: Tom Hirschowitz
* Résumé: [[https://coq.inria.fr Coq]] est un logiciel de mathématiques sur ordinateur, grâce auquel des programmes élaborés ont pu être certifiés ces dernières années.
* Objectifs:
*# prendre en main le logiciel [[https://coq.inria.fr Coq]] de démonstration sur ordinateur,
*# programmer certaines démonstrations basiques en Coq,
*# suivre le début du cours [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]],
* Pour aller plus loin : Software Foundations est un cours assez long et très bien fait, il y aura suffisamment à faire. Eventuellement, selon l'intérêt de l'étudiant, étude des fondements mathématiques de Coq.
* Liens pour démarrer
** [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]]
** [[https://coq.inria.fr Coq]]

== Algorithmes probabilistes/déterministes pour tester la primalité d'un entier ==

* Tuteur : Sébastien Tavenas
* Pouvoir tester si un entier est un nombre premier semble être une brique de base si l'on souhaite faire de l'arithmétique sur un ordinateur. Le crible d'Érathostène enseigné dans les petites classes se montre beaucoup trop lent en pratique. L'algorithme probabiliste utilisé le plus rapide est le test de Fermat. Or, si on regarde les algorithmes des librairies "génériques", on peut s'apercevoir que la fonction 'mpz_probab_prime_p' de la librairie 'gmp' sur c++ utilise un test probabiliste de Miller-Rabin, la fonction 'isPrime' de la classe 'Prime' dans java utilise aussi un test de Miller-Rabin mais qui est déterminisé, alors que la fonction 'isprime' de la librairie 'sympy' dans python effectue un test de Miller-Rabin si l'entier est plus petit que 2^64 et un test BPSW fort si l'entier est plus grand. Ainsi, une fonction déjà implémentée de test de primalité peut se tromper ou non, être instantanée ou moins. Que dire alors de l'algorithme polynomial déterministe et toujours correct proposé par AKS?
* Objectifs :
*# Comprendre quelques tests de primalité et comment l'aléatoire est utilisé dans ces algorithmes
*# Comprendre la notion de nombre pseudopremier qui explique, entre autre, quand il vaut mieux utiliser le test de Fermat ou celui de Miller-Rabin
*# Programmer quelques uns des ces tests et les comparer
*# Essayer de dérandomiser ces tests à l'aide de hitting-sets précalculés

* Liens pour commencer
** [[https://en.wikipedia.org/wiki/Primality_test Tests de primalité]]

== Dilemme du prisonnier ==

* Tuteur: Gerald Cavallini
* Résumé: Le dilemme du prisonnier caractérise en théorie des jeux une situation où deux joueurs auraient
intérêt à coopérer, mais où, en l’absence de communication entre les deux joueurs, chacun choisira
de trahir l'autre si le jeu n'est joué qu'une fois.

On peut informatiquement modéliser ce dilemme à l’aide de matrices de gains et conserver la
mémoire des choix de l’adversaire. Ce modèle appliqué à un grand nombre d’individus peut être
utilisé pour comprendre l’émergence de stratégies stables dans l’économie, l’écologie, l’évolution
des espèces ...

On peut visualiser spatialement les interactions entre individus en les représentants par des pixels et
en leurs associant une couleur en fonction de leurs stratégies.

[[Fichier:Dilemme.png]]

* Objectifs
*# Comprendre le dilemme du prisonnier
*# Comprendre la notion de stratégie
*# Penser un modèle spatiale pour « opposer » des individus qui appliquent des stratégies différentes
*# Développer une interface pour visualiser dans le temps l’évolution d’une population d’individus adoptants des stratégies différentes.

* Lien :
*# [https://fr.wikipedia.org/wiki/Dilemme_du_prisonnier Dilemme du prisonnier Wikipedia]
*# [http://cormas.cirad.fr/fr/applica/dps.htm Site spécifique]

= Sujets réalisés (2017-2018) =

* [[VISI201 Analyse syntaxique (Tristan Porteries, 2018)]]
* [[Segmentation d'image par détection de contours et algorithme "ligne de partage des eaux"]] (Nils Ruet, 2018)
* [[Fouille de données textuelles à partir des "Exercices de style" de R. Queneau]] (Rémi Bouvier, 2018)
* [[Transformées en distance, diagramme de Voronoi et applications en geometry processing]] (Robin Wagner, 2018)
* [[Pavages de Penrose]] (Brunelle Cordier-Pierre-Bès, 2018)

= Sujets proposés (2017-2018) =

* Segmentation d'image par détection de contours et algorithme "ligne de partage des eaux"
* Initiation à la démonstration sur ordinateur et certification de logiciel
* Fouille de données textuelles à partir des "Exercices de style" de R. Queneau
* Transformées en distance, diagramme de Voronoi et applications en geometry processing
* Pavages de Penrose

== [[Segmentation d'image par détection de contours et algorithme "ligne de partage des eaux"]] ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: La segmentation d'image vise à identifier les régions d'intérêt dans une image. Typiquement, une région d'intérêt est une zone de l'image plutôt homogène (les pixels ont des valeurs proches) et le contour entre deux régions d'intérêt est tracé là où les valeurs subissent de fortes variations. La méthode de segmentation proposée ici suit ce principe en enchaînant deux calculs: (1) un premier traitement calcule une image "gradient" et fabrique une image dont les valeurs élevées correspondent à des zones de fortes variations, (2) le deuxième algorithme voit cette image comme un relief 3D et identifie ses bassins hydrographiques. Cette identification des lignes de partage des eaux permet de découper l'image en ses zones d'intérêt.
* Objectifs:
*# comprendre ce qu'est une image niveaux de gris ou couleur, ce qu'est le gradient d'une image et ce qu'on appelle segmentation d'image.
*# décrire un algorithme de calcul du gradient d'une image, e.g. le filtre de Sobel, voire les convolutions par dérivées de Gaussienne.
*# décrire le principe de ligne de partage des eaux ("watershed" en anglais), ses différentes définitions équivalentes, et les différents types d'algorithmes pour la calculer.
*# Coder un programme de segmentation d'image, qui prend une image (niveaux de gris) en entrée, calcule son gradient, et extrait les bassins de sa ligne de partage des eaux.
* Liens pour démarrer
** [[https://en.wikipedia.org/wiki/Watershed_(image_processing) Watershed Wikipedia]]
** Luc Vincent and Pierre Soille. Watersheds in digital spaces: an efficient algorithm based on immersion simulations. In IEEE Transactions on Pattern Analysis and Machine Intelligence, Vol. 13, Num. 6 (1991), pages 583–598 [[https://pdfs.semanticscholar.org/a381/9dda9a5f00dbb8cd3413ca7422e37a0d5794.pdf PDF]]

== [[Initiation à la démonstration sur ordinateur et certification de logiciel]] ==

* Tuteur: Tom Hirschowitz
* Résumé: [[https://coq.inria.fr Coq]] est un logiciel de mathématiques sur ordinateur, grâce auquel des programmes élaborés ont pu être certifiés ces dernières années.
* Objectifs:
*# prendre en main le logiciel [[https://coq.inria.fr Coq]] de démonstration sur ordinateur,
*# programmer certaines démonstrations basiques en Coq,
*# suivre le début du cours [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]],
* Pour aller plus loin : Software Foundations est un cours assez long et très bien fait, il y aura suffisamment à faire. Eventuellement, selon l'intérêt de l'étudiant, étude des fondements mathématiques de Coq.
* Liens pour démarrer
** [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]]
** [[https://coq.inria.fr Coq]]

== [[Fouille de données textuelles à partir des "Exercices de style" de R. Queneau]] ==

* Tuteur: Laurent Vuillon
* Résumé: L'idée de ce projet est de se familiariser avec les techniques de fouille de données textuelles à partir des "Exercices de style" de R. Queneau (https://fr.wikipedia.org/wiki/Exercices_de_style). On cherchera à comprendre la structure du vocabulaire du corpus de textes, à utiliser les techniques de TF/IDF pour extraire les mots significatifs du corpus puis à tester les techniques de LDA (Allocation de Dirichlet latente) pour extraire automatiquement les thématiques du corpus afin de construire des regroupements par thème. On pourra également proposer des visualisations des résultats afin de rendre accessible visuellement l'analyse de données produite sur le corpus de documents.
* Objectifs: Introduction à la fouille de données au travers d'un cas pratique
* Pour aller plus loin
** http://blogperso.univ-rennes1.fr/stephane.tuffery/
** http://www.editionstechnip.com/en/catalogue-detail/1005/data-mining-et-statistique-decisionnelle.html
* Liens pour démarrer
** https://fr.wikipedia.org/wiki/Exploration_de_donn%C3%A9es
** https://fr.wikipedia.org/wiki/TF-IDF
** "Recherche d'information : applications, modèles et algorithmes; Data mining, décisionnel et big data" de Amini et Gaussier aux éditions Eyrolles.

== [[Transformées en distance, diagramme de Voronoi et applications en geometry processing]] ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: Les nuages de points constituent une source de données géométriques importantes (cf LIDAR scanner, 3D scanner) et qui permet de construire des modèles géométriques 3D d'objets réels. La difficulté est de transformer ces nuages de points en des surfaces (souvent des surfaces triangulées, c'est-à-dire des triangles collés entre eux). Un outil essentiel dans ce processus est la transformée en distance, le diagramme de Voronoi (et son dual la triangulation de Delaunay). A partir de ces outils, des algorithmes existent pour reconstruire les surfaces, estimer la géométrie du nuage de point (sa normale par exemple), etc.
* Objectifs:
*# Comprendre ce qu'est une distance, une transformée en distance, et un diagramme de Voronoi. Comprendre ce qu'est la stabilité d'une fonction.
*# Identifier les propriétés des diagrammes de Voronoi, de leur dual la triangulation de Delaunay, et comprendre leurs variantes comme les diagrammes de puissance
*# Identifier le lien avec l'axe médian et les squelettes
*# Décrire les principaux algorithmes de calcul des transformées en distance et du diagramme de Voronoi, pour des nuages de point quelconques ou pour des nuages de points à coordonnées entières.
*# Présenter un algorithme de reconstruction de surface utilisant le diagramme de Voronoi
*# Coder un algorithme de calcul du diagramme de Voronoi et, si le temps le permet, un algorithme de reconstruction de surface.

* Liens pour démarrer
** [[https://en.wikipedia.org/wiki/Voronoi_diagram Diagramme de Voronoi Wikipedia]]
** [[https://en.wikipedia.org/wiki/Distance_transform Transformée en distance Wikipedia]]
** [[https://en.wikipedia.org/wiki/Topological_skeleton Squelette Wikipedia]]
** [[http://dgtal.org/doc/nightly/moduleVolumetric.html Transformées discrètes en distance DGtal]]

== [[Pavages de Penrose]] ==

* Tuteur : Pierre Hyvernat
* Résumé : le "cerf-volant" et la "fléchette" de Penrose sont deux tuiles qui permettent de recouvrir le plan, mais uniquement de manière non-périodique. Autrement dit, les pavages correspondants ne sont pas obtenus en répétant un même motif de manière régulière. A cause de ceci, il n'est pas évident de générer un tel pavage.

[[Fichier:P2.png]]

* Objectifs
*# comprendre les notion de pavage périodique, non périodique et apériodique,
*# comprendre la méthode "inflation / déflation" pour générer des pavages de Penrose des différents types,
*# comprendre le lien entre les 2 (ou 3) types de pavage de Penrose
*# écrire un programme permettant de générer de tels pavages : avec la méthode "inflation / déflation" et avec la méthode "grille de de Bruijn"
*# utiliser ces méthodes pour générer d'autres types de pavages apériodique.

* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Pavage_de_Penrose pavage de Penrose (wikipedia]]
** [[https://www.maa.org/sites/default/files/pdf/pubs/focus/Gardner_PenroseTilings1-1977.pdf Penrose Tiling (Marting Gardner, en anglais)]]

== [[Algorithmes d'analyse syntaxique]] ==

* Tuteur : Pierre Hyvernat

* Résumé : le code source d'un programme, d'un fichier de configuration d'un serveur de base de données ou le code d'une page web sont des données ''textuelles'' et ''structurées''. Il est possible de définir exactement quelles données sont correctes, et quelle est leur signification. (Cela est beaucoup plus difficile pour des textes en langue naturelle par exemple.) En ce sens, il est possible de lire, d'interpréter ces données à l'aide d'un programme. On parle ''d'analyseur syntaxique'' ou de ''parseur''. Il existe de nombreux outils pour faire ça automatiquement, mais il est parfois important (et toujours intéressant) de comprendre les mécanismes correspondant. C'est ce que ce stage propose de faire.

* Objectifs :
*# étudier la formalisation du problème à travers la notion de ''langage'' et les premiers étages de la hiérachie de Chomsky (langages réguliers et grammaires hors contexte).
*# comprendre le lien entre les langages et les automates (automates finis / automates à pile)
*# implémenter un parseur "from scratch" et le tester sur des petits exemples simples, "à la main", soit en calculant "à la volée" la sémantique d'un langage, soit en produisant des "arbres de syntaxe abstraits", qui pourront être analysés par la suite,
*# comprendre les restrictions souvent imposées sur les grammaires afin d'améliorer l'efficacité du parseur (''LL*(k)'', ''LR'', etc.)
*# à partir de là, de nombreuses pistes sont ouvertes :
*#* essayer d'écrire un petit outils qui puisse lire une grammaire, et générer un parseur pour cette grammaire,
*#* comparer l'approche "automate" avec l'approche "combinateurs" et "parseur récursifs"
*#* améliorer l'efficacité des parseurs produits
*#* ajouter des fonctionnalités,
*#* ...

* Liens pour démarrer :
** [[https://en.wikipedia.org/wiki/Parsing page wikipedia "parsing"]]
** [[https://en.wikipedia.org/wiki/Recursive_descent_parser page wikipedia "recursive descent parser"]]
** Le livre référence sur le parsing est probablement "Compilers: Principles, Techniques, and Tools" de Aho, Sethi et Ullman (le "dragon book")
** [[https://web.stanford.edu/class/archive/cs/cs143/cs143.1128/ exemples de notes cours de compilation]]

= Sujets réalisés (2016-2017) =

* [[Algorithme de rendu de scène 3D par Z-buffer]]
* [[Traitement d'image]]
* [[Nim et la théorie des jeux impartiaux]]
* [[Calculabilité et modèles de calcul]]
* [[Génération et résolution de labyrinthes]]

= Sujets proposés (2016-2017) =

== [[Algorithme de rendu de scène 3D par Z-buffer]] ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: Le Z-buffer est un algorithme classique de rendu de scène 3D. C'est celui (avec quelques variantes) qui est implémenté dans nos cartes graphiques 3D et qui permet de visualiser des scènes extrêmement complexes en temps réel (typiquement 24 image/s).
* Objectifs:
*# décrire le principe de la projection 3D vers 2D
*# décrire la rastérisation des triangles sur une image en pixel
*# expliquer le principe du Z-buffer qui permet de gérer le fait que certains objets sont cachés par d'autres
*# expliquer comment les couleurs sont calculées par pixel
*# indiquer les qualités et limitations de l'algorithme
* Pour aller plus loin
*# mettre du code démo (WebGL) avec quelques explications sur le pipeline graphique OpenGL
*# expliquer comment on peut utiliser cet algorithme pour calculer des ombres (shadow map)
* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Z-buffer Wikipedia]]
** [[https://www.scratchapixel.com/lessons/3d-basic-rendering/rasterization-practical-implementation/overview-rasterization-algorithm Scratch a pixel]]

== [[Traitement d'image]] ==

* Tuteur: Jacques-Olivier Lachaud
* Résumé: Le traitement d'image rassemble tous les algorithmes utilisés pour transformer les images, les améliorer, éliminer certaines perturbations, augmenter ou diminuer le contraste, changer les couleurs vers d'autres couleurs, éliminer le flou ou les yeux rouges, faire du cartooning pour un rendu moins photo-réaliste, etc.
* Objectifs:
*# identifier les grandes familles de traitement: restauration, égalisation, élimination du flou de déplacement, segmentation, etc
*# identifier les grandes familles de techniques: filtrage spatial, filtrage fréquentiel, optimisation, etc
*# comprendre les points communs et différences entre le traitement des images noir et blanc et le traitement des images couleurs.
*# choisir un ou deux algorithmes de traitement et les expliquer en détails
* Pour aller plus loin
*# Coder un algorithme de traitement d'image simple (e.g, un filtrage médian, ou un algo qui transporte les couleurs d'une photo vers une autre photo)

* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Traitement_d%27images Wikipedia]]
** [[http://www.ipol.im/ Image Processing on line]] (permet de tester en ligne des algorithmes sur vos images)

== [[Nim et la théorie des jeux impartiaux]] ==

* Tuteur: Pierre Hyvernat

* Étudiant : Luca Chapelle

* Le jeu de Nim (aussi appelé jeu des allumettes) est l'un des premiers jeux ayant été analysé mathématiquement (par Charles Bouton en 1901). Les stratégies gagnantes peuvent être calculées en utilisant le développement en base 2 des nombres, et l'opération d'"addition de Nim" (XOR). La théorie de ce type de jeux (jeux "impartiaux") est assez simple, mais de nombreuses instances de jeux sont encore non résolues.
* Objectifs:
*# comprendre la théorie du jeu de Nim (et la programmer)
*# comprendre le théorème de Sprague Grundy qui montre que tout jeu impartial est équivalent à un jeu de nim
*# regarder quelques autres exemples de tels jeux : jeu de Nim déguisés, ou jeux véritablement différents
*# programmer une version naịve de recherche de stratégie basée sur le théorème de Sprague-Grundy pour quelques jeux

* Liens pour commencer
** [https://fr.wikipedia.org/wiki/Jeux_de_Nim jeu de Nim]
** [https://fr.wikipedia.org/wiki/Th%C3%A9or%C3%A8me_de_Sprague-Grundy théorème de Sprague Grundy]
** [https://fr.wikipedia.org/wiki/Jeu_de_Grundy jeu de Grundy]

== La suite de Conway et la classification périodique des "éléments" ==

* Tuteur : Pierre Hyvernat
* La suite de Conway est la suite suivante : 1 ; 11 ; 21 ; 1211 ; 111221 ; ... Chaque terme est obtenu en "lisant" le terme précédent.
** "1" : un "1" -> 11
** "11" : deux "1" -> 21
** "21" : un "2", un "1" -> 1211
** "1211" : un "1", un "2", deux "1" -> 111221
** etc.
Cette suite possède des propriétés étonantes données par le théorème "chimique", le théorème "arithmétique" et le théorème "cosmologique".
* Objectifs :
*# comprendre les énoncés de ces théorèmes, et l'idée de la preuve du premier.
*# programmer la suite de Conway pour retrouver la classification des "atomes"
*# écrire un programme pour calculer expérimentalement une approximation de la constante "lambda" ainsi que des fréquences respectives des différents atomes.
*# écrire un programme pour calculer la suite de Robinson, une variante plus simple de la suite de Conway

* Liens pour commencer
** [[https://fr.wikipedia.org/wiki/Suite_de_Conway suite de Conway]]
** [[https://fr.wikipedia.org/wiki/Suite_de_Robinson suite de Robinson]]

== Initiation à la démonstration sur ordinateur et certification de logiciel ==

* Tuteur: Tom Hirschowitz
* Résumé: [[https://coq.inria.fr Coq]] est un logiciel de mathématiques sur ordinateur, grâce auquel des programmes élaborés ont pu être certifiés ces dernières années.
* Objectifs:
*# prendre en main le logiciel [[https://coq.inria.fr Coq]] de démonstration sur ordinateur,
*# programmer certaines démonstrations basiques en Coq,
*# suivre le début du cours [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]],
* Pour aller plus loin : Software Foundations est un cours assez long et très bien fait, il y aura suffisamment à faire. Eventuellement, selon l'intérêt de l'étudiant, étude des fondements mathématiques de Coq.
* Liens pour démarrer
** [[https://www.cis.upenn.edu/~bcpierce/sf Software Foundations]]
** [[https://coq.inria.fr Coq]]

== [[Calculabilité et modèles de calcul]] ==

* Tuteur: Rodolphe Lepigre
* Résumé: Une fonction f sur l'ensemble des entiers naturels est dite calculable s'il existe une procedure effective (ou un algorithme) qui permet, étant donné un entier n, de calculer f(n) en temps fini. Il existe divers modèles de calcul qui permettent de représenter toutes les fonctions calculables : machines de Turing, λ-calcul, automates cellulaires, ...
* Objectifs:
*# comprendre la notion de fonction calculable,
*# comparer l'ensemble des fonctions à l'ensemble des fonctions calculables,
*# regarder et comparer quelque modèles de calcul,
*# programmer un modèle de calcul et comprendre les limitations pratiques.

* Liens pour commencer:
** https://fr.wikipedia.org/wiki/Calculabilité
** https://fr.wikipedia.org/wiki/Machine_de_Turing
** https://fr.wikipedia.org/wiki/Lambda-calcul
** https://fr.wikipedia.org/wiki/Jeu_de_la_vie

== [[Génération et résolution de labyrinthes]] ==

* Tuteur: <strike>Jacques-Olivier Lachaud</strike> Xavier Provençal
* Résumé: On veut générer des labyrinthes aussi grands et complexes que possible, avec des murs dans une grille carré voire d'autres domaines. Comment faire pour qu'il y ait toujours un chemin de l'entrée à la sortie ? Comment faire pour qu'il n'y ait qu'un chemin ? Ensuite, comment trouver la sortie quand on est perdu dans le labyrinthe.
* Objectifs:
*# Comprendre comment représenter avec une structure de données un labyrinthe
*# Voir le lien avec la théorie des graphes et voir que le problème se résout de la même façon pour des grilles carrées, hexagonales ou autres.
*# Comprendre l'algorithme d'arbre couvrant minimum
*# Comprendre le principe du parcours en profondeur et de la récursivité
* Pour aller plus loin
*# coder la génération d'un labyrinthe et sa visualisation
* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Mod%C3%A9lisation_math%C3%A9matique_d%27un_labyrinthe Wikipedia]]
** [[https://en.wikipedia.org/wiki/Maze_generation_algorithm Version anglaise plus complète]]

== Pavages par polyomino ==

* Tuteur: Xavier Provençal
* Résumé : On s'intéresse aux pavages du plan par des tuiles formées de petits carrés collés les uns aux autres, appelé "polyominos". Étant donné une tuile, peut-on paver le plan ? Si oui, avec quelles opérations (translation et/ou rotations et/ou réflexions) Une fois un pavage réalisé, on observe ses propriétés. Quelles symétries ? Le pavage est-il identique du point de vue de chacune des tuiles ? Si ce n'est pas le cas, en combien de classes peut-on diviser ces tuiles ?
On s'intéressera aussi à des propriétés connexes. Au lieu de paver tout le plan, on peut essayer de paver une région finie donnée. Plus localement, peut-on encercler complètement une tuile avec des copies d'elle-même, sans former de trous ? Si oui, peut-on faire de même avec la proto-tuile formée par la tuile de départ et toutes ses copies ? Si oui, combien de fois peut-on répéter l'opération ?
* Objectifs :
*# Comprendre les différentes classes de pavages (isohédral, k-isohédral, anisohédral).
*# Pour chacun des sept types de pavages "isohédraux", comprendre le lien entre les symétries du pavages et la caractérisation des tuiles qui le réalisent.
*# Pour un pavage k-isohédral, identifier les "classes d'équivalences" et le "domaine fondamental".
* Pour aller plus loin :
*# Coder la génération de tuiles capables de paver le plan en fonction pour une classe de pavages donnée.
*# Étudier et implémenter certains algorithmes pour le pavages d'un domaine fini.
* Liens pour démarrer
** [[https://fr.wikipedia.org/wiki/Polyomino Polyomino]]
** [[https://en.wikipedia.org/wiki/Polyomino Polyomino (en)]]
** [[https://fr.wikipedia.org/wiki/Pavage_par_des_polygones_r%C3%A9guliers Pavages]]

Architectures Orientées Micro-Services

2020-05-14T13:29:47Z

Rnegro :

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

A cause d'un crash prématuré de la machine virtuelle, nous n'avons pas pu finir cette partie.

=== Commandes utiles ===

*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])

*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.

*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)

*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.

*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*Si vous n'arrivez pas à ouvrir la page, essayez les choses suivantes :
**Echangez les ports dans votre commande <code>docker run</code>
**Vérifier que vous avez rentré la bonne adresse dans la barre de recherche

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:28:16Z

Rnegro : /* Problèmes rencontrés */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

A cause d'un crash prématuré de la machine virtuelle, nous n'avons pas pu finir cette partie.

=== Commandes utiles ===

*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])

*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.

*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)

*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.

*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*Si vous n'arrivez pas à ouvrir la page, essayez les choses suivantes :
**Echangez les ports dans votre commande <code>docker run</code>
**Vérifier que vous avez rentré la bonne adresse dans la barre de recherche

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:26:38Z

Rnegro : /* Problèmes rencontrés */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

A cause d'un crash prématuré de la machine virtuelle, nous n'avons pas pu finir cette partie.

=== Commandes utiles ===

*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])

*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.

*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)

*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.

*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*Si vous n'arrivez pas à ouvrir la page, essayez les choses suivantes :
**Echangez les ports dans votre commande <code>docker run</code>
**Vérifier que vous avez rentré la bonne adresse dans la barre de recherche

Si vous rencontrez un autre problème veuillez me contacter par mail à l'adresse suivante : romain.negro@etu.univ-savoie.fr

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:16:04Z

Rnegro : /* Commandes utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

A cause d'un crash prématuré de la machine virtuelle, nous n'avons pas pu finir cette partie.

=== Commandes utiles ===

*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])

*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.

*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)

*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.

*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:12:03Z

Rnegro : /* Faire communiquer deux conteneurs */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

A cause d'un crash prématuré de la machine virtuelle, nous n'avons pas pu finir cette partie.

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.
*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:07:21Z

Rnegro : /* Liens utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.
*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]
*[http://www.alain-andre.fr/docker/ruby/2016/11/08/faire-communiquer-des-conteneurs-docker.html Communication entre conteneurs basique]

Architectures Orientées Micro-Services

2020-05-14T13:00:50Z

Rnegro : /* Liens utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.
*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]
*[https://docs.docker.com/ Documentation Docker Complète]

Architectures Orientées Micro-Services

2020-05-14T12:58:23Z

Rnegro : /* Faire communiquer deux conteneurs */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.
*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T12:57:17Z

Rnegro : /* Dans la Pratique (Docker) */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Publier une image ===

Pour publier une image sur DockerHub, il faut tout d'abord :
*Créer un compte sur DockerHub et s'y connecter via le terminal
*Mettre en route l'image sur un conteneur sur la machine
Suite à cela, la commande à entrer est la suivante : <pre>docker push NOM_IMAGE</pre>
Il y a cependant une restriction pour le nom de l'image, il doit être de la forme <code>VotrePseudoDocker/NomImage:Tag</code> '''sans''' majuscules.

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>docker network connect NOM_RESEAU NOM_CONTENEUR</pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0,host et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])
*<code>docker tag image NomImage:NewTag</code> permet de changer le tag d'une image docker (par défaut le tag est <code>latest</code>)
*<code>docker images</code> permet de lister les images qui ont été utilisés sur la machine et celles qui sont en cours d'utilisation par les conteneurs allumés.
*<code>docker rename OLD_NAME NEW_NAME</code> permet de renommer une image docker.
*<code>docker run -t NOM_CONTENEUR --network NOM_RESEAU NOM_IMAGE</code> permet de démarrer un conteneur et de le connecter sur le réseau en argument.
*<code>docker network stop NOM_RESEAU</code> arrête le réseau en argument.
*<code>docker network disconnect NOM_RESEAU NOM_CONTENEUR</code> déconnecte un conteneur d'un réseau.
*<code>docker network rm NOM_RESEAU</code> supprime un réseau de la machine.

=== Problèmes rencontrés ===

Durant ce projet, des problèmes sont survenus :
*Si vous rencontrez un manque d'autorisation, rajoutez <code>sudo</code> devant vos commandes pour que docker ait les autorisations nécessaires.
*

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T11:49:59Z

Rnegro : /* Commandes utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0 et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.
*<code>docker login</code> permet de se connecter à DockerHub via le terminal (il faut se créer un compte au préalable sur le site [https://hub.docker.com/ DockerHub])

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T11:38:26Z

Rnegro : /* Faire communiquer deux conteneurs */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Faire communiquer deux conteneurs ===

Pour faire communiquer deux conteneurs afin d'échanger des informations (comme un texte, un identifiant, etc.), il faut tout d'abord créer un réseau afin de relier les deux conteneurs.

Pour cela, il faut entrer la commande suivante : <pre>docker network create --driver bridge NOM_RESEAU</pre> où <code>--driver bridge</code> permet de calquer le réseau sur le driver nommé bridge

Ensuite, pour connecter un conteneur au réseau, il faut entrer <pre>

=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0 et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T11:11:55Z

Rnegro : /* Commandes utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Faire communiquer deux conteneurs ===
=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code>docker network ls</code> liste les réseaux accessibles via la machine (par défaut, il y a docker0 et bridge.
*<code>docker network inspect NOM_RESEAU</code> affiche les caractéristiques d'un réseau docker, dont les conteneurs connectés dessus ou encore son adresse ip.

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T10:05:55Z

Rnegro : /* Commandes utiles */

//page WIP//

Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-generalites/ théorique], ou niveau pratique (via [https://www.docker.com/ Docker]).

= Dans la théorie =

=== Introduction ===

Le terme d'architectures micro-services est apparu aux alentours de 2011 lors d'un workshop sur les différentes architectures logicielles.

Lors de leur invention, cela fut une révolution dans la création des services, les rendant plus rapides et plus économes à grande échelle que les architectures orientées services.

=== Architecture logicielle ===

*<i>Voir "[https://fr.wikipedia.org/wiki/Architecture_logicielle Architecture Logicielle]" sur wikipédia.</i>

Une architecture logicielle décrit l'organisation globale d'un réseau, que ce soit les échanges ou la taille des entités.

=== Architecture orientée micro-services ===

Une architecture orientée micro-services se base sur l'architecture du Web, dans le sens où il n'y a pas de serveur centralisé. Chaque micro-service est un serveur, que l'on nomme conteneur, et ces conteneurs communiquent entre-eux, afin d'aboutir à ce que l'on recherche.

Cette architecture permet un travail à équipe réduite, car l'on assigne une équipe à un micro-service, qui ne nécessite pas de connaître tous les langages, mais uniquement les langages du micro-service sur lequel elle travaille.

De plus, une mise à jour d'une fonctionnalité ne nécessite que la mise à jour du conteneur en question, et non de toute l’infrastructure comme sur une architecture monolithique.

Enfin, si une surcharge se produit sur un micro-service car beaucoup d'utilisateurs le demande, l'application peut dupliquer ce service sans modifier l'architecture, car les conteneurs prennent source sur le même micro-service et donc gardent en mémoire les conteneurs où les informations sont stockées.

=== Utilisation en entreprise ===

*Entreprises de vente de masse ([https://www.amazon.fr/ Amazon])
*Sites de Streaming Vidéo ou Audio ([https://www.netflix.com/fr/ Netflix] ou [https://www.deezer.com/fr/ Deezer])
*Sites d'information utilisateur dans le domaine du transport (comme la [https://www.sncf.com/fr SNCF] ou [https://www.airfrance.fr/ Air France])
*Applications qui vendent des services en général (comme [https://www.uber.com/fr/fr/ Uber] ou [https://maps.google.fr/ Google Maps])

=== Comparatif avec les architectures les plus communes ===

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Architectures
!Monolithique
!Orientée Services
!Orientée Micro-Services
|-
!Forme
|Une seule grosse application contenant toutes les fonctions
|Une application par type de fonction
|Une application par fonction
|-
!Nombres de langages
|Un seul pour toute l'application afin de faciliter la communication
|Un nombre défini lors de la création du réseau
|Autant de langages que l'on veut
|-
!Moyen de communication
|Par les données
|Par les services
|Par les services
|-
!Force du couplage
|Fort
|Moyen
|Faible
|-
|}

{| class="wikitable plainrowheaders" style="text-align: center; margin:auto; margin:auto;"
!Monolithique
!Micro-services
|-
|[[Fichier:monolit.png|400px]]
|[[Fichier:OMS.png|400px]]
|-
|}

= Dans la Pratique (Docker) =
=== Prérequis ===
*Avoir un système d'exploitation linux (soit une [https://www.oracle.com/virtualization/technologies/vm/downloads/virtualbox-downloads.html machine virtuelle] avec [http://releases.ubuntu.com/ ubuntu] de préférence, soit physique)
*Avoir des connaissances de base en [https://www.tutorialspoint.com/unix/index.htm bash] et en [https://www.python.org/ python]

=== Installation ===

Pour installer Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer cette commande : <pre>sudo apt-get update && sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>

=== Installer un conteneur depuis DockerHub ===

Pour installer un conteneur depuis DockerHub sur notre machine via Docker, il faut :
#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker pull NOM_DU_CONTENEUR</pre>

Exemple :
<pre> docker pull romain22222/friendlyhello:Test</pre> permet de télécharger le conteneur romain22222/friendlyhello:Test

=== Utiliser un conteneur ===

#Ouvrir le terminal de commandes
#Entrer la commande suivante : <pre>docker run -d -p NumPort NOM_IMAGE</pre>

Ici, <code>run</code> permet de lancer un conteneur à partir d'une image.

<code>-d</code> permet de faire tourner le conteneur en arrière plan.

<code>-p NumPort</code> permet de définir le port de votre machine sur lequel le conteneur est relié. Le port est de la forme #A:#B où #A correspond au port de la machine, et #B le port que Docker écoute.

=== Créer un conteneur ===
Pour créer un conteneur, il faut :
#Choisir un dossier ou l'on va créer l'image pour ce conteneur
#Créer un fichier nommé <code>Dockerfile</code> (Voir comment créer un fichier Dockerfile en-dessous)
#Créer votre projet dans le dossier
#Ajouter un fichier requirements.txt dans lequel vous devez mettre tous les librairies non-natives pour python (au moins mettre Redis et Flask)
#Sauvegarder vos fichiers
#Lancer la commande suivante : <pre>docker build -t NOM_DU_CONTENEUR CHEMIN</pre>, où <code>-t</code> permet de spécifier le nom du conteneur (par défaut, le conteneur aura un nom aléatoire de la forme adjective_knownScientist, exemple : bold_einstein)

Exemple de fichier Dockerfile :
<pre>
FROM ubuntu:16.04
RUN apt-get update -y && \
apt-get install -y python3-pip python3-dev
COPY ./requirements.txt /app/requirements.txt
WORKDIR /app
RUN pip3 install -r requirements.txt
COPY . /app
ENTRYPOINT [ "python3" ]
CMD [ "app.py" ]</pre>

*<code>FROM NOM_IMAGE_BASE</code> permet de partir d'une image docker existante (sur la machine ou sur dockerhub)
*<code>RUN COMMANDE</code> permet de faire les mises à jour nécessaires et les installations hors python afin de faire tourner le conteneur
*<code>COPY CHEMIN1 CHEMIN2</code> fait une copie d'un fichier ou dossier vers un autre emplacement
*<code>WORKDIR CHEMIN</code> donne le nom du chemin où va travailler la machine
*<code>EXPOSE NOM_PORT</code> permet d'ouvrir un port de votre machine afin que le conteneur puisse communiquer (généralement 5000 pour Docker)
*<code>ENTRYPOINT [ "PREFIX" ]</code> permet d'exécuter les prochaines CMD avec le préfix en argument
*<code> CMD [ "NOM_FICHIER_PRINCIPAL.py" ]</code> fait tourner python3 avec le fichier de lancement de votre conteneur.

----

Exemple de fichier python pour une page web :
<pre>
#!/bin/env python3
from flask import Flask
from redis import Redis, RedisError
import os
import socket

redis = Redis(host="redis", db=0, socket_connect_timeout=2, socket_timeout=2)

#définition de l'application
app = Flask(__name__)
@app.route('/')
def hello():
try:
visits = redis.incr("counter")
except RedisError:
visits = "<i>Erreur<i>"

html = "<h3>Hello {name}!<h3>" \
"<b>Hostname:</b> {hostname}<br/>" \
"<b>Visits:</b> {visits}"
html+="<ul>"
for i in range(10):
html+="<li>{patate} "+str((i/5)**2)+"</li>"
html+=("</ul>")
return html.format(name=os.getenv("NAME","world"),hostname=socket.gethostname(),visits=visits,patate="test")

#lancement de l'application
if __name__ == "__main__":
app.run(host='0.0.0.0',port=5000, debug=False)
#host = adresse d'écoute (si 0.0.0.0, écoute tous les canaux)
#port = port de connexion sur la machine hôte (laisser à 5000 pour les premiers tests)
#debug = permet d'activer ou non le mode debug
</pre>

=== Faire communiquer deux conteneurs ===
=== Commandes utiles ===
*<code>docker ps</code> permet de lister les conteneurs créés sur la machine (mettre -la va lister tous les conteneurs ayant existés au moins une fois sur la machine).
*<code>docker system prune</code> supprime les images, les conteneurs et réseaux non-utilisés de la machine.
*<code>docker stop NOM_CONTENEUR</code> permet d'arrêter un conteneur.
*<code>docker rm NOM_CONTENEUR</code> permet de supprimer un conteneur (il faut que le conteneur soit à l'arrêt pour effectuer la commande)
*<code></code>
*<code></code>

= Liens utiles =
*[https://mbaron.developpez.com/cours/microservices/introduction-generalites/ Diaporama de cours sur les architectures micro-services]
*[https://www.docker.com/ Docker Site officiel]
*[https://www.youtube.com/watch?v=YFl2mCHdv24 lien vers une vidéo (pour le php) d'un tutoriel pour Docker]

Architectures Orientées Micro-Services

2020-05-14T09:37:41Z

Rnegro : /* Créer un conteneur */

Architectures Orientées Micro-Services

2020-05-11T20:49:52Z

Rnegro : /* Créer un conteneur */

Architectures Orientées Micro-Services

2020-05-11T20:42:41Z

Rnegro : /* Installer un conteneur depuis DockerHub */

Architectures Orientées Micro-Services

2020-05-11T20:41:35Z

Rnegro : /* Prérequis */

Architectures Orientées Micro-Services

2020-05-11T17:53:58Z

Rnegro : /* Créer un conteneur */

Architectures Orientées Micro-Services

2020-05-11T17:53:22Z

Rnegro : /* Créer un conteneur */

Architectures Orientées Micro-Services

2020-05-11T15:30:26Z

Rnegro : /* Liens utiles */

Architectures Orientées Micro-Services

2020-05-11T15:29:27Z

Rnegro : /* Dans la Pratique (Docker) */

Architectures Orientées Micro-Services

2020-05-11T14:44:16Z

Rnegro : /* Dans la Pratique (Docker) */

Architectures Orientées Micro-Services

2020-05-04T22:03:17Z

Rnegro : /* Architecture orientée micro-services */

Architectures Orientées Micro-Services

2020-05-04T21:57:52Z

Rnegro : /* Comparatif avec les architectures les plus communes */

Architectures Orientées Micro-Services

2020-05-04T21:57:37Z

Rnegro : /* Comparatif avec les architectures les plus communes */

Architectures Orientées Micro-Services

2020-05-04T21:57:30Z

Rnegro : /* Comparatif avec les architectures les plus communes */

Architectures Orientées Micro-Services

2020-05-04T21:57:02Z

Rnegro :

Architectures Orientées Micro-Services

2020-05-04T21:55:39Z

Rnegro :

Architectures Orientées Micro-Services

2020-05-04T21:44:51Z

Rnegro :

Architectures Orientées Micro-Services

2020-05-04T21:38:33Z

Rnegro : /* Dans quelles types d'entreprises est-elle utilisée ? */

Architectures Orientées Micro-Services

2020-05-04T21:34:43Z

Rnegro : /* Comparatif avec les autres architectures */

Architectures Orientées Micro-Services

2020-05-04T21:34:02Z

Rnegro : /* Comment marche cette architecture ? */

Architectures Orientées Micro-Services

2020-05-04T21:32:56Z

Rnegro : /* Côté théorique */

Architectures Orientées Micro-Services

2020-05-04T21:25:00Z

Rnegro : /* Comment marche cette architecture ? */

Architectures Orientées Micro-Services

2020-05-04T21:23:16Z

Rnegro : /* Comment marche cette architecture ? */

Fichier:OMS.png

2020-05-04T21:18:28Z

Rnegro :

Fichier:Monolit.png

2020-05-04T21:06:11Z

Rnegro :

Architectures Orientées Micro-Services

2020-05-04T21:04:10Z

Rnegro : /* Comment marche cette architecture ? */

Architectures Orientées Micro-Services

2020-05-04T20:57:57Z

Rnegro : /* Comparatif avec les autres architectures */

Architectures Orientées Micro-Services

2020-05-04T20:57:21Z

Rnegro : /* Comment marche cette architecture ? */

Architectures Orientées Micro-Services

2020-05-04T20:49:25Z

Rnegro :

Architectures Orientées Micro-Services

2020-05-04T19:25:00Z

Rnegro : Page créée avec « //page WIP// Dans ce projet, nous avons étudié les architectures micro-services que ce soit niveau [https://mbaron.developpez.com/cours/microservices/introduction-gener... »