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

  1. You need a Google Cloud Platform project with an App Engine application to deploy to. If you don't 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. Sign in to a Google account that is used to deploy your project to App Engine.

    1. Select File > Sign in to Google.

      If you see Manage Google Accounts instead of the Sign in to Google option, that means you are already signed in, so you can skip these account sign in steps.

    2. Your system browser opens outside of Eclipse and asks for the permissions it needs to manage your App Engine applications:

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

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

  3. Ensure that the appengine-web.xml file is in the WEB-INF folder of your web application.

  4. Ensure that the project has the App Engine Project facet. If you created it using the wizard, it should already have this facet. Otherwise:

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

    2. Select Configure > Convert to App Engine Project.

Deploy the Project to App Engine

To deploy the project to App Engine standard environment:

  1. Right click the project in the Package Explorer 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

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Tools for Eclipse
Need help? Visit our support page.