CASIRCloud: Difference between revisions

From air
Jump to navigation Jump to search
Line 76: Line 76:
Générez d'une application d'online-store à partir du modèle https://raw.githubusercontent.com/mastering-microservices/tutorial/master/online-store.jh
Générez d'une application d'online-store à partir du modèle https://raw.githubusercontent.com/mastering-microservices/tutorial/master/online-store.jh


Visualisez le modèle avec le [JHipster JDL Studio](https://start.jhipster.tech/jdl-studio/).
Visualisez le modèle avec le [https://start.jhipster.tech/jdl-studio/ JHipster JDL Studio].


[[Image:jhipster-jdl-casir.png|JHipster JDL|center|500px]]
[[Image:Jhipster-jdl-casir.png|center|500px|JHipster JDL]]




Revision as of 12:56, 29 March 2019

Enseignant: Didier Donsez (Polytech Grenoble, UGA)

Coordinateur : Clement Raievsky (IUT de Valence, UGA)

Etudiants : UGA - IUT Valence - L3 Pro CASIR

Modalité d’évaluation : DS (30%)+ DM (70%)


Séance 0 : 21/03 Après-Midi

Auto-formation

Obligatoire

Suivre les cours suivants en vidéo :


Pour Docker, suivre ce tutoriel https://www.katacoda.com/courses/docker

A VOIR : Mastering Chaos - A Netflix Guide to Microservices (slides)

Optionnel

Lire:

Vous pouvez suivre les autres présentations si vous en avez envie et le temps: http://erods.liglab.fr/icar2013/programme.html

Et notamment la présentation du datacentre d'OVH

Création des comptes

  • Création d’un compte Pack étudiant Github https://education.github.com/pack
  • Création d’un compte sur Docker Hub https://hub.docker.com/
  • Création d’un compte sur le SaaS public Heroku (ne requiert pas de carte bancaire)
  • Création d’un compte sur le SaaS public Azure à partir de ce github student pack OU Création d’un compte sur le SaaS public AWS à partir de ce github student pack


Remarque: il existe d'autres hébergeurs IaaS avec des offres gratuites 1 an pour de petites VMs : https://www.digitalocean.com ...

Installation des prérequis de JHipster

Avant la séance 1, vous installerez le générateur JHipster de projets web fullstack via l'installation par Docker https://www.jhipster.tech/installation/ . Le conteneur contient alors tous les requis dans les bonnes versions : java 8, npm, nodejs, yarn, yeoman, jhipster generator.

Pour cela :

  1. Installez Docker CE et Docker Compose
  2. Installez Heroku CLI
  3. Faites un pull de l'image Docker du générateur JHipster au moyen de la commande suivante.
docker pull jhipster/jhipster

Agenda

  • DS QUICK (30 minutes) sur la séance 0 (15% de la note globale). !!!!! NE PAS ARRIVER EN RETARD !!!!
  • Introduction aux applications distribuées (transparents)

Génération de l'application fullstack avec JHipster

# Term 1
docker pull jhipster/jhipster

Générez d'une application d'online-store à partir du modèle https://raw.githubusercontent.com/mastering-microservices/tutorial/master/online-store.jh

Visualisez le modèle avec le JHipster JDL Studio.

JHipster JDL


Créez une application de type Monolithic (avec une base Postgres pour la production)

Générez le backend et le frontend de de l'exemple online-store 

# Term 1
mkdir -p ~/casircloud/online-store
cd ~/casircloud/online-store
docker container run --name jhipster --hostname jhipster-online-store \
    -v $PWD:/home/jhipster/app \
    -v ~/.m2:/home/jhipster/.m2 \
    -p 8080:8080 -p 9000:9000 -p 3001:3001 \
    -d -t jhipster/jhipster

EXEC="docker exec -it jhipster"
$EXEC bash
$EXEC jhipster

Répondez aux questions suivantes: 

? May JHipster anonymously report usage statistics to improve the tool over time? No
? Which *type* of application would you like to create? Monolithic application (recommended for simple projects)
? What is the base name of your application? onlinestore
? What is your default Java package name? com.onlinestore.shop
? Do you want to use the JHipster Registry to configure, monitor and scale your application? No
? Which *type* of authentication would you like to use? JWT authentication (stateless, with a token)
? Which *type* of database would you like to use? SQL (H2, MySQL, MariaDB, PostgreSQL, Oracle, MSSQL)
? Which *production* database would you like to use? PostgreSQL
? Which *development* database would you like to use? H2 with disk-based persistence
? Do you want to use the Spring cache abstraction? Yes, with the Ehcache implementation (local cache, for a single node)
? Do you want to use Hibernate 2nd level cache? Yes
? Would you like to use Maven or Gradle for building the backend? Maven
? Which other technologies would you like to use? 
? Which *Framework* would you like to use for the client? Angular
? Would you like to enable *SASS* stylesheet preprocessor? Yes
? Would you like to enable internationalization support? Yes
? Please choose the native language of the application English
? Please choose additional languages to install French
? Besides JUnit and Jest, which testing frameworks would you like to use? Gatling, Cucumber, Protractor
? Would you like to install other generators from the JHipster Marketplace? No

Installing languages: en, fr

Générez le code des classes Java et des composants Angular de l'application Online Store 

$EXEC wget https://raw.githubusercontent.com/mastering-microservices/tutorial/master/online-store.jh 
$EXEC jhipster import-jdl online-store.jh

Qualité du code généré avec SonarQube

Modifiez l'adresse du serveur SonarQube dans le ./pom.xml (par défaut localhost).

Lancez le conteneur SonarQube 

docker-compose -f src/main/docker/sonar.yml up -d

Relancez le conteneur jhipster avec un lien vers le container SonarQube 

docker rm -f jhipster
docker container run --name jhipster --hostname jhipster-online-store \
    -v $PWD:/home/jhipster/app \
    -v ~/.m2:/home/jhipster/.m2 \
    -p 8080:8080 -p 9000:9000 -p 3001:3001 \
    --link onlinestore-sonar:sonarqube
    -d -t jhipster/jhipster

$EXEC ./mvnw -Pprod clean test sonar:sonar 
# Remarque : Maven envoie l'analyse au conteneur SonarQube

Visualisez le rapport d'analyse généré pour SonarQube à l'adresse http://localhost:9001 

open http://localhost:9001

Coût du projet

Installez l'utilitaire sloccount

Lancez l'analyse des sources 

sloccount ./src

Estimez le coût de ce projet

Exécution en mode DEV

  • Lancez l'application online-store en mode DEV sur votre machine de développement
# Term 1
$EXEC ./mvnw

# Term 2
cd ~/casircloud/online-store
EXEC="docker exec -it jhipster"
$EXEC yarn start

# Term 3
cd ~/casircloud/online-store
open http://localhost:9000

OpenAPI

Loggez vous en admin et ouvrez l'interface Swagger (Administration > API)

Ouvrez les pages suivantes: 

# Term 3
cd ~/casircloud/online-store
open http://localhost:9000
open http://localhost:8080/swagger-ui/index.html

Ouvrez la spécification Swagger dans http://editor.swagger.io 

# Term 3
curl http://localhost:8080/v2/api-docs > swagger.json
open http://editor.swagger.io

Générez le client Bash (curl) et la documentation HTML2 à partir de la documentation OpenAPI (Swagger) avec l'outil en ligne Swagger Editor

Utilisez le client Bash (curl) généré avec http://editor.swagger.io

Exécution en mode PROD sur le cloud public Heroku

Installez Heroku CLI https://devcenter.heroku.com/articles/heroku-cli

Installez le plugin Java pour Heroku CLI https://devcenter.heroku.com/articles/deploying-executable-jar-files 

# Term 5
heroku plugins:install java

Installez le générateur JHipster pour Heroku. 

# Term 5

Configurez le fichier de production du backend pour Heroku (src/main/resources/config/application*.yml).

Construisez l'application en mode PROD.

Déployez votre application online-store en mode PROD sur Heroku 


# Term 5

cd ~/casircloud/online-store
$EXEC ./mvnw package -Pprod -DskipTests
heroku login
heroku deploy:jar target/*.war --app onlineshop-1234

# A noter, le nom des applications est global à heroku !!!!

Arrêtez de l'application (mode maintenance)

Redémarrez l'application

Supprimez l'application d'Heroku


CD-CI

Générez le pipeline Jenkins pour le CD-CI (https://www.jhipster.tech/setting-up-ci/) 

# Term 5
cd ~/casircloud/online-store
$EXEC jhipster ci-cd

Lancez le conteneur Jenkins

Configurez Jenkins

L'installation du conteneur Jenkins est assez longue ! patience

Séance 3 & 4 : 29/03

Le but de cette séance est d'installer une plateforme de e-commerce (Prestashop) sur une machine virtuelle IaaS (AWS ou Azure), de la sécuriser et de la surveiller.

  • Créez et démarrez une machine virtuelle (Ubuntu 16.04 LTS ou Ubuntu 18.04 LTS) dans un des IaaS pour lesquels vous avez créés des comptes. Sur AWS, choisissez une machine "gratuite" type 't2.micro' (1 vCPU, 1 GB RAM, 8GB EBS).
  • Notez l'adresse IP publique de la machine et initialisez la variable d'environnement PRESTASHOP_HOST
  • Sauvegardez la clé privée SSH dans le répertoire ~/.ssh de votre machine de développement
  • Installez Docker CE et Docker Compose

Installation

  • DS QUICK (30 minutes) sur la séance 0 (15% de la note globale). !!!!! NE PAS ARRIVER EN RETARD !!!!
  • Recréez ou redémarrez votre machine virtuelle IaaS, si nécessaire
  • Loggez vous sur la machine virtuelle du IaaS par SSH
PRESTASHOP_HOST=123.45.67.89
PRESTASHOP_PRIVKEY=~/.ssh/prestashop.pem
chmod 400 $PRESTASHOP_PRIVKEY
ssh -i $PRESTASHOP_PRIVKEY ubuntu@$PRESTASHOP_HOST
# l'utilisateur peut être différent d'un IaaS à un autre (ubuntu sur AWS).

Démarrage de la plateforme

Créez un répertoire prestashop 

mkdir prestashop

Copiez le fichier docker-compose.yml suivant dans ~/prestashop et corrigez la valeur du PS_DOMAIN, DB_PASSWD, MYSQL_ROOT_PASSWORD, ADMIN_MAIL, et ADMIN_PASSWD. 

# CASIR Cloud 2019 : NOM PRENOM A COMPLETER

version: '2'

services:
    ps-prod-mysql:
        image: mysql:5
        ports:
            - "3306"
        volumes:
            - ./data/mysql:/var/lib/mysql
        environment:
            MYSQL_ROOT_PASSWORD: __MYSQL_SUPER_SECRET_TO_CHANGE__
            MYSQL_DATABASE: prestashop
        restart: always
    ps-prod-prestashop:
        image: prestashop/prestashop:1.7.5.1
        environment:
            PS_INSTALL_AUTO: 1
            DB_PASSWD: __MYSQL_SUPER_SECRET_TO_CHANGE__
            DB_NAME: prestashop
            DB_SERVER: ps-prod-mysql
            PS_DOMAIN: 123.45.67.89:8001
            PS_FOLDER_INSTALL: install
            PS_FOLDER_ADMIN: admin
            ADMIN_MAIL: admin@prestashop.casir.fr
            ADMIN_PASSWD: __SUPER_SECRET_TO_CHANGE__
        ports:
            - "8001:80"
        volumes:
            -  ./data/prestashop:/var/www/html/:delegated
            -  ./data/prestashop/vendor:/var/www/html/vendor
            -  ./data/prestashop/var:/var/www/html/var
        restart: always

# add smtp, nginx, myadmin

Lancez les 2 services de la composition (Prestashop et MySQL) 

mkdir prestashop

cd prestashop
mkdir -p data/mysql
mkdir -p data/prestashop
mkdir -p data/prestashop/var
mkdir -p data/prestashop/vendor
mkdir -p configuration/nginx
mkdir -p ssl_reports

docker-compose up -d
docker-compose logs -f


Supprimez le répertoire d'installation 

sudo rm -fr data/prestashop/install
sudo mv data/prestashop/admin data/prestashop/admin-XXXX


Depuis votre machine, ouvrez les page 

PRESTASHOP_HOST=123.45.67.89
open http://$PRESTASHOP_HOST:8001
open http://$PRESTASHOP_HOST:8001/admin-XXXX

Les crédentiels de l'admin sont admin@prestashop.casir.fr __SUPER_SECRET_TO_CHANGE__

Depuis l'interface d'administration, modifiez le catalogue de produits et le logo du site.

Serveur de mails

Complétez la composition en ajoutant ce container de serveur mail (mailserver.yml) https://github.com/tomav/docker-mailserver

Configurez le nom de domaine du serveur via la console d'administration

Webservices

PRESTASHOP_HOST=123.45.67.89
WEBSERVICES_KEY=DXSLMRV2UFQL5ZE5EJJUXSAB8S7NCGY5
curl http://${WEBSERVICES_KEY}@$PRESTASHOP_HOST:8001/api/addresses
curl http://${WEBSERVICES_KEY}@$PRESTASHOP_HOST:8001/api/addresses/3

Supervision

Sauvegarde périodique de la base de données

Ajoutez à la composition un conteneur qui sauvegarde toutes les 10 minutes la base de données MySQL prestashop.

Les sauvegardes sont placées dans le répertoire ./backup/mysql

Sécurisation

  • Sécurisez les ports de votre VM via la console d'administration du IaaS. N'autorisez que les ports TCP 22, 80, 443, 8001, 3000.
  • Ajouter un conteneur nginx pour sécuriser par SSL l'accès aux services Prestashop au moyen d'un certificat auto-signé.
  • Visualisez le certificat du serveur
openssl s_client -connect $PRESTASHOP_HOST:443 -showcerts
  • Sauvegardez la trace dans ssl_reports/trace-1.txt
  • Vérifiez la qualité de votre configuration SSL avec https://www.ssllabs.com/ssltest/
  • Installez cipherscan (https://github.com/mozilla/cipherscan) pour vérifier et pour analyser votre configuration SSL
  • Sauvegardez le rapport cipherscan dans ssl_reports/report-1.txt
  • Améliorez votre configuration SSL avec https://github.com/mozilla/cipherscan
  • Ajouter un conteneur letencrypt pour générer automatiquement le certificat SSL du conteneur nginx
  • Modifiez la configuration du conteneur nginx pour sécuriser également l'accès à Grafana (utiliser le port 3443).
  • Modifiez les ports autorisés de votre VM via la console d'administration du IaaS. N'autorisez que les ports TCP 22, 80, 443, 3443.
  • Visualisez le certificat du serveur
openssl s_client -connect $PRESTASHOP_HOST:443 -showcerts
  • Sauvegardez la trace dans ssl_reports/trace-2.txt
  • Vérifiez et analysez votre configuration SSL avec cipherscan
  • Sauvegardez le rapport dans ssl_reports/report-2.txt
  • Améliorez la configuration SSL à partir des instructions de cipherscan
  • Vérifiez et analysez votre configuration SSL avec cipherscan
  • Sauvegardez le rapport final dans ssl_reports/report-3.txt

Vous voici presque ingénieur en cyber-sécurité

Ressources

Bonus track (OPTIONNEL) : Serveless Architecture

Testez le déploiement de fonctions simples avec le projet https://github.com/serverless/serverless sur votre compte Azure de votre compte GitHub Student Pack.

Par exemple, Simple HTTP parmi les nombreux exemples après avoir modifier provider.location dans serverless.yml

DM individuel 2018-2019

Noté (70% de la note globale)

A RENDRE LE 9/05/2018 23H59.

Le DM consiste à rendre le résultat des sections "Serveur de mails", "Sécurisation" et "Sauvegarde périodique de la base de données" dans un tarball (Ie .tgz) envoyé par email à mon adresse email avec votre adresse institutionnelle (@etu.univ-grenoble-alpes.fr) et avec le sujet suivant : "[CASIR Cloud 2019] Rendu DM NOM PRENOM" (Prière de bien respecter la consigne : autre chose est traité comme un SPAM). 

cd prestashop
tar czvf ../CASIRCloud2019_DM_NOM_PRENOM.tgz README.md *.yml configuration/nginx ssl_reports

ARCHIVE DM individuel 2017-2018

Noté (70% de la note globale)

A RENDRE LE 9/05/2018 (date limite étendue au 01/06/2018, 23h59, deuxième date limite au 24/06/2018 23H59).

Dépend de ce qui aura été produit durant les séances 1,2,3 & 4.

Réalisations

  1. Générer le rapport de qualité avec le container SonarQube et faire une copie d'écran de la page des métriques dans le rapport. Donner votre avis sur la dette du projet (en 5 lignes max)
  2. Estimer le code généré du projet 'blog' selon la méthode COCOMOII (par exemple en utilisant ce calculateur).
  3. Terminer votre cluster HA en configurant les deux containers HAProxy en mode load balancing vers les 2 processus Spring de JHipster.
  4. Terminer votre cluster HA en configurant les deux containers MySQL en réplication maître-esclave (https://github.com/bergerx/docker-mysql-replication).
  5. Tester le crash d'une machine (voir Chaos Monkey).
  6. Combien de temps êtes vous capables de redémarrer complêment la machine (recréer une machine, refaire toutes les installations, reconfigurer les 2 machines : la survivante et la nouvelle qui a une nouvelle adresse IP).
  7. Installer un container InfluxDB sur la machine virtuelle 1 de votre cluster.
  8. Mettre en place Telegraf sur vos 2 machines virtuelles et configurer le pour qu'ils écrivent le mesure dans la base InfluxDB.
  9. Visualiser les métriques collectées par les démons Telegraf avec une console Chronograf.
  10. Configurer une alerte de surcharge et dépasser de capacité disque avec Kapacitor
  11. Sécuriser SSH de vos 2 VMs avec une authentification à 2 facteurs (How To Set Up Multi-Factor Authentication for SSH on Ubuntu 16.04)
  12. Configurer le firewall de vos 2 machines virtuelles (soit via les IPTables, soit via UFW : Attention UFW a quelques soucis avec Docker). Pour ceux qui maîtrisent Fail2Ban, vous pouvez installer et configurer un container Fail2Ban pour prévenir des ataques "brute force" lors de l'authentification sur le microservice Spring (de JHipster).
  13. Tester la pénétration de vos machines depuis l'extérieur avec un outil comme Security Monkey
  14. (NOUVEAU) Indiquer le service cloud utilisé et joindre au rapport une copie d'écran de la console dans laquelle apparaissent les machines virtuelles créés pour les besoins de votre DM et une copie d'écran de la console de facturation montrant le crédit ou le montant consommé pour les besoins de votre DM.
  15. Conclusion et retour d'expérience (franc) du cours. Proposition(s) d'amélioration (J'en tiendrai compte pour l'amélioration continue de ce compte. Merci).


Rendu par mail (avec copie à Clément et dans le sujet "[CASIR DM Cloud]"):

Un rapport de 15 pages (1 page par étape)

  • avec liste des commandes,
  • extraits pertinents des traces ou des logs,
  • et références vers les documents utilisés (lien web).

Vous pouvez ajouter des annexes à votre rapport.

Remarque: si certains ont entrepris ou réussi des mises en place des anciennes étapes concernant la haute disponibilité (HA = High Avaibility), n'hésitez pas à compléter votre rapport avec des pages supplémentaires.

Bonus track:

ARCHIVE DM 2016-2017

Noté (70% de la note globale)

A RENDRE LE 9/06/2017

Dépend de ce qui aura été produit durant les séances 1,2,3 & 4.

Réalisations

  1. Installer un container InfluxDB sur la machine 1 de votre cluster AWS.
  2. Mettre en place Telegraf sur vos 2 machines AWS et configurer le pour qu'ils écrivent le mesure dans la base InfluxDB.
  3. Visualiser les métriques collectées par les démons Telegraf avec une console Chronograf.
  4. Configurer une alerte de surcharge et dépasser de capacité disque avec Kapacitor
  5. Sécuriser SSH de vos 2 VMs avec une authentification à 2 facteurs (How To Set Up Multi-Factor Authentication for SSH on Ubuntu 16.04)
  6. Configurer le firewall de vos 2 machines (soit via les IPTables, soit via UFW).
  7. Tester la pénétration de vos machines depuis l'extérieur avec un outil comme Security Monkey
  8. Conclusion et retour d'expérience (franc) du cours. Proposition(s) d'amélioration.

Rendu par mail (avec copie à Clément et dans le sujet "[CASIR DM Cloud]"):

Un rapport de 8 pages (1 page par étape)

  • avec liste des commandes,
  • extraits pertinents des traces ou des logs,
  • et références vers les documents utilisés (lien web).

Vous pouvez ajouter des annexes à votre rapport.

Remarque: si certains ont entrepris ou réussi des mises en place des anciennes étapes concernant la haute disponibilité (HA = High Aviability), n'hésitez pas à compléter votre rapport avec des pages supplémentaires.

Bonus track:


Un rapport de 12 pages (1 page par étape)

  • avec liste des commandes,
  • extraits pertinents des traces ou des logs,
  • et références vers les documents utilisés (lien web).

Bonus track:

Retrieved from "https://air.imag.fr/index.php?title=CASIRCloud&oldid=45562"