L'AFPy organise un atelier de contribution à Ansible. Cet atelier se tiendra le 21 novembre 2017 à partir de 19h au NUMA (39 rue du Caire, Paris).
Ansible est un outil libre de configuration et d'orchestration à
destination des administrateurs système , écrit en Python.
Il permet l'automatisation :
- du déploiement d'applications
- de la configuration de serveurs ou équipements réseau.
Cet atelier se déroule sur deux soirs espacés d'une semaine.
Au cours de cet atelier les participants apprendront , avec l'aide de deux contributeurs Ansible (un membre de la core team et un membre du Testing Working Group) à contribuer à des modules Ansible existants.
Cet atelier a pour but de permettre aux participants :
- de corriger eux-mêmes les bugs éventuellement rencontrés par les
participants déjà utilisateurs d'Ansible ;
- d' apprendre à contribuer à un logiciel libre ;
- de mieux comprendre le fonctionnement d'Ansible ;
Les contributions pourront notamment porter sur les aspects suivants :
- vérification, amélioration de la compatibilité des modules avec Python 3
- corrections de bugs existants
- reviews de pull-requests existantes
- ajout de tests :
- tests unitaires (tox/mock)
- tests d'intégration (Docker/LXC)
- amélioration/correction de la documentation
L'atelier débutera par une présentation du "Workflow de contribution" pour
les apprentis contributeurs :
- structure du dépôt Git
- fonctionnement du système d'intégration continue (CI)
- workflows de contribution :
- description des labels GitHub utilisés
- présentation du bot utilisé pour trier les issues et pull requests Github
Cet atelier est ouvert aux développeurs Python débutant avec Ansible.
Pour profiter au maximum de l'atelier, sont requis:
1. un ordinateur avec Python (2.7 ou 3.5),
2. Git
3. un compte GitHub opérationnel , et avoir forké le projet (
https://github.com/ansible/ansible )
4. une installation fonctionnelle d'Ansible à partir des sources
( )
5. savoir lire/écrire un rapport de bug en anglais
Il est fortement recommandé d'avoir lu la Documentation et parcouru le Guide du développeur (en anglais) :)
Une première version de cet atelier s'est déroulée lors des sprints PyConFR
2017, voici la liste des contributions qui ont été réalisées :
- https://github.com/ansible/ansible/pull/30696: pull request rejetée, un
des commits a cependant été accepté :
https://github.com/ansible/ansible/commit/901bc2cffef231194a5710bb068c7218590c5a91
- https://github.com/ansible/ansible/pull/30707: ajout d'un test unitaire
pour le plugin d'inventaire YAML
- https://github.com/ansible/ansible/pull/30710: correctif d'une erreur
Python 3
- https://github.com/ansible/ansible/pull/30713: correctif de la
documentation
- https://github.com/ansible/ansible/pull/30738 correctif du module apt
- https://github.com/ansible/ansible/pull/30742: mise à jour de la liste
des maintainers (pull request mergée)
- https://github.com/ansible/ansible/pull/30747: correctif du module apt
- https://github.com/ansible/ansible/pull/30762: ajout de tests unitaires
pour le module iptables
- https://github.com/ansible/ansible/issues/21182: vérification et
fermeture d'un rapport de bug obsolète (module iptables)
- https://github.com/ansible/ansible/issues/25153: vérification et
fermeture d'un rapport de bug obsolète (module iptables)
- https://github.com/ansible/ansible/issues/29379: vérification et
fermeture d'un rapport de bug obsolète (module iptables)