NOTE: This is a feature in private preview. By getting access to this repository you understand not to speak publicly about the feature and not to discuss it with users outside of the private preview.

Pulumi Deploy

Pulumi Deploy is a new product to power infrastructure and platform automation. It consists of three components:

1. The Programmatic Deployment API - run Pulumi programs (pulumi up, pulumi refresh, etc) on Pulumi Service hardware (api.pulumi.com).
2. Deployment Visualization - rich UX to visualize deployment status, deployment logs, and queueing from via the Pulumi Service Console (app.pulumi.com). (coming soon!)
3. git push to Deploy - Configure a stack to deploy automatically in response to git push events by installing the Pulumi GitHub App.(coming soon!)

A deployment in the Pulumi Service runs on an isolated, single use deployment runner (a virtual machine). That runner will prepare the runtime environment, clone source code, set up any necessary environment variables, run the Pulumi program, and handle reporting logs and status back to the Pulumi Service.

This API enables many of the same scenarios as Automation API, like platform building, self-service infrastructure, customer infrastructure workflows and portals, and more. The main difference is that Automation API programs run on your hardware, where you're responsible for handling asynchrony, workflow, reporting status, cancellatios, etc. The Pulumi Deployment API takes care of workflow for you, providing API endpoints to monitor deployments, tail update logs, queue deployments, and cancel deployments.

Docs

• API Docs
• Git Push To Deploy
• Deployment Driver Sample (TypeScript)
• Deployment Driver Sample (Go)

Examples

Deployment driver examples show using the Pulumi Deployment API to create deployments, monitor status, and tail logs.

• typescript-driver - a deployment driver written in Typescript. It can deploy Pulumi programs written in any language.
• Go CLI driver - a deployment driver written in Typescript. It can deploy Pulumi programs written in any language.
• TTL Stacks - infrastructure that enables temporary stacks. Set a ttl stack tag, run an update, and the stack automatically gets destroyed by Pulumi Deployment API after the expiration period.
• Drift Detection - infrastructure that detects when desired state diverges from reality. Automatically detect when manual changes are made to your infrastructure and not synced to the Pulumi program.

Pulumi Programs

We have a set of demo Pulumi programs that can be conveniently referenced as git source within this repo. They can be found in the pulumi-programs directory.

Share feedback

We are really excited to start garnering feedback on Pulumi Deploy from users. Please feel free to open an issue in this repo for enhancements or bugs or ask to be invited to the private #pulumi-deploy-beta Slack channel to ask us questions.