Guía de instalación de Cyclope 3

Última actualización: 17/04/2011

Este proyecto se encuentra aún en etapa de desarrollo (beta)

Si deseas contribuir al desarrollo o testear Cyclope en tu propio equipo o servidor (Linux), éstas son las intrucciones para instalar tu entorno de testeo.

Requerimientos

Es muy importante que verifiques que tu sistema tenga instalados los siguientes requerimientos. Todos los reportes de error que recibimos están relacionados a algún requerimiento faltante o mal instalado.

• mercurial
• subversion
• git >= 1.7 (git-core en debian/ubuntu)
• virtualenv >= 1.45 (python-virtualenv en debian/ubuntu)
• gcc (or another C compiler)
• python headers (python-dev package en debian/ubuntu)
• libjpeg / libjpeg-dev (libjpeg62 and libjpeg62-dev en debian/ubuntu)
• freetype2 (libfreetype6-dev en debian/ubuntu)

Si estás utilizando Debian o Ubuntu, ejecuta el siguiente comando para instalar todas la dependencias listadas:

$ sudo apt-get install mercurial subversion git-core python-virtualenv gcc python-dev libjpeg62 libjpeg62-dev libfreetype6-dev

Necesitas los tres sistemas de control de versión (Mercurial, Subversion y Git) porque utilizamos numerosas versiones de desarrollo en nuestras dependencias. El compilador de C (gcc), las cabeceras de python y libjpeg son necesarios para poder compilar PIL, que es utilizado para el procesamiento de imágenes.

Si tu distribución de GNU/Linux no provee una versión reciente (1.4.5 o superior) de virtualenv, puedes instalar una versión nueva utilizando easy_install (easy_install es provista por python-setuptools).

Chequea la versión de virtualenv con el comando:

$ virtualenv --version

Si es menor a 1.4.5, primero deberás remover tu instalación actual de virtualenv. Si estás utilizando Debian o Ubuntu, ejecuta este comando:

$ sudo apt-get remove python-virtualenv

Luego puedes instalar una nueva versión de virtualenv ejecutando (recuerda que necesitas tener python-setuptools instalado):

$ sudo easy_install virtualenv

Creación del entorno virtual

Una vez que hayas instalado la versión requerida de virtualenv, crea un nuevo entorno virtual y actívalo:

$ virtualenv --no-site-packages cyclope_workenv
$ source  cyclope_workenv/bin/activate

Luego de activar el entorno virtual, aparecerá a la izquierda en el prompt “(cyclope_workenv)”, lo que sinifica que está trabajando dentro del entorno.
El paso siguiente instalará pip (Python Install Packages), que a su vez nos permitirá instalar Cyclope.

$ easy_install pip

Instalación de Cyclope

Con los requerimientos satisfechos, ya puedes instalar Cyclope. Las demás dependencias serán automáticamente traídas por el instalador.

$ pip install -e hg+http://trac.usla.org.ar/hg/cyclope#egg=cyclope

Este paso demorará unos minutos (dependiendo de la velocidad de tu conexión puede ser bastante tiempo) ya que instalará automáticamente todos los paquetes Python para que funcione Cyclope.

Si la instalación de PIL da un error del tipo: “expected ‘{’ at end of input”, es porque olvidaste instalar el paquete python-dev (o el equivalente de tu distribución). Instálalo y luego repite el paso anterior.

Puedes recibir alertas (warnings) durante la instalación de dependencias, pero no son relevantes para nuestro propósito.

Sitio de demostración

Una vez que Cyclope esté instalado, dentro de tu entorno de trabajo (cyclope_workenv, si seguiste estas instrucciones) encontrarás un pequeño sitio de demostración:

$ cd cyclope_workenv/src/cyclope/demo/cyclope_project/

Corrobora que los links simbólicos en la carpeta media/ dentro del proyecto de demo apunten a las rutas correspondientes al entorno virtual creado. Ubicado en el último directorio indicado (.../cyclope_project/), si se ejecuta el siguiente comando, listará los links simbólicos que no encuentran el destino indicado:

$ find -L media/ -type l 2> /dev/null

Si no hay links rotos, no habrá salida. Si la hay, deberás encontrar el error y corregirlo. Una vez corroborados o corregidos los links puedes correr el servidor de pruebas allí mismo:

$ python manage.py runserver

A esta altura deberías poder ver el sitio de demo navegando a la dirección:

http://localhost:8000/

El sitio de administración estará disponible en la ubicación:

http://localhost:8000/admin

Y las credenciales de administración son:

nombre de acceso: admin
contraseña: password

Cuando termines de trabajar, puedes terminar el proceso del servidor de pruebas presionando las teclas Ctrl+C. Para desactivar el entorno de pruebas, usarás el comando:

$ deactivate

Cuando desees volver a correr el servidor, necesitarás ejecutar los siguientes pasos:

$ source cyclope_workenv/bin/activate
$ cd cyclope_workenv/src/cyclope/demo/cyclope_project
$ python manage.py runserver

Para iniciar tu propio sitio

Cyclope cuenta con un comando para iniciar proyectos. Deberás ubicarte en el directorio donde quieres que se cree la carpeta de tu proyecto y ejecutarlo. Por ejemplo (siempre con tu entorno virtual activado):

$ cd /var/www
$ cyclopeproject mi_sitio

El nombre del proyecto debe ser un nombre que Python pueda entender como como nombre de un módulo, por lo tanto no podrá contener espacios ni signos de puntuación o caracteres especiales. Si necesitas usar el nombre del sitio con el que estarás trabajando, te recomendamos crear un directorio para “envolver” el proyecto, por ejemplo: /var/www/mi_sitio.org y entonces ahí dentro ejecutar el comando cyclopeproject mi_proyecto.

Después de ejecutar este comando deberás ingresar a la carpeta resultante y crear la base de datos inicial

$ cd mi_sitio
$ ./manage.py syncdb
$ ./manage.py migrate

Una vez completado este paso puedes correr el servidor de desarrollo

$ ./manage.py runserver

y acceder a tu sitio en http://localhost:8000

En otro artículo explicaremos como comenzar tu propio tema local…

Por cualquier error o problema con estas instrucciones, por favor déjanos un comentario.