Supports de cours des formations OpenStack et conteneurs de la société Osones
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cours
images removed useless image Dec 4, 2018
presentation
resources updated vagrant box name Dec 10, 2018
styles updated beamer theme Dec 15, 2017
templates
tp minor fixes Dec 3, 2018
.gitignore updated .gitignore Jun 13, 2018
Makefile
README.md Merge pull request #14 from ameukam/rqmts-build-course Aug 10, 2018
build.sh move to upper level Oct 18, 2018
buildspec.yml
cours.json lowercase course name Dec 10, 2018
modules.dot

README.md

Supports de formation Osones

Build Status

Supports de formation (sous forme de slides) écrits en Français et traduits en Anglais et réalisés par Osones pour ses offres de formation.

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

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

Auteurs :

HTML et PDF construits automatiquement : https://osones.com/formations/

Prérequis

Option 1 : Utiliser le Makefile

Option 2 : Utiliser le script build.sh

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 :

  1. HTML / reveal.js
  2. PDF à partir du HTML / reveal.js
  3. 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 : $0 options

    -o output           Output format (html, pdf or all). If none, all outputs
                        are built

    -t theme            Theme to use, default to osones

    -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://osones.com/formations/revealjs)

    -c course           Courses to build, if not specified all courses are built

If you want to build the courses locally, you'll need to :

Pour visualiser :

  • Lire les fichiers HTML dans cours/output-html/ avec votre navigateur
  • Les PDF se trouvent dans output-pdf/

OU

docker run -d \
            -p 80:8001 \
            -v $PWD/images:/revealjs/images \
            -v $PWD/cours/output-html/$(cours).html:/revealjs/index.html \
            -v $PWD/cours/output-html/revealjs/css/theme:/revealjs/css/theme \
            vsense/revealjs

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 :

Creative Commons BY-SA

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