Python 3.8 is now generally available.

Creating Your Google Cloud Project

To deploy your app to App Engine, you must create a Google Cloud project and your App Engine application resources.

The Cloud project is a top-level container that holds your App Engine application and other Google Cloud resources.

The App Engine application is a resource that you must create to enable App Engine. The App Engine application resource defines the region in which you want to run your web service and store its related settings, credentials, and metadata. Only a single App Engine application resource can be created per Cloud project and the specified region cannot be changed after those resources are created.

If you already have a Cloud project with App Engine enabled, you can continue to Writing Your Web Service.

Creating a Cloud project

To create a Cloud project and your App Engine resources using the Cloud SDK:

  1. Install and initialize the Cloud SDK. When prompted, select Create a new project. If you already have the SDK installed, you can create a project by running gcloud projects create PICK_A_NAME.
  2. Run the following gcloud command to enable App Engine and create the associated application resources. Note that the location you select cannot be changed later.
    gcloud app create
  3. Make sure that billing is enabled for your project.

    Learn how to enable billing

    Tip: Running only the sample app in this topic does not exceed the free quotas. You will be charged only if you exceed those quotas, for example, by running other samples and adding other services to the same GCP project.

App Engine locations

App Engine is regional, which means the infrastructure that runs your apps is located in a specific region, and Google manages it so that it is available redundantly across all of the zones within that region.

Meeting your latency, availability, or durability requirements are primary factors for selecting the region where your apps are run. You can generally select the region nearest to your app's users, but you should consider the locations where App Engine is available as well as the locations of the other Google Cloud products and services that your app uses. Using services across multiple locations can affect your app's latency as well as its pricing.

You cannot change an app's region after you set it.

If you already created an App Engine application, you can view its region by doing one of the following:

Next steps

Now that your Cloud project is set up, you're ready to write a basic web service.