App Engine Quickstart using Go
App Engine Quickstart
This tutorial shows you how to deploy a sample application to App Engine using the
Here are the steps you will be taking.
Create a project
Projects bundle code, VMs, and other resources together for easier development and monitoring.
Build and run your "Hello, world!" app
You will learn how to run your app using Cloud Shell, right in your browser. At the end, you'll deploy your app to the web using the
After the tutorial...
Your app will be real and you'll be able to experiment with it after you deploy, or you can remove it and start fresh.
GCP organizes resources into projects, which collect all of the related resources for a single application in one place.
Begin by creating a new project or selecting an existing project for this tutorial.
For details, see Creating a project.
Using Cloud Shell
Cloud Shell is a built-in command-line tool for the console. We're going to use Cloud Shell to deploy our app.
Open Cloud Shell
Open Cloud Shell by clicking the
Clone the sample code
Use Cloud Shell to clone and navigate to the "Hello World" code. The sample code is cloned from your project repository to the Cloud Shell.
git clone https://github.com/GoogleCloudPlatform/golang-samples
Then, switch to the tutorial directory:
Configuring your deployment
You are now in the main directory for the sample code. We'll look at the files that configure your application.
Exploring the application
Enter the following command to view your application code:
Exploring your configuration
App Engine uses YAML files to specify a deployment's configuration.
app.yaml files contain information about your
application, like the runtime environment, URL handlers, and more.
Enter the following command to view your configuration file:
Testing your app
Test your app on Cloud Shell
Cloud Shell lets you test your app before deploying to make sure it's running as intended, just like debugging on your local machine.
To test your app enter the following:
go run .
Preview your app with "Web preview"
Your app is now running on Cloud Shell. You can access the app by clicking the
Terminating the preview instance
Terminate the instance of the application by pressing
Ctrl+C in the Cloud Shell.
Deploying to App Engine
Create an application
To deploy your app, you need to create an app in a region:
gcloud app create
Deploying with Cloud Shell
You can use Cloud Shell to deploy your app. To deploy your app enter the following:
gcloud app deploy
Visit your app
Congratulations! Your app has been deployed.
The default URL of your app is a subdomain on appspot.com that starts with your project's ID:
Try visiting your deployed application.
View your app's status
You can check in on your app by monitoring its status on the App Engine dashboard.
Open the Navigation menu in the upper-left corner of the console.
Then, select the App Engine section.
Disable your project
You have successfully deployed an App Engine application!
Here are some next steps for building your next application and learning to use App Engine with other GCP products:
Download the Google Cloud SDK and develop locally.
Install the Google Cloud SDK on your local machine.