Tools/Ansible/Use Cases - Historique des versions

Admin : /* Transformation de données */

2020-05-25T15:08:40Z

Transformation de données

Voir les modifications

Admin : /* Manipulation de données JSON */

2020-05-25T14:52:44Z

Manipulation de données JSON

Admin : /* Hachage, codage et manipulation de chaînes */

2020-05-25T14:46:42Z

Hachage, codage et manipulation de chaînes

Admin : /* Manipulation des dictionnaires */

2020-05-25T14:32:08Z

Manipulation des dictionnaires

Admin : /* Modifier l'ordre des éléments d'une liste */

2020-05-25T14:26:09Z

Modifier l'ordre des éléments d'une liste

Admin : /* Manipulation de listes */

2020-05-25T14:17:21Z

Manipulation de listes

Admin : /* Opérations arithmétiques */

2020-05-25T14:10:06Z

Opérations arithmétiques

Admin : /* Opérations arithmétiques */

2020-05-25T14:08:34Z

Opérations arithmétiques

Admin : /* Opérations arithmétiques */

2020-05-25T14:05:40Z

Opérations arithmétiques

Admin : /* Opérations arithmétiques */

2020-05-25T14:04:54Z

Opérations arithmétiques

← Version précédente		Version du 25 mai 2020 à 14:52
Ligne 772 :		Ligne 772 :

	==== Manipulation de données JSON ====		==== Manipulation de données JSON ====
		+
		+	De nombreuses structures de données utilisées par Ansible sont au format JSON. Les notations JSON et YAML sont étroitement liées et les structures de données Ansible peuvent être traitées en tant que JSON. De même, de nombreuses API avec lesquelles les playbooks Ansible peuvent interagir consomment ou utilisent des informations au format JSON. Étant donné que ce format est largement utilisé, les filtres JSON sont particulièrement utiles.
		+
		+	===== Requêtes JSON =====
		+	Utilisez le filtre '''json_query''' pour extraire des informations des structures de données Ansible.
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Get the 'name' elements from the list of dictionaries in 'hosts'
		+	vars:
		+	hosts:
		+	- name: bastion
		+	ip:
		+	- 172.25.250.254
		+	- 172.25.252.1
		+	- name: classroom
		+	ip:
		+	- 172.25.252.254
		+	assert:
		+	that:
		+	- "{{ hosts \| json_query('[*].name') }} is eq( ['bastion','classroom'] )"
		+	</syntaxhighlight>
		+
		+	===== Analyse et encodage de structures de données =====
		+	La transformation de structures de données vers du texte et à partir de celui-ci est utile pour le débogage et la communication. Les structures de données sont sérialisées au format JSON ou YAML avec les filtres '''to_json''' et '''to_yaml'''. Utilisez les filtres '''to_nice_json''' et '''to_nice_yaml''' pour obtenir une sortie mise en forme lisible par l'utilisateur.
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Convert between JSON and YAML format
		+	vars:
		+	hosts:
		+	- name: bastion
		+	ip:
		+	- 172.25.250.254
		+	- 172.25.252.1
		+	hosts_json: '[{"name": "bastion", "ip": ["172.25.250.254", "172.25.252.1"]}]'
		+	assert:
		+	that:
		+	- "'{{ hosts \| to_json }}' is eq( hosts_json )"
		+	</syntaxhighlight>

← Version précédente		Version du 25 mai 2020 à 14:46
Ligne 695 :		Ligne 695 :
	==== Hachage, codage et manipulation de chaînes ====		==== Hachage, codage et manipulation de chaînes ====

		+	Un certain nombre de filtres sont disponibles pour manipuler le texte d'une valeur. Vous pouvez prendre plusieurs checksums, créer des hachages de mots de passe et convertir du texte à partir d'un encodage '''Base64''' et vers celui-ci, tel qu'il est utilisé par un certain nombre d'applications.
		+
		+	=====Hachage de chaînes et de mots de passe=====
		+	Le filtre '''hash''' renvoie la valeur de hachage de la chaîne d'entrée, à l'aide de l'algorithme de hachage fourni :
		+
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: the string's SHA-1 hash
		+	vars:
		+	expected: '8bae3f7d0a461488ced07b3e10ab80d018eb1d8c'
		+	assert:
		+	that:
		+	- "'{{ 'Arthur' \| hash('sha1') }}' is eq( expected )"
		+	</syntaxhighlight>
		+
		+	Utilisez le filtre password_hash pour générer des hachages de mot de passe :
		+
		+
		+	<syntaxhighlight lang="yaml">
		+	{{ 'secret_password' \| password_hash('sha512') }}
		+	</syntaxhighlight>
		+
		+	=====Encodage de chaînes=====
		+
		+	Les données binaires peuvent être traduites en base64 par le filtre '''b64encode''', puis retraduites au format binaire par le filtre b64decode :
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Base64 encoding and decoding of values
		+	assert:
		+	that:
		+	- "'{{ 'âÉïôú' \| b64encode }}' is eq( 'w6LDicOvw7TDug==' )"
		+	- "'{{ 'w6LDicOvw7TDug==' \| b64decode }}' is eq( 'âÉïôú' )"
		+	</syntaxhighlight>
		+
		+	Avant d'envoyer des chaînes au shell sous-jacent et d'éviter les problèmes d'analyse ou d'injection de code, il est recommandé d'assainir la chaîne à l'aide du filtre quote :
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Put quotes around 'my_string'
		+	shell: echo {{ my_string \| quote }}
		+	</syntaxhighlight>
		+
		+	=====Mise en forme de texte=====
		+
		+	Utilisez les filtres lower, upper ou capitalize pour appliquer la casse d'une chaîne d'entrée :
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Change case of characters
		+	assert:
		+	that:
		+	- "'{{ 'Marvin' \| lower }}' is eq( 'marvin' )"
		+	- "'{{ 'Marvin' \| upper }}' is eq( 'MARVIN' )"
		+	- "'{{ 'marvin' \| capitalize }}' is eq( 'Marvin' )"
		+	</syntaxhighlight>
		+
		+
		+	=====Remplacement de texte=====
		+	Le filtre '''replace''' est utile lorsque vous devez remplacer toutes les occurrences d'une sous-chaîne à l'intérieur de la chaîne d'entrée :
		+
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Replace 'ar' with asterisks
		+	assert:
		+	that:
		+	- "'{{ 'marvin, arthur' \| replace('ar','') }}' is eq( 'mvin, **thur' )"
		+	</syntaxhighlight>
		+
		+	Des recherches et des remplacements beaucoup plus complexes sont disponibles en utilisant des expressions rationnelles et les filtres '''regex_search''' et '''regex_replace'''.
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: Test results of regex search and search-and-replace
		+	assert:
		+	that:
		+	- "'{{ 'marvin, arthur' \| regex_search('ar\S*r') }}' is eq( 'arthur' )"
		+	- "'{{ 'arthur up' \| regex_replace('ar(\S*)r','\\1mb') }}' is eq( 'thumbup' )"
		+	</syntaxhighlight>

	==== Manipulation de données JSON ====		==== Manipulation de données JSON ====

← Version précédente		Version du 25 mai 2020 à 14:32
Ligne 646 :		Ligne 646 :

	==== Manipulation des dictionnaires ====		==== Manipulation des dictionnaires ====
		+
		+	Contrairement aux listes, les dictionnaires ne respectent aucun ordre. Il s'agit simplement d'une collection de paires clé-valeur. Mais vous pouvez utiliser des filtres pour construire des dictionnaires. Ensuite, vous pouvez les convertir en listes ou convertir des listes en dictionnaires.
		+
		+	=====Liaison de dictionnaires=====
		+	Deux dictionnaires peuvent être reliés par le filtre combine. Les entrées du second dictionnaire ont une priorité plus élevée que les entrées du premier dictionnaire, comme le montre la tâche suivante :
		+
		+	Exemple
		+
		+	<syntaxhighlight lang="yaml">
		+
		+	- name: 'combine' combines two dictionaries into one
		+	vars:
		+	expected:
		+	A: 1
		+	B: 4
		+	C: 5
		+	assert:
		+	that:
		+	- "{{ {'A':1,'B':2} \| combine({'B':4,'C':5}) }} is eq( expected )"
		+	</syntaxhighlight>
		+	=====Remodelage de dictionnaires=====
		+
		+	Un dictionnaire peut être remodelé en une liste d'éléments avec le filtre '''dict2items''', et une liste d'éléments peut être remodelée en un dictionnaire avec le filtre '''items2dict''' :
		+
		+	Exemple
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: converting between dictionaries and lists
		+	vars:
		+	characters_dict:
		+	Douglas: Human
		+	Marvin: Robot
		+	Arthur: Human
		+	characters_items:
		+	- key: Douglas
		+	value: Human
		+	- key: Marvin
		+	value: Robot
		+	- key: Arthur
		+	value: Human
		+	assert:
		+	that:
		+	- "{{ characters_dict \| dict2items }} is eq( characters_items )"
		+	- "{{ characters_items \| items2dict }} is eq( characters_dict )"
		+
		+	</syntaxhighlight>

	==== Hachage, codage et manipulation de chaînes ====		==== Hachage, codage et manipulation de chaînes ====

@@ Ligne 601 : / Ligne 601 : @@
        - "{{ [ 4, 8, 10, 6, 2 ] | sort | list }} is eq( [ 2, 4, 6, 8, 10 ] )"
 </syntaxhighlight>
 ==== Manipulation des dictionnaires ====

← Version précédente		Version du 25 mai 2020 à 14:17
Ligne 562 :		Ligne 562 :

	==== Manipulation de listes ====		==== Manipulation de listes ====
		+
		+	Il existe de nombreux filtres qutilisables pour analyser et manipuler des listes.
		+
		+	Si la liste se compose de nombres, utiliser {{CODE\|max, min ou sum}} pour trouver le plus grand nombre, le plus petit nombre et la somme de tous les éléments de la liste.
		+	<syntaxhighlight lang="yaml">
		+	{{ [2, 4, 6, 8, 10, 12] \| sum }}
		+	</syntaxhighlight>
		+
		+	===== Extraire des éléments d'une liste =====
		+
		+	* obtenir des informations sur le contenu de la liste, telles que le premier élément ('''first'''), le dernier ('''last'''), ou la longueur ('''length''') de la liste :
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: All three of these assertions are true
		+	assert:
		+	that:
		+	- "{{ [ 2, 4, 6, 8, 10, 12 ] \| length }} is eq( 6 )"
		+	- "{{ [ 2, 4, 6, 8, 10, 12 ] \| first }} is eq( 2 )"
		+	- "{{ [ 2, 4, 6, 8, 10, 12 ] \| last }} is eq( 12 )"
		+	</syntaxhighlight>
		+
		+	Le filtre '''random''' renvoie un élément aléatoire de la liste :
		+
		+	<syntaxhighlight lang="yaml">
		+	{{ ['Douglas', 'Marvin', 'Arthur'] \| random }}
		+	</syntaxhighlight>
		+
		+
		+	===== Modifier l'ordre des éléments d'une liste =====
		+
		+	Une liste peut être réordonnée de plusieurs façons. Le filtre '''sort''' trie la liste dans l'ordre naturel de ses éléments. Le filtre '''reverse''' renvoie une liste dans laquelle l'ordre est le contraire de l'ordre d'origine. Le filtre '''shuffle''' renvoie une liste avec les mêmes éléments, mais dans un ordre aléatoire.
		+
		+	<syntaxhighlight lang="yaml">
		+	- name: All three of these assertions are true
		+	assert:
		+	that:
		+	- "{{ [ 2, 4, 6, 8, 10 ] \| reverse \| list }} is eq( [ 10, 8, 6, 4, 2] )"
		+	- "{{ [ 4, 8, 10, 6, 2 ] \| sort \| list }} is eq( [ 2, 4, 6, 8, 10 ] )"
		+	</syntaxhighlight>

	==== Manipulation des dictionnaires ====		==== Manipulation des dictionnaires ====

@@ Ligne 548 : / Ligne 548 : @@
 Par exemple, l'expression '''Jinja2''' suivante ajoute une heure à l'heure actuelle, qui est collectée en tant que fait et stockée en tant que chaîne, et non en tant que nombre entier :
 {{ ( ansible_facts['date_time']['hour'] | int ) + 1 }}
 Il existe également un certain nombre de filtres qui peuvent effectuer une opération mathématique sur un nombre : log, pow, root, abs et round sont des exemples.
 {{ 1764 | root }}
 ==== Manipulation de listes ====

@@ Ligne 540 : / Ligne 540 : @@
 |-
 |{{CODE|**}}
-|Augmenter le nombre de gauche à la puissance du nombre
+|Augmenter le nombre de gauche à la puissance du nombre correct.
 |}
 ==== Manipulation de listes ====

← Version précédente		Version du 25 mai 2020 à 14:04
Ligne 513 :		Ligne 513 :


−	==== Opérations arithmétiques ====	+	==== Opérations arithmétiques ====
		+
		+
		+	{\| class="wikitable"
		+
		+	! class="wikitable" \| Opérateur
		+	! Description
		+	\|-
		+	\|{{CODE\|+}}
		+	\|Ajouter deux nombres.
		+	\|-
		+	\|{{CODE\|-}}
		+	\|Soustraire deux nombres.
		+	\|-
		+	\|{{CODE\|/}}
		+	\|Effectuer une division en virgule flottante.
		+	\|-
		+	\|{{CODE\|//}}
		+	\|Effectuer une division d'entiers.
		+	\|-
		+	\|{{CODE\|%}}
		+	\|Récupérer le reste de la division d'un entier.
		+	\|-
		+	\|{{CODE\|*}}
		+	\|Multiplier deux nombres.
		+	\|-
		+	\|{{CODE\|**}}
		+	\|Augmenter le nombre de gauche à la puissance du nombre
		+	correct.
		+
		+	-}

	==== Manipulation de listes ====		==== Manipulation de listes ====