Go 1.11 has reached end of support
and will be deprecated
on January 31, 2026. After deprecation, you won't be able to deploy Go 1.11
applications, even if your organization previously used an organization policy to
re-enable deployments of legacy runtimes. Your existing Go
1.11 applications will continue to run and receive traffic after their deprecation date
. We
recommend that you migrate to the latest supported version of Go
.
Defining Runtime Settings
Stay organized with collections
Save and categorize content based on your preferences.
A Go 1.11 app in App Engine is configured using an app.yaml
file, that contains the runtime, handlers, scaling, and other general settings
including environment variables.
About app.yaml
files
You can specify the runtime configuration for your Go 1.11 app,
including versions and URLs, in the app.yaml
file. This file acts as a
deployment descriptor of a specific service
version. You must first create the app.yaml
file for the default
service of your app
before you can create and deploy app.yaml
files for additional services.
Generally, your app.yaml
file requires only the runtime
element for a simple
Go 1.11 app in the standard environment, for
example:
runtime
:
go111
To learn more about structuring multiple services and app.yaml
files in your
app, see Structuring Web Services
. App Engine provides default values for all other settings, including
the F1 instance class
, which
determines the memory and CPU resources that are available to your app, and automatic scaling
,
which controls how and when new instances of your app are created.
If you need to override the default settings, create an app.yaml
file and
specify the settings you need. For more information, see app.yaml
file reference
.
You can specify a unique name for your app.yaml
files, but then you must
specify the file name with the deployment
command
as well. For example, if you name your app.yaml
file service-name-app.yaml
or app.standard.yaml
, then you must deploy your app using either:
gcloud app deploy service-name-app.yaml
gcloud app deploy app.standard.yaml
All configuration elements
For a complete list of all the supported elements in this configuration file,
see the app.yaml
reference
.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eA Go 1.11 app in App Engine uses an \u003ccode\u003eapp.yaml\u003c/code\u003e file to configure its runtime, handlers, scaling, environment variables, and other settings.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapp.yaml\u003c/code\u003e file is essential for deploying a specific service version and must be created for the default service before adding others.\u003c/p\u003e\n"],["\u003cp\u003eA simple Go 1.11 app generally only needs the \u003ccode\u003eruntime\u003c/code\u003e element specified in its \u003ccode\u003eapp.yaml\u003c/code\u003e file, with other settings defaulting to App Engine's configurations.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the default settings of your app by creating an \u003ccode\u003eapp.yaml\u003c/code\u003e file and overriding the desired settings.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003eapp.yaml\u003c/code\u003e can be named uniquely, doing so requires you to specify the file's name in the deployment command.\u003c/p\u003e\n"]]],[],null,["# Defining Runtime Settings\n\nA Go 1.11 app in App Engine is configured using an `app.yaml`\nfile, that contains the runtime, handlers, scaling, and other general settings\nincluding environment variables.\n\nAbout `app.yaml` files\n----------------------\n\n\u003cbr /\u003e\n\nYou can specify the runtime configuration for your Go 1.11 app, including versions and URLs, in the `app.yaml` file. This file acts as a deployment descriptor of a specific [service](/appengine/docs/legacy/standard/go111/an-overview-of-app-engine) version.\n\nYou must first create the `app.yaml` file for the `default` service of your app\nbefore you can create and deploy `app.yaml` files for additional services.\n\n\nGenerally, your `app.yaml` file requires only the `runtime` element for a simple\nGo 1.11 app in the standard environment, for\nexample: \n\n runtime: go111\n\nTo learn more about structuring multiple services and `app.yaml` files in your app, see [Structuring Web Services](/appengine/docs/legacy/standard/go111/configuration-files).\n\nApp Engine provides default values for all other settings, including\nthe [F1 instance class](/appengine/docs/standard#instance_classes), which\ndetermines the memory and CPU resources that are available to your app, and\n[automatic scaling](/appengine/docs/legacy/standard/go111/how-instances-are-managed#scaling_types),\nwhich controls how and when new instances of your app are created.\n\nIf you need to override the default settings, create an `app.yaml` file and\nspecify the settings you need. For more information, see\n[`app.yaml` file reference](/appengine/docs/legacy/standard/go111/config/appref).\n\n\nYou can specify a unique name for your `app.yaml` files, but then you must\nspecify the file name with the [deployment\ncommand](/appengine/docs/legacy/standard/go111/testing-and-deploying-your-app)\nas well. For example, if you name your `app.yaml` file `service-name-app.yaml`\nor `app.standard.yaml`, then you must deploy your app using either: \n\n gcloud app deploy service-name-app.yaml\n gcloud app deploy app.standard.yaml\n\n\u003cbr /\u003e\n\nAll configuration elements\n--------------------------\n\n\nFor a complete list of all the supported elements in this configuration file,\nsee the\n[`app.yaml` reference](/appengine/docs/legacy/standard/go111/config/appref)."]]