CAMARA
MAMADOU
SOMMAIRES
I-Qu’est ce que YAML ?
II-Comment écrire YAML
III-Exemple YAML : types scalaires
I-Qu’est ce que YAML ?
YAML (YAML Ain’t Markup Language) est un langage qui s’inspire de XML. C’est un
acronyme récursif qui n’est pas un langage de balisage. En effet, il s’agit plutôt pour ce
langage de sérialiser des données. Il ressemble à XML dans la manière de représenter
les données comme une suite d’éléments. Mais la ressemblance ne va pas plus loin.
YAML est donc très facile à écrire et à lire. C’est pourquoi ce langage est de plus en
plus utilisé par exemple pour stocker des données de configuration.
Par exemple, en YAML pour représenter une liste de pays :
#LES COMMUNES
communes:
-attecoube
-adjame
-abobo
-cocody
-yopougon
-treichville
Le dièse indique qu’il s’agit d’un commentaire. Les tirets indiquent qu’il s’agit des
éléments du tableau dont le nom est suivi de deux points.
II-Comment écrire YAML
La structure de base d'un fichier YAML est une carte. Vous pouvez appeler cela un
dictionnaire, un hachage ou un objet, selon votre langage de programmation ou votre
[Link]ès généralement, ce sont des clés et des valeurs tout en bas :
SYNTAXE
cle : valeur
exemple:
date_de_debut: 2021-08-24
III-Exemple YAML : types scalaires
Vous pouvez utiliser toutes sortes de types scalaires comme valeurs : nombres,
booléens et chaînes (entre guillemets ou non). La première ligne d'un [Link], par
exemple, est généralement :
version:2
Les mots dans les clés peuvent être séparés par des traits de soulignement, des tirets
ou des espaces. Chez CircleCI, nous utilisons des traits de soulignement .
Si la valeur d'une clé est une chaîne multiligne, vous pouvez utiliser le style 'literal block'
Si la valeur d'une clé est une chaîne multiligne, vous pouvez utiliser le style 'literal block'
en utilisant le '|' personnage. Ceci est particulièrement utile lors de la définition de
commandes shell :
comande: |
if [ "${CIRCLE_BRANCH}" == "master" ];
then ansible-playbook [Link] -i production;
fi
Notez que l'indentation de début pour la chaîne multiligne sera supprimée.
IV-YAML Example: Collection Types
Tout ce que vous avez à faire pour créer des collections est d'utiliser l'indentation :
environment:
TEST_REPORTS: /tmp/test-reportse
Si vous avez une liste de choses (comme des images), vous pouvez désigner cette
séquence à l'aide de tirets :docker:
- image: ubuntu:14.04
- image: mongo:2.6.8
command: [mongod, --smallfiles]
- image: postgres:9.4.1
Notez que le deuxième élément de la séquence a deux clés : imageet command. La
commandclé utilise une séquence de style JSON car (rappelez-vous !) YAML est un
sur-ensemble de JSON.
Enfin, YAML n'autorise pas les caractères de tabulation, donc si vous les utilisez pour
mettre en retrait, demandez à votre éditeur de texte de les convertir en espaces. Les
erreurs de syntaxe dans votre YAML peuvent parfois entraîner le blocage des builds
CircleCI, mais elles sont également facilement évitables en exécutant votre
[Link]/[Link] un validateur en ligne .
