From 953c27a866710608e003b9d0cce563e131f3899b Mon Sep 17 00:00:00 2001 From: Jeremy Lecour Date: Fri, 30 Sep 2016 09:48:41 +0200 Subject: [PATCH] Switch to English for documentation and comments --- apt-upgrade/README.md | 12 ++++++------ apt-upgrade/tasks/main.yml | 2 +- monit/README.md | 16 +++++++-------- munin/README.md | 10 +++++----- mysql/README.md | 40 ++++++++++++++++++-------------------- rbenv/README.md | 20 +++++++++---------- rbenv/tasks/main.yml | 22 ++++++++++----------- redis/README.md | 28 +++++++++++++------------- redis/tasks/main.yml | 6 +++--- 9 files changed, 77 insertions(+), 79 deletions(-) diff --git a/apt-upgrade/README.md b/apt-upgrade/README.md index e50dc9c0..0b7ac94b 100644 --- a/apt-upgrade/README.md +++ b/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 }`). diff --git a/apt-upgrade/tasks/main.yml b/apt-upgrade/tasks/main.yml index 2c3bf879..c93e9b54 100644 --- a/apt-upgrade/tasks/main.yml +++ b/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') }}" diff --git a/monit/README.md b/monit/README.md index 44db7011..78e19dbb 100644 --- a/monit/README.md +++ b/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_httpd_enable` : activation du serveur http intégré (`true`/`false`) -* `monit_httpd_port` : port d'écoute pour le serveur http -* `monit_httpd_allow_items` : liste des IP/hosts autorisés à se connecter +* `monit_daemon_time` : execution frequency (in seconds) ; +* `monit_httpd_enable` : integrated http server enabled or not ; +* `monit_httpd_port` : TCP port of http server ; +* `monit_httpd_allow_items` : IP/hosts allow to conenct to http server. diff --git a/munin/README.md b/munin/README.md index 0c531bac..5bdc034c 100644 --- a/munin/README.md +++ b/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. diff --git a/mysql/README.md b/mysql/README.md index 9e641ec2..61d94595 100644 --- a/mysql/README.md +++ b/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 -* `users.yml` : remplacement de l'utilisateur `root` par `mysqladmin` -* `config.yml` : copie des configurations -* `datadir.yml` : configuration du dossier de travail -* `tmpdir.yml` : configuration du dossier temporaire -* `nrpe.yml` : utilisateur `nrpe` pour checks Nagios -* `munin.yml` : activation des plugins Munin -* `log2mail.yml` : recettes log2mail -* `utils.yml` : installation d'outils utiles +* `packages.yml` : packages installation ; +* `users.yml` : replacement of `root` user by `mysqladmin` user ; +* `config.yml` : configurations ; +* `datadir.yml` : data directory customization ; +* `tmpdir.yml` : temporary directory customization ; +* `nrpe.yml` : `nrpe` user for Nagios checks ; +* `munin.yml` : Munin plugins ; +* `log2mail.yml` : log2mail patterns ; +* `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 -* `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). +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). diff --git a/rbenv/README.md b/rbenv/README.md index 6366273b..645deee0 100644 --- a/rbenv/README.md +++ b/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_ruby_version`: version de Ruby à installer, `2.3.1` par défaut -* `rbenv_root`: dossier d'installation, `~/.rbenv` par défaut -* `rbenv_repo`: source Git pour Rbenv -* `rbenv_plugins`: liste des plugins Rbenv à installer +* `rbenv_version`: Rbenv version to install ; +* `rbenv_ruby_version`: Ruby version to install ; +* `rbenv_root`: install path for Rbenv ; +* `rbenv_repo`: repository location ; +* `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: diff --git a/rbenv/tasks/main.yml b/rbenv/tasks/main.yml index aac58684..b56e3ee8 100644 --- a/rbenv/tasks/main.yml +++ b/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 diff --git a/redis/README.md b/redis/README.md index 43720018..1035c337 100644 --- a/redis/README.md +++ b/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_conf_path`: emplacement du fichier de config -* `redis_port`: port TCP d'écoute -* `redis_bind_interface`: IP d'écoute -* `redis_unixsocket`: socket Unix écouté -* `redis_loglevel`: verbosité des logs -* `redis_logfile`: emplacement du fichier de log +* `redis_daemon`: name of the process ; +* `redis_conf_path`: config file location ; +* `redis_port`: listening TCP port ; +* `redis_bind_interface`: listening IP address ; +* `redis_unixsocket`: Unix socket ; +* `redis_loglevel`: log verbosity ; +* `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`. diff --git a/redis/tasks/main.yml b/redis/tasks/main.yml index 636f7d77..69b8298a 100644 --- a/redis/tasks/main.yml +++ b/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