pulumi/pulumi


Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your favorite language.

https://www.pulumi.com

License: Apache-2.0

Language: Go

Keywords: aws, azure, containers, gcp, infrastructure-as-code, kubernetes, serverless


Slack NPM version Python version GoDoc License

Pulumi's Infrastructure as Code SDK is the easiest way to create and deploy cloud software that use containers, serverless functions, hosted services, and infrastructure, on any cloud.

Simply write code in your favorite language and Pulumi automatically provisions and manages your AWS, Azure, Google Cloud Platform, and/or Kubernetes resources, using an infrastructure-as-code approach. Skip the YAML, and use standard language features like loops, functions, classes, and package management that you already know and love.

For example, create three web servers:

let aws = require("@pulumi/aws");
let sg = new aws.ec2.SecurityGroup("web-sg", {
    ingress: [{ protocol: "tcp", fromPort: 80, toPort: 80, cidrBlocks: ["0.0.0.0/0"]}],
});
for (let i = 0; i < 3; i++) {
    new aws.ec2.Instance(`web-${i}`, {
        ami: "ami-7172b611",
        instanceType: "t2.micro",
        securityGroups: [ sg.name ],
        userData: `#!/bin/bash
            echo "Hello, World!" > index.html
            nohup python -m SimpleHTTPServer 80 &`,
    });
}

Or a simple serverless timer that archives Hacker News every day at 8:30AM:

const aws = require("@pulumi/aws");

const snapshots = new aws.dynamodb.Table("snapshots", {
    attributes: [{ name: "id", type: "S", }],
    hashKey: "id", billingMode: "PAY_PER_REQUEST",
});

aws.cloudwatch.onSchedule("daily-yc-snapshot", "cron(30 8 * * ? *)", () => {
    require("https").get("https://news.ycombinator.com", res => {
        let content = "";
        res.setEncoding("utf8");
        res.on("data", chunk => content += chunk);
        res.on("end", () => new aws.sdk.DynamoDB.DocumentClient().put({
            TableName: snapshots.name.get(),
            Item: { date: Date.now(), content },
        }).promise());
    }).end();
});

Many examples are available spanning containers, serverless, and infrastructure in pulumi/examples.

Pulumi is open source under the Apache 2.0 license, supports many languages and clouds, and is easy to extend. This repo contains the pulumi CLI, language SDKs, and core Pulumi engine, and individual libraries are in their own repos.

Welcome

  • Getting Started: get up and running quickly.

  • Tutorials: walk through end-to-end workflows for creating containers, serverless functions, and other cloud services and infrastructure.

  • Examples: browse a number of useful examples across many languages, clouds, and scenarios including containers, serverless, and infrastructure.

  • Reference Docs: read conceptual documentation, in addition to details on how to configure Pulumi to deploy into your AWS, Azure, or Google Cloud accounts, and/or Kubernetes cluster.

  • Community Slack: join us over at our community Slack channel. Any and all discussion or questions are welcome.

  • Roadmap: check out what's on the roadmap for the Pulumi project over the coming months.

Getting Started

See the Get Started guide to quickly get started with Pulumi on your platform and cloud of choice.

Otherwise, the following steps demonstrate how to deploy your first Pulumi program, using AWS Serverless Lambdas, in minutes:

  1. Install:

    To install the latest Pulumi release, run the following (see full installation instructions for additional installation options):

    $ curl -fsSL https://get.pulumi.com/ | sh
  2. Create a Project:

    After installing, you can get started with the pulumi new command:

    $ mkdir pulumi-demo && cd pulumi-demo
    $ pulumi new hello-aws-javascript

    The new command offers templates for all languages and clouds. Run it without an argument and it'll prompt you with available projects. This command created an AWS Serverless Lambda project written in JavaScript.

  3. Deploy to the Cloud:

    Run pulumi up to get your code to the cloud:

    $ pulumi up

    This makes all cloud resources needed to run your code. Simply make edits to your project, and subsequent pulumi ups will compute the minimal diff to deploy your changes.

  4. Use Your Program:

    Now that your code is deployed, you can interact with it. In the above example, we can curl the endpoint:

    $ curl $(pulumi stack output url)
  5. Access the Logs:

    If you're using containers or functions, Pulumi's unified logging command will show all of your logs:

    $ pulumi logs -f
  6. Destroy your Resources:

    After you're done, you can remove all resources created by your program:

    $ pulumi destroy -y

To learn more, head over to pulumi.com for much more information, including tutorials, examples, and details of the core Pulumi CLI and programming model concepts.

Platform

CLI

Architecture Build Status
Linux/macOS x64 Linux x64 Build Status
Windows x64 Windows x64 Build Status

Languages

Language Status Runtime
JavaScript Stable Node.js 8+
TypeScript Stable Node.js 8+
Python Stable Python 3.6+
Go Preview Go 1.x

Clouds

See Supported Clouds for the full list of supported cloud and infrastructure providers.

Contributing

Please See CONTRIBUTING.md for information on building Pulumi from source or contributing improvements.

Project Statistics

Sourcerank 15
Repository Size 22.8 MB
Stars 4,199
Forks 226
Watchers 110
Open issues 439
Dependencies 562
Contributors 49
Tags 193
Created
Last updated
Last pushed

Top Contributors See all

Joe Duffy Matt Ellis CyrusNajmabadi Pat Gavlin Luke Hoban Sean Gillespie Chris Smith Alex Clemmer Matthew Riley Justin Van Patten Mikhail Shilkov James Nugent Paul Stack khyperia Britton Forsyth Thomas Schersach Erin Donnelly praneetloke david raistrick Cameron Stokes

Packages Referencing this Repo

github.com/pulumi/pulumi/pkg/resource/edit
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/util/result
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/backend/httpstate/client
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
@parisholley/pulumi
Pulumi's Node.js SDK
Latest release 1.6.0-alpha.1575564388 - Updated - 4.2K stars
github.com/pulumi/pulumi/pkg/resource/deploy/providers
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/util/ciutil
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/backend/display
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
pulumi
Pulumi's Python SDK
Latest release 1.7.0a1575548199 - Updated - 4.2K stars
@pulumi/pulumi
Pulumi's Node.js SDK
Latest release 1.7.0-alpha.1575548199 - Updated - 4.2K stars
github.com/pulumi/pulumi/pkg/secrets/passphrase
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/util/validation
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/resource/deploy/deploytest
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/backend/filestate
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/backend/httpstate
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/sdk/go/pulumi-language-go
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/version
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/sdk/go/pulumi/config
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/sdk/go/pulumi/asset
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/util/gitutil
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars
github.com/pulumi/pulumi/pkg/util/retry
Modern Infrastructure as Code - Create, deploy, and manage infrastructure on any cloud using your...
Latest release v1.6.1 - Published - 4.2K stars

Recent Tags See all

v1.6.1 November 26, 2019
v1.6.0 November 20, 2019
v1.5.2 November 13, 2019
v1.5.1 November 07, 2019
v1.5.0 November 06, 2019
v1.4.1 November 01, 2019
v1.4.0 October 24, 2019
v1.3.4 October 18, 2019
v1.3.4 October 18, 2019
v1.3.4 October 18, 2019
v1.3.3 October 17, 2019
v1.3.2 October 15, 2019
v1.3.2 October 15, 2019
v1.3.2 October 15, 2019
v1.3.1 October 10, 2019

Something wrong with this page? Make a suggestion

Last synced: 2019-10-24 21:15:34 UTC

Login to resync this repository