README.md aktualisiert

README.md

@@ -1,2 +1,28 @@
 # ansible-fte
 
+*worked in Debian 12 [25.03.26]*
+
+### Funktionsweise:
+- ansible verbindet sich via SSH mit Server
+- installiert runner mit token von gitea
+
+# Installation:
+- repo clonen (auf lokale Instanz/Server)
+- ggf. inventory.ini anpassen:
+  - "ansible_host=192.168.0.12" ... IP zum SSH-Client
+  - "ansible_port=4707" SSH Port
+  - "ansible_user=root" SSH User
+  - "ansible_python_interpreter=/usr/bin/python3" ... bleibt unverändert
+- in gitea im repo unter Einstellungen -> Actions -> Runner -> Neuen Runner erstellen -> token kopieren
+- ansible starten mit ansible-playbook -i inventory.ini playbooks/gitea.yml --ask-pass
+  - SSH-Passwort des Servers eingeben
+  - gitea token eingeben
+  - runner-namen/-label angeben
+- *bei erfolgreicher Ausführung sollte unter /opt/runner der Ordner workdir entstehen*
+- Erstellen des Ordners für das repo der zu hostenden Seite (muss in workflow-configs im repo angegeben werden)
+- Erstellen des Ordners der Seite unter /var/www/html/ - z.B. dev.ftecke.de
+- Zugriffsrechte beider Ordner mit chown -R runner:runner ORDNER bearbeiten
+- unter git.ftecke.de prüfen ob runner erstellt wurde
+- im repo unter .gitea/workflows erstellen - z.B. dev.yml
+  - bei "runs-on:" das richtige Label eintragen - z.B. "act-runnerV2"
+- NGINX Webserver einrichten

playbooks/gitea.yml

@@ -8,7 +8,13 @@
       - all
   vars_prompt:
     - name: gitea__runner_token
-      prompt: Input your runner token obtained on https://git.cantorgymnasium.de/org/gcg/settings/actions/runners
+      prompt: Input your runner token obtained on https://git.ftecke.de/user/settings/actions/runners
+      private: false
+    - name: gitea__runner_name
+      prompt: Name of the new runner
+      private: false
+    - name: gitea__runner_labels
+      prompt: Labels of the new runner
       private: false
   tasks:
     - name: Get latest act_runner version
@@ -60,7 +66,7 @@
           - /usr/local/bin/act_runner
           - register
           - --instance
-          - "https://git.cantorgymnasium.de/"
+          - "https://git.ftecke.de/"
           - --name
           - "{{ gitea__runner_name }}"
           - --labels
@@ -86,7 +92,7 @@
         group: root
 
     - name: Enable systemd service
-      ansible.builtin.systemd_service:
+      ansible.builtin.systemd:
         daemon_reload: true
         name: act_runner.service
         enabled: true