Licencia de Publicación

Transcripción

1 Manual para la instalación Plataforma de desarrollo y control de proyectos sobre tecnología JAVA Universidad Nacional Heredia, Costa Rica Actualizado al 09 de Septiembre de 2009 Por: José Pablo Carvajal Chaves Licencia de Publicación Esta obra está licenciada bajo una Licencia Atribución 3.0 Unported de Creative Commons. Para ver una copia de esta licencia, visite o envíenos una carta a Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA. PNUD 1/12

2 Índice Contenido Primer Parte: Descripción de la plataforma de control de proyectos y desarrollo bajo plataformas JAVA Segunda Parte: Instalación de Apache2 y Subversion 5 Tercera Parte: Instalación de Glassfish y Hudson 7 Cuarta Parte: Instalación de Archiva 9 Página Referencias 11 3 PNUD 2/12

3 Primera Parte Descripción de la Plataforma de control de proyectos y desarrollo bajo plataformas JAVA 1. Subversion (SVN): Es un sistema de control de versiones para proyectos de desarrollo que permite: Dar seguimiento al historial de archivos y directorios Dar seguimiento a los cambios presentados Existen diferentes clientes que me permiten gestionar los proyectos por medio de SVN: 1. TortoiseSVN: Permite integración con el explorador de MS/Windows 2. Subversive: Es un agregado para el IDE de desarrollo para JAVA Eclipse 3. NautilusSVN: Permite por medio de Nautilus en sistemas GNU/Linux gestionar el control de versiones con SVN 4. El IDE Netbeans (de importancia primordial para el CGI) posee integrado un gestor de proyectos bajo SVN. Para ingresar Team >Subversion >Checkout Más información visite: PNUD 3/12

4 2. MAVEN: Nos permite: Crear la estructura de un proyecto JAVA. Se crean subdirectorios para los fuentes de JAVA, para los test unitarios, ficheros de configuración, etc. Genera los.war,.jar,.ear para la distribución de nuestro proyecto. Se encarga de guardar los.jar de los que depende el proyectos, los busca en internet o en el servidor que le sea indicado. Al compilar con MAVEN, automáticamente se pasan los test unitarios, e indica donde falla el compilado en caso de compilar algún test. Algunas ventajas: Se maneja la misma estructura para todos los proyectos. La compilación de todos los proyectos se da la misma manera. Nos gestiona automáticamente los.jar de nuestro proyecto. Gestiona los test cada cierto tiempo para efectos de compilación. 3. ARCHIVA: Es un servidor de jars compatible con MAVEN. ARCHIVA permite montar nuestro propio servidor de jars para almacenar nuestras propias librerías y proyectos. 4. HUDSON: Es un sistema de integración continua. Administra los cambios en las fuentes de SVN, en caso de existir los obtiene y compilará; si todo el proceso es correcto dejará los jars a disposición de quien los necesite y en caso de fallo enviará una notificación a los responsables del proyecto y a los desarrolladores que ingresaron los cambios por medio del SVN. FUNCIONAMIENTO INTEGRAL: El desarrollador modifica las fuentes del proyecto y las compila con MAVEN. MAVEN busca en ARCHIVA los jars actualizados de los que depende el proyecto, compila y realiza los test automáticamente. Si no existe error, el desarrollar realiza un commit de sus fuentes en SVN. Según se programe HUDSON, revisa los fuentes y cambios en SVN; en caso de existir, extrae los últimos fuentes y los compila utilizando MAVEN. En caso de error se envía PNUD 4/12

5 una notificación al desarrollador que agregó los cambios al SVN. Por medio de HUDSON, MAVEN compila todo el proyecto, ejecuta los test automáticos, y si no existe error pasa el.jar generado a ARCHIVA. Segunda Parte Instalación de Apache 2 y Subversion Para realizar las instalaciones de los siguientes paquetes se recomienda hacerlo como usuario root dentro de entornos GNU/Linux. Las instalaciones acá descritas son para entornos GNU/Linux Debian Instalar los paquetes: Apache 2, Subversion y la librería de subversión para apache. PNUD 5/12

6 apt get install apache2 subversion libapache2 svn 2. Creamos la raíz del repositorio: mkdir /var/svn repos 3. Creamos un repositorio para un proyecto: svnadmin create /var/svn repos/cgi 4. Creamos el grupo y agregamos el usuario cgi groupadd subversion addgroup usuario subversion 5. Damos los permisos al repositorio chown R www data.subversion /var/svn repos chmod R 770 /var/svn repos/* 6. Se modifica el archivo /etc/apache2/mods available/dav_svn.conf, agregando al final: <Location /svn_cgi> DAV svn SVNPath /var/svn repos/cgi AuthType Basic AuthName "Repositorio de Proyectos del CGI" AuthUserFile /etc/apache2/dav_svn.passwd Require valid user </Location> 7. Se genera el archivo de autenticación para autenticarse en el SVN remotamente: htpasswd c /etc/apache2/dav_svn.passwd cgi 8. Se reinicia Apache2: /etc/init.d/apache2 restart 9. Ingresar por web para verificar el repositorio: PNUD 6/12

7 1. Instalamos el jdk de java: Tercera Parte Instalación de Glassfish y Hudson apt get install sun java6 jdk update java alternatives s java 6 sun echo 'JAVA_HOME="/usr/lib/jvm/java 6 sun"' tee a /etc/environment 2. Definimos el punto de montaje donde vamos a descargar e instalar el servidor, por ejemplo /opt, Descargamos installerv2.1 b60e linux.jar utilizamos el comando wget 3. Se crea la carpeta con el contenido del.jar (recuerde hacer esto en el punto de montaje donde desea instalar el servidor): java Xmx256m jar [nombre del archivo.jar] 4. Creamos un usuario para el servidor: adduser home /opt/glassfish glassfish (recuerde asignar el home al punto de montaje donde está instalando el servidor) 5. Asignar como dueño de grupo la carpeta de instalación del servidor al usuario recién creado: chown R glassfish:glassfish [carpeta] 6. Hacer login con el usuario y construir el entorno: su glassfish chmod R +x lib/ant/bin lib/ant/bin/ant f setup.xml logout PNUD 7/12

8 7. Descargamos el archivo para montar el inicio automático del servidor: Manual Plataforma de Desarrollo wget content/uploads/2009/06/glassfish_init.txt mv glassfish_init.txt /etc/init.d/glassfish chown root:root /etc/init.d/glassfish chmod +x /etc/init.d/glassfish recuerde editar el archivo glassfish_init.txt con los parámetros de instalación, rutas y demás. 8. Se liga el servicio al inicio del sistema operativo: update rc.d glassfish defaults 9. Iniciamos el servicio y cambiamos la contraseña del usuario admin del panel de administración del servidor: /etc/init.d/glassfish start /opt/glassfish/bin/asadmin change admin password user admin cambiar por la ruta de instalación y el password de admin es : adminadmin Instalación de HUDSON: 1. Desacargamos el archivo.war de: 2. Ingresamos al panel de administración de Glassfish y vamos a Web Applications en Applications 3. Damos click en deploy y buscamos el archivo.war de HUDSON 4. Con ello se instala el HUDSON y el plug in de MAVEN Instalación de MAVEN: 1. Instalamos el paquete en GNU/Linux Debian: apt get install maven2 2. Se liga MAVEN al HUDSON: Ingresamos al panel de control de HUDSON y se procede a indicar la versión del MAVEN instalado: manage hudson Configure System Maven PNUD 8/12

9 Se da check en Install Automatically y se indica la versión instalada Cuarta Parte Instalación de ARCHIVA 1. Creamos los grupos de usuario de MAVEN : su c "groupadd maven" su c "useradd g maven maven" su c "passwd maven" 2. Se crean los directorios en el punto de montaje desea: su c "mkdir /datos/maven" chown R maven:maven /datos/maven su c "su maven" cd /datos/maven mkdir archiva 3. Obtenemos el comprimido de archiva, lo descomprimimos y movemos su contenido: wget archiva bin.tar.gz tar xvf apache archiva bin.tar.gz cd apache archiva mv * /datos/maven/archiva cd.. rm R apache archiva mkdir repositories 4. Modificar el puerto del servidor de ARCHIVA: PNUD 9/12

10 Buscamos el archivo archiva/conf/jetty.xml y modificamos la línea al puerto deseado <Set name="port"><systemproperty name="jetty.port" default="8081"/></set> 5. Agregar un archivo de arranque al init.d del sistema operativo: Se debe crear un archivo que se llame start.sh: #! /bin/bash JAVA_HOME=/opt/jdk1.6.0_03 ARCHIVA_HOME=/datos/maven/archiva LOG_ARCHIVA=$ARCHIVA_HOME/logs export JAVA_HOME if [! d $LOG_ARCHIVA ]; then mkdir $LOG_ARCHIVA fi if [ f $ARCHIVA_HOME/bin/archiva ]; then $ARCHIVA_HOME/bin/archiva start else exit 1 fi #! /bin/bash Se debe crear un archivo que se llame stop.sh JAVA_HOME=/opt/jdk1.6.0_03 ARCHIVA_HOME=/datos/maven/archiva LOG_ARCHIVA=$ARCHIVA_HOME/logs export JAVA_HOME if [! d $LOG_ARCHIVA ]; then mkdir $LOG_ARCHIVA fi if [ f $ARCHIVA_HOME/bin/archiva ]; then PNUD 10/12

11 $ARCHIVA_HOME/bin/archiva stop else exit 1 fi Procedemos a crear el archivo llamado archiva: #! /bin/sh # /etc/init.d/archiva # # Carry out specific functions when asked to by the system case "$1" in start) su c "/datos/maven/archiva/bin/start.sh" ;; stop) su c "/datos/maven/archiva/bin/stop.sh" ;; *) echo "Usage: /etc/init.d/archiva {start stop}" exit 1 ;; esac exit 0 Los archivos start.sh y stop.sh se deben colocar en /datos/maven/archiva/bin, se deben dar permisos chmod 755 a cada uno de los archivos. El archivo archiva debe colocarse en /etc/init.d y se le deben dar permisos chmod 755. Se debe ligar el servicio al sistema operativo: update rc.d archiva defaults PNUD 11/12

12 Referencias Recurso en la Web: Recurso en la Web: %C3%B3n_CVS%2C_Hudson%2C_Maven_y_Archiva_en_proyectos_Java Recurso en la Web SVN: desubversion trac hudson parte practica/ Recurso en la Web Glassfish: instalarglassfish en debian lenny/ Recurso en la Web HUDSON: Recurso en la Web ARCHIVA: PNUD 12/12