Manual de implantación del entorno de entrega

Este documento describe de forma rápida la instalación de los componentes mínimos recomendados por el Marco de Desarrollo para la recepción de las entregas de software.

• Elementos a instalar en el servidor para la recepción de entregas.
  • Subversion + Apache + módulo de subversion.
  • JDK 1.5 o superior.
  • Tomcat 5.5
  • Artifactory 2.2.5
• Elementos a instalar en el puesto de trabajo:
  • JDK 1.5 o superior
  • Maven 2.0.8 (o superior)
  • Cliente Subversion

Elementos del Servidor

A continuación se detallan los componentes que se deben instalar en el servidor para conseguir la integración con el Catálogo Interno de Software. Se insiste que esto es una guía rápida sobre un sistema ejemplo (Ubuntu) que en ningún caso debe reemplazar la documentación oficial, a la cuál debemos dirigirnos en caso de dudas.

Instalación de Subversion y Apache2

A continuación veremos la instalación de Subversion y Apache2 con el módulo de subversion.

En primer lugar instalamos el servidor Apache:

sudo apt-get install apache2

A continuación instalamos subversion y su módulo de apache:

sudo apt-get install subversion libapache2-svn

Se crea un repositorio de subversion y le damos permisos a apache sobre el mismo:

sudo svnadmin create /svn
chown -R apache:apache svn

Se edita el fichero de configuración de apache para que soporte el nuevo módulo y mapeamos a una url. Este fichero depende de cada instalación específica:

sudo gedit /etc/apache2/mods-enabled/dav_svn.conf

El contenido del fichero puede quedar tal que:

<Location /svn>
# Descomentamos esta línea para habilitar el repositorio
DAV svn
# Establecemos la ruta a dicho repositorio.
SVNPath /svn
# Descomentamos estas 3 líneas para habilitar la autenticación básica
AuthType Basic
AuthName "Subversion Repository"
AuthUserFile /etc/apache2/dav_svn.passwd
AuthzSVNAccessFile /etc/apache2/dav_svn.auth
        <LimitExcept REPORTS>
                Require valid-user
        </LimitExcept>
</Location>

Creamos un usuario para nuestro subversion:

sudo htpasswd -cm /etc/apache2/dav_svn.passwd <username>

Y añadimos los permisos para el usuario en el fichero (por ejemplo para admin):

[/]
admin=rw

Y por último bastaría con reiniciar Apache. A este servidor subversion deben subirse los proyectos empaquetados de la Consejería.

sudo /etc/init.d/apache2 restart

Con todo esto si intentamos acceder por el navegador web para consultar nuestro repositorio de subversión nos pedirá usuario y password.

JDK 1.5 o superior

sudo apt-get install sun-java6-jdk

Y definir la variable de entorno JAVA_HOME apuntando a la ruta de instalación.

Tomcat 5.5

sudo apt-get install tomcat5.5

Artifactory 2.2.5

La última versión estable de Artifactory durante la redacción de esta página es la 2.2.5. Para descargarlo podemos ir a su página http://www.jfrog.org/download.php.

La instalación de Artifactory está descrita en el Manual de uso de Artifactory

Elementos a instalar en el puesto de trabajo

Para poder probar que la implantación ha quedado funcionando correctamente deberemos utilizar un equipo cliente con JDK y Maven instalados, donde probaremos a bajar un proyecto del subversion y compilarlo.

JDK 1.5 o superior

Véase en los Componentes del servidor.

Maven 2.0.8 o superior

Basta con seguir los siguientes pasos:

1. Descargarlo de su página web: http://maven.apache.org
2. Decomprimirlo en una carpeta del cliente, p. ej. /home/viavansi/maven
3. Definir la variable de entorno M2_HOME=/home/viavansi/maven y agregar al PATH M2_HOME/bin.