This is a set of generic instructions for both Java and Python users of App Engine, which describe how to first obtain an App Engine account as well as how to create your first application placeholder in the cloud which you can later deploy onto once you've built your application locally.
- To create your first App Engine account you'll first need a Google account. The most popular way to get a Google account is to create a GMail address, so if you already have a GMail address, then you have a Google account and you can proceed to http://appengine.google.com and sign in with your GMail(Google) credentials.
- If you don't, then you can either go to http://gmail.com and click on the "Create an account" button - if you want to create a GMail account while you're at it.
- Or, if you just want a Google account, you can proceed directly to http://appengine.google.com and click on the link, "Create an account now".
- After creating your Google account either through gmail, or directly at appengine.google.com, you can then activate your App Engine account.
- Note: as part of the App Engine activation process, there is an SMS verification process that you'll need to follow. This means that in order to get approved for App Engine development, you need to receive an SMS verification message from Google. If you are in a foreign country where SMS connectivity is not so good with the United States or Europe, you may have a little difficulty. Fortunately there are alternate ways to get verified. For further info on activating your App Engine account, see the FAQ at: http://code.google.com/appengine/kb/
Creating your first application
Assuming your account is now verified through SMS, you should be able to login to the main "My Applications" page at appengine.google.com. You can now create your first application by:
- Clicking on the button "Create An Application". Keep in mind though that the application you create at appengine.google.com, is only an empty placeholder until you upload your first completed application from your local machine. Follow these steps to create your first app:
- A dialog will appear that asks you to provide a unique name for your app. This is needed because your app will be live on the Internet at <your_unique_app_name>.appspot.com. Checking to for a unique name is easily done by simply clicking on the button, "Check Availability", to see if your name app name has been taken by somebody else.
- Once you've found a unique name, this will be known as your "application-id" and will be the value that you apply to your "application:" field in your app.yaml file for Python, or in your <application></application> field in your appengine-web.xml file in your Java application. It will also serve as the unique subdomain of appspot.com for your application, ex: averyuniqueappname.appspot.com.
- You will also have to set the Application Title. This is the plain text title of your application. You can use spaces in this name.
- To create the application, click on the "Save" button. You will then be able to view the dashboard for your new app. Incidentally, the first time you view the dashboard for your app, there will be no data shown since you still have to deploy your app using either the command line tools or the Eclipse plugin.
This concludes the steps on how to create and activate your App Engine account, as well as how to create your first App Engine (placeholder) App. You can now proceed on to either the Python, or Java App Engine codelabs!