Deploying your Go app on Google App Engine

Mar 28, 2018 · 3 min read
Google Cloud Platform

This tutorial will show you how to deploy a Go app to both the GCP App Engine Standard and Flexible Environments


  • You have the gcloud tool installed
  • You have Go installed
  • You have a project in GCP

Let’s Get Started

First, let’s make a directory and enter it:

mkdir ~/hello-world-go && cd hello-world-go

Now make sure we set our GOPATH to this directory:

export GOPATH=$(pwd):$GOPATH

Next, we’ll set up our project directory:

mkdir -p src/go-app && cd src/go-app

And now let’s go get the GCP App Engine library:

go get -u

Finally, we’ll set our Project ID (from GCP) as an environmental variable and configure gcloud to use it:

gcloud config set project $PROJECT_ID

Time to Write Some Some Code

First we need to make an app.yaml file to configure your project’s settings:

runtime: go
api_version: go1
env: standard
- url: /.*
script: _go_app

This tells the App Engine that we want to use the Go runtime, that we want to use the Standard environment, and sets up the handlers for when the server gets a request.

Take note of line 3 where it says env: standard

Now let’s make our main.go file for our server:

package mainimport (
func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello, world!") // Response to request
func main() {
http.HandleFunc("/", handler) // Set endpoint handler
appengine.Main() // Start the server

This first imports the libraries that we need, then sets up a handler for when you hit the / endpoint, and finally starts the server.

Let’s Deploy!

This is so easy, simply run:

gcloud app deploy

And make sure to hit Y when it asks you Do you want to continue (Y/n)?

Protip: use yes | gcloud app deploy if you want to skip the confirmation

Now, this should take ~30 seconds to deploy (sooooooo fast).

When it’s done either run gcloud app browse or open your browser to https://<project-id>


Above, we deployed our Go app to the App Engine Standard Environment. But now let’s see how easy it is to deploy to the Flexible Environment.

Remember our app.yaml file? Let’s change one word in line three:

runtime: go
api_version: go1
env: flex
- url: /.*
script: _go_app

Can you spot the difference? We changed env: standard to env: flex

Now simply re-run gcloud app deploy and hit Y again to confirm. Since we are deploying to the Flex Environment, this will take a bit longer (on the order of 3–5 minutes).

There’s different advantages for each environment, and I won’t discuss them here. However, if you want to look into it, there is a quick guide here on Choosing an App Engine Environment.

👋 ✌️

Thanks for reading! If you have any questions, comment below!


Written by


Student at the University of Washington

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade