devnet-2009intercloud fabric rest apis for providers
TRANSCRIPT
Intercloud Fabric REST APIs for ProvidersPaulo Renato, Technical Marketing Architect
[email protected], @prenatos
DEVNET-2009
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
• ICF Solution Overview
• ICF for Provider APIs Overview
• Conclusion
Agenda
3
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric Provider Platform
(ICFPP)Intercloud Fabric for Providers
Intercloud Fabric Secure Extender(Secure Network Extension)
DC/Private Cloud
Provider Cloud
Cisco Intercloud Fabric Architectural Details
Intercloud Switch
VM Manager
Intercloud Fabric Services
Intercloud Extender
Intercloud Fabric Director
End User and IT Admin PortalWorkload and Fabric ManagementIT AdminsEnd Users
VM VM
VM VMIntercloud Fabric for Business
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP Multi-tier Topology
• High Availability
• Scalability• Horizontal Scaling Approach• Ability to deploy multiple ICFPP nodes• Service Provider Load balancer distributes load across ICFPPs
• Max: 4 service nodes and 2 DB nodes
• Up to 160 concurrent VM upload/download
• Synchronized database nodes
• Load Balancer: Least-Connection with Session Sticky
ICFPPServiceNode
ICFPPDatabaseNode
(Primary)
ICFPPDatabaseNode
(Standby)
Load Balancer
ICFPPServiceNode
ICFPPServiceNode
ICFPPServiceNode
ICFPP Multi-tier Topology
SP Choice
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cloud API
Provider API
Southbound Cloud Adapter
VCDAdapter
Open Stack Adapter
Cloud stackAdapter
Custom Adapter
Core Logic Tenant DB
Custom Adapter
ICFPP Architecture
Intercloud Fabric Cloud API
Provider Platform
Intercloud Fabric Provider API
Intercloud Fabric ProviderSouthbound Cloud Adapter
To Provider OSS / BSS
To Provider Cloud Platform
To Intercloud Fabric for Business
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICF Cloud APIs Overview
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric Provider Platform – Cloud API
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP à Cloud Platform: Image Upload with HTTP Pull Model
ICFPP Appliance
Intercloud Fabric for Business
POST Image API RequestResp (COMPLETE, Image ID)
Cloud Platform APICloud API
Upload Image API Request(Image ID, Image binary …)
Cloud Platform
Resp (COMPLETE)
Resp (IS_NOT_READY, Job ID)
Register Template API Request(Template ID, Image URL path e.g. http://<image-path>)
GET Template API Request(Template ID, Polling Status)
Resp (COMPLETE, Template ID)
HTTP GET http://<image-path> HTTP Response + Image Binary
Resp (IS_READY, Job ID)
Asynchronous Polling Job Status API Request(Job ID)
POST Template API Request(Image ID, Polling Status)
Resp (COMPLETE, Template ID)
HTTP Chunked Encoding Transfer
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICF Provider APIs Overview
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric Provider Platform – Provider API
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cloud Platform Instance Provisioning API
Cloud Platform Instance Provisioning Input Parameters:
• Instance Name –An unique name that identifies a cloud instance
• Adapter Type –Type of cloud adapter;; valid values are ”CUSTOM" or ”CISCO“, where “CUSTOM” specifies the adapter is a third party developed plugin, and ”CISCO” specifies the adapter is part of the existing Cisco delivery.
• Module Name –An unique string that maps a cloud adapter plugin module to a given Cloud Adapter.
• Platform URI/IP-addr–Either a URI or IP address to reach the cloud platform server.
Name Input Parameters
Output Parameters
Descriptions
POST /capi/v1/cloudinstances Instance Name,Adapter Type,Module Name,Platform URI/IP
Status as CREATED with cloudId
Add a Cloud Platform Instance to ICFPP
DELETE /capi/v1/cloudinstances/cloudId
Status as DELETED or error
Delete a Cloud Platform Instance from ICFPP
PUT /capi/v1/cloudinstances/cloudId Status as UPDATED Update the Platform IP/URL for a previously provisioned cloud instance
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Tenant/User Provisioning API
Tenant Provisioning API Input Parameters:
• Tenant Name –Name or identity that SP cloud platform uses to identify a tenant• Cloud Platform Instance –Cloud Platform Instance Name
• Org Name –Name of the org associated with the tenant. This can be ignored if the provided does not have a concept of an org (like VCD).• Resource Limit –Currently we support setting the maximum number of VMs per tenant.
• Parameter List – It will allow API user to pass additional parameter• Accounts –Array of User Account records associated with tenant org. Each of the Account records consists of :
v Username – User Namev Password – User Credential (Optional)v Secret key – Additional User Credential (Optional)
Name Input Parameters
Output Parameters
Descriptions
POST /capi/v1/tenants Tenant Name, Cloud PlatformInstance,OrgName, Resource Limit, Account Records [ ]
ACTIVE or Error code Add a Tenant and relevant User Account to ICFPP
DELETE /capi/v1/tenants/tenantId
None DELETED or Error code Delete a Tenant from ICFPP
UPDATE /capi/v1/tenants/tenantId
Can update the apikey and secretkey.
ACTIVE or Error code Update certain attributes of an account
DELETE /capi/v1/tenants/tenantId/purge
None PURGED or Error code Purge an existing tenant.
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Tenant/User Query API Name Input
ParametersOutput
ParametersDescriptions
GET /capi/v1/tenants/tenantId None Tenants , Accounts Tenant and List of Accounts
GET /capi/v1/tenants/tenantId/details
None Tenants, Accounts, All VM details
List of Tenants, Accounts and VMs
GET /capi/v1/tenants None All Tenants, All accounts List of Tenants, Accounts and server statistics
GET /capi/v1/servers/serverId None Details regarding a VM
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
ICFPP MonitoringName Input
ParametersOutput
ParametersDescriptions
GET/capi/v1/logs/current
None Zipped file with current logs Returns current ICFPP application and web-server logs
GET/capi/v1/logs/all
None Zipped file with all logs Returns all ICFPP logs
POST/capi/v1/syslogconfig
Enabled true/false, log level, host, port, protocol for Primary and Secondary Server
Syslog server configuration Post remote syslog config
GET/capi/v1/syslogconfig
None Syslog configuration Get syslog config
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Southbound Cloud Adapter Overview
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Custom1Cloud Platform
ICFPP Cloud Adapter Programming Model
Cloud AdapterBased on“custom1.jar” file
MgmtSession
Virtualmachine
VPC Template Service Network/Security
Intercloud Cloud API
Development
SP Admin
GUIWeb/HTTPS Interface
Cloud Platform Instance
Core Application Logic
Southbound Cloud Adapter Interface
Tenant Provisioning
CloudAdapterDeveloper
New Plugin.jar file (e.g. custom1.jar)
Custom1 Cloud API
Cloud Platform Instance
• Instance ID• Cloud Type (e.g. Custom)• Cloud Module (e.g. “custom1”) • Cloud Platform IP-addr
A new cloud platform adapter can be developed in the following steps: • Develop a cloud adapter plug-in
code and load it into the ICFPP system.
• Configure a Cloud Platform Instance and associate it with the plug-in module (e.g. custom1.jar)
• Provision tenants with Tenant On-board API and associate them with a targeted cloud instance.
• Tenant Identity• Cloud Instance ID• Tenant Credential (e.g. Uname + Password, or Access keys)
Tenant Record
From IntercloudFabric Director
12
34
5
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Cisco ICFPP SDK• Sample Code:• Adapter Example (Java code)• Test Harness (Test suite for API level testing of ICFPP)
• Documentation:• ICFPP Adapter Development Guide• ICFPP Architecture Document• ICFPP SP Integration REST API• ICFPP Installation Guide• ICFPP Release Notes
• ICFPP OVA
• ICFB Bundle (during engagement)
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
References• Cisco ICFPP Administrator Guide
• Southbound Cloud Adapter Framework
• Cisco Intercloud Fabric Provider Platform Adapter Developer Guide
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Key Takeaways• ICFPP concept and architecture is simple
• ICFPP Creates Cloud API uniformity for different Providers
• ICFPP Cloud Adapter supports OpenStack, Cloudstack and vCD (Beta) out-of-box integration
• Cisco gives customer an SDK to develop custom Cloud Adapter for ICFPP to integrate with any Cloud Management Platform
• ICFPP will differentiate Cisco Powered Providers from other clouds• Roadmap to include bare-metal workloads, tither storage integration etc.
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Intercloud Fabric @ CiscoLive San DiegoBreakouts TECCLD-3001 Sun 8:00 4 hrs 16B Mezz Intercloud Fabric Technical Deepdive
PSOCLD-1001 Mon 11:00 60 min 14B Mezz Hybrid Cloud with Intercloud Fabric
PSODCT-1009 Mon 2:00 60 min 14B Mezz Hybrid Clouds: Integrating the Enterprise Data Center and Public Cloud
BRKCLD-2003 Wed 8:00 2 hrs 7A Upper Building Hybrid Cloud Applications with Intercloud Fabric
BRKCLD-1828 Thu 8:00 90 min 25C Upper Designing Hybrid Cloud operations with ServiceGrid and Intercloud Fabric
DevN
et
DEVNET-1008 Mon 9:00 30 min Devnet Theater Private or Public or Hybrid ? Which Cloud Should I choose?
DEVNET-1120 Mon 1:00 60 min Devnet Classrm #2 Intercloud Fabric - AWS and Azure Account Setup and Utilization
DEVNET-1128 Mon 2:00 30 min Devnet Classrm #2 Cisco Intercloud Fabric NB APIs for BusinessDEVNET-1009 Tue 9:00 30 min Devnet Theater Cisco Intercloud Fabric for Business, Helping Enterprises Move to Hybrid!DEVNET-2009 Wed 12:00 30 min Devnet Classrm #2 Intercloud Fabric REST APIs for Providers
World of Solutions Learning Labs Table Topics Meet the EngineerICF in Hybrid Cloud
Mon 12:00Table #11
Wed 11:30Table #13
Building Hybrid Cloud Apps withICF
Tue 11:30Table # 11
Wed 11:30Table #10
Talk to an ICF Expert @ ‘The Hub’Ground Level
See ICF in action with 3-tier hybrid cloud application
‘Cloud’ Booth in WoS, Ground Level
Hands on with ICF:‘Intercloud Fabric Learning Lab’‘DevNet Zone’ Ground Level
cisco.com/go/intercloudfabric The im
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Participate in the “My Favorite Speaker” Contest
• Promote your favorite speaker through Twitter and you could win $200 of Cisco Press products (@CiscoPress)
• Send a tweet and include • Your favorite speaker’s Twitter handle @prenatos• Two hashtags: #CLUS #MyFavoriteSpeaker
• You can submit an entry for more than one of your “favorite” speakers
• Don’t forget to follow @CiscoLive and @CiscoPress
• View the official rules at http://bit.ly/CLUSwin
Promote Your Favorite Speaker and You Could Be a Winner
23
© 2015 Cisco and/or its affiliates. All rights reserved. Cisco PublicPresentation ID
Complete Your Online Session Evaluation
Don’t forget: Cisco Live sessions will be available for viewing on-demand after the event at CiscoLive.com/Online
• Give us your feedback to be entered into a Daily Survey Drawing. A daily winner will receive a $750 Amazon gift card.
• Complete your session surveys though the Cisco Live mobile app or your computer on Cisco Live Connect.
24