Before You Begin

Before you get started using Pulumi, let’s run through a few quick steps to ensure your environment is set up correctly.

Install Pulumi

Install Pulumi on macOS through Homebrew:

$ brew install pulumi

Install Pulumi on Linux by running the installation script:

$ curl -fsSL https://get.pulumi.com | sh

Install Pulumi on Windows using elevated permissions through the Chocolatey package manager:

> choco install pulumi

For alternative installation instructions (e.g. script-based installation, binaries, etc.) or troubleshooting, see Download and Install.

Next, install the required language runtime, if you have not already.

Install Language Runtime

Choose Your Language

Install Node.js.

Install Python version 3.6 or later. To reduce potential issues with setting up your Python environment on Windows or macOS, you should install Python through the official Python installer.

Install Go.

Install .NET Core 3.1 SDK or later.

Finally, configure Pulumi with Google Cloud.

Configure Pulumi to access your Google Cloud account

Pulumi requires cloud credentials to manage and provision resources. You must use an IAM user or service account that has Programmatic access with rights to deploy and manage your Google Cloud resources.

In this guide, you will need an IAM user account with permissions that can create and populate a Cloud Storage bucket, such as those in the predefined Storage Admin (roles/storage.admin) or the Storage Legacy Bucket Owner (roles/storage.legacyBucketOwner) roles.

When developing locally, we recommend that you install the Google Cloud SDK and then authorize access with a user account.

If gcloud is not configured to interact with your Google Cloud project, set it with the config command using the project’s ID:

gcloud config set project <YOUR_GCP_PROJECT_ID>

Next, Pulumi requires default application credentials to interact with your Google Cloud resources, so run auth application-default login command to obtain those credentials.

gcloud auth application-default login

For additional information on setting and using Google Cloud credentials, see Google Cloud Setup.

Next, you’ll create a new Pulumi project.