Home | History | Annotate | Download | only in gettingstarted
      1 .. _tutorials.gettingstarted.uploading:
      2 
      3 Uploading Your Application
      4 ==========================
      5 You create and manage applications in App Engine using the Administration
      6 Console. Once you have registered an application ID for your application, you
      7 upload it to your website using ``appcfg.py``, a command-line tool provided
      8 in the SDK. Or, if you're using Google App Engine Launcher, you can upload
      9 your application by clicking the Deploy button.
     10 
     11 .. note::
     12    Once you register an application ID, you can delete it, but you can't
     13    re-register that same application ID after it has been deleted. You can
     14    skip these next steps if you don't want to register an ID at this time.
     15 
     16 
     17 Registering the Application
     18 ---------------------------
     19 You create and manage App Engine web applications from the App Engine
     20 Administration Console, at the following URL:
     21 
     22 - `https://appengine.google.com/ <https://appengine.google.com/>`_
     23 
     24 Google App Engine Launcher users can reach this URL by clicking the Dashboard
     25 button.
     26 
     27 Sign in to App Engine using your Google account. If you do not have a Google
     28 account, you can `create a Google account <https://www.google.com/accounts/>`_
     29 with an email address and password.
     30 
     31 To create a new application, click the "Create an Application" button. Follow
     32 the instructions to register an application ID, a name unique to this
     33 application. If you elect to use the free appspot.com domain name, the full
     34 URL for the application will be ``http://application-id.appspot.com/``. You can
     35 also purchase a top-level domain name for your app, or use one that you have
     36 already registered.
     37 
     38 Edit the ``app.yaml`` file, then change the value of the ``application:``
     39 setting from ``helloworld`` to your registered application ID.
     40 
     41 
     42 Uploading the Application
     43 -------------------------
     44 To upload your finished application to Google App Engine, run the following
     45 command::
     46 
     47 .. code-block:: text
     48 
     49    appcfg.py update helloworld/
     50 
     51 Or click Deploy in Google App Engine Launcher.
     52 
     53 Enter your Google username and password at the prompts.
     54 
     55 You can now see your application running on App Engine. If you set up a free
     56 appspot.com domain name, the URL for your website begins with your application
     57 ID::
     58 
     59 .. code-block:: text
     60 
     61    http://application-id.appspot.com
     62 
     63 
     64 Congratulations!
     65 ----------------
     66 You have completed this tutorial. For more information on the subjects
     67 covered here, see the rest of
     68 `the App Engine documentation <http://code.google.com/appengine/docs/>`_ and
     69 the :ref:`guide.index`.
     70