Deploying App Engine Standard Applications from Eclipse

This page takes you through the steps of creating a new App Engine app in the Google Cloud Platform Console, authenticating with Google, and deploying your project to Google App Engine.

Before you begin

You need a Google Cloud Platform project with an App Engine application to deploy to. If you do not already have one, use the Google Cloud Platform Console to set up your GCP project:

Go to GCP Console

  1. Select or create a new GCP project.
  2. If you need to create an App Engine application for your project, you are prompted to select the region where you want your App Engine application located.
  3. The Dashboard opens after your App Engine application has been created in your project.
  4. Note the project ID. You'll need to supply this to Eclipse shortly.

Sign In to Google

First sign in to a Google account that is used to deploy your project to App Engine. Select the File > Sign in to Google… menu item.

Your system browser, such as Firefox, will open outside of Eclipse and ask for the permissions it needs to manage your App Engine applications:

1. View and manage your data across Google Cloud Platform services

Click Allow and close the window. Eclipse is now signed into your account.

Deploy the Project to App Engine


  • The appengine-web.xml file must be in the WEB-INF folder of your web application.

  • The project must have the App Engine Project facet. If you created it using the wizard, it should already have this facet. Otherwise,

  • Right click the project in the Package Explorer to bring up the context menu.

  • Select Configure > Convert to App Engine Project.

To deploy the project to App Engine Standard environment:

  1. Right click the project in the Package Explorer the project to open the context menu.
  2. Select Deploy to App Engine Standard
  3. A dialog pops up.
  4. Select the account you want to deploy with, or add a new account.
  5. The list of projects the account has access to loads. Select the one you want to deploy to.
  6. Click OK.

A background job launches that deploys the project to App Engine. The output of the job is visible in the Eclipse Console view.

By default, App Engine stops the previous version of your application and immediately promotes your new code to receive all traffic. If you'd rather manually promote it later using gcloud or the Google Cloud Platform Console, uncheck Promote the deployed version to receive all traffic. If you don't want to stop the previous version, uncheck Stop previous version.

What's next

Send feedback about...

Cloud Tools for Eclipse