Getting started with .NET on Compute Engine

This tutorial shows how to get started with Compute Engine.Follow this tutorial by deploying a Hello World .NET webapp to Compute Engine. For help getting started with App Engine, seetheApp Engine standard environment.

Objectives

  • Deploy a Hello World sample app to a single Compute Engine instance.

Costs

In this document, you use the following billable components of Google Cloud:

To generate a cost estimate based on your projected usage, use thepricing calculator.

New Google Cloud users might be eligible for afree trial.

Before you begin

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Compute Engine API.

    Enable the API

  5. Install.NET Core SDK 2.1 or later on your local machine runningMicrosoft Windows.

  6. InstallWeb Deploy 3.6 or later on your local machine runningMicrosoft Windows.

Running the app locally

  1. Download and unzip or clone the sample repository from github:

    git clone https://github.com/GoogleCloudPlatform/getting-started-dotnet.git

  2. In a PowerShell window, go into theHelloWorld directory:

    cd getting-started-dotnet\HelloWorld

  3. Start a local web server:

    dotnet run

  4. Open a web browser tolocalhost:8080.

    In your web browser, you see some Hello World text, served from yourlocal machine.

  5. When you're ready to move on, stop the local web server by pressingControl+C.

Deploying to a single instance

This section walks you through running a single instance of your appon Compute Engine.

Single-instance deployment.

Create and configure a Compute Engine instance

From Google Cloud Marketplace, you can launch an instance of Windows running Microsoft IIS on Compute Engine.

  1. In the Google Cloud console, go to theASP.NET Framework Cloud Marketplace page.

    Go to Cloud Marketplace

  2. ClickLaunch.

  3. Leave the settings set to their default values, and clickDeploy.

    Wait for the Compute Engine instance to deploy. It usuallytakes about 5 minutes to deploy.

  4. To display resource information, clickVM instance.

  5. To edit the VM instance, clickManage Resource.

  6. ClickSet Windows password, and then make a note of the username.

  7. Copy the new Windows password, and then clickClose.

  8. In theVM instance details page, make a note of the external IP address.

  9. On your local Windows machine, edit the fileHelloWorld/Properties/PublishProfiles/ComputeEngine.pubxml.

  10. Enter your VM instance's external IP address between<MSDeployServiceURL>and</MSDeployServiceURL>. For example,<MSDeployServiceURL>203.0.113.22</MSDeployServiceURL>

  11. Enter the instance's username that you previously noted between<UserName> and</UserName>.

  12. Save your changes to theComputeEngine.pubxml file.

  13. In a PowerShell window, publish your app to the Compute Engine instance:

    dotnet publish -c Release `  /p:PublishProfile=Properties\PublishProfiles\ComputeEngine.pubxml `  "/p:Password=YOUR-PASSWORD"

    ReplaceYOUR-PASSWORD with the password you previously copied.

  14. Open a web browser to your instance's external IP address.

    In your web browser, you see some Hello World text, served from yourCompute Engine instance.

Manage and monitor an instance

You can use the Google Cloud console to monitor and manage your instance.

  1. To view all of the logs generated by your Compute Engine resources, go to theLogs Explorer page.

    Go to Logs Explorer

    Cloud Logging is automatically configured to gather logs from various common services, includingsyslog.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used in this tutorial, either delete the project that contains the resources, or keep the project and delete the individual resources.

Delete the project

    Caution: Deleting a project has the following effects:
    • Everything in the project is deleted. If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.
    • Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as anappspot.com URL, delete selected resources inside the project instead of deleting the whole project.

    If you plan to explore multiple architectures, tutorials, or quickstarts, reusing projects can help you avoid exceeding project quota limits.

  1. In the Google Cloud console, go to theManage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then clickDelete.
  3. In the dialog, type the project ID, and then clickShut down to delete the project.

Delete the individual resources

gcloudcomputeinstancesdeletemy-app-instance--zone=YOUR_ZONE--delete-disks=allgcloudcomputefirewall-rulesdeletedefault-allow-http-80

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-09 UTC.