Contribuer à un projet Python libre : l'exemple d'Ansible (1/2)

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+), un système d'exploitation suffisamment récent et supporté par Ansible (cf http://docs.ansible.com/ansible/devel/intro_installation.html#control-machine-requirements , ou Windows avec WSL) : en cas de doute contactez-nous.
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 (http://docs.ansible.com/ansible/devel/dev_guide/developing_modules_general.html#environment-setup )
5. savoir lire/écrire un rapport de bug en anglais

Il est fortement recommandé d'avoir lu la Documentation (http://docs.ansible.com/ansible/devel/intro_getting_started.html) et parcouru le Guide du développeur (http://docs.ansible.com/ansible/devel/dev_guide) (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)