From b0fbf7097ac6b515311f6b8b143027280eb50798 Mon Sep 17 00:00:00 2001
From: ulif <uli@gnufix.de>
Date: Thu, 23 Apr 2020 14:38:14 +0200
Subject: [PATCH] Update README, add basic maintenance.

Also add a first playbook for checking the general ansible setup.
---
 .gitignore    |  3 +++
 README.md     | 33 ++++++++++++++++++++++++++++++++-
 bbb-check.yml | 14 ++++++++++++++
 hosts         |  9 +++++++++
 vault         | 10 ++++++++++
 5 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 .gitignore
 create mode 100644 bbb-check.yml
 create mode 100644 hosts
 create mode 100644 vault

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..cffe130
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+authorized_keys
+vault.pwd
+*~
diff --git a/README.md b/README.md
index d7dbbed..a1d6db3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,34 @@
 # bbb-dc-ansible
 
-Ansible playbooks zur Installation von BigBlueButton
\ No newline at end of file
+Ansible Playbooks zur Installation von BigBlueButton
+
+Basierend auf Skripten des fantastischen Projekts [Digital souveräne Schule](https://lehrerfortbildung-bw.de/st_digital/medienwerkstatt/dossiers/bbb/index.html) in
+Baden-Württemberg:
+
+  https://codeberg.org/DigitalSouveraeneSchule/bbb
+
+Wir administrieren mit diesen Skripten unsere eigenen BigBlueButton-Server.
+
+## Installation BBB
+
+* Einen oder mehrere Server mit Ubuntu 16.04 mit IPv4 Adresse
+* DNS Einträge für alle Server müssen angelegt sein (z.B. bbb1.meinserver.de, bbb2.andererpc.de)
+* Sicherstellen, dass man sich mit SSH-Key auf den Server verbinden kann und dort sudo-Rechte hat
+* Anpassen der Einstellungen für die BBB Version und den Turn-Server im Playbook wenn nötig.
+* Wenn man mehrere Maschinen ausrollen möchte, kann man ein Inventory File anlegen und mit ``ansible-playbook -i hosts bbb-install.yml --ask-vault-pass`` alle Maschinen auf einmal installieren.
+* Wenn man nur eine Maschine installieren möchte kann man das ohne Inventory tun: ``ansible-playbook -i "bbb.q-gym.de," bbb-install.yml --ask-vault-pass``
+
+*Grundsätzliche Unterschiede unseres Setups zum Setup des DSS-Projekts:*
+
+* Wir benutzen keinen SSH-Root-Zugriff auf die Server
+* Sicherstellen, dass man sich als gewöhnliche Userin mit SSH-Key mit dem Server verbinden kann und dort `sudo`-Rechte hat
+* Wir benutzen nur `greenlight`, kein `Moodle`.
+
+## Under Construction
+
+**Im Moment ist dieses Projekt im Aufbau und die Informationen hier daher sehr
+unvollständig. Wenn dieser Hinweis hier verschwunden ist, sollte alles
+benutzbar sein.  Vorher bitten wir von nicht total dringenden Rückfragen
+abzusehen, um unseren Arbeitsdruck zu mildern.**
+
+ulif + datenzwerg.in
diff --git a/bbb-check.yml b/bbb-check.yml
new file mode 100644
index 0000000..9f3326b
--- /dev/null
+++ b/bbb-check.yml
@@ -0,0 +1,14 @@
+- name: Check BBBs
+  hosts: bigbluebutton
+  become: yes
+  tasks:
+    - name: Run BBB status check
+      command: /usr/bin/bbb-conf --status
+      register: status
+      changed_when: status.stdout_lines | length != 13 or status.stdout is search('inactive') or status.stdout is search('failed')
+
+    - name: show output
+      debug:
+        msg: "{{ status.stdout_lines }}"
+      when: status.stdout_lines | length != 13 or status.stdout is search('inactive') or status.stdout is search('failed')
+      failed_when: status.stdout_lines | length != 13 or status.stdout is search('inactive') or status.stdout is search('failed')
diff --git a/hosts b/hosts
new file mode 100644
index 0000000..4f15cbb
--- /dev/null
+++ b/hosts
@@ -0,0 +1,9 @@
+$ANSIBLE_VAULT;1.1;AES256
+63663133373665666333353235393832333633666465383439303838303439373563343364636333
+3735653764653436386361346337653936653161656633350a336262326335323964366261373433
+32663538636666376135623864383630623966363530616366313937653230333037393432313432
+3133363063356238610a313836663233393530316633313865653231613635636332353031393864
+64343866666362363765626664383962363033336363343764653163343132336361303337356235
+34373436656532323836386662646364666235313031326531323431323764613936363563363534
+62396666313464616131633839386230666136636334306364663232633861353636396362633161
+62653366333962323638
diff --git a/vault b/vault
new file mode 100644
index 0000000..58f4a76
--- /dev/null
+++ b/vault
@@ -0,0 +1,10 @@
+$ANSIBLE_VAULT;1.1;AES256
+32373862623663343063306262393337323066303935633933353635313161343935656238663966
+3462386663366266343762383762306431616233636439340a356435386238386234623433646539
+36646365366261373633653062663735363161386536363162396161383466303535643930653937
+3466383563376431370a396234333361303337343634333136363466313562336163646164393838
+39613565366435303564356134336266323763643333343638353936303832386134623435383363
+30323735393665633532646465626133663262643564373331666533306664313864313534616230
+65353633643734343064633962346330663563636331313434356166393134373565373131653735
+62366337313839303362363261613439323938643463383931373566633934373031656136356563
+32356538386530663535333264643933636535346263353733633363393964643666
-- 
GitLab