Ansible 小手冊系列 八(Yaml 語法格式)

介紹


YAML 語言(發(fā)音 /?j?m?l/ )的設(shè)計目標(biāo)仲义,就是方便人類讀寫婶熬。它實質(zhì)上是一種通用的數(shù)據(jù)串行化格式。

它的基本語法規(guī)則如下埃撵。

? 大小寫敏感
? 使用縮進(jìn)表示層級關(guān)系
? 縮進(jìn)時不允許使用Tab鍵赵颅,只允許使用空格。
? 縮進(jìn)的空格數(shù)目不重要暂刘,只要相同層級的元素左側(cè)對齊即可
? yaml文件以"---"作為文檔的開始饺谬,"..."作為文檔的結(jié)束

# 表示注釋,從這個字符一直到行尾谣拣,都會被解析器忽略募寨。

YAML 支持的數(shù)據(jù)結(jié)構(gòu)有三種。

? 對象:鍵值對的集合芝发,又稱為映射(mapping)/ 哈希(hashes) / 字典(dictionary)
? 數(shù)組:一組按次序排列的值绪商,又稱為序列(sequence) / 列表(list)
? 純量(scalars):單個的、不可再分的值

對象


對象的一組鍵值對辅鲸,使用冒號結(jié)構(gòu)表示格郁。

job: Developer

列表


---
fruits:
  - Apple
  - Orange
  - Strawberry
  - Mango

轉(zhuǎn)換為python格式

{'fruits': ['Apple', 'Orange', 'Strawberry', 'Mango']}

可以使用行內(nèi)表示法

---
fruits: ['Apple', 'Orange', 'Strawberry', 'Mango']

字典


---
martin:
  name: Martin D'vloper
  job: Developer
  skill: Elite

轉(zhuǎn)換為python格式

{'martin': {'job': 'Developer', 'name': "Martin D'vloper", 'skill': 'Elite'}}

可以使用行業(yè)內(nèi)表示法

---
martin: {name: Martin D'vloper, job: Developer, skill: Elite}

復(fù)合結(jié)構(gòu)


---
- martin:
  name: Martin D'vloper
  job: Developer
  skills:
    - python
    - perl
    - pascal
- tabitha:
  name: Tabitha Bitumen
  job: Developer
  skills:
    - lisp
    - fortran
    - erlang

轉(zhuǎn)換為python格式

[{'martin': {'job': 'Developer','name': "Martin D'vloper",'skills': ['python', 'perl', 'pascal']}},{'tabitha': {'job': 'Developer', 'name': 'Tabitha Bitumen','skills': ['lisp', 'fortran', 'erlang']}}]

純量


** 數(shù)值**

number: 12
float:12.30

轉(zhuǎn)換為python格式

{'float': 12.300000000000001, 'number': 12}

** 布爾值**

表示true的值
true, True, TRUE, yes, Yes, YES, on, On, ON, y, Y

表示false的值
false, False, FALSE, no, No, NO, off, Off, OFF, n, N

** 轉(zhuǎn)換數(shù)據(jù)類型**

e: !!str 123
f: !!str true

轉(zhuǎn)換為python格式

{'e': '123', 'f': 'true'}

** 字符串**

字符串默認(rèn)不使用引號表示。

str: 這是一行字符串

轉(zhuǎn)換為python格式

{'str': '這是一行字符串'}

如果字符串之中包含空格或特殊字符独悴,需要放在引號之中例书。

str: '內(nèi)容: 字符串'

轉(zhuǎn)換為python格式

{'str': '內(nèi)容: 字符串'}

單引號和雙引號都可以使用,雙引號不會對特殊字符轉(zhuǎn)義刻炒。

str: 'labor''s day' 

轉(zhuǎn)換為python格式

{'str': "labor's day"}

單引號之中如果還有單引號决采,必須連續(xù)使用兩個單引號轉(zhuǎn)義。

s1: '內(nèi)容\n字符串'
s2: "內(nèi)容\n字符串"

轉(zhuǎn)換為python格式

{'s1': '內(nèi)容\\n字符串','s2': '內(nèi)容\n字符串'}

字符串可以寫成多行坟奥,從第二行開始树瞭,必須有一個單空格縮進(jìn)。換行符會被轉(zhuǎn)為空格爱谁。

str: 這是一段
  多行
  字符串

轉(zhuǎn)換為python格式

{'str': '這是一段 多行 字符串'}

多行字符串可以使用|保留換行符晒喷,也可以使用>折疊換行。

this: |
  Foo
  Bar
that: >
  Foo
  Bar

轉(zhuǎn)換為python格式

{'that': 'Foo Bar', 'this': 'Foo\nBar\n'}

+表示保留文字塊末尾的換行访敌,-表示刪除字符串末尾的換行凉敲。

s1: |
  Foo

s2: |+
  Foo

s3: |-
  Foo

轉(zhuǎn)換為python格式

{'s1': 'Foo\n', 's2': 'Foo\n\n\n', 's3': 'Foo'}

字符串之中可以插入 HTML 標(biāo)記。

message: |

  <p style="color: red">
    段落
  </p>

轉(zhuǎn)換為python格式

{'message': '\n<p style="color: red">\n  段落\n</p>'}

引用

錨點&和別名*,可以用來引用爷抓。

defaults: &defaults
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  <<: *defaults

test:
  database: myapp_test
  <<: *defaults

等同于下面的代碼势决。

defaults:
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  adapter:  postgres
  host:     localhost

test:
  database: myapp_test
  adapter:  postgres
  host:     localhost

轉(zhuǎn)換為python格式

{'defaults': {'adapter': 'postgres', 'host': 'localhost'},
 'development': {'adapter': 'postgres',
                 'database': 'myapp_development',
                 'host': 'localhost'},
 'test': {'adapter': 'postgres',
          'database': 'myapp_test',
          'host': 'localhost'}}

&用來建立錨點(defaults),<<表示合并到當(dāng)前數(shù)據(jù)蓝撇,*用來引用錨點果复。

下面是另一個例子。

- &showell Steve 
- Clark 
- Brian 
- Oren 
- *showell 

轉(zhuǎn)換為python格式

['Steve', 'Clark', 'Brian', 'Oren', 'Steve']

yaml中引用變量

foo: "{{ variable }}"

高級YAML語法


!unsafe使用

變量值中保存的數(shù)據(jù)應(yīng)被視為不安全的唉地,防止不安全的字符子集和信息披露据悔。

---
hosts: all
vars:
    my_unsafe_variable: !unsafe 'unsafe value'
tasks:
    ...

資料


Playbooks 采用YMAL 語法結(jié)構(gòu)传透,基本的YMAL 語法請參考
http://docs.ansible.com/YAMLSyntax.html

python利用pyyaml模塊進(jìn)行解析yaml語言
http://pyyaml.org/wiki/PyYAMLDocumentation

yaml格式在線檢查
http://yaml-online-parser.appspot.com/


更多文章請看 Ansible 專題文章總覽

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末耘沼,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子朱盐,更是在濱河造成了極大的恐慌群嗤,老刑警劉巖,帶你破解...
    沈念sama閱讀 221,888評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件兵琳,死亡現(xiàn)場離奇詭異狂秘,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)躯肌,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,677評論 3 399
  • 文/潘曉璐 我一進(jìn)店門者春,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人清女,你說我怎么就攤上這事钱烟。” “怎么了嫡丙?”我有些...
    開封第一講書人閱讀 168,386評論 0 360
  • 文/不壞的土叔 我叫張陵拴袭,是天一觀的道長。 經(jīng)常有香客問我曙博,道長拥刻,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,726評論 1 297
  • 正文 為了忘掉前任父泳,我火速辦了婚禮般哼,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘惠窄。我一直安慰自己蒸眠,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 68,729評論 6 397
  • 文/花漫 我一把揭開白布睬捶。 她就那樣靜靜地躺著黔宛,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上臀晃,一...
    開封第一講書人閱讀 52,337評論 1 310
  • 那天觉渴,我揣著相機(jī)與錄音,去河邊找鬼徽惋。 笑死案淋,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的险绘。 我是一名探鬼主播踢京,決...
    沈念sama閱讀 40,902評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼宦棺!你這毒婦竟也來了瓣距?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,807評論 0 276
  • 序言:老撾萬榮一對情侶失蹤代咸,失蹤者是張志新(化名)和其女友劉穎蹈丸,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體呐芥,經(jīng)...
    沈念sama閱讀 46,349評論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡逻杖,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,439評論 3 340
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了思瘟。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片荸百。...
    茶點故事閱讀 40,567評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖滨攻,靈堂內(nèi)的尸體忽然破棺而出够话,到底是詐尸還是另有隱情,我是刑警寧澤铡买,帶...
    沈念sama閱讀 36,242評論 5 350
  • 正文 年R本政府宣布更鲁,位于F島的核電站,受9級特大地震影響奇钞,放射性物質(zhì)發(fā)生泄漏澡为。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,933評論 3 334
  • 文/蒙蒙 一景埃、第九天 我趴在偏房一處隱蔽的房頂上張望媒至。 院中可真熱鬧,春花似錦谷徙、人聲如沸拒啰。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,420評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽谋旦。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間册着,已是汗流浹背拴孤。 一陣腳步聲響...
    開封第一講書人閱讀 33,531評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留甲捏,地道東北人演熟。 一個月前我還...
    沈念sama閱讀 48,995評論 3 377
  • 正文 我出身青樓,卻偏偏與公主長得像司顿,于是被迫代替她去往敵國和親芒粹。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,585評論 2 359

推薦閱讀更多精彩內(nèi)容