You create and manage App Engine applications using the Google Developers Console.
Once you have registered an application ID for your application, you upload it to your website using
appcfg.py
, a command-line tool provided 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. Developers that do not have a Premier account need to
fill out this form
and
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 applications from the Developers Console, at the following URL:
https://console.developers.google.com/
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 Developers 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. If you elect to use the free appspot.com domain name, 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.
Edit the
app.yaml
file, then change the value of the
application:
setting from
helloworld
to your registered application ID.
If your application uses Google Cloud SQL for data storage (none of the examples in the PHP Getting Started tutorial do) then you must also request a Google Cloud SQL instance .
Uploading the Application
You can upload your finished application to Google App Engine in a few ways.
Uploading via command line
Run the following command:
appcfg.py update helloworld/
Enter your Google username and password at the prompts.
Use the App Engine Launcher
You can also use the interface of the Google App Engine Launcher to upload your application. Simply select the projet in Launcher and click Deploy .
Using Git
If you work with the Git version control system, you can create a remote repository in Google's cloud, and configure your development environment to deploy the latest version of your code each time you push it to that repository. See Using Git to Push and Deploy .
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:
http://
your_app_id
.appspot.com
Congratulations!
You have completed this tutorial. For more information on the subjects covered here, see the rest of the App Engine documentation .