Introduction of Cisco ACI APIC API. Sorry it's Japanese presentation material. I explain about acitoolkit and others.

1. ACIのAPIって何それ美味しいの？
Takao Setaka
Cisco Systems
November 6, 2014

2. ACIの理想と現実。

3. ACIの理想
アプリケーション視点のポリシーに
基づいたインフラストラクチャ
(特にネットワーク)の実現

4. ACIの現実
ネットワーク視点のデザインを
いかにアプリケーション視点の
デザインに落とし込むか？
• APIC GUIだけ？
• REST/APIは…(゜_゜)

5. ACIの管理手法。

6. ACIのAPIを活用する主な方法
1. Web GUI
2. API Inspector
3. APIC Object Browser (Visore)
4. Cobra SDK
5. APIC REST to Python Adapter (arya)
6. ACI Toolkit
7. ACI PowerTool － 開発休止中？

7. APICをブラウザのGUIを通じて
REST/APIで処理するための、
標準で提供されるWebアプリ実装
What’s APIC Web GUI?

8. What’s APIC Web GUI?

9. ブラウザのGUIを通じたREST/API
通信を覗き見るためのツール
What’s API Inspector?

10. What’s API Inspector?

11. オブジェクトモデルのMIT(Management Information Tree)
構造のデータを簡易に参照するツール
(主に開発者向け)
What’s APIC Object Browser?
TOOL: https://[your APIC]/visore.html

12. What’s APIC Object Browser?

13. APIC標準提供のPython SDK
ACIのMITにMappingされた開発環境
What’s Cobra SDK?
DOCS: https://[your APIC]/cobra/
CODE(EGG): https://[your APIC]/cobra/_download

14. What’s Cobra SDK?

15. APICのREST/APIをCobra SDKの
Pythonスクリプトに変換する
オープンソースツール
What’s APIC REST to Python Adapter?
CODE&DOCS: https://github.com/datacenter/arya

16. What’s APIC REST to Python Adapter?

17. Pythonでシンプルに
ACI(APIC)のAPIを活用してもらうための
オープンソースツール(+サンプルアプリ)
日々進化中。
What’s ACI Toolkit?
DOCS: https://datacenter.github.io/acitoolkit
CODE: https://github.com/datacenter/acitoolkit/

18. • Cobra SDKは主に開発者向け
(MIT構造に即したPython向け開発環境)
• ACI Toolkitは主に構築・管理者向け
(PythonでAPICを簡易に管理するためのツール)
What’s different with Cobra SDK?

19. 導入設定や運用管理を「楽にする」・
「確実にする」ために活用する
How to use ACI Toolkit?

20. ACI Toolkitの中身
acitoolkit
acitoolkit
samples
applications
Pythonパッケージ フォルダ
acitoolkitのPythonソースコード一式
(acitoolkit.py等)
サンプルスクリプト集
acitoolkitを活用したスクリプトのサンプル
サンプルアプリケーション集
acitoolkitを活用したちょっとしたアプリ
ケーションのサンプル

21. ACI Toolkitのclass
Tenant EPG Taboo L2Interfac
e
VMM OutsideL3 PhyDomain
Context Contract FilterEntr
y
L3Interfac
e
VMMvSwitch
Info
OSPFInterf
acePolicy
EPGDomain
BridgeDoma
in
ContractSu
bject
IPEndpoint FexInterfa
ce
VmmDomain OSPFRouter L2ExtDomai
n
Subnet Filter AppProfile PortChanne
l
VMMCredent
ials
BGPSession L3ExtDomai
n
OutsideNet
work
BaseContra
ct
CommonEPG TunnelInte
rface
Search MonitorTar
get
OutsideEPG ContractIn
terface
Collection
Policy
Search BaseMonito
rClass
MonitorSta
ts
NetworkPoo
l
Endpoint LogicalMod
el
BaseMonito
rClass
MonitorCla
ss

22. サンプルアプリケーション
アプリケーション 概要
ACI Diagram APIC構成情報のダイアグラム図画像ファイルの生成
Cable Plan ケーブル接続プランのXMLファイル参照と現状接続状況の比較
CLI APICに対するCisco CLI的な操作
Endpoint Tracker Endpoint情報の検索と参照
Event Feeds APIC変更情報のAtom Feed生成
Lint ACIファブリックの分析ツール(各種エラー・警告情報の提示)
Multi Site 複数APIC間でのアプリケーションネットワークプロファイル情報の同期
Object Browser
Reports ACI構成環境の各種レポートの生成
Search APIC構成情報パラメータの検索
Snap Back APIC構成情報のスナップショットの取得、差分の確認、ロールバックなど
Visualizations APIC情報のグラフ表示

23. APIを活用するツールを使って楽しましょう！
さらにはツールの
改善に参加ください!!
@github

25. いいえ。
残念ながら、Web GUIやREST/APIの
全ての機能には対応していません。
でも、80%ぐらいの「やりたいこと」には対応
できる…ようになることを目指しています。
ACI Toolkitはなんでもできる？

26. はい。
でも、ちょっと便利にACIを活用するために
ぜひお使いください。
ACI Toolkitは、手段です。
ACI Toolkitはサポートされない？

27. いいえ。
Pythonの実行環境さえあれば、
WindowsでもMacでも使えます。
でも、一部サンプルアプリケーションはLinux
での使用が前提となっています…。
ACI ToolkitはLinuxでしか使えない？