2018 Cisco and/or its affiliates. All rights reserved. Cisco Public

Transcription

1

2 Cisco ACI App Center Fabrice Servais, Software Engineer, Data Center Networking, Cisco

3 Cisco Spark How Questions? Use Cisco Spark to communicate with the speaker after the session 1. Find this session in the Cisco Live Mobile App 2. Click Join the Discussion 3. Install Spark or go directly to the space 4. Enter messages/questions in the space cs.co/ciscolivebot#

4 You can enable the power of apps in your datacenter

5 Agenda Introduction Technical Deep Dive App Development Demo Distribution Takeaways

6 Who I Am Fabrice Servais Software Engineer, Data Center Networking, Cisco

7 Introduction

8 Automation and agility Security and analytics Application Centric Infrastructure Programmable Workload mobility at scale 8

9 Introducing ACI App Center CLI Network Management Open APIs SDN Controller App Center Device Config Fabric-as-a- Monitoring Build Your Own Programmable Solution Device Fabric-as-a- Smart Device 9

10 Introduction ACI App Center Open APIs SDN Controller App Center + = Build Your Own Fabric-as-a- Solution Programmable Device Fabric-as-a- Smart Device 10

11 Introduction ACI App Center Security Apps Troubleshooting Apps Monitoring Apps Optimization Apps Tools Apps 11

12 App Center Apps Programmable Infrastructure: Open APIs for Value Added Applications Contract Viewer APIC POSTMAN FaultAnalytics Customizable Mgmt. View Deeper Flow Visualization API. Workflows Clear MIT. Easy requests Visibility. Faults Troubleshoot Deeper Visibility Into Traffic Flows Between EPGs and Contracts ECOSYSTEM Simplify Operations With Custom Workflows for MOs Simplify Troubleshooting of Faults 10

13 What will be your next big idea?

14 Technical Deep Dive

15 What s an app? Web application Embedded inside APIC s UI App s UI REST API DMEs iframe Container 15

16 Stateless App Queries APIC s API, manipulates data and presents it HTML, CSS, JS, Only running when app is visited Not running in the background UI location can be defined in app s metadata Rendered in an iframe 16

17 What s an iframe? Embed an HTML file into another Includes this file 17

18 What s an iframe? 18

19 Stateful App Running in the background App running in docker container App s API is exposed Can have a frontend (= stateless) More complex apps with database, external integration, App s data replicated across APICs in a cluster 19

20 Stateful App Infrastructure App 1 App 2 WEB SERVICE APIC REST CLIENT WEB SERVICE APIC REST CLIENT (FLASK) (PYCOBRA) (FLASK) (PYCOBRA) *: 80 *: 80 DISTRIBUTED FILE SYSTEM DISTRIBUTED FILE SYSTEM

21 App Development

22 Getting started We will go through the development process for a stateless and stateful app Developer s guide and other docs: 22

23 Getting started 23

24 Workflow Directory structure Metadata Developing Packaging Upload and install Run 24

25 Workflow Stateless App Directory structure Metadata Developing Packaging Upload and install Run 25

26 Directory Structure Stateless Apps must follow a specific directory structure i The packager is case sensitive 26

27 app-start.html Provided by Cisco Do not modify it You can get it from DevNet To be placed under UIAssets/ Run the app Wait for tokens Load app.html Load appstart.html Store tokens 27

28 app-start.html 28

29 Other directories Legal is required if the app is going to be published on AppCenter Media contains: License Readme : Explain your app Snapshots : Show your app IntroVideo : Presentation video 29

30 Workflow Stateless App Directory structure Metadata Developing Packaging Upload and install Run 30

31 App Metadata Located in app.json in main directory Contains information about the app (name, version, privileges, ) i Internal ID for the app = vendordomain + _ + appid 31

32 App Metadata Explained Most are self-explanatory iconfile Name of the app icon. Located in UIAssets/ category Can be Tools and Utilities, Visibility and Monitoring, Optimization, Security, Networking, Cisco Automation and Orchestration, Beta. metaversion Version of the metadata. 32

33 insertionurl This property gives the possibility to insert the app in a Tenant for instance. 33

34 insertionurl - Demystified Bring up the APIC UI and turn in show debug info If you then go to a tenant, take a look at the bottom of the screen The bit we re intested in is the layout information - in this case, it appears to be fv:infotenant:center That s the value you want to use in insertionurl, should you wish to render your app at a precise UI location 34

35 Workflow Stateless App Directory structure Metadata Developing Packaging Upload and install Run 35

36 Let s code UIAssets/app.html Code that is loaded first. Mandatory. Rest of the code inside UIAssets/ Can include other files, JS, CSS 36

37 Tips & Tricks Log what s going on Use the browser console Monitor your API requests from your browser Try locally 37

38 Workflow Directory structure Metadata Developing Packaging Upload and install Run 38

39 Packaging your app Use the packager utility Will check the directory structure and the metadata Will create a.aci application i Currently runs on Linux and macos 39

40 Workflow Stateful App Directory structure Metadata Developing Packaging Upload and install Run 40

41 Directory Structure Stateful Apps must also follow a specific directory structure Stateful specific: Image Docker image Service Application running in the container start.sh Entrypoint i The packager is case sensitive 41

42 From image to running app Upload Docker image How to create a docker image for an ACI App > docker save <image id> gzip -c > </path/to/file>.tgz Docker container Install Run start.sh Bootstrap the app 42

43 Workflow Stateful App Directory structure Metadata Developing Packaging Upload and install Run 43

44 App Metadata Stateful specific: api Describe the exposed APIs 44

45 Workflow Stateful App Directory structure Metadata Developing Packaging Upload and install Run 45

46 App Backend Infrastructure App s backend will run in a container Need to provide the docker image (.tgz) Pre-built images available on DevNet aci/docs/app-center/gettingstarted/ WEB SERVI CE (FLAS K) Container APIC REST CLIENT (PYCOB RA) DISTRIBUTED *: 80 FILE SYSTEM Container WEB SERVI CE (FLAS K) APIC REST CLIENT (PYCOB RA) DISTRIBUTED *: 80 FILE SYSTEM

47 Let s code start.sh server.py 47

48 Mounted directories Some directories from the APIC are mounted in the container APIC /data2/apps/<app_id> /gluster/gv0/<app_id> /data2/logs/<app_id> /securedata/plugincredentials/<app_id> Container /home/app/src /home/app/data /home/app/log /home/app/credentials Source code in.aci Data of your app, to be available on all the APICs Your logs in here Use your private key for your requests 48

49 Tips & Tricks Log what s going on Use /home/app/log to read them from the APIC Convert an existing script Need state? -> Stateless app Not written in JS? -> Stateful app, run it in docker container 49

50 Workflow Directory structure Metadata Developing Packaging Upload and install Run 50

51 Upload your app Add your app to the controller without activating it Apps -> Apps -> Upload Application 51

52 Install your app Click on Enable i Only admin can install/uninstall an app 52

53 Workflow Directory structure Metadata Developing Packaging Upload and install Run 53

54 Let s run it! 54

55 Let s run it! Inside a Tenant 55

56 Demo

57 Distribution

58 Install your first App today! aciappcenter.cisco.com 1. Register 2. Download your private key 3. Package your app with the private key 4. Upload to publish 5. Wait for approval 6. Congrats! 58

59 App Development & Support Matrix Developed By Supported By Monetized By (optional) Partners Partners Partners Cisco Corporate Cisco TAC Cisco Cisco Employee DevNet Community N/A Non-Cisco Developer Non-Cisco Developer Non-Cisco Developer 59

60 Takeaways

61 Key takeaways Fabric-as-a-Smart Device (FaaSD) Technology Partners Channel Partners Developers Customers A platform to collaborate and offer joint solutions. A medium to reach 1000s of customers with your value-added solutions. A catalyst to bring your networking innovation out in the market The most flexible, useful & meaningful solutions from ACI ecosystem 61

62 Q & A

63 Cisco Spark How Questions? Use Cisco Spark to communicate with the speaker after the session 1. Find this session in the Cisco Live Mobile App 2. Click Join the Discussion 3. Install Spark or go directly to the space 4. Enter messages/questions in the space cs.co/ciscolivebot#

64 Please complete your Online Session Evaluations after each session Complete 4 Session Evaluations & the Overall Conference Evaluation (available from Thursday) to receive your Cisco Live T-shirt All surveys can be completed via the Cisco Live Mobile App or the Communication Stations Complete Your Online Session Evaluation Don t forget: Cisco Live sessions will be available for viewing on-demand after the event at

65 Continue Your Education Demos in the Cisco campus Walk-in Self-Paced Labs Tech Circle Meet the Engineer 1:1 meetings Related sessions 65

66 You can enable the power of apps in your datacenter

67 Thank you

68