PASO A PRODUCCIÓN APLICACIONES SITIO LABORUM

Transcripción

1 Página 1 de 15 COPIA CONTROLADA NO CONTROLADA Fecha de Edición: 01/01/2013 Elaborado por: Mauricio Guerra M. Revisado por: Susana Magna G. Aprobado por: Mauricio Guerra

2 Página 2 de 15 CONTENIDO PRINCIPAL: 1 PROPÓSITOS ALCANCES DEFINICIONES DEFINICIONES Y ACRÓNIMOS CONVENCIONES UTILIZADAS EN ESTE DOCUMENTO RESPONSABILIDADES Y/O FUNCIONES DESCRIPCIÓN AUTORIZAR PASO A PRODUCCIÓN DEFINIR IDENTIFICADOR DE VERSIÓN SW GENERAR NUEVA VERSIÓN Ramas de código fuente Obtener código fuente Compilar nueva versión Comprimir source y resource ETIQUETAR NUEVA VERSIÓN PASO A PRODUCCIÓN Respaldar Versión Actual en Servidor Frontal Respaldar Nueva Versión en Servidor Frontal Liberar Nueva Versión REVISAR LIBERACIÓN DOCUMENTAR E INFORMAR CARACTERÍSTICAS NUEVA VERSIÓN Crear documento con características o mejoras Distribuir documento ANEXOS... 15

3 Página 3 de 15 1 PROPÓSITOS Detallar las actividades necesarias para realizar el paso a producción de nuevas versiones del sitio laborum.com bajo la arquitectura de Apache y Tomcat. 2 ALCANCES Desarrollos realizados por el área de tecnología de laborum.com bajo una arquitectura de Apache y Tomcat. 3 DEFINICIONES 3.1 Definiciones y Acrónimos (no aplica) 3.2 Convenciones utilizadas en este documento A través de este documento se utilizan una serie de convenciones que proveen de información adicional y que son definidas a continuación. instrucción (. ) [ a b c ] {... } Instrucción requerida en interfaz de DOS para la ejecución de algún comando. Implica que aquello que se encuentre entre los paréntesis redondos puede ser omitido. Significa que se debe escoger una de las alternativas que se encuentra entre los paréntesis, separadas entre sí por los caracteres [ y ]. Implica que aquello que se encuentre entre los paréntesis de llaves, es un campo repetitivo.

4 Página 4 de 15 4 RESPONSABILIDADES Y/O FUNCIONES Responsable Jefe Área Tecnología Actividad Velar por el cumplimiento de las actividades requeridas para el paso a producción. Autorizar el paso a producción de una versión de software. Encargado Paso a Producción (EPP) Realizar las actividades señaladas en este documento, para el paso a producción de los desarrollos realizados por laborum.com.

5 Página 5 de 15 5 DESCRIPCIÓN 5.1 Autorizar Paso a Producción El EPP debe obtener por parte del gerente o jefe de tecnología, la autorización de paso a producción, mediante o documento formal donde se indiquen las funcionalidades que serán liberadas. 5.2 Definir Identificador de Versión SW El EPP debe definir la identificación de la versión del software a liberar y que se encontrará en cualquier documentación asociada a la liberación, así como para identificar esta versión de software en el repositorio de códigos fuentes de laborum.com. Se define que la identificación se compone de lo siguiente: Donde, Nomenclatura Descripción año mes día hora <año><mes><día><hora><min> Año que es liberado en formato numérico con 4 cifras Mes que es liberado en formato numérico con 2 cifras Día que es liberado en formato numérico con 2 cifras Hora que es liberado en formato numérico con 2 cifras min Minuto que es liberado en formato numérico con 2 cifras 5.3 Generar Nueva Versión Ramas de código fuente El repositorio de código fuente contará con dos ramas distintas que se describen a continuación: HEAD, rama principal de desarrollo y donde se almacenan todos los códigos fuentes actualmente en desarrollo. PROD, rama con los códigos liberados en ambiente de producción.

6 Página 6 de Obtener código fuente El EPP debe obtener el código de las nuevas funcionalidades o correcciones a pasar a producción desde el repositorio de código fuente desde la rama principal de desarrollo denominada Head de la forma que se indica a continuación: 1. Abrir programa Eclipse y utilizar rama de producción (Ver anexo 1) 2. Comparar versión del sistema contra rama Head, mediante la opción compare withanother branch or versión (ver Ilustración 1) Ilustración 1. Comparar versión actual contra otra. 3. Seleccionar la versión contra la cual se comparará identificada por el tag asignado y seleccione la rama Head (ver Ilustración 2)

7 Página 7 de 15 Ilustración 2. Seleccionar otra versión. 4. Revise y obtenga el código que será pasado a producción Compilar nueva versión La compilación de cualquier proyecto en eclipse requerirá que se tenga un archivo ant para su realización y correcta ejecución. La compilación de la solución se realizará mediante el archivo buildcore_cma.xml ubicado en el proyecto jobcma (ver Ilustración 3). Ilustración 3. Archivo Ant para compilación 1. Ejecute el proceso copiarjarcorecma, el cual compilará el proyecto jobcma. 2. Tras su correcta ejecución, desde el Project Explorer o Navigator de eclipse seleccione los proyectos jobapp, jobcma y jobrender y refresque su contenido mediante F5 o la opción Refresh (ver Ilustración 4)

8 Página 8 de 15 Ilustración 4. Refresco de proyectos. 3. Ejecute el proceso generarwar desde el archivo ant buildcore_cma (ver Ilustración 3). 4. Tras la correcta compilación del resto de proyectos, la consola indicará la ruta donde han sido generados los archivos.war correspondientes (ver Ilustración 5). Dicha ruta corresponde a c:\proyectos\source\wars. Ilustración 5. Consola con fin de compilación. Nota En la misma ruta donde son almacenados los archivos.war, se almacenarán archivos.zip con las fuentes de esta versión.

9 Página 9 de Comprimir source y resource Tras la compilación del proyecto, será necesario comprimir las carpetas con archivos html, css y javascript, entre otros que se encuentren en las siguientes carpetas: C:\proyectos\source\source\laborum.cl comprimir en archivo www_source.rar C:\proyectos\source\resource\laborum.cl comprimir en archivo www_resource.rar 5.4 Etiquetar Nueva Versión Se requiere almacenar y etiquetar esta nueva versión en CVS, para ello se debe hacer lo siguiente: 1. Seleccionar los proyectos: jobapp jobcma jobrender resource/laborum.cl source/laborum.cl 2. Subir proyectos al CVS para lo cual se debe presionar botón derecho del mouse y seleccionar la opción Teamcommit 3. Tras subir las modificaciones al CVS, es necesario etiquetar la versión. Para esto se deben seleccionar los proyectos indicados en punto 1, presionar el botón derecho del mouse y seleccionar la opción teamtag as versión 4. Escriba el nombre de la etiqueta incorporando el prefijo prod_ a la identificación de la versión de la forma indicada en punto Presionar botón OK. Prod_<identificadorDeVersion> 5.5 Paso a Producción La arquitectura de laborum.com posee: 2 servidores frontales identificados con la ip y servidor de búsquedas y backoffice con ip Se define como servidor pivote para trabajar es la máquina , donde será necesario respaldar la versión actual del sistema y hacer deploy de la nueva aplicación.

10 Página 10 de Respaldar Versión Actual en Servidor Frontal Para respaldar la versión actual del sistema es necesario: 1. En carpeta d:\laborum\cvs, cree otra con el nombre definido como identificador de la versión (ver punto 5.2) y en esta crear la subcarpeta backup. Por ejemplo, si la versión ha sido identificada como la estructura quedará de la siguiente forma: D:\Laborum\cvs\ \backup D:\Laborum\cvs\ \proyecto 2. Respaldar archivos war. Desde carpeta d:\laborum\tomcat 6.0\webapps copie los archivos a la carpeta backup creada en punto Respaldar source: a. Desde carpeta d:\laborum\source\laborum.cl comprima el contenido de carpeta www en el archivo www_source.rar b. Copie el archivo www_source.rar a la carpeta backup creada en punto Respaldar archivos properties: a. Desde carpeta d:\laborum\source\properties comprima el contenido de todas esta carpeta en el archivo www_properties.rar b. Copie el archivo www_properties.rar a la carpeta backup creada en punto Respaldar resource: a. Desde carpeta d:\laborum\sites\prod\laborum.cl comprima el contenido de carpeta resource en el archivo www_resource.rar b. Copie el archivo www_resource.rar a la carpeta backup creada en punto Respaldar índice lucene: a. Desde carpeta d:\laborum\indices comprima el contenido de carpeta ofertas en el archivo www_ofertas.rar b. Copie el archivo www_ofertas.rar a la carpeta backup creada en punto Respaldar Nueva Versión en Servidor Frontal 1. En carpeta d:\laborum\cvs, cree otra con el nombre definido como identificador de la versión (ver punto 5.2) y en esta crear la subcarpeta proyectos. Por ejemplo, si la versión ha sido identificada como la estructura quedará de la siguiente forma: D:\Laborum\cvs\ \proyecto 2. Los archivos siguientes archivos generados en punto 5.3 deben ser copiados a la carpeta creada en punto 1. Archivos.war y.zip

11 www_source.rar www_resource.rar Página 11 de Liberar Nueva Versión Realizado todos los puntos anteriores, será necesario realizar la liberación de la nueva versión del sistema Liberar versión en máquina Los pasos para realizar la liberar la nueva versión en el servidor son los siguientes: 1. Informar al jefe de servicio al cliente que se realizará una nueva liberación y que el sistema laborum.cl y backoffice puede sufrir alguna interrupción momentánea. 2. Conectarse al servidor con usuario y contraseña suministrado por el jefe de tecnología. 3. Detener Tomcat mediante el botón Stop del Apache Tomcar Properties, (ver Ilustración 6) Ilustración 6. Pantalla de Apache Tomcat Properties. 4. Una vez detenido tomcat, se debe eliminar las siguientes carpetas desde el directorio d:\laborum\tomcat 6.0\webapps

12 \jobrender \cma \boac \appjob Página 12 de Eliminar todas las carpetas contenidas en directorio d:\laborum\tomcat 6.0\work 6. Desde carpeta \proyectos copiar archivos.war a carpeta d:\laborum\tomcat 6.0\webapps 7. Desde carpeta \proyectos descomprimir y copiar contenido de archivo www_source a carpeta d:\laborum\source\laborum.cl\www 8. Desde carpeta \proyectos descomprimir y copiar contenido de archivo www_resource a carpeta d:\laborum\sites\prod\laborum.cl\resource 9. Revise que en carpeta d:\laborum\indices\ofertas no exista el archivo write.log y en caso que se encuentre elimínela. 10. Inicie Tomcat con el botón Start 11. Revise que en carpeta d:\laborum\tomcat 6.0\webapps se hayan generado las carpetas indicadas en punto Detenga Tomcat una vez más y vuelva a Iniciarlo Liberar versión en máquina y 206 Tanto el servidor y requirieren de los siguientes pasos: 1. Conectarse al servidor con usuario y contraseña suministrado por el jefe de tecnología. 2. Detener Tomcat mediante el botón Stop del Apache Tomcat Properties, (ver Ilustración 6)

13 Página 13 de 15 Ilustración 7. Pantalla de Apache Tomcat Properties. 3. Una vez detenido tomcat, se debe eliminar las siguientes carpetas desde el directorio d:\laborum\tomcat 6.0\webapps \appjob 4. Eliminar todas las carpetas contenidas en directorio d:\laborum\tomcat 6.0\work 5. Desde carpeta \proyectos correspondiente a la versión a liberar y que se encuentra en servidor , copiar archivos appjob.war a carpeta d:\laborum\tomcat 6.0\webapps 6. Desde carpeta \proyectos correspondiente a la versión a liberar y que se encuentra en servidor , descomprimir y copiar contenido de archivo www_source a carpeta d:\laborum\source\laborum.cl\www 7. Desde carpeta \proyectos correspondiente a la versión a liberar y que se encuentra en servidor , descomprimir y copiar contenido de archivo www_resource a carpeta d:\laborum\sites\prod\laborum.cl\resource 8. Inicie Tomcat con el botón Start 9. Revise que en carpeta d:\laborum\tomcat 6.0\webapps se hayan generado las carpetas indicadas en punto Detenga Tomcat una vez más y vuelva a Iniciarlo

14 Página 14 de Render sitio laborum.cl Finalmente se requiere realizar render al sitio laborum.cl, para ello revise lo siguiente: Archivo hosts en C:\WINDOWS\system32\drivers\etc contenga las siguiente lineas: render-p0.laborum.cl Tiene acceso desde su equipo al servidor Luego, en el navegador acceda al sitio y navegue por el sitio, esto permite a Apache y Velocity generar la versión estática de las páginas html almacenadas en carpeta source. 5.6 Revisar Liberación Tras la liberación será necesario revisar el estado de los servicios básicos del sitio identificados en el documento TECPRO-001-A2. Este documento debe ser almacenado y archivado en repositorio de documentos del área de tecnología. 5.7 Documentar e Informar Características Nueva Versión Crear documento con características o mejoras El EPP deberá completar la información las mejoras, correcciones o nuevas características del sistema en el documento TECPRO-001-A Distribuir documento El documento generado en punto deberá ser enviado a: Encargado de comunicados internos para su distribución al personal de laborum.com, y Gerente y Jefe de Tecnología.

15 Página 15 de 15 6 RESTRICCIONES 1. No se podrá realizar el paso a producción los días Viernes, salvo que esta se requiera con suma urgencia, entendiéndose por esto como correcciones a problemas graves al sistema. 7 ANEXOS [TECPRO-001-A1] Anexo 1- Documento características y mejoras laborum.cl [TECPRO-001-A2] Anexo 2- Checklist Liberación. CONTROL DE MODIFICACIONES: Revisión Nº Fecha Descripción del cambio Elaborado por 01 07/01/2013 Documento Original Mauricio Guerra M