mattandes.jenkins_slave_win
Rôle Ansible : Jenkins Esclave - Windows
Configure un esclave Jenkins sous Windows en utilisant le fichier agent.jar du maître Jenkins. Ce rôle créera un service Windows en utilisant NSSM pour gérer et exécuter automatiquement le fichier agent.jar au démarrage.
Exigences
- Accès administrateur sur le nœud esclave Windows
- Un maître Jenkins en cours d'exécution (le rôle suppose que cela fonctionne à http://localhost:8080)
- Le nœud esclave Windows doit être défini dans la section des nœuds Jenkins, avec le nom du nœud correspondant au nom d'hôte Windows en minuscules.
Variables du Rôle
Les variables disponibles sont listées ci-dessous, avec des valeurs par défaut (voir defaults/main.yml
):
jenkins_slave_win_user: jenkins
L'utilisateur Windows sous lequel l'esclave Jenkins doit s'exécuter.
jenkins_slave_win_password: jenkins
Le mot de passe pour l'utilisateur Windows sous lequel l'esclave Jenkins s'exécutera.
jenkins_slave_win_create_user: true
Détermine si l'utilisateur Jenkins spécifié doit être créé en tant que compte utilisateur local Windows.
jenkins_slave_win_dir: "C:\\Jenkins"
Le répertoire que l'esclave Jenkins doit utiliser pour son travail. Idéalement, cela devrait correspondre au paramètre Répertoire racine distant
dans la configuration du nœud sur le maître Jenkins. Ce répertoire sera créé s'il n'existe pas déjà.
jenkins_slave_win_jenkins_url: http://localhost:8080
L'URL pour le maître Jenkins auquel cet esclave doit se connecter. Le rôle s'attend à ce que le nœud soit déjà défini sur le maître, de préférence via le plugin JSasC.
jenkins_slave_win_jenkins_user: admin
L'utilisateur pour se connecter au maître Jenkins afin de récupérer le mot de passe du nœud. Doit être un compte capable de gérer la section des nœuds.
jenkins_slave_win_jenkins_password: admin
Le mot de passe pour l'utilisateur se connectant au maître Jenkins.
jenkins_slave_win_java_args: "-Xmx768m"
Variable utilisée pour passer des arguments Java supplémentaires au processus de l'agent esclave lors de son démarrage.
Dépendances
Aucune.
Exemple de Playbook
- hosts: jenkins-slaves-win
become: yes
vars:
jenkins_slave_win_jenkins_url: "http://jenkins:8080"
roles:
- role: mattandes.jenkins_slave_win
Licence
MIT
Ansible role to setup a Jenkins Windows slave installed as a service via NSSM
ansible-galaxy install mattandes.jenkins_slave_win