Portal de Canaima GNU/Linux

Framework:	Plone 4.3.4
Bug tracker:	https://github.com/CanaimaGNULinux/buildout.web.canaimagnulinux/issues
Source:	https://github.com/CanaimaGNULinux/buildout.web.canaimagnulinux
Documentation:	https://github.com/CanaimaGNULinux/buildout.web.canaimagnulinux/wiki/Home

Este paquete instala una instancia de Plone con todos los componentes necesarios para construir el sitio web de Canaima GNU/Linux

Se proporcionan configuraciones para los siguientes entornos:

• Desarrollo
• Pruebas
• Producción

Instalación

Entorno de desarrollo

Requisitos previos

• Python 2.7 y bibliotecas de desarrollo

Crear un archivo ~/.buildout/default.cfg con lo siguiente:

 [buildout]
 download-cache = ~/.buildout/downloads
 eggs-directory = ~/.buildout/eggs
 extends-cache = ~/.buildout/extends

- ``download-cache``: Directorio donde se almacenan los sources de los paquetes
  descargados con los que se construyen los paquetes python (eggs).

- ``eggs-directory``: Directorio donde se almacenan los paquetes python generados.

- ``extends-cache``: Directorio donde se almacenan archivos de configuración (.cfg)
  que son descargados desde la red, generalmente por una clausula ``extends`` y que
  son utilizados cuando el buildout se ejecuta sin conexión (offline mode)

Descargar el buildout

Para obtener una copia de este proyecto ejecute las siguientes instrucciones en lineas de comando:

$ cd ~
$ git clone https://github.com/CanaimaGNULinux/buildout.web.canaimagnulinux.git

Puede utilizar un nombre de carpeta diferente si así lo desea.

Generar el buildout

Para inicializar y construir una copia de este proyecto en entornos de desarrollo, ejecute las siguientes instrucciones en lineas de comando:

$ cd ~/buildout.web.canaimagnulinux
$ python bootstrap.py
$ ./bin/buildout

Para iniciar la instancia del sitio Plone, ejecute el siguiente comando:

$ ./bin/instance fg

Puede acceder al sitio a través de la dirección http://127.0.0.1:8080/

Entorno de pruebas (staging)

Ingresar al directorio donde se obtuvo la copia del buildout:

$ cd ~/buildout.web.canaimagnulinux

Una vez realizado ese paso, debe modificar el archivo buildout.cfg con el siguiente comando

$ vim buildout.cfg

Y este archivo debería lucir así:

[buildout]
#extends = buildout.d/development.cfg
extends = buildout.d/staging.cfg
#extends = buildout.d/production.cfg

Luego inicie la construcción con el siguiente comando

$ python bootstrap.py
$ ./bin/buildout -vvvvvvN

Para iniciar la instancia del sitio Plone, ejecute el siguiente comando:

$ ./bin/instance fg

Puede acceder al sitio a través de la dirección http://127.0.0.1:8080/

En caso de encontrar errores del tipo "Can't update package 'xxx.yyy' because its URL doesn't match." utilice el siguiente comando y ejecute nuevamente el buildout:

$ rm -rf ~/canaimagnulinux/src/xxx.yyy

Reemplace "xxx.yyy" por el nombre del paquete que se muestra en el mensaje de error.

Pasos comunes para el entorno de producción y pruebas

Ejecución paso a paso:

Instalación de dependencias del sistema operativo:

$ sudo apt-get install git-core python-dev build-essential libjpeg62-dev \
               libfreetype6-dev zlib1g-dev libxml2 libxml2-dev libxslt1-dev \
               libmysqlclient-dev wv poppler-utils lynx munin libwww-perl

Crear el usuario de sistema:

$ sudo adduser --system --home /srv/plone \
               --disabled-password --disabled-login plone

Acceder al usuario, clonar el repositorio y correr el bootstrap:

$ sudo -u plone -s -H

$ git clone git@github.com/canaimagnulinux/buildout.web.canaimagnulinux.git
Initialized empty Git repository in /srv/plone/buildout.web.canaimagnulinux/.git/
Password:

$ cd buildout.web.canaimagnulinux

Generar el buildout y lo ejecutarlo con el perfil de producción según sea una instancia.

Una vez realizado ese paso, debe modificar el archivo buildout.cfg con el siguiente comando

$ vim buildout.cfg

Y este archivo debería lucir así:

[buildout]
#extends = buildout.d/development.cfg
#extends = buildout.d/staging.cfg
extends = buildout.d/production.cfg

Luego inicie la construcción con el siguiente comando

$ python bootstrap.py
$ ./bin/buildout -vvvvvvN

Iniciar las instancias manualmente.

$ bin/supervidord

Actualizar la configuración de las servicios del SO:

(haproxy, varnish y nginx).

Ejecutar el siguiente comando desde un usuario que tenga los privilegios necesarios para utilizar sudo.

$ bin/update-so-config.sh

Descargas

Usted puede encontrar la versión de desarrollo del paquete buildout.web.canaimagnulinux en el repositorio Canaima GNU/Linux en Github.com.

Sobre la calidad

¿Tienes una idea?, ¿Encontraste un error? Háganos saber mediante la apertura de un ticket de soporte.

Autor(es) Original(es)

• Leonardo J .Caballero G. aka macagua

Colaboraciones impresionantes

• Nombre Completo aka apodo

Para una lista actualizada de todo los colaboradores visite: https://github.com/canaimagnulinux/buildout.web.canaimagnulinux/contributors