mattandes.jenkins_slave_win
Ansible-Rolle: Jenkins Slave - Windows
Diese Rolle konfiguriert einen Jenkins Windows Slave, der die agent.jar-Datei vom Jenkins Master verwendet. Diese Rolle erstellt einen Windows-Dienst mit NSSM, um die agent.jar-Datei beim Start automatisch auszuführen.
Anforderungen
- Administratorzugang auf dem Windows-Slave-Knoten
- Ein laufender Jenkins Master (Standardmäßig wird angenommen, dass dieser unter http://localhost:8080 läuft)
- Der Windows-Slave-Knoten sollte im Jenkins-Knotenteil definiert sein, mit einem Namen, der dem Windows-Hostname in Kleinbuchstaben entspricht
Rollenvariablen
Verfügbare Variablen sind unten aufgelistet, zusammen mit Standardwerten (siehe defaults/main.yml
):
jenkins_slave_win_user: jenkins
Der Windows-Benutzer, unter dem der Jenkins Slave ausgeführt werden soll.
jenkins_slave_win_password: jenkins
Das Passwort für den Windows-Benutzer, unter dem der Jenkins Slave ausgeführt wird.
jenkins_slave_win_create_user: true
Bestimmt, ob der angegebene Jenkins-Benutzer als lokales Windows-Benutzerkonto erstellt werden soll.
jenkins_slave_win_dir: "C:\\Jenkins"
Das Verzeichnis, das der Jenkins Slave für seine Arbeit verwenden soll. Idealerweise sollte dies mit den Einstellungen für das Remote root directory
im Knotenkonfigurationsbereich des Jenkins Masters übereinstimmen. Dieses Verzeichnis wird erstellt, falls es noch nicht existiert.
jenkins_slave_win_jenkins_url: http://localhost:8080
Die URL für den Jenkins Master, mit dem sich dieser Slave verbinden soll. Die Rolle erwartet, dass der Knoten bereits auf dem Master definiert ist, vorzugsweise über das JSasC Plugin.
jenkins_slave_win_jenkins_user: admin
Der Benutzer, der sich mit dem Jenkins Master verbindet, um das Secret des Knotens abzurufen. Sollte ein Konto sein, das in der Lage ist, den Knotenteil zu verwalten.
jenkins_slave_win_jenkins_password: admin
Das Passwort für den Benutzer, der sich beim Jenkins Master anmelden soll.
jenkins_slave_win_java_args: "-Xmx768m"
Variable, die verwendet wird, um zusätzliche Java-Argumente an den Slave-Agent-Prozess bei dessen Start zu übergeben.
Abhängigkeiten
Keine.
Beispiel-Playbook
- hosts: jenkins-slaves-win
become: yes
vars:
jenkins_slave_win_jenkins_url: "http://jenkins:8080"
roles:
- role: mattandes.jenkins_slave_win
Lizenz
MIT
Ansible role to setup a Jenkins Windows slave installed as a service via NSSM
ansible-galaxy install mattandes.jenkins_slave_win