Creating an application in the App Engine standard environment

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.

Cloud Tools for Eclipse provides a wizard inside Eclipse to create new Java applications in the App Engine standard environment.

Before you begin

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build API.

   Enable the API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Build API.

   Enable the API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

12. Create an App Engine application for your Google Cloud project in the Google Cloud console.

    Open app creation

13. Select a region where you want your app's computing resources located.

    Note: After you create your App Engine app, you cannot change the region. To reduce latency, choose the region closest to your app's intended users. For more information on the available regions, see App Engine Locations.
14. Ensure you have the latest version of Cloud Tools for Eclipse.

Creating a new Java project in the App Engine standard environment

To create a new project for the App Engine standard environment in Eclipse:

1. Click the Google Cloud Platform toolbar button .

2. Select Create New Project > Google App Engine Standard Java Project.

   

3. Enter a Project name and (optionally) a Java package.

   

4. To create a Maven-based App Engine project, select Create as Maven Project and enter a Maven Group ID and Artifact ID of your choosing to set the coordinates for this project. The Group ID is often the same as the package name, but does not have to be. The Artifact ID is often the same as or similar to the project name, but does not have to be.

5. Click Next.

6. Select any libraries you need in the project.

7. Click Finish.

The wizard generates a native Eclipse project, with a simple servlet, that you can run and deploy from the IDE.

What's next

• Once you've created an application, you can run and debug it on your local workstation.