Pulumi Deployments

Note

Pulumi Deployments is currently in preview.

Please post any bug reports or feature requests in the Service Requests repo.

Pulumi Deployments is a Pulumi Service feature that automates the execution of your Pulumi programs in a secure, hosted environment. Deploy any stack with a click of a button, git push, or API call. Available in preview today.

You can use this feature on your Pulumi individual account or in a Pulumi organization.

Click-to-deploy in the Console

Deploy infrastructure with the click of a button from the Pulumi Service console.

deploy-actions

Git push-to-deploy from GitHub

Configure automatic infrastructure deployments in response to git push events by installing and configuring the Pulumi GitHub App.

GitHub App Installation

You’ll need to install and configure the Pulumi GitHub App to use push-to-deploy functionality. The app requires read access to your repos so it can clone your Pulumi programs and listen to merge commits to automatically trigger deployments on git push.

Warning

While the app can be installed via GitHub, it must be installed through the Pulumi Service using the steps below to ensure correct setup. Installing through the Pulumi Service ensures we have a connection from Pulumi to your GitHub user or organization.

Follow these steps:

Ensure you have selected the Pulumi organization you wish to use with Pulumi Deployments in the Organization drop-down.
Navigate to Settings > Integrations.
Select the “Install the Pulumi GitHub App” button.
If this page says you already have the app installed, you can stop here. If the page asks you to accept additional permissions for the app, please accept the permissions and stop here.
After clicking “Install” you will be directed to GitHub. Select the GitHub organization you wish to use with Pulumi Deployments.
Select which repos (or all repos) Pulumi Deployments can have access to, and then Install.
You will be redirected to the Pulumi Service (app.pulumi.com). Return to the Settings > Integrations tab and confirm the GitHub App is installed on your desired organization.

If you installed the GitHub app in the past and the steps above aren’t showing it as installed for your desired organization, please try the following:

Ensure you’re a GitHub admin of the GitHub organization where you’re installing the app.
Uninstall the app (via GitHub) and re-install it following the steps above. Note: Uninstalling the app will delete any push-to-deploy configurations you may have already setup.

Deployment Settings

We need your GitHub repo and branch in order to connect a stack to Pulumi Deployments. Follow these steps to get a Deployment running:

Navigate to a stack you want to connect to Pulumi Deployments.
Go to Settings > Deploy.
Select the GitHub Repository with source context for Pulumi to Deploy.
Select the branch.
Ensure you have the required Environment Variables to run your repository.

Create a Deployment

You can create a Deployment by using the Deploy Actions buttons or by pushing a commit to a GitHub pull request.

Programmatic deployments via the Pulumi Service REST API

Pulumi Deployments REST API is a fully managed REST API to execute Pulumi programs with the Pulumi Service. This includes APIs to observe your deployment and all associated logs.