Skip to content
Browse files

Merge pull request #39 from Habel/gae_start_doc

added docs for deploying as a google app engine application
  • Loading branch information...
2 parents a3d2a1c + 1d8139b commit 65a7bb6ca5750a519090524e5c7e7d2f60a6287b @aaronsw aaronsw committed
Showing with 85 additions and 0 deletions.
  1. +84 −0 cookbook/google_app_engine.md
  2. +1 −0 cookbook/index.md
View
84 cookbook/google_app_engine.md
@@ -0,0 +1,84 @@
+---
+layout: default
+title: Webpy + Google App Engine
+---
+
+# Webpy + Google App Engine
+
+This cookbook entry explains how to run web.py as a google app engine application
+
+### Requirements
+
+* Google App Engine Python API
+
+### Resources
+
+* [Google App Engine](https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python)
+
+### Notes
+* The mechanisms for running GAE in python2.7 and 2.5 are different, change the app.yaml accordingly
+* code.py is the main file of your application (2.5)
+* code.app is the main file that includes the global variable app (2.7)
+* appname is the name that you specified while creating your GAE application
+* runtime for 2.5 is python, 2.7 is python27
+* threadsafe is only required in 2.7, read about it on the google app engine site
+
+## app.yaml for python 2.5
+
+ application: appname
+ version: 1
+ runtime: python
+ api_version: 1
+
+ handlers:
+ - url: /.*
+ script: code.py
+
+## app.yaml for python 2.7
+
+ application: appname
+ version: 1
+ runtime: python27
+ api_version: 1
+ threadsafe: true
+
+ handlers:
+ - url: /.*
+ script: code.app
+
+To serve static files, you must add this under handlers (where static is the name of your static dir):
+ - url: /static
+ static_dir: static
+
+## Hello World!
+
+This is a sample application that can be run by using dev_appserver.py (it is bundled with the SDK download):
+
+ import web
+
+ urls = (
+ "/.*", "hello",
+ )
+
+ app = web.application(urls, globals())
+
+ class hello:
+ def GET(self):
+ return 'Hello, world!'
+
+ app = app.gaerun()
+
+Save this as code.py (or whatever you specified in app.yaml) and type:
+dev_appserver.py .
+
+Now visit localhost:8080 in your browser and you should see hello world!
+
+## NOTES
+
+### There is a blank page or an internal server error
+
+solution: Make sure that you are running the version of python specified in the app.yaml file
+
+### dev_appserver.py is not found
+
+solution: Make sure that it is in your path
View
1 cookbook/index.md
@@ -90,6 +90,7 @@ _Other languages:_ [简体中文](/cookbook/index.zh-cn) | [日本語](/cookbook
* [mod_wsgi deployment through Nginx](/cookbook/mod_wsgi-nginx )
* [Fastcgi deployment through Nginx](/cookbook/fastcgi-nginx)
* [PyISAPIe deployment through IIS7/IIS6](/cookbook/iis7_iis6_windows_pyisapie)
+* [Deploying as a google app engine application](/cookbook/google_app_engine)
## Subdomains
* Subdomains and how to access the username (requested)

0 comments on commit 65a7bb6

Please sign in to comment.
Something went wrong with that request. Please try again.