Switch to English for documentation and comments

apt-upgrade/README.md

@@ -1,13 +1,13 @@
 # apt-upgrade
 
-Mise à jour des paquets APT.
+Upgrades Debian packages
 
-## Taches
+## Tasks
 
-L'ensemble des actions est dans le fichier `tasks/main.yml`
+Everything is in the `tasks/main.yml` file.
 
-## Variables possibles
+## Available variables
 
-* `apt_upgrade_mode` : indique le type de mise à jour, `safe` par défaut (cf. http://docs.ansible.com/ansible/apt_module.html#options)
+* `apt_upgrade_mode` : kind of upgrade to do (cf. http://docs.ansible.com/ansible/apt_module.html#options)
 
-Le choix peut se faire dans un fichier de variables (par exemple `vars/main.yml`) ou bien lors de l'appel du rôle (`- { role: apt-upgrade, apt_upgrade_mode: safe }`)
+Choice of upgrade mode can be set in a variables file (ex. `vars/main.yml`) or when invoking the role (`- { role: apt-upgrade, apt_upgrade_mode: safe }`).

apt-upgrade/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-- name: Debian is up-to-date
+- name: Ensure Debian is up-to-date
   apt:
     update_cache: yes
     upgrade: "{{ apt_upgrade_mode | default('safe') }}"

monit/README.md

@@ -1,14 +1,14 @@
 # monit
 
-Installation de Monit et ajout d'une configuration personnalisée.
+Install Monit.
 
-## Taches
+## Tasks
 
-L'ensemble des actions est dans le fichier `tasks/main.yml`
+Everything is in the `tasks/main.yml` file.
 
-## Variables possibles
+## Available variables
 
-* `monit_daemon_time` : délai d'exécution des vérifications (en secondes)
+* `monit_daemon_time` : execution frequency (in seconds) ;
-* `monit_httpd_enable` : activation du serveur http intégré (`true`/`false`)
+* `monit_httpd_enable` : integrated http server enabled or not ;
-* `monit_httpd_port` : port d'écoute pour le serveur http
+* `monit_httpd_port` : TCP port of http server ;
-* `monit_httpd_allow_items` : liste des IP/hosts autorisés à se connecter
+* `monit_httpd_allow_items` : IP/hosts allow to conenct to http server.

munin/README.md

@@ -1,11 +1,11 @@
 # munin
 
-Installation de Munin et changement de quelques plugins.
+Install Munin and enables/diables some default plugins.
 
-## Taches
+## Tasks
 
-L'ensemble des actions est dans le fichier `tasks/main.yml`
+Everything is in the `tasks/main.yml` file.
 
-## Variables possibles
+## Available variables
 
-Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
+The only variables are related to the hostname (short and fully qualified) and are derived from gathered facts.

mysql/README.md

@@ -1,29 +1,27 @@
 # mysql
 
-Installation de MySQL, une configuration type Evolix et quelques outils.
+Install MySQL
 
-## Taches
+## Tasks
 
-Les taches sont éclatées dans différents fichiers, inclus dans `tasks/main.yml` :
+Tasks are extracted in several files, included in `tasks/main.yml` :
 
-* `packages.yml` : installation des paquets
+* `packages.yml` : packages installation ;
-* `users.yml` : remplacement de l'utilisateur `root` par `mysqladmin`
+* `users.yml` : replacement of `root` user by `mysqladmin` user ;
-* `config.yml` : copie des configurations
+* `config.yml` : configurations ;
-* `datadir.yml` : configuration du dossier de travail
+* `datadir.yml` : data directory customization ;
-* `tmpdir.yml` : configuration du dossier temporaire
+* `tmpdir.yml` : temporary directory customization ;
-* `nrpe.yml` : utilisateur `nrpe` pour checks Nagios
+* `nrpe.yml` : `nrpe` user for Nagios checks ;
-* `munin.yml` : activation des plugins Munin
+* `munin.yml` : Munin plugins ;
-* `log2mail.yml` : recettes log2mail
+* `log2mail.yml` : log2mail patterns ;
-* `utils.yml` : installation d'outils utiles
+* `utils.yml` : useful tools.
 
-## Variables possibles
+## Available variables
 
-Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
+* `mysql_replace_root_with_mysqladmin`: switch from `root` to `mysqladmin` user or not ;
+* `mysql_thread_cache_size`: number of threads for the cache ;
+* `mysql_innodb_buffer_pool_size`: amount of RAM dedicated to InnoDB ;
+* `mysql_custom_datadir`: custom datadir
+* `mysql_custom_tmpdir`: custom tmpdir.
 
-* `mysql_replace_root_with_mysqladmin`: remplacement de `root` par `mysqladmin` – `true` par défaut
+NB : changing the _datadir_ location can be done multiple times, as long as it is not restored to the default initial location, (because a symlink is created  and can't be switched back, yet).
-* `mysql_thread_cache_size`: nombre de threads pour le cache – nombre de vCPU par défaut
-* `mysql_innodb_buffer_pool_size`: taille du buffer InnoDB – 30% de la RAM installée par défaut
-* `mysql_custom_datadir`: le dossier de travail personnalisé
-* `mysql_custom_tmpdir`: le dossier temporaire personnalisé
-
-NB : le changement de _datadir_ peut se faire plusieurs fois, tant qu'on ne revient pas vers la valeur par défaut (car une fois déplacé un lien symbolique est créé au point de départ).

rbenv/README.md

@@ -1,22 +1,22 @@
 # munin
 
-Installation de Rbenv, Ruby et des gems par défaut.
+Install Rbenv, Ruby and some default gems.
 
-## Taches
+## Tasks
 
-L'ensemble des actions est dans le fichier `tasks/main.yml`
+Everything is in the `tasks/main.yml` file.
 
-## Variables possibles
+## Available variables
 
 Les seules variables sont liées au hostname (court et complet) qui sont simplement déduites des facts.
 
-* `rbenv_version`: version de Rbenv à installer, `v1.0.0` par défaut
+* `rbenv_version`: Rbenv version to install ;
-* `rbenv_ruby_version`: version de Ruby à installer, `2.3.1` par défaut
+* `rbenv_ruby_version`: Ruby version to install ;
-* `rbenv_root`: dossier d'installation, `~/.rbenv` par défaut
+* `rbenv_root`: install path for Rbenv ;
-* `rbenv_repo`: source Git pour Rbenv
+* `rbenv_repo`: repository location ;
-* `rbenv_plugins`: liste des plugins Rbenv à installer
+* `rbenv_plugins`: list of Rbenv plugins to install.
 
-Le rôle doit être ajouté en indiquant l'utilisateur concerné :
+The role must be specified with a `username` variable :
 
 ```
 roles:

rbenv/tasks/main.yml

@@ -1,6 +1,6 @@
 ---
 
-- name: install rbenv dependencies
+- name: Rbenv dependencies are installed
   apt:
     pkg: '{{ item }}'
     install_recommends: no
@@ -19,7 +19,7 @@
     - rbenv
     - packages
 
-- name: checkout rbenv_repo for {{ username }}
+- name: Rbenv repository is checked out for {{ username }}
   git:
     repo: '{{ rbenv_repo }}'
     dest: '{{ rbenv_root }}'
@@ -31,7 +31,7 @@
   tags:
     - rbenv
 
-- name: create plugins directory for {{ username }}
+- name: plugins directory for {{ username }}
   file:
     path: '{{ rbenv_root }}/plugins'
     state: directory
@@ -40,7 +40,7 @@
   tags:
     - rbenv
 
-- name: install plugins for {{ username }}
+- name: plugins are installed for {{ username }}
   git:
     repo: '{{ item.repo }}'
     dest: '{{ rbenv_root }}/plugins/{{ item.name }}'
@@ -54,7 +54,7 @@
   tags:
     - rbenv
 
-- name: Init rbenv in profile for {{ username }}
+- name: Rbenv is initialized in profile for {{ username }}
   become_user: "{{ username }}"
   blockinfile:
     dest: '~{{ username }}/.profile'
@@ -63,7 +63,7 @@
       eval "$(rbenv init -)"
     marker: "# {mark} ANSIBLE MANAGED RBENV INIT"
 
-- name: set default-gems for {{ username }}
+- name: default gems are installed for {{ username }}
   copy:
     src: default-gems
     dest: '{{ rbenv_root }}/default-gems'
@@ -72,7 +72,7 @@
   tags:
     - rbenv
 
-- name: set gemrc for {{ username }}
+- name: gemrc for {{ username }}
   copy:
     src: gemrc
     dest: ~/.gemrc
@@ -81,7 +81,7 @@
   tags:
     - rbenv
 
-- name: check ruby {{ rbenv_ruby_version }} installed for {{ username }}
+- name: is Ruby {{ rbenv_ruby_version }} available for {{ username }} ?
   shell: /bin/bash -lc "rbenv versions | grep {{ rbenv_ruby_version }}"
   become_user: "{{ username }}"
   register: ruby_installed
@@ -91,7 +91,7 @@
   tags:
     - rbenv
 
-- name: install ruby {{ rbenv_ruby_version }} for {{ username }}
+- name: Ruby {{ rbenv_ruby_version }} is available for {{ username }}
   shell: /bin/bash -lc "TMPDIR=~/tmp rbenv install {{ rbenv_ruby_version }}"
   become_user: "{{ username }}"
   when: ruby_installed.rc != 0
@@ -99,7 +99,7 @@
   tags:
     - rbenv
 
-- name: check if user ruby version is {{ rbenv_ruby_version }} for {{ username }}
+- name: is Ruby {{ rbenv_ruby_version }} selected for {{ username }} ?
   shell: /bin/bash -lc "rbenv version | cut -d ' ' -f 1 | grep -Fx '{{ rbenv_ruby_version }}'"
   become_user: "{{ username }}"
   register: ruby_selected
@@ -109,7 +109,7 @@
   tags:
     - rbenv
 
-- name: set ruby {{ rbenv_ruby_version }} for {{ username }}
+- name: select Ruby {{ rbenv_ruby_version }} for {{ username }}
   shell: /bin/bash -lc "rbenv global {{ rbenv_ruby_version }} && rbenv rehash"
   become_user: "{{ username }}"
   when: ruby_selected.rc != 0

redis/README.md

@@ -1,23 +1,23 @@
 # munin
 
-Installation de Redis.
+Install Redis with sensible configuration.
 
-Rôle basé sur https://github.com/geerlingguy/ansible-role-redis
+This role is based on https://github.com/geerlingguy/ansible-role-redis
 
-## Taches
+## Tasks
 
-L'ensemble des actions est dans le fichier `tasks/main.yml`
+Everything is in the `tasks/main.yml` file.
 
-## Variables possibles
+## Available variables
 
-Les variables principales sont :
+Main variables are :
 
-* `redis_daemon`: nom du processus
+* `redis_daemon`: name of the process ;
-* `redis_conf_path`: emplacement du fichier de config
+* `redis_conf_path`: config file location ;
-* `redis_port`: port TCP d'écoute
+* `redis_port`: listening TCP port ;
-* `redis_bind_interface`: IP d'écoute
+* `redis_bind_interface`: listening IP address ;
-* `redis_unixsocket`: socket Unix écouté
+* `redis_unixsocket`: Unix socket ;
-* `redis_loglevel`: verbosité des logs
+* `redis_loglevel`: log verbosity ;
-* `redis_logfile`: emplacement du fichier de log
+* `redis_logfile`: log file location.
 
-La liste complète est disponible dans `defaults/main.yml`.
+The full list of variables (with default values) can be found in `defaults/main.yml`.

redis/tasks/main.yml

@@ -1,5 +1,5 @@
 ---
-- name: Ensure redis is installed.
+- name: Redis is installed.
   apt:
     name: redis-server
     state: installed
@@ -7,7 +7,7 @@
     - redis
     - packages
 
-- name: Ensure Redis is configured.
+- name: Redis is configured.
   template:
     src: redis.conf.j2
     dest: "{{ redis_conf_path }}"
@@ -16,7 +16,7 @@
   tags:
     - redis
 
-- name: Ensure redis is running and enabled on boot.
+- name: Redis is running and enabled on boot.
   service:
     name: "{{ redis_daemon }}"
     enabled: yes