https://github.com/puzzle/ansible-training

Puzzle ITC Ansible Training
https://github.com/puzzle/ansible-training

ansible hugo techlab

Last synced: 3 days ago
JSON representation

Puzzle ITC Ansible Training

• Host: GitHub
• URL: https://github.com/puzzle/ansible-training
• Owner: puzzle
• License: agpl-3.0
• Created: 2019-12-05T16:11:13.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2023-11-20T12:55:47.000Z (12 months ago)
• Last Synced: 2023-11-20T13:50:42.661Z (12 months ago)
• Topics: ansible, hugo, techlab
• Language: HTML
• Homepage: https://ansible.puzzle.ch
• Size: 12.4 MB
• Stars: 10
• Watchers: 5
• Forks: 15
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Puzzle ITC Ansible Training

In the guided hands-on training, participants are able to learn the basics of [Ansible](https://www.ansible.com/).

For more see [Puzzle Ansible Training online](https://ansible.puzzle.ch/).

:rocket: Changing IT for the better with Ansible!

## Content Sections

The training content resides within the [content](content) directory.

The main part are the labs, which can be found at [content/en/docs](content/en/docs).

## Hugo

This site is built using the static page generator [Hugo](https://gohugo.io/).

The page uses the [docsy theme](https://github.com/google/docsy) which is included as a Git Submodule.

Docsy is being enhanced using [docsy-plus](https://github.com/acend/docsy-plus/) as well as [docsy-puzzle](https://github.com/puzzle/docsy-puzzle/).

After cloning the main repo, you need to initialize the submodules:

```bash

git submodule update --init --recursive

```

In order to update all submodules, run the following command:

```bash

git pull --recurse-submodules

```

### Docsy Theme Usage

* [Official docsy documentation](https://www.docsy.dev/docs/)

* [Docsy Plus](https://github.com/acend/docsy-plus/)

### Update submodules for theme updates

Run the following command to update all submodules with their newest upstream version:

```bash

git submodule update --remote

```

## Build using Docker

Build the image:

```bash

docker build . -t puzzle/ansible-techlab:latest

```

Run it locally:

```bash

docker run -i -p 8080:8080 puzzle/ansible-techlab

```

## Contributions

If you find errors, bugs or missing information, please help us improve our training and have a look at the [Contribution Guide](CONTRIBUTING.md).