devnet-2009intercloud fabric rest apis for providers

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


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


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


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


ICF Cloud APIs Overview


Intercloud Fabric Provider Platform – Cloud API


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


ICF Provider APIs Overview


Intercloud Fabric Provider Platform – Provider API


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


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.


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


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


Demo

16


Southbound Cloud Adapter Overview


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


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)


References• Cisco ICFPP Administrator Guide

• Southbound Cloud Adapter Framework

• Cisco Intercloud Fabric Provider Platform Adapter Developer Guide


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.


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


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


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

devnet-2009intercloud fabric rest apis for providers

Technology

cisco andor

provider cloud platform

intercloud fabric rest

image upload

provider oss bss

service nodes

polling status resp

image url path