--- title: "Container Service on Google Cloud" description: "Deploy a container service on Google Cloud with Pulumi, Cloud Run, and Artifact Registry in TypeScript, Python, Go, C#, or HCL." url: "https://www.pulumi.com/dev/templates/container-service/gcp/" image: "https://www.pulumi.com/assets/og/dev/templates/container-service/gcp.png" --- # Container Service on Google Cloud Deploy a container service on Google Cloud with Pulumi, Cloud Run, and Artifact Registry in TypeScript, Python, Go, C#, or HCL. The Google Cloud Container Service template scaffolds a Pulumi project that deploys a containerized service to [Google Cloud Run](https://www.pulumi.com/registry/packages/gcp/api-docs/cloudrun) for serverless container execution, with the container image stored in Artifact Registry. The template ships with placeholder app content so the project deploys end to end out of the box. ![An architecture diagram of the Google Cloud Container Service template](./architecture.png) ## Using this template To use this template to deploy your own container service, make sure you've [installed Pulumi](https://www.pulumi.com/docs/install/) and [configured your Google Cloud credentials](https://www.pulumi.com/registry/packages/gcp/installation-configuration#credentials), then create a new [project](https://www.pulumi.com/docs/iac/concepts/projects/) using the template in the language of your choice: **TypeScript** ```bash mkdir my-container-service && cd my-container-service pulumi new container-gcp-typescript ``` **Python** ```bash mkdir my-container-service && cd my-container-service pulumi new container-gcp-python ``` **Go** ```bash mkdir my-container-service && cd my-container-service pulumi new container-gcp-go ``` **C#** ```bash mkdir my-container-service && cd my-container-service pulumi new container-gcp-csharp ``` **HCL** ```bash mkdir my-container-service && cd my-container-service pulumi new container-gcp-hcl ``` Follow the prompts to complete the new-project wizard. When it's done, you'll have a complete Pulumi project that's ready to deploy and configured with the most common settings. Feel free to inspect the code in `index.ts` for a closer look. ## Deploying the project **TypeScript / Python / Go / C#** You must supply an existing Google Cloud project ID and choose a region before deploying the container service. You can input both through the new-project wizard. Once the project is created, you can deploy it with [`pulumi up`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_up): **HCL** The template deploys into your active Google Cloud project (read from your gcloud credentials) and defaults to the `us-central1` region, which you can change with the `region` setting. Once the new project is created, you can deploy it with [`pulumi up`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_up): ```bash $ pulumi up ``` When the deployment completes, Pulumi exports the following [stack output](https://www.pulumi.com/docs/iac/concepts/stacks/#outputs) values: **`url`** The HTTP URL of your Cloud Run service. Output values like these are useful in many ways, most commonly as inputs for other stacks or related cloud resources. The computed `url`, for example, can be used from the command line to open the newly deployed container in your favorite web browser: ```bash $ open $(pulumi stack output url) ``` ## Customizing the project Projects created with the Container Service template expose the following [configuration](https://www.pulumi.com/docs/iac/concepts/config/) settings: **TypeScript / Python / Go / C#** **`containerPort`** The port mapping for the container service. Defaults to port `8080`. **`cpu`** The amount of CPU to allocate to each container instance. Defaults to `1` CPU. **`memory`** The amount of memory to allocate to each container instance. Defaults to `1Gi`. **`concurrency`** The maximum number of concurrent requests per container instance. Defaults to `50`. **`imageName`** The name of the container image deployed to your Cloud Run service. Defaults to `my-app`. **`appPath`** The location of the Dockerfile used to build the container image. Defaults to the `app` folder, which contains a "Hello World" example app. **HCL** **`region`** The Google Cloud region to deploy into. Defaults to `us-central1`. **`image_name`** The name of the container image deployed to your Cloud Run service. Defaults to `my-app`. **`app_path`** The location of the Dockerfile used to build the container image. Defaults to the `app` folder, which contains a "Hello World" example app. **`container_port`** The port mapping for the container service. Defaults to port `8080`. **`cpu`** The amount of CPU to allocate to each container instance. Defaults to `1` CPU. **`memory`** The amount of memory to allocate to each container instance. Defaults to `1Gi`. **`concurrency`** The maximum number of concurrent requests per container instance. Defaults to `80`. All of these settings are optional and may be adjusted either by editing the stack configuration file directly (by default, `Pulumi.dev.yaml`) or by changing their values with [`pulumi config set`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_config_set): **TypeScript / Python / Go / C#** ```bash $ pulumi config set containerPort 3000 $ pulumi up ``` **HCL** ```bash $ pulumi config set container_port 3000 $ pulumi up ``` ## Cleaning up You can cleanly destroy the stack and all of its infrastructure with [`pulumi destroy`](https://www.pulumi.com/docs/iac/cli/commands/pulumi_destroy): ```bash $ pulumi destroy ``` ## Learn more - Browse other architecture templates in the [Templates gallery](https://www.pulumi.com/templates). - Explore the [Google Cloud provider API docs](https://www.pulumi.com/registry/packages/gcp) in the Pulumi Registry. - Walk through Pulumi from the ground up in [Pulumi Tutorials](https://www.pulumi.com/dev/browse/?type=tutorial). - Read the latest [container posts on the Pulumi blog](https://www.pulumi.com/blog/tag/containers).