OpenStack - User contributions [en]

SDK-Development

2014-05-14T15:48:13Z

Ken Perkins: /* SDK Projects */

To enable application developers to build applications that use OpenStack, we need SDKs for each programming language (e.g., PHP, Go, Java) to provide them with what they need.

__TOC__

The purpose of this page is to work through how we go about building SDKs in a semi-consistent manner on the OpenStack infrastructure.

== What's in an SDK? ==

An SDK is more than just a set of APIs provided to you. A complete SDK provides a consumer focused API for interacting with the system, and it additionally includes:

* Documentation aimed at users consuming the SDK and system.
* Clear examples of usage, including functioning, executable examples.
* The SDK may optionally include tools to help developers use the SDK, such as IDE plugins or batch scripts.

== Audience ==
Application developers build applications that interact with OpenStack. Application developers are not OpenStack Operators or Developers. These are developers looking to consume a feature-rich OpenStack Cloud with its many services. These Developers require a consistent, single namespace API ("Application Programming Interface") that allows them to build and deploy their application with minimal dependencies.

== Goals for each SDK ==

# Don't break clients!
# Support multiple API versions for each service (e.g., Keystone API v2 and v3).
# Use application developer friendly language in descriptions (e.g., Compute instead of Nova).
# Provide a manner to extend the services in the SDKs.
# Be written in a manner consistent with the language and platform they are for (e.g., A Java SDK shouldn't look like Python).
# Contain example code to get started.
# Contain documentation explaining how to get started and going with the SDKs and the services.
# Contain cross-linked class/module reference documentation.
# Contain a release history/change log documenting deprecations, new additions and bug fixes in the SDK (with links wherever possible).
# Handle OpenStack extensions in a graceful manner (e.g. you should be able to simply make a method call to determine if an OpenStack cloud supports a particular extension).
# Be open source and [http://opensource.com/life/14/1/evaluate-sustainability-open-source-project sustainable].
# Open source license must be compatible with Apache License v2?

== Non-Goals for each SDK ==

# While an SDK should provide working code examples showing usage of the SDK, it must '''not''' provide a complete end-user client (e.g. a CLI) implementation. Such an implementation belongs to a separate project that would depend on and use the appropriate SDK.

==SDK Projects==
# [[SDK-Development/PythonOpenStackSDK]]
# [[OpenStack-SDK-PHP]]
# [[OpenStack-SDK-Ruby]]
# [[OpenStack-SDK-DotNet]]
# [[OpenStack-SDK-Java]]
# [[OpenStack-SDK-Node.js]]

== Resources ==
Summit Design Sessions
# [https://etherpad.openstack.org/p/sdk-documentation SDK Documentation Discussion] at Grizzly Summit
# [https://etherpad.openstack.org/p/icehouse-doc-app-devs Documenting Application Developer Resources] at Icehouse Summit

== Example uses of an SDK ==
* Syncing objects between containers from two different providers. For example, syncing objects between a private and public cloud.
* Using object storage as a back end to store data or files within an application.
* Building a custom services management tool (e.g., a special purpose CLI or console).

OpenStack-SDK-Node.js

2014-05-14T15:47:51Z

Ken Perkins:

__TOC__

== Summary ==
This project is not an official OpenStack project, nor are there plans to do so in the near term. This wiki entry is an effort to clearly communicate the recommended way to interact/interoperate with OpenStack via a Node.js language binding/Software Development Kit (SDK). We hope this will improve the experience of OpenStack end-users who are using the Node.js programming language by providing them with everything they need to develop applications against OpenStack.

'''What's in an SDK?:'''
An SDK is more than just a set of APIs provided to you. A complete SDK provides a consumer focused API for interacting with the system, and it additionally includes:

* Documentation aimed at users consuming the SDK and system.
* Clear examples of usage, including functioning, executable examples.

OpenStack is considering endoring pkgcloud as the 'official' Node.js binding for interacting with OpenStack public/hybrid/private clouds:
[http://developer.openstack.org Open source SDKs for OpenStack application development]

Much effort is currently being invested in the pkgcloud project in general and the OpenStack provider in particular. The pkgcloud OpenStack provider already has maximum reuse for OpenStack provider clouds.

== Audience ==
The primary target for this package is application developers who develop against OpenStack. This does not include those who develop OpenStack itself or operate it. These are developers looking to consume a feature-rich OpenStack Cloud with its many services. These Developers require a consistent, single namespace API ("Application Programming Interface") that allows them to build and deploy their application with minimal dependencies.

== Requirements ==
# Feel native to developers working in Node.js.
# Support multiple API versions for each service (e.g., Nova API v1 and v2).
# Provide a method for vendor extensions. Numerous vendors have extensions. There needs to be a method to support these to aid the end developer.

== Resources ==
{| border="1" cellpadding="2" cellspacing="0"
| Source code (pkgcloud) || https://github.com/pkgcloud/pkgcloud
|-
| Bug tracker || https://github.com/pkgcloud/pkgcloud/issues
|}

== IRC ==
The developers use IRC in #pkgcloud on freenode for development discussion.

OpenStack-SDK-Node.js

2014-05-14T15:43:42Z

Ken Perkins: Created page with "__TOC__ == Summary == This project is not an official OpenStack project, nor are there plans to do so in the near term. This wiki entry is an effort to clearly communicate th..."

__TOC__

== Summary ==
This project is not an official OpenStack project, nor are there plans to do so in the near term. This wiki entry is an effort to clearly communicate the recommended way to interact/interoperate with OpenStack via a Node.js language binding/Software Development Kit (SDK). We hope this will improve the experience of OpenStack end-users who are using the Node.js programming language by providing them with everything they need to develop applications against OpenStack.

'''What's in an SDK?:'''
An SDK is more than just a set of APIs provided to you. A complete SDK provides a consumer focused API for interacting with the system, and it additionally includes:

* Documentation aimed at users consuming the SDK and system.
* Clear examples of usage, including functioning, executable examples.

OpenStack has endorsed pkgcloud as the 'official' Node.js binding for interacting with OpenStack public/hybrid/private clouds:
[http://developer.openstack.org Open source SDKs for OpenStack application development]

Much effort is currently being invested in the pkgcloud project in general and the OpenStack provider in particular. The pkgcloud OpenStack provider already has maximum reuse for OpenStack provider clouds.

== Audience ==
The primary target for this package is application developers who develop against OpenStack. This does not include those who develop OpenStack itself or operate it. These are developers looking to consume a feature-rich OpenStack Cloud with its many services. These Developers require a consistent, single namespace API ("Application Programming Interface") that allows them to build and deploy their application with minimal dependencies.

== Requirements ==
# Feel native to developers working in Node.js.
# Support multiple API versions for each service (e.g., Nova API v1 and v2).
# Provide a method for vendor extensions. Numerous vendors have extensions. There needs to be a method to support these to aid the end developer.

== Resources ==
{| border="1" cellpadding="2" cellspacing="0"
| Source code (pkgcloud) || https://github.com/pkgcloud/pkgcloud
|-
| Bug tracker || https://github.com/pkgcloud/pkgcloud/issues
|}

== IRC ==
The developers use IRC in #pkgcloud on freenode for development discussion.