Skip to content

Latest commit

 

History

History
55 lines (38 loc) · 1.78 KB

README.md

File metadata and controls

55 lines (38 loc) · 1.78 KB
Raw

Using the OpenStack provider in pkgcloud

The OpenStack provider in pkgcloud supports the following services:

Getting Started with Compute

We've provided a simple compute example where it creates a couple of compute instances.

Authentication

For all of the OpenStack services, you create a client with the same options:

  var openstack = pkgcloud.storage.createClient({
    provider: 'openstack', // required
    username: 'your-user-name', // required
    password: 'your-password', // required
    authUrl: 'your identity service url' // required
  });

Note: Due to variances between OpenStack deployments, you may or may not need a region option.

Authentication Endpoints and Regions

All of the OpenStack createClient calls have a few options that can be provided:

region

region specifies which region of a service to use.

Specifying a custom region
var client = require('pkgcloud').compute.createClient({
    provider: 'openstack',
    username: 'your-user-name',
    password: 'your-api-key',
    authUrl: 'https://your-identity-service'
    region: 'Calxeda-AUS1'
});

Tokens and Expiration

When you make your first call to a OpenStack provider, your client is authenticated transparent to your API call. OpenStack will issue you a token, with an expiration. When that token expires, the client will automatically re-authenticate and retrieve a new token. The caller shouldn't have to worry about this happening.