Wiki-Tech.io/Configuration/Ansible/Installation.md

title	description	published	date	tags	editor	dateCreated
Ansible - Installation et configuration	Mettre en place Ansible dans son environnement	true	2021-07-08T17:52:12.911Z	ansible, configuration	markdown	2021-07-08T17:18:58.350Z

Installation

Liens utiles

Documentation : https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html

Les différentes releases : https://releases.ansible.com/ansible/

Prérequis

Controller node

• Python >= 2.7
• tout sauf windows
• ssh/scp (ou sftp)

Managed node

• Python >= 2.6

Différents types d'installations

• paquets des distributions
• librairie python
• binaire
• éventuellement par docker (abandonné depuis 2 ans)

Installation via le binaire

git clone https://github.com/ansible/ansible.git
cd ansible
source ./hacking/env-setup
sudo apt install python-pip
pip install --user -r ./requirements.txt
echo "127.0.0.1" > ~/ansible_hosts
export ANSIBLE_INVENTORY=~/ansible_hosts
ansible all -m ping --ask-pass

Installation via pip

sudo apt install python3-pip
pip3 install ansible

Installation via les paquets (Debian)

sudo apt install ansible

Remarques

MacOS

• remonter la limite du nombre de fichiers
• fork > 15

sudo launchctl limit maxfiles unlimited

Python interpreter - par défaut /usr/bin/python

ansible_python_interpreter=/usr/bin/python3

ou installation (raw ne dépend pas de python côté client)

ansible myhost --become -m raw -a "yum install -y python2"

Doc : https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html#ansible-python-interpreter

Configuration SSH

Principes clefs

• clef privée
• clef privée
• type de clef / algorithme (rsa, dsa, ecdsa)
• longeur de clef (dépend de l'algo ecdsa 521)

Gestion d'une clef SSH

Génération via ssh-keygen

ssh-keygen -t ecdsa -b 521

Spécifier la localisation de sortie

ssh-keygen -t ecdsa -b 521 -f /myhome/.ssh/maclefprivee

Configurez une passphrase sinon une clef ssh est plus dangereuse qu'un password {.is-warning}

Ajout de votre clef publique sur le host distant

vim /home/user/.ssh/authorized_keys

Ou via ssh-copy-id

ssh-copy-id -i /myhome/.ssh/maclefprivee xavki@monhost

Remarque : specific pour une ip

from="10.0.0.?,*.example.com",no-X11-forwarding ssh-rsa AB3Nz...EN8w== xavki@monhost

Utilisation de la clef

ssh -i /localisation/clef/privee xavki@monhost

Ou plus facilement par un agent ssh (embarque votre configuration ssh)

Check si un agent tourne

ps -p $SSH_AGENT_PID

Lancement d'un agent ssh

eval `ssh-agent`

Ajout de la clef à l'agent

ssh-add

Check de la clef de l'agent

ssh-add -l

Exemple :

touch ~/.ssh/config
chmod 600 ~/.ssh/config
cat ~/.ssh/config

Host * !monhost*
    User vagrant
    Port 22
    IdentityFile /myhome/.ssh/maclefprivee
    LogLevel INFO
    Compression yes
    ForwardAgent yes
    ForwardX11 yes

Astuce pour bypasser la conf

ssh -F /dev/null xavki@monhost

Configuration et tuning

Configuration

Configuration de différentes manières :

• ansible.cfg
• cli

Et à différents endroits pour ansible.cfg (ordre inverse de prise en compte)

• éventuellement en définissant ANSIBLE_CONFIG
• à l'endroit de votre playbook ansible.cfg
• ~/.ansible/ansible.cfg
• /etc/ansible/ansible.cfg

Exemple :

inventory       = /etc/ansible/hosts
forks           = 5
sudo_user       = root
ask_sudo_pass   = True
ask_pass        = True
gathering       = implicit
gather_subset   = all
roles_path      = /etc/ansible/roles
log_path        = /var/log/ansible.log
vault_password_file = /path/to/vault_password_file
fact_caching_connection =/tmp
pipelining = False

Doc : https://docs.ansible.com/ansible/2.3/intro_configuration.html

Commande :

ansible-config
ansible-config view  # voir le ansible.cfg pris en compte
ansible-config list  # toute les variables et leurs valeurs
ansible-config dump  # liste toutes les variables ansible
ansible-config dump --only-changed #valeurs par défaut modifiée

cf : https://docs.ansible.com/ansible/latest/reference_appendices/config.html

Exemple :

ANSIBLE_SSH_ARGS:
  default: -C -o ControlMaster=auto -o ControlPersist=60s
  description:
  - If set, this will override the Ansible default ssh arguments.
  - In particular, users may wish to raise the ControlPersist time to encourage performance.  A
    value of 30 minutes may be appropriate.
  - Be aware that if `-o ControlPath` is set in ssh_args, the control path setting
    is not used.
  env:
  - name: ANSIBLE_SSH_ARGS
  ini:
  - key: ssh_args
    section: ssh_connection
  yaml:
    key: ssh_connection.ssh_args

Tuning

Host key checking = fingerprint

[defaults]
host_key_checking = False

Callback temps par action

[defaults]
callback_whitelist = profile_tasks

Pipelining

[ssh_connection]
pipelining = True

Principe par défaut :

• création fichier python
• création directory
• envoi fichier python via sftp
• run python
• récupération résultat

Avec pipelining :

• génération du fichier python
• envoi sur le python interpreter distant via stdin
• récupération du stdout

Rq: travailler sans fichier distant

Partage de plusieurs sessions et augmentation de la persistence (connexion...)

[ssh_connection]
ssh_args = -o ControlMaster=auto -o ControlPersist=60s

Doc : https://www.blog-libre.org/2019/05/11/loption-controlmaster-de-ssh_config/

Spécifier le mode d'identification

[ssh_connection]
ssh_args = -o ControlMaster=auto -o ControlPersist=60s -o PreferredAuthentications=publickey

fork = parallélisation

[defaults]
forks = 30

gather facts avec précaution

gather_facts: no

gather facts caching par fichier

fact_caching = jsonfile
fact_caching_timeout = 3600
fact_caching_connection = /tmp/mycachedir

gather facts caching par redis

fact_caching = redis
fact_caching_timeout = 3600
fact_caching_connection = localhost:6379:0

Mitogen

Doc : https://mitogen.networkgenomics.com/ansible_detailed.html

cas ultime > ansible localhost >> ansible-pull (commande)

chargement du code ansible sur le serveur distant

cloud init > cron > ansible-pull

exécution en localhost problème récupération des informations