diff --git a/README.md b/README.md index 8ea9782..770525f 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,63 @@ # Beispiel Ansible +## Erste schritte + +```sh +# Installiere ansible +apt update +apt install -y ansible + +# Kopiere die "skeleton" rolle +cp -r roles/{skeleton,webserver} + +# Editiere die inventory datei +$EDITOR inventory +``` + +Wenn die rolle kopiert ist, musst du sie in der `site.yml` noch importieren: + +```yaml +- name: Import webserver role + hosts: + - all + roles: + - webserver +``` + +## Relevante befehle/tasks + +### Rolle ausführen + +```sh +# Auf deinem Rechner +ansible-playbook site.yml +``` + +### Webserver neuladen + +```sh +# Auf dem Raspi +sudo nginx -s reload +``` + +(oder) + +```yaml +# In deiner Rolle +- name: Reload nginx + ansible.builtin.systemd_service: + name: nginx + state: reloaded +``` + ## TODO -- [ ] Write a proper readme for the poor intern cursed with this playbook +- [ ] Installiere einen Webserver (apache/traefik/nginx/lighttpd) +- [ ] Serviere `files/index.html` (unter `/var/www/html/index.html` ablegen) +- [ ] Bonusaufgabe: aktiviere eine Password-Authentifizierung (Basic Auth) + +## Relevante Dokumentation + +- [Paket Installieren](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/package_module.html) +- [Datei kopieren](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/file_module.html) +- [NGINX basic auth](https://docs.nginx.com/nginx/admin-guide/security-controls/configuring-http-basic-authentication/) diff --git a/files/index.html b/files/index.html new file mode 100644 index 0000000..eafa957 --- /dev/null +++ b/files/index.html @@ -0,0 +1 @@ + diff --git a/roles/skeleton/defaults/main.yml b/roles/skeleton/defaults/main.yml index 2a274ce..e4dd2d2 100644 --- a/roles/skeleton/defaults/main.yml +++ b/roles/skeleton/defaults/main.yml @@ -1,2 +1,2 @@ --- -# defaults file for basic +# defaults file for skeleton diff --git a/roles/skeleton/handlers/main.yml b/roles/skeleton/handlers/main.yml index f5945c9..61e51c3 100644 --- a/roles/skeleton/handlers/main.yml +++ b/roles/skeleton/handlers/main.yml @@ -1,2 +1,2 @@ --- -# handlers file for basic +# handlers file for skeleton diff --git a/roles/skeleton/tasks/main.yml b/roles/skeleton/tasks/main.yml index acd3852..fe9d342 100644 --- a/roles/skeleton/tasks/main.yml +++ b/roles/skeleton/tasks/main.yml @@ -1,2 +1,2 @@ --- -# tasks file for basic +# tasks file for skeleton diff --git a/roles/skeleton/vars/main.yml b/roles/skeleton/vars/main.yml index 1cfa44d..ae6e975 100644 --- a/roles/skeleton/vars/main.yml +++ b/roles/skeleton/vars/main.yml @@ -1,2 +1,2 @@ --- -# vars file for basic +# vars file for skeleton diff --git a/site.yml b/site.yml index 89cf661..3a781d9 100644 --- a/site.yml +++ b/site.yml @@ -1,6 +1,6 @@ --- -- name: Import example role - hosts: - - all - roles: - - example +# - name: Import skeleton role +# hosts: +# - all +# roles: +# - skeleton