Skip to content
A highly productive multi-cloud framework for containers, serverless, and data
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
api
aws
azure Use 0.17 features (#718) Mar 6, 2019
build Make it simpler to run go tests consistently (#710) Mar 7, 2019
docker Address PR feedback Oct 10, 2017
examples Make it simpler to run go tests consistently (#710) Mar 7, 2019
scripts
.gitignore Delete yarn.lock files Nov 16, 2018
.travis.yml
CHANGELOG.md
CODE-OF-CONDUCT.md Adopt Contributor Covenant code of conduct Jun 1, 2018
Gopkg.lock Update pulumi dependencies Feb 12, 2019
Gopkg.toml
LICENSE
Makefile
README.md
cloud_test.go Run aws and azure tests in parallel. (#684) Jan 9, 2019
tslint.json Fix creation of TimeSpan timers in azure. (#610) Sep 25, 2018

README.md

Build Status

Pulumi Cloud Framework

Pulumi's multi-cloud framework for building modern container and serverless cloud applications.

Installing

This package is available for Node.js (JavaScript or TypeScript).

To install the core API package, use either npm:

$ npm install @pulumi/cloud

or yarn:

$ yarn add @pulumi/cloud

Note that there are implementation packages for each major cloud provider that you will need also.

For AWS, install the package using either npm:

$ npm install @pulumi/cloud-aws

or yarn:

$ yarn add @pulumi/cloud-aws

Note: At the moment, only Amazon Web Services (AWS) support is fleshed out enough to be used. Azure support is currently being worked on and is in an early preview state. It can be used, but issues may be encountered. To use Azure change the above lines to:

$ npm install @pulumi/cloud-azure
$ yarn add @pulumi/cloud-azure

We also intend to support GCP in the future. https://github.com/pulumi/pulumi-cloud/issues/518 tracks this request.

Concepts

The Pulumi Cloud Framework is in preview. It provides abstractions that can allow one to write a cloud-application on many different cloud providers (i.e. Amazon Web Services (AWS), Azure, Google Cloud Platform (GCP)), using a common API.

There is an abstraction package, @pulumi/cloud, that defines the APIs common to all cloud providers. This provides a highly productive view on modern cloud architectures, akin to Java or .NET's approach to operating systems. Because these abstractions allow one to operate over different cloud platforms in a consistent manner, low level functionality and capabilities of the individual platforms are intentionally not exposed.

There are implementation packages for individual cloud providers, such as @pulumi/cloud-aws, which first and foremost implement those APIs for the target cloud in question, but also offer more specific functionality in the form of derived classes that provide cloud-specific functionality. This allows you to mix multi-cloud code with cloud-specific logic.

Note that you are free, of course, to intersperse these abstractions with specific resources in your cloud platform of choice, using the appropriate Pulumi platform framework. This delivers the highest fidelity possible. For example, pulumi/pulumi-aws or pulumi/pulumi-azure. These frameworks will give access to the full power of those platforms, but will in turn create applications specific to them.

Packages

Currently, Pulumi Cloud contains two primary packages: api and aws.

@pulumi/cloud defines the cloud abstractions common to building modern cloud applications, and can be used by any Pulumi application directly for cloud-neutral logic. For example, the Service type expresses a load balanced container, API exposes simple serverless functions over HTTP, and timer allows you to schedule timers. All serverless functions are expressed using lambdas in your language of choice. The package also offers simple data abstractions, systems like Table and Bucket.

@pulumi/cloud-aws supplies an implementation of those abstractions, built on top of the @pulumi/aws library. Its implementation types offer more AWS-specific functionality than is available in the @pulumi/cloud package.

To use either, simply reference them in the usual NPM style in your program. You may decide to code against either the APIs or the implementation types, depending on the style of code you're writing and functionality you need.

If you code against @pulumi/cloud directly, you will need to configure your program before running pulumi update. This can be done simply by running the pulumi config set command; for instance, to select aws, you will run:

$ pulumi config set cloud:provider aws

For more details see the examples in examples, or online at: https://docs.pulumi.com/quickstart/

Reference

For detailed reference documentation, please visit the API docs site for the package in question:

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.