h1. Implementar un proyecto

Para poder implementar un proyecto en los entornos de test y/o producción hemos desarrollado una herramienta que puede descargar aquí http://redmine.zennovia.com/attachments/download/1259/deploy.zip

Esta herramienta ejecuta los siguientes pasos:

+*Deploy*+

* Deshabilitar el sitio
* Backup de código
* Backup de BD
* Deployar el código
* Limpiar cache
* Limpiar logs
* Corre migraciones
* Cambiar los permisos de cache y logs
* Recuperar Uploads
* Activar sitio

+*RollBack*+

* Deshabilitar el sitio
* Restaura DB
* Restaura código
* Activar sitio

A continuación se encuentra un tutorial para utilizar dicha herramienta.

----


h2. Deploy



*1-* Descomprimir la herramienta *deploy* a la altura del directorio que contiene el proyecto, por ejemplo:

> Si el directorio raíz del proyecto es *public_html*, entonces *deploy* tiene que estar a la misma altura de este directorio, quedando la siguiente estructura:

<pre>
	...
	...
	public_html
	...
	...
	znv_deploy
	...
	...
</pre>


*2-* La estructura de archivo dentro del directorio *deploy* es la siguiente

<pre>
	new_version
	config.ini
	deploy.sh
	rollback.sh
</pre>


*3-* Seteamos con los valores correcto el archivo config.ini. Lo que se debe setear es:

* Los accesos a la base de datos
<pre>
	# Configuracion base de datos
	DBSERVER="localhost"
	DBNAME="LA_BASE_DE_DATOS"
	DBUSER=root
	DBPASS=root
</pre>

* El nombre del directorio raiz que contiene el proyecto
<pre>
	PROYECTDIR="public_html"
</pre>


*4-* En el directorio new_version colocar el archivo zip de la nueva versión a deployar.


*5-* Luego parados a la altura del archivo deploy.sh ejecutamos el mismo de la siguiente manera:
<pre>
sudo ./deploy.sh
</pre>


*6-* Luego si hay algún parametro nuevo o modificado en el parameter.yml se debe setear de forma manual. Esto se notificara desde Zennovia en el momento de entregar la versión.


*7-* Una vez terminado el proceso, si desea, puede chequear la versión leyendo el archivo version.txt



----



h2. Rollback



Si por algún motivo se decide volver a la versión anterior esto se lograr ejecutando Rollback de la siguiente manera:


*1-* Posicionado a la altura del archivo rollback.sh ejecutamos


<pre>
	sudo ./rollback.sh
</pre>


Mostrará el siguiente mensaje con todas las release disponibles:


<pre>
Se creo archivo de mantenimiento. SE DESHABILITO SITIO
201609151212  201609151213  201609151217
Ingrese la release a la cual quiere volver:
</pre>


*2-* Ingresar la release deseada y presionar Enter para comenzar.


*3-* Una vez terminado el proceso, si desea, puede chequear la versión leyendo el archivo version.txt