インフラエンジニアBooks#6 での資料です。 https://infra-eng-books.connpass.com/event/200739/

1. Ansible 実践ガイド第3版
ネットワーク担当としてのふりかえり
株式会社エーピーコミュニケーションズ
技術開発部 ⾃動化グループ
横地 晃
1
2021/2/16 インフラエンジニアBooks#6

2. はじめに
¡ Ansible 実践ガイド 第3版で主に「5-3 ネットワーク機器の構成管理」
を担当しました
¡ Ansible や本書との出会いや、書こうと思った理由、ポイント
などをふりかえります
2

3. ⾃⼰紹介
3
所属
（株）エーピーコミュニケーションズ
技術開発部 ⾃動化グループ
業務 ネットワーク⾃動化の⽀援、各種アウトプット
コミュニティ Ansible ユーザー会、JANOG など
共著
寄稿
Ansible 実践ガイド 第3版
Software Design 2018年12⽉号 他
横地 晃 @akira6592
https://book.impress.co.jp/books/1118101094
https://tekunabe.hatenablog.jp/
てくなべ（ブログ）

4. Ansible と私
4

5. 出会いは 5 年前、Ansible 2.1
¡ 2016年、名前は聞いたことある程度
¡ 「サーバーは⾃動化のOSSがあっていいなぁ」
¡ 「ネットワークにもないかなぁ」
¡ ネットワーク対応したという記事で⼀気に興味が湧いて触り始める
¡ 「Ansible、シスコやArista、Juniperなどのネットワーク機器に対応。ネットワークも含め
た構成⾃動化が可能に － Publickey」
¡ https://www.publickey1.jp/blog/16/ansiblearistajuniper.html
5

6. Ansible 実践ガイドと私
6

7. 出会いは初版
¡ 2017年、Ansible 実践ガイド（初版）の出版記念イベントに参加
¡ 北⼭さんのサインをいただいたが、多分覚えられていない
7
https://thinkit.co.jp/article/10947
は、はじめまして

8. 第2版は研修教材
¡ 2018年、第2版が社内研修の教材に（会社のお⾦）
8
https://twitter.com/akira6592/status/978932187616591873

9. 第3版で共著者に
¡ 2018年、第3版に向けて著者チームに参加
¡ 「5-3 ネットワーク機器の構成管理」を担当
¡ Ansible 2.8 対応に伴う修正も少し
9

10. なぜ書こうと思った︖
10

11. ⾃分がつまずいてきたから
¡ 公式ドキュメントの情報も多くなく、それ以外の情報が少なかった
¡ 読んできた Ansible の書籍にはネットワーク対応が書かれていなかった
11
• モジュールがたくさんあって使い分けが分からない
• コネクションプラグインや使う変数などのお作法が分からない
ネットワーク対応について⽇本語のまとまった情報があるとよいのでは

12. 書いた内容「5-3 ネットワーク機器の構成管理」
¡ 5-3-1 ネットワークモジュールの特徴
¡ 概要、対応ベンダー、変数、コネクションプラグインなど
¡ 5-3-2 ネットワーク機器情報取得の実装
¡ show コマンド実⾏、ログ保存の Playbook（Cisco IOS、Juniper Junos）
¡ 5-3-3 ネットワーク機器設定変更の実装
¡ 設定コマンド実⾏の Playbook（Cisco IOS、Juniper Junos）
12

13. こだわりポイント
13

14. こだわりポイント1、2
¡ (1) P247 モジュールの分類
¡ プラットフォームや機能による分類
¡ ネットワークモジュールはたくさんあるため、分類⽅法を知っておくと探しやすい
¡ (2) P250 Table 5-13 「コマンド実⾏結果と格納先の関係」
¡ show コマンドの結果がどのように stdout や stdout_lines に⼊るか
¡ この構造を知っておくと、後処理がしやすい
14

15. こだわりポイント3、4
¡ (3) P257 Table 5-17 「接続に利⽤する主な変数」
¡ コネクションプラグインごとに、利⽤する変数を整理
¡ ansible_password、ansible_http_password など
¡ (4) P289 Column 仮想ネットワーク機器の準備⽅法
¡ どうやってネットワーク機器の検証環境を準備するかが課題
¡ 有償、無償含めた検証環境を紹介（Cisco DevNet Sandboxなど）
15

16. 担当外のおすすめポイント
¡ P 363 「7-4 プレイブックのデバッグ」
¡ ansible-playbook コマンドの細かいオプション
¡ デバッグログの出⼒
¡ ansible-console コマンド
¡ Playbook Debugger
¡ など
16

17. あせったこと
17

18. P259 接続確認の⽅法
¡ 当初は ping モジュールを使⽤した記述
¡ 通⽤しなくなるプルリク(*1) を発⾒
¡ 本書の想定バージョン 2.8 まではセーフだったが
¡ Troubleshooting Guide(*2) 掲載のように
*_command モジュールを利⽤する⽅法に変更
18
*1 https://github.com/ansible/ansible/pull/59153
*2 https://docs.ansible.com/ansible/latest/network/user_guide/network_debug_troubleshooting.html#isolating-an-error

19. まとめ
19

20. まとめ
¡ 「5-3 ネットワーク機器の構成管理」は⾃分と同じつまずき
をする⼈がいなくなるように願って書きました。
¡ 本書がネットワークエンジニアと Ansible の架け橋
になっているのであれば幸いです。
¡ 公式ドキュメントやネットの情報だけでは不⾜する場合は
是⾮本書をご活⽤ください。
20

21. 参考
¡ Ansible for Network Automation
¡ https://docs.ansible.com/ansible/latest/network/index.html
¡ 「Ansible 実践ガイド第3版」のネットワーク的なおすすめポイント - APC 技術ブログ
¡ https://techblog.ap-com.co.jp/entry/2019/10/18/ansible_practical_book_3rd
21