Supports de formation Particule

Supports de formation (sous forme de slides) écrits en Français et traduits en Anglais et réalisés originellement par les employés d'alter way Cloud Consulting (ex Osones) et repris depuis 2020 par Particule pour ses offres de formation.

Sont notamment abordés les sujets suivants : le cloud, sa philosophie, le projet Kubernetes, l'administration et l'utilisation de Kubernetes, le principe des conteneurs, l'utilisation de Docker, le projet OpenStack, l'utilisation d'OpenStack, le déploiement d'OpenStack.

Sources : https://github.com/particuleio/formations/

Auteurs originaux :

Adrien Cunin adrien@adriencuin.fr
Pierre Freund pierre.freund@gmail.com
Romain Guichard romain@particule.io
Kevin Lefevre kevin@particule.io
Jean-François Taltavull jftalta@gmail.com

HTML et PDF construits automatiquement : https://particule.io/formations/

OpenStack User PDF/HTML
OpenStack Ops PDF/HTML
Kubernetes User PDF/HTML
Kubernetes Ops PDF/HTML
Cloud PDF/HTML
Docker PDF/HTML

Prérequis

Option 1 : Utiliser le script build.sh

Docker : https://docs.docker.com/install
jq : https://github.com/stedolan/jq

Option 2 : Utiliser le Makefile

make : https://www.gnu.org/software/make/
jq : https://github.com/stedolan/jq
pandoc : https://pandoc.org
TeX Live : https://www.tug.org/texlive/

Fonctionnement

Les supports de formation (slides) sont écrits en Markdown. Chaque fichier dans cours/ est un module indépendant.

cours.json définit les cours à partir des modules.

Il est possible de générer ces slides sous différents formats :

HTML / reveal.js
PDF à partir du HTML / reveal.js
PDF à partir de LaTeX / Beamer

Deux méthodes de build sont disponibles :

build.sh : supporte 1. et 2.
Makefile : supporte 1. et 3.

Build.sh

Le build utilise des conteneurs Docker. L'utilisation de conteneurs Docker ne vise qu'à fournir un environnement stable (version des paquets fixes) et de ne pas "encrasser" le système hôte avec des paquets dont l'utilisation est faible.

Les Dockerfiles des images Docker sont disponibles ici :

Un daemon Docker est donc le seul pré-requis pour le build via build.sh

 USAGE : ./build.sh options

    -o output           Output format (html, pdf or all). Default: all

    -t theme            Theme to use. Default: particule

    -u revealjsURL      RevealJS URL that need to be use. If you build formation
                        supports on local environment you should git
                        clone https://github.com/hakimel/reveal.js and set
                        this variable to your local copy.
                        This option is also necessary even if you only want PDF
                        output. Default: https://particule.io/formations/revealjs

    -c course           Course to build, "all" for build them all !

    -l language         Language in which you want the course to be built. Default: fr

Theme

Les thèmes sont stockés dans styles/. Un thème est constitué de :

un fichier CSS
un dossier (nom du thème) contenant les assets (images, font, etc)

Reveal.js

Par défaut, nous utilisons une version forkée de reveal.js. Pour utiliser votre propre version, vous devez spécifier son chemin avec le paramètre -u. Les fichiers de votre thème seront copiés dans ce chemin. Si le chemin est distant (uptream version par exemple), vous ne pourrez utiliser votre propre thème.

Language

Nous supportons le multi langage. Le script build.sh est conçu pour rebasculer sur le contenu français si le cours n'existe pas dans la langue demandée.

Exemples

./build.sh -c docker -l fr -o html
./build.sh -o pdf
./build.sh -c openstack-user -u ~/reveal.js
./build.sh -c kubernetes-ops -l en -t customer

Les fichiers HTML se trouvent dans output-html/
Les PDF se trouvent dans output-pdf/

En ayant puller au préalable les deux images Docker et en ayant une copie locale de reveal.js (spécifié avec -u), les builds se font uniquement en local.

Makefile

Le build se fait entièrement en local.

Voir le header du Makefile pour les dépendances nécessaires.
Voir make help pour l'utilisation.

Quelques exemples :

make openstack.pdf
make docker-handout.pdf
make docker-print.pdf
make openstack.html

Copyright et licence

Tous les contenus originaux (Makefile, scripts, fichiers dans cours/) sont :

Depuis 2020, tous les commits sont la propriété de leurs auteurs respectifs
Distribués sous licence Creative Commons BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/)

Les autres fichiers du répertoire images/ sont soumis à leur copyright et licence respectifs.

MenelikV / formations