Create a New Project

Now that you have set up your environment by installing Pulumi, installing your preferred language runtime, and configuring your Google Cloud credentials, let’s get started with creating your first Pulumi program.

In this guide you will:

Create a new Pulumi project.
Provision a new Google Cloud Storage bucket.
Add an index.html file to your bucket.
Serve the index.html as a static website.
Destroy the resources you’ve provisioned.

To get started, first create a new directory and project.

$ mkdir quickstart && cd quickstart
$ pulumi new gcp-javascript

$ mkdir quickstart && cd quickstart
$ pulumi new gcp-typescript

$ mkdir quickstart && cd quickstart
$ pulumi new gcp-python

# from within your $GOPATH
$ mkdir quickstart && cd quickstart
$ pulumi new gcp-go

$ mkdir quickstart && cd quickstart
$ pulumi new gcp-csharp

The pulumi new command creates a new Pulumi project with some basic scaffolding based on the cloud and language specified.

Note

If this is your first time running pulumi new or most other pulumi commands, you will be prompted to log in to the Pulumi service. The Pulumi CLI works in tandem with the Pulumi service in order to deliver a reliable experience. It is free for individual use, with features available for teams. Hitting ENTER at the prompt opens up a web browser allowing you to either sign in or sign up.

After logging in, the CLI will proceed with walking you through creating a new project.

First, you will be asked for a project name and description. Hit ENTER to accept the default values or specify new values.

Next, you will be asked for the name of a stack. Hit ENTER to accept the default value of dev.

Finally, you will be prompted for some configuration values for the stack. For Google Cloud projects, you will be prompted for the Google Cloud region. You can accept the default value or choose another value like us-west1.

What are projects and stacks? Pulumi projects and stacks let you organize Pulumi code. Consider a Pulumi project to be analogous to a GitHub repo—a single place for code—and a stack to be an instance of that code with a separate configuration. For instance, Project Foo may have multiple stacks for different development environments (Dev, Test, or Prod), or perhaps for different cloud configurations (geographic region for example). See Organizing Projects and Stacks for some best practices on organizing your Pulumi projects and stacks.

After some dependency installations from `npm`, the project and stack will be ready.

After the command completes, the project and stack will be ready.

Next, we’ll review the generated project files.

← Previous Step Review the New Project →

Create a New Project

On This Page