You create and manage applications in App Engine using the Administration Console. Once you have registered an application ID for your application, you upload it to App Engine using either the Eclipse plugin, or a command-line tool in the SDK.
Note: Application IDs must begin with a letter. Once you register an application ID, you can delete it, but you can't re-register that same application ID after it has been deleted. You can skip these next steps if you don't want to register an ID at this time.
Note : If you have an App Engine Premier account, you can specify that your new application should reside in the European Union rather than the United States. For developers that do not have a Premier account, you will need to enable billing for applications that should reside in the European Union.
Hosting applications in the European Union is especially useful if your users are closer to Europe than to the United States. There is less network latency and the End User Content will be stored at rest in the European Union. You must specify this location by clicking the "Edit" link in the "Location Options" section when you register the application; you cannot change it later.
Registering the Application
You create and manage App Engine web applications from the App Engine Administration Console, at the following URL:
Sign in to App Engine using your Google account. If you do not have a Google account, you can create a Google account with an email address and password.
Note: You may have already created a project using the Google Cloud Console. If this is the case, you do not have to create a new application. Your project has a title and an id. In the instructions that follow, the project title and id can be used wherever an application title and id are mentioned. They are the same thing.
To create a new application, click the "Create an Application" button. Follow the instructions to register an application ID, a name unique to this application.
appengine-web.xml file, then change the value of the
<application> element to be your registered application ID.
For this tutorial, you should probably elect to use the free appspot.com domain name, and so the full URL for the application will be
http://your_app_id.appspot.com/. You can also purchase a top-level domain name for your app, or use one that you have already registered.
For Authentication Options (Advanced), the default option, "Open to all Google Accounts users", is the simplest choice for this tutorial. If you choose "Restricted to the following Google Apps domain", then your domain administrator must add your new app as a service on that domain. If you choose the Google Apps domain authentication option, then failure to add your app to your Google Apps domain will result in an HTTP 500 where the stack trace shows the error "Unexpected exception from servlet: java.lang.IllegalArgumentException: The requested URL was not allowed: /guestbook.jsp". If you see this error, add the app to your domain. See Configuring Google Apps to Authenticate on Appspot for instructions.
If you have an App Engine Premier account, you can specify that your new application should reside in the European Union rather than the United States. This is especially useful if your application's users are closer to Europe than to the United States. There is less network latency and the End User Content will be stored at rest in the European Union. You must specify this location when you register the application; you cannot change it later. Click the Edit link in the Location Options section; select a location option, either United States or European Union.
Uploading the Application
You can upload your application using Eclipse, or using a command at the command prompt. See the quotas page for limits on file sizes and data.
Uploading From Eclipse
You can upload your application code and files from within Eclipse using the Google Plugin.
To upload your application from Eclipse, click on the Google button in the Eclipse toolbar, then select "Deploy to App Engine."
If prompted, follow the instructions to provide the Application ID from the App Engine console that you would like to use for this app, your Google account username (your email address), and your password. Then click the Deploy button. Eclipse will then automatically upload the contents of the
Uploading Using the Command Prompt
You can upload your application code and files using a command included in the SDK named
appcfg.cmd (Windows) or
appcfg.sh (Mac OS X, Linux).
AppCfg is a multi-purpose tool for interacting with your app on App Engine. The command takes the name of an action, the path to your app's
war/ directory, and other options. To upload the app code and files to App Engine, you use the
To upload the app, using Windows:
..\appengine-java-sdk\bin\appcfg.cmd update war
To upload the app, using Mac OS X or Linux:
../appengine-java-sdk/bin/appcfg.sh update war
Enter your Google username and password at the prompts.
Checking Your Application State
After your application is uploaded,
its Datastore Indexes
will be automatically generated. This operation may take some time, and any visitors
to your site will receive a
DatastoreNeedIndexException until the indexes have been
built. You can monitor the progress of the operation by visiting the
App Engine console, selecting your application, and then
Datastore Indexes link.
Accessing Your Application
You can now see your application running on App Engine. If you set up a free appspot.com domain name, the URL for your website begins with your application ID:
You have completed this tutorial. For more information on the subjects covered here, see the rest of the App Engine documentation.