adfinis/adsy-trainings

Workshop and training materials

Adfinis SyGroup AG Trainings

This are the source files for our trainings. For the builded versions, see: https://docs.adfinis-sygroup.ch/public/trainings

How to clone the git repository

For read-write clone it over ssh

git clone --recursive [email protected]:adfinis-sygroup/adsy-trainings.git

or for read-only over https

git clone --recursive https://github.com/adfinis-sygroup/adsy-trainings.git

How to create a new training

Each training has three unique parts

• Name of the training

• Name of the module

• A unique ID

  $ ./adsy-trainings-common.src/new-training.sh <training name> <module name> <id>

• Edit <training-name>/<id>_<module-name>/modul_<module-name>_<id>.yml to your needs. This file is required to build the training.

• Add your training content

  • All images need to be in a subdirectory of <training-name>/<id>_<module-name>/, e.g. <training-name>/<id>_<module-name>/, otherwise they will not be displayed when built

  • Make sure to only use non-copyrighted materials

• Check if your training looks like you wish.

  cd <training-name>/<id>_<module-name>/

  make

• Add the files to the git repository and push it. After a few minutes, the new training should be available at https://docs.adfinis-sygroup.ch/public/trainings

adsy-trainings's Issues

Docker Slides - pandoc warning: Could not parse YAML header

When rendering the slides for the Docker Workshop the following warning is printed:

Building: docker-workshop/2001_basics
   > modul_basics_2001_01_slides.html
[pandoc warning] Could not parse YAML header: did not find expected alphabetic or numeric character "source" (line 29, column 2)
   > modul_basics_2001_03_handson.html
   > modul_basics_2001_04_check.html
   > modul_basics_2001_01_slides.pdf

[9002_components] Explain acronyms CC and BBS beforehand

see comment:

#54 (comment)

Missing LICENSE

This repository currently doesn't provide LICENSE information.

[2003_dockermanagement] Hands-On does not work with Docker-compose Version 2 or 3

[2004_swarm & 2003_docker-compose] handson redis-server --appendonly yes command needed

Translate Docker workshop checks to English

All Docker workshop check slides are in German.

We should translate those to English.

Make does not work out of the box

Before being able to properly render the slides by executing make some manual workarounds are required:

• build directory has to be created
• The commons sources are copied to adsy-trainings/build/commons/adsy-trainings-common.src but this won't work. I had to move the whole content to adsy-trainings/build/commons

[9004_operation] text instead of images

susecap-workshop/9004_operation/static/asg.png

Create text from this files.

Update Ansible workshop slides regarding roles

Ansible 2.4 introduced changes to the way roles can be imported in playbooks. We should review how this changes the section in the workshop regarding the roles syntax and logic.

[9100_basics] Add information about `count`

Currently information about working with count in a resource is missing.

Missing Images when building

The following images are not found while building:

suse-system-administration/1001_systemd/pics_02/killandrestart.png
suse-system-administration/1004_grub2/demo1.png
suse-system-administration/1004_grub2/demo2.png
suse-system-administration/1004_grub2/demo3.png
suse-system-administration/1004_grub2/demo4.png
suse-system-administration/1004_grub2/demo5.png
suse-system-administration/1004_grub2/demo6.png
suse-system-administration/1004_grub2/demo7.png
suse-system-administration/1004_grub2/demo8.png
suse-system-administration/1004_grub2/demo9.png
suse-system-administration/1004_grub2/demo10.png
suse-system-administration/1004_grub2/demo11.png
suse-system-administration/1004_grub2/demo12_1.png
suse-system-administration/1004_grub2/demo12_2.png
suse-system-administration/1004_grub2/demo13.png
suse-system-administration/1008_dracut/pics/demo1.png
suse-system-administration/1008_dracut/pics/demo2.png
suse-system-administration/1008_dracut/pics/demo3.png
suse-system-administration/1009_wicked/wicked1.png
suse-system-administration/1009_wicked/wicked2.png

Please make sure that the images are in a subdirectory of the trainings. For example suse-system-administration/1004_grub2/demo1.png will not work, the images needs to be for example in the following directory: suse-system-administration/1004_grub2/images

WORKDIR missing in docker-workshop/2002_dockerfile

WORKDIR Command missing in 2002_dockerfile Module.

PDF Rendering Issue

Code markups (`) using back ticks are not rendered properly in the PDF output. See the Foreman training modul_basics_5001_01_slides.pdf, slide / page 34.

Make target for specific slidedecks

It would be nice to have a make target which accepts a slidedeck name to only render this specific decks. Otherwise all decks are created by default which takes a while.

[9100_basics] Add information about semver

We should add a section explaining semver (https://semver.org)

Could also be a full standalone training, as semver can get quite complicated and in a lot of cases it would make sense to explain it properly (and not related to terraform).