1. Docs
  2. Intro to Pulumi
  3. Cloud Providers
  4. Google Cloud Platform (GCP)

Google Cloud Platform (GCP)

The Google Cloud Platform (GCP) provider for Pulumi can be used to provision any of the cloud resources available in GCP. The GCP provider must be configured with credentials to deploy and update resources in Google Cloud.

See the full API documentation for complete details of the available GCP provider APIs.

Setup

The GCP provider supports several options for providing access to Google Cloud credentials. See GCP setup page for details.

Getting Started

The quickest way to get started with GCP is to follow the Get Started guide.

Additionally, a tutorial is available to follow:

In addition to the tutorial, several interesting examples are available complete with instructions:

Example

const gcp = require("@pulumi/gcp")

const bucket = new gcp.storage.Bucket("my-bucket");

import * as gcp from "@pulumi/gcp";

const bucket = new gcp.storage.Bucket("my-bucket");

from pulumi_gcp import storage

bucket = storage.Bucket('my-bucket')

import (
    "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    "github.com/pulumi/pulumi-gcp/sdk/v5/go/gcp/storage"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		bucket, err := storage.NewBucket(ctx, "my-bucket", nil)
		if err != nil {
			return err
		}

		return nil
	})
}

using System.Threading.Tasks;
using Pulumi;
using Pulumi.Gcp;

class Program
{
    static Task Main() =>
        Deployment.Run(() => {
            var bucket = new Gcp.Storage.Bucket("my-bucket");
        });
}

You can find additional examples of using Google Cloud in the Pulumi examples repo.

Libraries

The following packages are available in packager managers:

The GCP provider is open source and available in the pulumi/pulumi-gcp repo.

Configuration

The GCP provider accepts the following configuration settings. These can be provided to the default GCP provider via pulumi config set gcp:<option>, or passed to the constructor of new gcp.Provider to construct a specific instance of the GCP provider.

  • project: (Required) The ID of the project to apply any resources to. This can also be specified using any of the following environment variables (listed in order of precedence): GOOGLE_PROJECT, GOOGLE_CLOUD_PROJECT, GCLOUD_PROJECT, CLOUDSDK_CORE_PROJECT.
  • credentials: (Optional) Contents of a file that contains your service account private key in JSON format. You can download your existing Google Cloud service account file from the Google Cloud Console, or you can create a new one from the same page. Credentials can also be specified using any of the following environment variables (listed in order of precedence): GOOGLE_CREDENTIALS, GOOGLE_CLOUD_KEYFILE_JSON, GCLOUD_KEYFILE_JSON. The GOOGLE_APPLICATION_CREDENTIALS environment variable can also contain the path of a file to obtain credentials from. If no credentials are specified, the provider will fall back to using the Google Application Default Credentials. If you are running Pulumi from a GCE instance, see Creating and Enabling Service Accounts for Instances for details.
  • region: (Optional) The region to operate under, if not specified by a given resource. This can also be specified using any of the following environment variables (listed in order of precedence): GOOGLE_REGION, GCLOUD_REGION, CLOUDSDK_COMPUTE_REGION.
  • zone: (Optional) The zone to operate under, if not specified by a given resource. This can also be specified using any of the following environment variables (listed in order of precedence): GOOGLE_ZONE, GCLOUD_ZONE, CLOUDSDK_COMPUTE_ZONE.
Register Now For PulumiUP