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 Deployments is a new product to power infrastructure and platform automation. It consists of three components:
- The Programmatic Deployment API - run Pulumi programs (
pulumi up,pulumi refresh, etc) on Pulumi Service hardware (api.pulumi.com). This includes APIs to observe your deployment and all associated logs as it runs. - Click to Deploy - click a button from the Pulumi Service Console to run an ad hoc update on your stack.
- Deployment Visualization - rich UX to visualize deployment status, deployment logs, and queueing from via the Pulumi Service Console (app.pulumi.com).
git pushto Deploy - Configure a stack to deploy automatically in response togit pushevents by installing the Pulumi GitHub App.
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, cancellations, 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.
Watch the introduction video by clicking below
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
ttlstack 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.
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.
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.