пятница, 9 мая 2008 г.

Django приложение на Google App Engine в 12 шагов

В этом туториале рассказывается, как создать простое Django приложение с использованием Google App Engine. Предполагается, что у вас уже есть аккаунт в Google App Engine.

1. Для начала нужно зарегистрировать имя приложения в GAE и установить у себя тулкит. Среда Google App Engine работает только с Python 2.5 (2.5.1, 2.5.2). Вместе с Питоном должен быть установлен и Django 0.96 (0.96.1) (.../python/libsite-packages/django).

2. Создайте папку для вашего приложения. Имя и размещение не имеет значения. У меня папка называется "dvk".

3. В папке приложения создайте файл main.py
import os, sys

os.environ["DJANGO_SETTINGS_MODULE"] = "dvk.settings"

ROOT_PATH = os.path.dirname(__file__)
sys.path.append(ROOT_PATH)

# Google App Engine imports.
from google.appengine.ext.webapp import util

# Force Django to reload its settings.
from django.conf import settings

settings._target = None

import django.core.handlers.wsgi
import django.core.signals
import django.db
import django.dispatch.dispatcher

# Unregister the rollback event handler.
django.dispatch.dispatcher.disconnect(
django.db._rollback_on_exception,
django.core.signals.got_request_exception)

def main():
    # Create a Django application for WSGI.
    application = django.core.handlers.wsgi.WSGIHandler()

    # Run the WSGI CGI handler with that application.
    util.run_wsgi_app(application)

if __name__ == "__main__":
    main()

Этот файл запускается на выполнение, когда пользователь открывает в браузере страницу вашего веб-приложения.

4. Создайте файл app.yaml
application: dvk
version: 1
runtime: python
api_version: 1

handlers:
- url: /static
static_dir: static

- url: /.*
script: main.py

Имя приложения естественно подставьте по своему вкусу :)

5. Из папки приложения выполните команду создания нового Django-проекта:
django-admin.py startproject dvk

Маленькое замечание: Всего у нас будет 2 папки проектов - папка GAE-проекта и папка Django-проекта внутри неё. Внешний проект выполняет роль обёртки.
dvk/
main.py
app.yaml
    dvk/
    manage.py
    settings.py
    urls.py

В файле настроек Django-проекта settings.py нужно удалить всё, что относиться к настройкам БД, админке, аутентификации и сессиям. Google App Engine не поддерживает модели Django, поэтому эти модули работать не будут.

6. Теперь можно протестировать наше GAE+Django приложение
cd ..
dev_appserver.py dvk

INFO 2008-04-08 19:08:10,023 appcfg.py] Checking for updates to the SDK.
INFO 2008-04-08 19:08:10,384 appcfg.py] The SDK is up to date.
INFO 2008-04-08 19:08:10,404 dev_appserver_main.py] Running application dvk on port 8080: http://localhost:8080

Откройте браузер с адресом http://127.0.0.1:8080/ и у вас отобразится стандартная страница Django с сообщением It worked!

7. Создайте Django апликейшн в папке Django-проекта.
manage.py startapp main


8. Теперь самое время добавить модель данных. Мы создадим простой класс Visitor, который будет хранить информацию обо всех посетителях сайта.
#.../dvk/dvk/main/models.py
from google.appengine.ext import db

class Visitor(db.Model):
    ip = db.StringProperty()
    added_on = db.DateTimeProperty(auto_now_add=True)

При добавлении или изменении моделей в Google App Engine не требуется проводить синхронизацию с базой данных. Она выполняется автоматически.

9. Теперь создадим процедуру-контроллер. Она будет записывать в базу данных параметры посетителя нашей веб-страницы и отображать список всех посетителей.
#.../dvk/dvk/main/views.py
from django.http import HttpResponse
from dvk.main.models import Visitor

def main(request):
    visitor = Visitor()
    visitor.ip = request.META["REMOTE_ADDR"]
    visitor.put()
    result = ""

    visitors = Visitor.all()
    visitors.order("-added_on")
    for visitor in visitors:
        result += visitor.ip + u" visited on " + unicode(visitor.added_on) + u""

    return HttpResponse(result)


10. В файле диспетчера URL-ов укажем, что наша процедура ответственна за обработку запроса главной страницы сайта.
#.../dvk/dvk/main/urls.py
from django.conf.urls.defaults import *

urlpatterns = patterns("",
(r"^$", "mashname.main.views.main"),
)

11. Протестируйте своё приложение открыв окно браузера по адресу http://127.0.0.1:8080/. При каждом обновлении веб-страницы будет добавлятся новая строка и соответственно новый объект Visitor будет записан в БД. GAE также автоматически создает админ-панель приложения - http://127.0.0.1:8080/_ah/admin/

12. Теперь можно заливать наше приложение на GAE: appcfg.py update dvk
При первом выполнении команда попросит авторизироваться.

Использованные материалы:
Running Django on Google App Engine
Django on Google App Engine in 13 simple steps

__________________________________
Мои переводы:
Начинайте бизнес создавая стартап
Интервью Пола Грэма для Found|READ
Как выглядит рабочее место в XXI веке

2 комментария:

Анонимный комментирует...

дядя Вова, а можно выложить готовый архивчик с примером. Кстати в последнем файле разве не
так должно было бы быть?
urlpatterns = patterns("",
(r"^$", "dvk.main.views.main"),
)
все исправил , записи в бд не ложаться :(

Антон Данильченко комментирует...

Предлагаю попробовать проект http://code.google.com/p/appengine-framework/

Это набор готовых приложений, написанный специально для GAE (Google AppEngine). Структура проекта очень похожа на Django, однако имеет и ряд удобных изменений.

Успешного знакомства с GAE!