Etude : Différence entre versions

De TARENTINO
Aller à la navigationAller à la recherche
Ligne 102 : Ligne 102 :
 
</tr>
 
</tr>
 
</table>
 
</table>
−
 
+
== INSTALLATION ==
−
== LES INSTALLATIONS (PIP, DEPOTS ET A SAVOIR) ==
+
=== LES INSTALLATIONS (PIP, DEPOTS ET A SAVOIR) ===
 
<table>
 
<table>
 
<tr>
 
<tr>
Ligne 147 : Ligne 147 :
 
</table>
 
</table>
  
−
== SSH : CLEFS ET ASTUCES ==
+
=== SSH : CLEFS ET ASTUCES ===
 
<table>
 
<table>
 
<tr>
 
<tr>
Ligne 170 : Ligne 170 :
 
</table>
 
</table>
  
−
== FICHIER CFG : CONFIGURATION ET TUNING ==
+
=== FICHIER CFG : CONFIGURATION ET TUNING ===
 
<table>
 
<table>
 
<tr>
 
<tr>
Ligne 383 : Ligne 383 :
 
#
 
#
 
#command_warnings = False
 
#command_warnings = False
−
 
  
 
# set plugin path directories here, separate with colons
 
# set plugin path directories here, separate with colons
Ligne 398 : Ligne 397 :
 
#terminal_plugins  = /usr/share/ansible/plugins/terminal
 
#terminal_plugins  = /usr/share/ansible/plugins/terminal
 
#strategy_plugins  = /usr/share/ansible/plugins/strategy
 
#strategy_plugins  = /usr/share/ansible/plugins/strategy
−
 
  
 
# Ansible will use the 'linear' strategy but you may want to try another one.
 
# Ansible will use the 'linear' strategy but you may want to try another one.
 
#strategy = linear
 
#strategy = linear
−
 
 
# By default, callbacks are not loaded for /bin/ansible. Enable this if you
 
# By default, callbacks are not loaded for /bin/ansible. Enable this if you
 
# want, for example, a notification or logging callback to also apply to
 
# want, for example, a notification or logging callback to also apply to
Ligne 408 : Ligne 405 :
 
#
 
#
 
#bin_ansible_callbacks = False
 
#bin_ansible_callbacks = False
−
 
−
 
 
# Don't like cows?  that's unfortunate.
 
# Don't like cows?  that's unfortunate.
 
# set to 1 if you don't want cowsay support or export ANSIBLE_NOCOWS=1
 
# set to 1 if you don't want cowsay support or export ANSIBLE_NOCOWS=1
 
#nocows = 1
 
#nocows = 1
−
 
 
# Set which cowsay stencil you'd like to use by default. When set to 'random',
 
# Set which cowsay stencil you'd like to use by default. When set to 'random',
 
# a random stencil will be selected for each task. The selection will be filtered
 
# a random stencil will be selected for each task. The selection will be filtered
Ligne 420 : Ligne 414 :
 
#cow_selection = default
 
#cow_selection = default
 
#cow_selection = random
 
#cow_selection = random
−
 
 
# When using the 'random' option for cowsay, stencils will be restricted to this list.
 
# When using the 'random' option for cowsay, stencils will be restricted to this list.
 
# it should be formatted as a comma-separated list with no spaces between names.
 
# it should be formatted as a comma-separated list with no spaces between names.
Ligne 429 : Ligne 422 :
 
#              hellokitty,kitty,luke-koala,meow,milk,moofasa,moose,ren,sheep,small,stegosaurus,\
 
#              hellokitty,kitty,luke-koala,meow,milk,moofasa,moose,ren,sheep,small,stegosaurus,\
 
#              stimpy,supermilker,three-eyes,turkey,turtle,tux,udder,vader-koala,vader,www
 
#              stimpy,supermilker,three-eyes,turkey,turtle,tux,udder,vader-koala,vader,www
−
 
 
# Don't like colors either?
 
# Don't like colors either?
 
# set to 1 if you don't want colors, or export ANSIBLE_NOCOLOR=1
 
# set to 1 if you don't want colors, or export ANSIBLE_NOCOLOR=1
 
#
 
#
 
#nocolor = 1
 
#nocolor = 1
−
 
 
# If set to a persistent type (not 'memory', for example 'redis') fact values
 
# If set to a persistent type (not 'memory', for example 'redis') fact values
 
# from previous runs in Ansible will be stored. This may be useful when
 
# from previous runs in Ansible will be stored. This may be useful when
Ligne 442 : Ligne 433 :
 
#
 
#
 
#fact_caching = memory
 
#fact_caching = memory
−
 
 
# This option tells Ansible where to cache facts. The value is plugin dependent.
 
# This option tells Ansible where to cache facts. The value is plugin dependent.
 
# For the jsonfile plugin, it should be a path to a local directory.
 
# For the jsonfile plugin, it should be a path to a local directory.
Ligne 448 : Ligne 438 :
 
#
 
#
 
#fact_caching_connection=/tmp
 
#fact_caching_connection=/tmp
−
 
 
# retry files
 
# retry files
 
# When a playbook fails a .retry file can be created that will be placed in ~/
 
# When a playbook fails a .retry file can be created that will be placed in ~/
Ligne 456 : Ligne 445 :
 
#retry_files_enabled = False
 
#retry_files_enabled = False
 
#retry_files_save_path = ~/.ansible-retry
 
#retry_files_save_path = ~/.ansible-retry
−
 
 
# prevents logging of task data, off by default
 
# prevents logging of task data, off by default
 
#no_log = False
 
#no_log = False
−
 
 
# prevents logging of tasks, but only on the targets, data is still logged on the master/controller
 
# prevents logging of tasks, but only on the targets, data is still logged on the master/controller
 
#no_target_syslog = False
 
#no_target_syslog = False
−
 
 
# Controls whether Ansible will raise an error or warning if a task has no
 
# Controls whether Ansible will raise an error or warning if a task has no
 
# choice but to create world readable temporary files to execute a module on
 
# choice but to create world readable temporary files to execute a module on
Ligne 471 : Ligne 457 :
 
#
 
#
 
#allow_world_readable_tmpfiles = False
 
#allow_world_readable_tmpfiles = False
−
 
 
# Controls what compression method is used for new-style ansible modules when
 
# Controls what compression method is used for new-style ansible modules when
 
# they are sent to the remote system. The compression types depend on having
 
# they are sent to the remote system. The compression types depend on having
Ligne 481 : Ligne 466 :
 
#
 
#
 
#module_compression = 'ZIP_DEFLATED'
 
#module_compression = 'ZIP_DEFLATED'
−
 
 
# This controls the cutoff point (in bytes) on --diff for files
 
# This controls the cutoff point (in bytes) on --diff for files
 
# set to 0 for unlimited (RAM may suffer!).
 
# set to 0 for unlimited (RAM may suffer!).
 
#
 
#
 
#max_diff_size = 104448
 
#max_diff_size = 104448
−
 
 
# Controls showing custom stats at the end, off by default
 
# Controls showing custom stats at the end, off by default
 
#show_custom_stats = False
 
#show_custom_stats = False
−
 
 
# Controls which files to ignore when using a directory as inventory with
 
# Controls which files to ignore when using a directory as inventory with
 
# possibly multiple sources (both static and dynamic)
 
# possibly multiple sources (both static and dynamic)
 
#
 
#
 
#inventory_ignore_extensions = ~, .orig, .bak, .ini, .cfg, .retry, .pyc, .pyo
 
#inventory_ignore_extensions = ~, .orig, .bak, .ini, .cfg, .retry, .pyc, .pyo
−
 
 
# This family of modules use an alternative execution path optimized for network appliances
 
# This family of modules use an alternative execution path optimized for network appliances
 
# only update this setting if you know how this works, otherwise it can break module execution
 
# only update this setting if you know how this works, otherwise it can break module execution
 
#
 
#
 
#network_group_modules=eos, nxos, ios, iosxr, junos, vyos
 
#network_group_modules=eos, nxos, ios, iosxr, junos, vyos
−
 
 
# When enabled, this option allows lookups (via variables like {{lookup('foo')}} or when used as
 
# When enabled, this option allows lookups (via variables like {{lookup('foo')}} or when used as
 
# a loop with `with_foo`) to return data that is not marked "unsafe". This means the data may contain
 
# a loop with `with_foo`) to return data that is not marked "unsafe". This means the data may contain
Ligne 506 : Ligne 486 :
 
#
 
#
 
#allow_unsafe_lookups = False
 
#allow_unsafe_lookups = False
−
 
 
# set default errors for all plays
 
# set default errors for all plays
 
#any_errors_fatal = False
 
#any_errors_fatal = False
−
 
  
 
[inventory]
 
[inventory]
 
# List of enabled inventory plugins and the order in which they are used.
 
# List of enabled inventory plugins and the order in which they are used.
 
#enable_plugins = host_list, script, auto, yaml, ini, toml
 
#enable_plugins = host_list, script, auto, yaml, ini, toml
−
 
 
# Ignore these extensions when parsing a directory as inventory source
 
# Ignore these extensions when parsing a directory as inventory source
 
#ignore_extensions = .pyc, .pyo, .swp, .bak, ~, .rpm, .md, .txt, ~, .orig, .ini, .cfg, .retry
 
#ignore_extensions = .pyc, .pyo, .swp, .bak, ~, .rpm, .md, .txt, ~, .orig, .ini, .cfg, .retry
−
 
 
# ignore files matching these patterns when parsing a directory as inventory source
 
# ignore files matching these patterns when parsing a directory as inventory source
 
#ignore_patterns=
 
#ignore_patterns=
−
 
 
# If 'True' unparsed inventory sources become fatal errors, otherwise they are warnings.
 
# If 'True' unparsed inventory sources become fatal errors, otherwise they are warnings.
 
#unparsed_is_failed = False
 
#unparsed_is_failed = False
−
 
  
 
[privilege_escalation]
 
[privilege_escalation]
Ligne 529 : Ligne 503 :
 
#become_method = sudo
 
#become_method = sudo
 
#become_ask_pass = False
 
#become_ask_pass = False
−
 
−
 
 
## Connection Plugins ##
 
## Connection Plugins ##
−
 
 
# Settings for each connection plugin go under a section titled '[[plugin_name]_connection]'
 
# Settings for each connection plugin go under a section titled '[[plugin_name]_connection]'
 
# To view available connection plugins, run ansible-doc -t connection -l
 
# To view available connection plugins, run ansible-doc -t connection -l
Ligne 543 : Ligne 514 :
 
# host key checking setting above.
 
# host key checking setting above.
 
#record_host_keys=False
 
#record_host_keys=False
−
 
 
# by default, Ansible requests a pseudo-terminal for commands executed under sudo. Uncomment this
 
# by default, Ansible requests a pseudo-terminal for commands executed under sudo. Uncomment this
 
# line to disable this behaviour.
 
# line to disable this behaviour.
 
#pty = False
 
#pty = False
−
 
 
# paramiko will default to looking for SSH keys initially when trying to
 
# paramiko will default to looking for SSH keys initially when trying to
 
# authenticate to remote devices. This is a problem for some network devices
 
# authenticate to remote devices. This is a problem for some network devices
Ligne 553 : Ligne 522 :
 
# disable the Paramiko look for keys function
 
# disable the Paramiko look for keys function
 
#look_for_keys = False
 
#look_for_keys = False
−
 
 
# When using persistent connections with Paramiko, the connection runs in a
 
# When using persistent connections with Paramiko, the connection runs in a
 
# background process. If the host doesn't already have a valid SSH key, by
 
# background process. If the host doesn't already have a valid SSH key, by
Ligne 560 : Ligne 528 :
 
# Paramiko automatically add host keys.
 
# Paramiko automatically add host keys.
 
#host_key_auto_add = True
 
#host_key_auto_add = True
−
 
  
 
[ssh_connection]
 
[ssh_connection]
Ligne 567 : Ligne 534 :
 
# paramiko on older platforms rather than removing it, -C controls compression use
 
# paramiko on older platforms rather than removing it, -C controls compression use
 
#ssh_args = -C -o ControlMaster=auto -o ControlPersist=60s
 
#ssh_args = -C -o ControlMaster=auto -o ControlPersist=60s
−
 
 
# The base directory for the ControlPath sockets.
 
# The base directory for the ControlPath sockets.
 
# This is the "%(directory)s" in the control_path option
 
# This is the "%(directory)s" in the control_path option
Ligne 574 : Ligne 540 :
 
# control_path_dir = /tmp/.ansible/cp
 
# control_path_dir = /tmp/.ansible/cp
 
#control_path_dir = ~/.ansible/cp
 
#control_path_dir = ~/.ansible/cp
−
 
 
# The path to use for the ControlPath sockets. This defaults to a hashed string of the hostname,
 
# The path to use for the ControlPath sockets. This defaults to a hashed string of the hostname,
 
# port and username (empty string in the config). The hash mitigates a common problem users
 
# port and username (empty string in the config). The hash mitigates a common problem users
Ligne 583 : Ligne 548 :
 
# control_path = %(directory)s/%%C
 
# control_path = %(directory)s/%%C
 
#control_path =
 
#control_path =
−
 
 
# Enabling pipelining reduces the number of SSH operations required to
 
# Enabling pipelining reduces the number of SSH operations required to
 
# execute a module on the remote server. This can result in a significant
 
# execute a module on the remote server. This can result in a significant
Ligne 593 : Ligne 557 :
 
#
 
#
 
#pipelining = False
 
#pipelining = False
−
 
 
# Control the mechanism for transferring files (old)
 
# Control the mechanism for transferring files (old)
 
#  * smart = try sftp and then try scp [default]
 
#  * smart = try sftp and then try scp [default]
Ligne 599 : Ligne 562 :
 
#  * False = use sftp only
 
#  * False = use sftp only
 
#scp_if_ssh = smart
 
#scp_if_ssh = smart
−
 
 
# Control the mechanism for transferring files (new)
 
# Control the mechanism for transferring files (new)
 
# If set, this will override the scp_if_ssh option
 
# If set, this will override the scp_if_ssh option
Ligne 607 : Ligne 569 :
 
#  * smart = try sftp, scp, and piped, in that order [default]
 
#  * smart = try sftp, scp, and piped, in that order [default]
 
#transfer_method = smart
 
#transfer_method = smart
−
 
 
# If False, sftp will not use batch mode to transfer files. This may cause some
 
# If False, sftp will not use batch mode to transfer files. This may cause some
 
# types of file transfer failures impossible to catch however, and should
 
# types of file transfer failures impossible to catch however, and should
 
# only be disabled if your sftp version has problems with batch mode
 
# only be disabled if your sftp version has problems with batch mode
 
#sftp_batch_mode = False
 
#sftp_batch_mode = False
−
 
 
# The -tt argument is passed to ssh when pipelining is not enabled because sudo
 
# The -tt argument is passed to ssh when pipelining is not enabled because sudo
 
# requires a tty by default.
 
# requires a tty by default.
 
#usetty = True
 
#usetty = True
−
 
 
# Number of times to retry an SSH connection to a host, in case of UNREACHABLE.
 
# Number of times to retry an SSH connection to a host, in case of UNREACHABLE.
 
# For each retry attempt, there is an exponential backoff,
 
# For each retry attempt, there is an exponential backoff,
 
# so after the first attempt there is 1s wait, then 2s, 4s etc. up to 30s (max).
 
# so after the first attempt there is 1s wait, then 2s, 4s etc. up to 30s (max).
 
#retries = 3
 
#retries = 3
−
 
  
 
[persistent_connection]
 
[persistent_connection]
Ligne 629 : Ligne 587 :
 
# expires, the connection is shutdown. The default value is 30 seconds.
 
# expires, the connection is shutdown. The default value is 30 seconds.
 
#connect_timeout = 30
 
#connect_timeout = 30
−
 
 
# The command timeout value defines the amount of time to wait for a command
 
# The command timeout value defines the amount of time to wait for a command
 
# or RPC call before timing out. The value for the command timeout must
 
# or RPC call before timing out. The value for the command timeout must
Ligne 635 : Ligne 592 :
 
# The default value is 30 second.
 
# The default value is 30 second.
 
#command_timeout = 30
 
#command_timeout = 30
−
 
−
 
 
## Become Plugins ##
 
## Become Plugins ##
−
 
 
# Settings for become plugins go under a section named '[[plugin_name]_become_plugin]'
 
# Settings for become plugins go under a section named '[[plugin_name]_become_plugin]'
 
# To view available become plugins, run ansible-doc -t become -l
 
# To view available become plugins, run ansible-doc -t become -l
Ligne 647 : Ligne 601 :
 
#flags = -H -S -n
 
#flags = -H -S -n
 
#user = root
 
#user = root
−
 
  
 
[selinux]
 
[selinux]
Ligne 654 : Ligne 607 :
 
# needs to be changed to use the file system dependent context.
 
# needs to be changed to use the file system dependent context.
 
#special_context_filesystems=fuse,nfs,vboxsf,ramfs,9p,vfat
 
#special_context_filesystems=fuse,nfs,vboxsf,ramfs,9p,vfat
−
 
 
# Set this to True to allow libvirt_lxc connections to work without SELinux.
 
# Set this to True to allow libvirt_lxc connections to work without SELinux.
 
#libvirt_lxc_noseclabel = False
 
#libvirt_lxc_noseclabel = False
−
 
  
 
[colors]
 
[colors]
Ligne 673 : Ligne 624 :
 
#diff_remove = red
 
#diff_remove = red
 
#diff_lines = cyan
 
#diff_lines = cyan
−
 
  
 
[diff]
 
[diff]
 
# Always print diff when running ( same as always running with -D/--diff )
 
# Always print diff when running ( same as always running with -D/--diff )
 
#always = False
 
#always = False
−
 
 
# Set how many context lines to show in diff
 
# Set how many context lines to show in diff
 
#context = 3
 
#context = 3
Ligne 685 : Ligne 634 :
 
# Controls whether the display wheel is shown or not
 
# Controls whether the display wheel is shown or not
 
#display_progress=
 
#display_progress=
−
 
 
# Validate TLS certificates for Galaxy server
 
# Validate TLS certificates for Galaxy server
 
#ignore_certs = False
 
#ignore_certs = False
−
 
 
# Role or collection skeleton directory to use as a template for
 
# Role or collection skeleton directory to use as a template for
 
# the init action in ansible-galaxy command
 
# the init action in ansible-galaxy command
 
#role_skeleton=
 
#role_skeleton=
−
 
 
# Patterns of files to ignore inside a Galaxy role or collection
 
# Patterns of files to ignore inside a Galaxy role or collection
 
# skeleton directory
 
# skeleton directory
 
#role_skeleton_ignore="^.git$", "^.*/.git_keep$"
 
#role_skeleton_ignore="^.git$", "^.*/.git_keep$"
−
 
 
# Galaxy Server URL
 
# Galaxy Server URL
 
#server=https://galaxy.ansible.com
 
#server=https://galaxy.ansible.com
−
 
 
# A list of Galaxy servers to use when installing a collection.
 
# A list of Galaxy servers to use when installing a collection.
 
#server_list=automation_hub, release_galaxy
 
#server_list=automation_hub, release_galaxy
−
 
 
# Server specific details which are mentioned in server_list
 
# Server specific details which are mentioned in server_list
 
#[galaxy_server.automation_hub]
 
#[galaxy_server.automation_hub]
Ligne 743 : Ligne 686 :
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
== UTILISATION ==

Version du 14 novembre 2020 à 13:05

Ansible

Introduction

Qu'est ce que Ansible?

  • Outil basé sur du Push
  • Pas d'agent à installer
  • Utilisation de modules (Ansible Galaxie)
  • Inventory / Playbook / Roles
    • Inventory (Vocation à avoir l'inventaire de toutes les machines)
    • Playbook (Faire l'articulation entre Inventory et Roles)
    • Roles (Pour une installation spécifique)
  • Type d'installations
    • Sources
    • Paquets
    • PIP (Librarie Python)
  • Sytème
    • Templating

Notions et définitions

Concepts de base de l'outil

  • Control Node
    • Noeud central contenant Ansible
    • Prérequis: Accès SSH aux autres machines
  • Managed Node
    • Serveurs cibles ayant SSH et Python installés
    • Dont un User avec privilèges Sudo
  • Inventory
    • Inventaire des machines (IP, ou DNS) sous forme de fichier
    • Format INI ou YAML
    • Egalement fichiers de variable (host_vars/group_vars)
    • Inventaire statique (fichiers) ou dynamique (API via scripts)
    • Utilisation de patterns façon Regex
  • Groupes
    • Machines regroupées et typées
      • Création de "boites" dans lesquelles seront classés les serveurs
      • Les boites peuvent être imbriquées et définir des groupes parent et enfant
      • Le groupe Racine (All) est le père de tous
    • Groupes VARS (9:28)
      • Répertoire contenant les variables d'un même groupe contenant un fichier YAML
      • Soit dans le fichier central d'inventory
    • Hosts VARS (10:51)
      • Variables spécifiques à un serveur en particulier
      • Surcharge d'autres variables
  • Exemple d'inventory (12:05)
  • Tasks (13:00)
    • Faire des actions ponctuelles.
      • Créer des users
      • Créer des groupes
      • Passer des commandes
      • Utiliser des modules
      • Copier des fichiers
      • Check de variables
      • etc....
    • Format YAML
  • Modules (13:49)
    • Permet de décrire des actions
    • Modules de base (natifs)
      • Templates
      • Copie de fichiers
      • Création de users
      • etc....
    • Chaque action de module est utilisable par des Tasks
      • Une Task = Une action
      • Une action appelle un module
    • Les actions des modules peuvent fournir des retours
  • Rôles (16:00)
    • Ensemble d'actions
    • L'idéal est de segmenter les rôles
    • Minimiser les rôles
    • Ils sont organisés avec une structure
      • Ils contiennent:
        • Tasks (actions à réaliser)
        • Templates (Fichiers mis à disposition dans les roles)
        • Handlers (Trigger qui va écouter les actions)
        • Variables
        • Meta (Pour le partage des Rôles)
  • Playbooks (19:13)
    • C'est un fichier
Inventory (liste des machines) >> playbook << Rôles à jouer
    • Le playbook fera la correspondance entre quelle machine sur quel groupe avec quelle variable, tel rôle s'appliquera
    • Peut contenir des variables mais à éviter.
    • Peut contenir des tasks mais à éviter.
    • Peut contenir des conditions mais à éviter.
  • Plugins (20:50)
    • Augmenter les capacités de Ansible

INSTALLATION

LES INSTALLATIONS (PIP, DEPOTS ET A SAVOIR)

Installation de Ansible

  • Machines
    • Controller Node
      • Python >= 2.7
      • Pas de Windows
      • SSH
    • Managed Node
      • Python >= 2.6
  • Installations (2:00)
    • Binaire
      • git clone https://github.com/ansible/ansible.git
      • cd ansible
      • source ./hacking/env-setup
      • sudo apt install python
      • pip install --user -r ./requirements.txt
      • echo "127.0.0.1" > ~/ansible_hosts
      • export ANSIBLE_INVENTORY=~/ansible_hosts
      • ansible all -m ping --ask-pass
    • PIP
      • sudo apt install python3-pip
      • pip3 install ansible (ou pip3 install ansible==2.2.9) (4:22)
    • Par la distribution (5:30)
      • sudo apt install
  • Utilisation (5:00)
    • Se reconnecter
    • Versions
      • ansible --version
      • cat /etc/*ea* (6:32)
    • Précisions et configuration(6:54)
      • sudo launchctl limit maxfiles unlimited (sur MacOS)
      • Indiquer l'endroit de l'interpréteur Python3 (/usr/bin/python3)
      • Installer Python sur la machine distante
        • ansible myhost --become -m raw -a "yum install -y python3"

SSH : CLEFS ET ASTUCES

Permettre aux Nodes de communiquer

  • Clé privée et clé publique
    • La clé privée ne doit pas être diffusée
    • La clé publique a vocation à être déployée sur les serveurs distants
  • Générer les clefs
    • ssh-keygen -t ecdsa -b 521
      • va générer une clef privée et publiquesans extension ou .pem
      • droits en 600
  • Transférer la clé
    • ssh-copy-id $USER@$SERVEUR
    • Sécuriser éventuellement (5:45)
    • Création d'un .ssh/config (8:40)

FICHIER CFG : CONFIGURATION ET TUNING

Fichier de configuration de Ansible

  • ansible.cfg
    • Permet de configurer la manière dont ansible va se jouer
    • Si le fichier ansible.cfg doit se trouver à un autre endroit, il faut l'indiquer dans la variable ANSIBLE_CONFIG
      • A l'endroit du playbook (4:16)
      • dans le HOME/.ansible/ansible.cfg
      • dans /etc/ansible/ansible.cfg
    • Contenu

  1 # Example config file for ansible -- https://ansible.com/
  2 # =======================================================
  3 
  4 # Nearly all parameters can be overridden in ansible-playbook
  5 # or with command line flags. Ansible will read ANSIBLE_CONFIG,
  6 # ansible.cfg in the current working directory, .ansible.cfg in
  7 # the home directory, or /etc/ansible/ansible.cfg, whichever it
  8 # finds first
  9 
 10 # For a full list of available options, run ansible-config list or see the
 11 # documentation: https://docs.ansible.com/ansible/latest/reference_appendices/config.html.
 12 
 13 [defaults]
 14 #inventory       = /etc/ansible/hosts
 15 #library         = ~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules
 16 #module_utils    = ~/.ansible/plugins/module_utils:/usr/share/ansible/plugins/module_utils
 17 #remote_tmp      = ~/.ansible/tmp
 18 #local_tmp       = ~/.ansible/tmp
 19 #forks           = 5
 20 #poll_interval   = 0.001
 21 #ask_pass        = False
 22 #transport       = smart
 23 
 24 # Plays will gather facts by default, which contain information about
 25 # the remote system.
 26 #
 27 # smart - gather by default, but don't regather if already gathered
 28 # implicit - gather by default, turn off with gather_facts: False
 29 # explicit - do not gather by default, must say gather_facts: True
 30 #gathering = implicit
 31 
 32 # This only affects the gathering done by a play's gather_facts directive,
 33 # by default gathering retrieves all facts subsets
 34 # all - gather all subsets
 35 # network - gather min and network facts
 36 # hardware - gather hardware facts (longest facts to retrieve)
 37 # virtual - gather min and virtual facts
 38 # facter - import facts from facter
 39 # ohai - import facts from ohai
 40 # You can combine them using comma (ex: network,virtual)
 41 # You can negate them using ! (ex: !hardware,!facter,!ohai)
 42 # A minimal set of facts is always gathered.
 43 #
 44 #gather_subset = all
 45 
 46 # some hardware related facts are collected
 47 # with a maximum timeout of 10 seconds. This
 48 # option lets you increase or decrease that
 49 # timeout to something more suitable for the
 50 # environment.
 51 #
 52 #gather_timeout = 10
 53 
 54 # Ansible facts are available inside the ansible_facts.* dictionary
 55 # namespace. This setting maintains the behaviour which was the default prior
 56 # to 2.5, duplicating these variables into the main namespace, each with a
 57 # prefix of 'ansible_'.
 58 # This variable is set to True by default for backwards compatibility. It
 59 # will be changed to a default of 'False' in a future release.
 60 #
 61 #inject_facts_as_vars = True
 62 
 63 # Paths to search for collections, colon separated
 64 # collections_paths = ~/.ansible/collections:/usr/share/ansible/collections
 65 
 66 # Paths to search for roles, colon separated
 67 #roles_path = ~/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles
 68 
 69 # Host key checking is enabled by default
 70 #host_key_checking = True
 71 
 72 # You can only have one 'stdout' callback type enabled at a time. The default
 73 # is 'default'. The 'yaml' or 'debug' stdout callback plugins are easier to read.
 74 #
 75 #stdout_callback = default
 76 #stdout_callback = yaml
 77 #stdout_callback = debug
 78 
 79 
 80 # Ansible ships with some plugins that require enabling
 81 # this is done to avoid running all of a type by default.
 82 # These setting lists those that you want enabled for your system.
 83 # Custom plugins should not need this unless plugin author disables them
 84 # by default.
 85 #
 86 # Enable callback plugins, they can output to stdout but cannot be 'stdout' type.
 87 #callback_enabled = timer, mail
 88 
 89 # Determine whether includes in tasks and handlers are "static" by
 90 # default. As of 2.0, includes are dynamic by default. Setting these
 91 # values to True will make includes behave more like they did in the
 92 # 1.x versions.
 93 #
 94 #task_includes_static = False
 95 #handler_includes_static = False
 96 
 97 # Controls if a missing handler for a notification event is an error or a warning
 98 #error_on_missing_handler = True
 99 
100 # Default timeout for connection plugins
101 #timeout = 10
102 
103 # Default user to use for playbooks if user is not specified
104 # Uses the connection plugin's default, normally the user currently executing Ansible,
105 # unless a different user is specified here.
106 #
107 #remote_user = root
108 
109 # Logging is off by default unless this path is defined.
110 #log_path = /var/log/ansible.log
111 
112 # Default module to use when running ad-hoc commands
113 #module_name = command
114 
115 # Use this shell for commands executed under sudo.
116 # you may need to change this to /bin/bash in rare instances
117 # if sudo is constrained.
118 #
119 #executable = /bin/sh
120 
121 # By default, variables from roles will be visible in the global variable
122 # scope. To prevent this, set the following option to True, and only
123 # tasks and handlers within the role will see the variables there
124 #
125 #private_role_vars = False
126 
127 # List any Jinja2 extensions to enable here.
128 #jinja2_extensions = jinja2.ext.do,jinja2.ext.i18n
129 
130 # If set, always use this private key file for authentication, same as
131 # if passing --private-key to ansible or ansible-playbook
132 #
133 #private_key_file = /path/to/file
134 
135 # If set, configures the path to the Vault password file as an alternative to
136 # specifying --vault-password-file on the command line. This can also be
137 # an executable script that returns the vault password to stdout.
138 #
139 #vault_password_file = /path/to/vault_password_file
140 
141 # Format of string {{ ansible_managed }} available within Jinja2
142 # templates indicates to users editing templates files will be replaced.
143 # replacing {file}, {host} and {uid} and strftime codes with proper values.
144 #
145 #ansible_managed = Ansible managed: {file} modified on %Y-%m-%d %H:%M:%S by {uid} on {host}
146 
147 # {file}, {host}, {uid}, and the timestamp can all interfere with idempotence
148 # in some situations so the default is a static string:
149 #
150 #ansible_managed = Ansible managed
151 
152 # By default, ansible-playbook will display "Skipping [host]" if it determines a task
153 # should not be run on a host. Set this to "False" if you don't want to see these "Skipping"
154 # messages. NOTE: the task header will still be shown regardless of whether or not the
155 # task is skipped.
156 #
157 #display_skipped_hosts = True
158 
159 # By default, if a task in a playbook does not include a name: field then
160 # ansible-playbook will construct a header that includes the task's action but
161 # not the task's args. This is a security feature because ansible cannot know
162 # if the *module* considers an argument to be no_log at the time that the
163 # header is printed. If your environment doesn't have a problem securing
164 # stdout from ansible-playbook (or you have manually specified no_log in your
165 # playbook on all of the tasks where you have secret information) then you can
166 # safely set this to True to get more informative messages.
167 #
168 #display_args_to_stdout = False
169 
170 # Ansible will raise errors when attempting to dereference
171 # Jinja2 variables that are not set in templates or action lines. Uncomment this line
172 # to change this behavior.
173 #
174 #error_on_undefined_vars = False
175 
176 # Ansible may display warnings based on the configuration of the
177 # system running ansible itself. This may include warnings about 3rd party packages or
178 # other conditions that should be resolved if possible.
179 # To disable these warnings, set the following value to False:
180 #
181 #system_warnings = True
182 
183 # Ansible may display deprecation warnings for language
184 # features that should no longer be used and will be removed in future versions.
185 # To disable these warnings, set the following value to False:
186 #
187 #deprecation_warnings = True
188 
189 # Ansible can optionally warn when usage of the shell and
190 # command module appear to be simplified by using a default Ansible module
191 # instead. These warnings can be silenced by adjusting the following
192 # setting or adding warn=yes or warn=no to the end of the command line
193 # parameter string. This will for example suggest using the git module
194 # instead of shelling out to the git command.
195 #
196 #command_warnings = False
197 
198 # set plugin path directories here, separate with colons
199 #action_plugins     = /usr/share/ansible/plugins/action
200 #become_plugins     = /usr/share/ansible/plugins/become
201 #cache_plugins      = /usr/share/ansible/plugins/cache
202 #callback_plugins   = /usr/share/ansible/plugins/callback
203 #connection_plugins = /usr/share/ansible/plugins/connection
204 #lookup_plugins     = /usr/share/ansible/plugins/lookup
205 #inventory_plugins  = /usr/share/ansible/plugins/inventory
206 #vars_plugins       = /usr/share/ansible/plugins/vars
207 #filter_plugins     = /usr/share/ansible/plugins/filter
208 #test_plugins       = /usr/share/ansible/plugins/test
209 #terminal_plugins   = /usr/share/ansible/plugins/terminal
210 #strategy_plugins   = /usr/share/ansible/plugins/strategy
211 
212 # Ansible will use the 'linear' strategy but you may want to try another one.
213 #strategy = linear
214 # By default, callbacks are not loaded for /bin/ansible. Enable this if you
215 # want, for example, a notification or logging callback to also apply to
216 # /bin/ansible runs
217 #
218 #bin_ansible_callbacks = False
219 # Don't like cows?  that's unfortunate.
220 # set to 1 if you don't want cowsay support or export ANSIBLE_NOCOWS=1
221 #nocows = 1
222 # Set which cowsay stencil you'd like to use by default. When set to 'random',
223 # a random stencil will be selected for each task. The selection will be filtered
224 # against the `cow_enabled` option below.
225 #
226 #cow_selection = default
227 #cow_selection = random
228 # When using the 'random' option for cowsay, stencils will be restricted to this list.
229 # it should be formatted as a comma-separated list with no spaces between names.
230 # NOTE: line continuations here are for formatting purposes only, as the INI parser
231 #       in python does not support them.
232 #
233 #cowsay_enabled_stencils=bud-frogs,bunny,cheese,daemon,default,dragon,elephant-in-snake,elephant,eyes,\
234 #              hellokitty,kitty,luke-koala,meow,milk,moofasa,moose,ren,sheep,small,stegosaurus,\
235 #              stimpy,supermilker,three-eyes,turkey,turtle,tux,udder,vader-koala,vader,www
236 # Don't like colors either?
237 # set to 1 if you don't want colors, or export ANSIBLE_NOCOLOR=1
238 #
239 #nocolor = 1
240 # If set to a persistent type (not 'memory', for example 'redis') fact values
241 # from previous runs in Ansible will be stored. This may be useful when
242 # wanting to use, for example, IP information from one group of servers
243 # without having to talk to them in the same playbook run to get their
244 # current IP information.
245 #
246 #fact_caching = memory
247 # This option tells Ansible where to cache facts. The value is plugin dependent.
248 # For the jsonfile plugin, it should be a path to a local directory.
249 # For the redis plugin, the value is a host:port:database triplet: fact_caching_connection = localhost:6379:0
250 #
251 #fact_caching_connection=/tmp
252 # retry files
253 # When a playbook fails a .retry file can be created that will be placed in ~/
254 # You can enable this feature by setting retry_files_enabled to True
255 # and you can change the location of the files by setting retry_files_save_path
256 #
257 #retry_files_enabled = False
258 #retry_files_save_path = ~/.ansible-retry
259 # prevents logging of task data, off by default
260 #no_log = False
261 # prevents logging of tasks, but only on the targets, data is still logged on the master/controller
262 #no_target_syslog = False
263 # Controls whether Ansible will raise an error or warning if a task has no
264 # choice but to create world readable temporary files to execute a module on
265 # the remote machine. This option is False by default for security. Users may
266 # turn this on to have behaviour more like Ansible prior to 2.1.x. See
267 # https://docs.ansible.com/ansible/latest/user_guide/become.html#becoming-an-unprivileged-user
268 # for more secure ways to fix this than enabling this option.
269 #
270 #allow_world_readable_tmpfiles = False
271 # Controls what compression method is used for new-style ansible modules when
272 # they are sent to the remote system. The compression types depend on having
273 # support compiled into both the controller's python and the client's python.
274 # The names should match with the python Zipfile compression types:
275 # * ZIP_STORED (no compression. available everywhere)
276 # * ZIP_DEFLATED (uses zlib, the default)
277 # These values may be set per host via the ansible_module_compression inventory variable.
278 #
279 #module_compression = 'ZIP_DEFLATED'
280 # This controls the cutoff point (in bytes) on --diff for files
281 # set to 0 for unlimited (RAM may suffer!).
282 #
283 #max_diff_size = 104448
284 # Controls showing custom stats at the end, off by default
285 #show_custom_stats = False
286 # Controls which files to ignore when using a directory as inventory with
287 # possibly multiple sources (both static and dynamic)
288 #
289 #inventory_ignore_extensions = ~, .orig, .bak, .ini, .cfg, .retry, .pyc, .pyo
290 # This family of modules use an alternative execution path optimized for network appliances
291 # only update this setting if you know how this works, otherwise it can break module execution
292 #
293 #network_group_modules=eos, nxos, ios, iosxr, junos, vyos
294 # When enabled, this option allows lookups (via variables like {{lookup('foo')}} or when used as
295 # a loop with `with_foo`) to return data that is not marked "unsafe". This means the data may contain
296 # jinja2 templating language which will be run through the templating engine.
297 # ENABLING THIS COULD BE A SECURITY RISK
298 #
299 #allow_unsafe_lookups = False
300 # set default errors for all plays
301 #any_errors_fatal = False
302 
303 [inventory]
304 # List of enabled inventory plugins and the order in which they are used.
305 #enable_plugins = host_list, script, auto, yaml, ini, toml
306 # Ignore these extensions when parsing a directory as inventory source
307 #ignore_extensions = .pyc, .pyo, .swp, .bak, ~, .rpm, .md, .txt, ~, .orig, .ini, .cfg, .retry
308 # ignore files matching these patterns when parsing a directory as inventory source
309 #ignore_patterns=
310 # If 'True' unparsed inventory sources become fatal errors, otherwise they are warnings.
311 #unparsed_is_failed = False
312 
313 [privilege_escalation]
314 #become = False
315 #become_method = sudo
316 #become_ask_pass = False
317 ## Connection Plugins ##
318 # Settings for each connection plugin go under a section titled '[[plugin_name]_connection]'
319 # To view available connection plugins, run ansible-doc -t connection -l
320 # To view available options for a connection plugin, run ansible-doc -t connection [plugin_name]
321 # https://docs.ansible.com/ansible/latest/plugins/connection.html
322 
323 [paramiko_connection]
324 # uncomment this line to cause the paramiko connection plugin to not record new host
325 # keys encountered. Increases performance on new host additions. Setting works independently of the
326 # host key checking setting above.
327 #record_host_keys=False
328 # by default, Ansible requests a pseudo-terminal for commands executed under sudo. Uncomment this
329 # line to disable this behaviour.
330 #pty = False
331 # paramiko will default to looking for SSH keys initially when trying to
332 # authenticate to remote devices. This is a problem for some network devices
333 # that close the connection after a key failure. Uncomment this line to
334 # disable the Paramiko look for keys function
335 #look_for_keys = False
336 # When using persistent connections with Paramiko, the connection runs in a
337 # background process. If the host doesn't already have a valid SSH key, by
338 # default Ansible will prompt to add the host key. This will cause connections
339 # running in background processes to fail. Uncomment this line to have
340 # Paramiko automatically add host keys.
341 #host_key_auto_add = True
342 
343 [ssh_connection]
344 # ssh arguments to use
345 # Leaving off ControlPersist will result in poor performance, so use
346 # paramiko on older platforms rather than removing it, -C controls compression use
347 #ssh_args = -C -o ControlMaster=auto -o ControlPersist=60s
348 # The base directory for the ControlPath sockets.
349 # This is the "%(directory)s" in the control_path option
350 #
351 # Example:
352 # control_path_dir = /tmp/.ansible/cp
353 #control_path_dir = ~/.ansible/cp
354 # The path to use for the ControlPath sockets. This defaults to a hashed string of the hostname,
355 # port and username (empty string in the config). The hash mitigates a common problem users
356 # found with long hostnames and the conventional %(directory)s/ansible-ssh-%%h-%%p-%%r format.
357 # In those cases, a "too long for Unix domain socket" ssh error would occur.
358 #
359 # Example:
360 # control_path = %(directory)s/%%C
361 #control_path =
362 # Enabling pipelining reduces the number of SSH operations required to
363 # execute a module on the remote server. This can result in a significant
364 # performance improvement when enabled, however when using "sudo:" you must
365 # first disable 'requiretty' in /etc/sudoers
366 #
367 # By default, this option is disabled to preserve compatibility with
368 # sudoers configurations that have requiretty (the default on many distros).
369 #
370 #pipelining = False
371 # Control the mechanism for transferring files (old)
372 #   * smart = try sftp and then try scp [default]
373 #   * True = use scp only
374 #   * False = use sftp only
375 #scp_if_ssh = smart
376 # Control the mechanism for transferring files (new)
377 # If set, this will override the scp_if_ssh option
378 #   * sftp  = use sftp to transfer files
379 #   * scp   = use scp to transfer files
380 #   * piped = use 'dd' over SSH to transfer files
381 #   * smart = try sftp, scp, and piped, in that order [default]
382 #transfer_method = smart
383 # If False, sftp will not use batch mode to transfer files. This may cause some
384 # types of file transfer failures impossible to catch however, and should
385 # only be disabled if your sftp version has problems with batch mode
386 #sftp_batch_mode = False
387 # The -tt argument is passed to ssh when pipelining is not enabled because sudo
388 # requires a tty by default.
389 #usetty = True
390 # Number of times to retry an SSH connection to a host, in case of UNREACHABLE.
391 # For each retry attempt, there is an exponential backoff,
392 # so after the first attempt there is 1s wait, then 2s, 4s etc. up to 30s (max).
393 #retries = 3
394 
395 [persistent_connection]
396 # Configures the persistent connection timeout value in seconds. This value is
397 # how long the persistent connection will remain idle before it is destroyed.
398 # If the connection doesn't receive a request before the timeout value
399 # expires, the connection is shutdown. The default value is 30 seconds.
400 #connect_timeout = 30
401 # The command timeout value defines the amount of time to wait for a command
402 # or RPC call before timing out. The value for the command timeout must
403 # be less than the value of the persistent connection idle timeout (connect_timeout)
404 # The default value is 30 second.
405 #command_timeout = 30
406 ## Become Plugins ##
407 # Settings for become plugins go under a section named '[[plugin_name]_become_plugin]'
408 # To view available become plugins, run ansible-doc -t become -l
409 # To view available options for a specific plugin, run ansible-doc -t become [plugin_name]
410 # https://docs.ansible.com/ansible/latest/plugins/become.html
411 
412 [sudo_become_plugin]
413 #flags = -H -S -n
414 #user = root
415 
416 [selinux]
417 # file systems that require special treatment when dealing with security context
418 # the default behaviour that copies the existing context or uses the user default
419 # needs to be changed to use the file system dependent context.
420 #special_context_filesystems=fuse,nfs,vboxsf,ramfs,9p,vfat
421 # Set this to True to allow libvirt_lxc connections to work without SELinux.
422 #libvirt_lxc_noseclabel = False
423 
424 [colors]
425 #highlight = white
426 #verbose = blue
427 #warn = bright purple
428 #error = red
429 #debug = dark gray
430 #deprecate = purple
431 #skip = cyan
432 #unreachable = red
433 #ok = green
434 #changed = yellow
435 #diff_add = green
436 #diff_remove = red
437 #diff_lines = cyan
438 
439 [diff]
440 # Always print diff when running ( same as always running with -D/--diff )
441 #always = False
442 # Set how many context lines to show in diff
443 #context = 3
444 
445 [galaxy]
446 # Controls whether the display wheel is shown or not
447 #display_progress=
448 # Validate TLS certificates for Galaxy server
449 #ignore_certs = False
450 # Role or collection skeleton directory to use as a template for
451 # the init action in ansible-galaxy command
452 #role_skeleton=
453 # Patterns of files to ignore inside a Galaxy role or collection
454 # skeleton directory
455 #role_skeleton_ignore="^.git$", "^.*/.git_keep$"
456 # Galaxy Server URL
457 #server=https://galaxy.ansible.com
458 # A list of Galaxy servers to use when installing a collection.
459 #server_list=automation_hub, release_galaxy
460 # Server specific details which are mentioned in server_list
461 #[galaxy_server.automation_hub]
462 #url=https://cloud.redhat.com/api/automation-hub/
463 #auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
464 #token=my_ah_token
465 #
466 #[galaxy_server.release_galaxy]
467 #url=https://galaxy.ansible.com/
468 #token=my_token

  • cli (ligne de commande)
    • Il existe un binaire (ansible-config)
      • Arguments:
        • view (4:16)
          • Permet de voir les paramètres de configuration
        • list
          • Donne la liste de tous les paramètres ansible qu'on va pouvoir "seter"
  • Astuce
    • Dans le fichier ansible.cfg
      • host_key_checking = False
        • Empeche la validation par <YES>
      • callback_whitelist = profile_tasks
        • Permet d'avoir la durée de chaque task ansible
      • pipelining = True (12:07)
        • Permet de gagner du temps
      • sh_args = -C -o ControlMaster=auto -o ControlPersist=60s -o PreferredAuthentications=publickey
        • Permet de partager plusieurs sessions pour une même connexion
        • contrôler la persistance
        • Spécifier directement l'authentification
      • fork = 30 (15:25)
        • (parallélisme)
      • gather_fact: no
        • Pour jouer un Run Ansible, il va d'abord y avoir un check des informations système, avec cette ligne on annule cette collecte (peut poser des problèmes, time, interface, .....)
      • Voir plus tard Mitogen'

UTILISATION

Récupérée de « https://tarentino.fr/index.php?title=Etude&oldid=2440 »