Deploying App Engine Standard Applications from Eclipse

Note: Cloud Tools for Eclipse is only compatible with the App Engine Java 8 runtime, which will reach the end of support on January 31, 2024. After this date, your existing Java 8 applications will continue to run and receive traffic. However, you cannot deploy new or update existing applications that use runtimes after their end of support date. We recommend that you migrate to the latest supported version of Java.

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

Before you begin

1. You need a Google Cloud project with an App Engine application to deploy to. If you don't already have one, use the Google Cloud console to set up your Google Cloud project:

   Go to Google Cloud console

   1. Select or create a new Google Cloud project.

2. Sign in to a Google account that is used to deploy your project to App Engine.

   1. Run the following command

      gcloud auth application-default login

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

      

   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 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

• Explore the plugin code or report issues on GitHub, or ask a question on Stack Overflow.