doc/book/fr/20-02-install.fr.txt
author Sylvain Thenault <sylvain.thenault@logilab.fr>
Tue, 25 Nov 2008 12:33:26 +0100
changeset 138 ed8a7efaadb6
parent 108 60faaa480f02
permissions -rw-r--r--
trigger 3.0 migration for beta versions
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
94
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     1
.. -*- coding: utf-8 -*-
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     2
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     3
.. _installationGAE:
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     4
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     5
Installation de `CubicWeb` pour GoogleAppEngine
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     6
===============================================
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     7
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     8
Qu'est-ce que `LAX` ?
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     9
=======================
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    10
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    11
`LAX` (Logilab Appengine eXtension) est un framework d'application
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    12
web basé sur `Google AppEngine`.
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    13
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    14
`LAX` est un portage de la partie web de la plate-forme applicative
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    15
développée par Logilab depuis 2001.  Cette plate-forme publie des
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    16
données tirées de bases SQL, d'annuaires LDAP et de systèmes de
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    17
gestion de version. En avril 2008, elle a été portée pour fonctionner
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    18
sur le "datastore" de `Google AppEngine`.
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    19
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    20
XXX: faire un parallèle entre Django/GAE et LAX/GAE
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    21
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    22
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    23
Téléchargement des sources
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    24
==========================
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    25
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    26
- Les sources de `Google AppEngine` peuvent être récupérées à l'adresse
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    27
  suivante : http://code.google.com/appengine/downloads.html
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    28
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    29
- Les sources de `LAX` se trouvent à l'adresse suivante :
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    30
  http://lax.logilab.org/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    31
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    32
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    33
Installation
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    34
============
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    35
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    36
Une fois décompactée, l'archive `lax-0.1.0-alpha.tar.gz`, on obtient
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    37
l'arborescence suivante::
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    38
  
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    39
  .
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    40
  |-- app.yaml
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    41
  |-- custom.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    42
  |-- data
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    43
  |-- ginco/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    44
  |-- i18n/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    45
  |-- logilab/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    46
  |-- main.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    47
  |-- mx/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    48
  |-- rql/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    49
  |-- schema.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    50
  |-- simplejson/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    51
  |-- tools/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    52
  |   |-- generate_schema_img.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    53
  |   `-- i18ncompile.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    54
  |-- views.py
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    55
  |-- yams/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    56
  `-- yapps/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    57
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    58
  
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    59
On retrouve le squelette d'une application web de `Google AppEngine`
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    60
(fichiers ``app.yaml``, ``main.py`` en particulier) avec les dépendances
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    61
supplémentaires nécessaires à l'utilisation du framework `LAX`
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    62
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    63
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    64
Lancement de l'application de base
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    65
==================================
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    66
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    67
Plusieurs répertoires doivent être accessibles via la variable 
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    68
d'environnement ``PYTHONPATH`` ::
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    69
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    70
  $ export PYTHONPATH=/path/to/google_appengine:/path/to/google_appengine/lib/yaml/lib:/path/to/myapp/
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    71
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    72
Le répertoire yaml n'est nécessaire que pour le lancement des scripts
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    73
qui se trouvent dans lax/tools et pour l'exécution des tests unitaires.
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    74
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    75
Pour démarrer::
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    76
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    77
  $ python /path/to/google_appengine/dev_appserver.py /path/to/lax
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    78
7044297a70ab [doc] missing files
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    79