Sei sulla pagina 1di 13

Estndar de desarrollo e implantacin de

aplicaciones del Govern de les Illes Balears

PROCEDIMIENTO PARA LA
IMPLANTACIN DE APLICACIONES

Versin 6.1

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

ndice de contenidos
FASES DEL PROCEDIMIENTO DE IMPLANTACIN DE APLICACIONES ......................................................................... 3
3.1. FLUJO DE OPERACIONES PARA LA PUESTA EN PRODUCCIN O PRUEBAS DE APLICACIONES NUEVAS.............................. 5
3.2. FLUJO DE OPERACIONES PARA LA PUESTA EN PRODUCCIN O PRUEBAS DE APLICACIONES EXISTENTES..........................7
3.3. ENTREGABLES........................................................................................................................... 8
3.4. DESCRIPCIN DE LOS FICHEROS ENTREGABLES....................................................................................... 8
3.4.1. Scripts de generacin de los objetos de base de datos Oracle........................................... 9
3.4.2. Aplicacin J2EE (fichero ear).......................................................................................... 9
3.4.3. Roles de la aplicacin J2EE............................................................................................ 9
3.4.4. Fuentes de la aplicacin............................................................................................... 10
3.4.5. Publicacin de la aplicacin......................................................................................... 10
3.4.6. Informacin adicional................................................................................................. 10
3.4.7. Documentacin.......................................................................................................... 10
3.5. NORMAS GENERALES................................................................................................................. 10
4.1. CUMPLIMENTACIN DEL CUADERNO DE CARGA.................................................................................... 11
4.1.1. Cabecera.................................................................................................................... 11
4.1.2. Lista de tareas............................................................................................................. 12

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Captulo 1
Introduccin
La tramitacin interna de un proyecto de sistemas de informacin viene regulada por el
Decreto 174/2003, de 24 de Octubre, por el cual se regulan las comisiones de sistemas de
informacin en tecnologa y comunicaciones. La tramitacin por parte de una consejera u
organismo del Govern de un proyecto relacionado con estas materias (incluida la adquisicin
de hardware, aplicaciones, programas, pginas web...) ha de contar con la aprobacin
previa por parte del director general de la DGIDT.
La revisin del proyecto por la comisin de informtica permite comprobar que el desarrollo
que se va a realizar se ajustar a los medios disponibles en el centro de proceso de datos, y se
seguirn los pasos, criterios, normas y recomendaciones indicados en este documento y, en
general, en la web de estndares de la DGIDT (http://dgtic.caib.es/estandards).
Este documento detalla el procedimiento a seguir para la implantacin de aplicaciones, tanto
en los entornos de pruebas como de produccin, en los servidores de la DGIDT.
El documento se estructurar en 6 grandes apartados:

Requisitos iniciales para el desarrollo de aplicaciones (Captulo 2).

Pasos puesta en produccin/pruebas de aplicaciones nuevas (Apartado 3.1).

Pasos puesta en produccin/pruebas de aplicaciones existentes (Apartado 3.2).

Documentacin necesaria para el despliegue de aplicaciones (Apartado 3.3).

Normas de obligado cumplimiento para las peticiones de instalacin (Apartado 3.4).

Cumplimentacin del cuaderno de carga (Apartado 3.5 y Captulo 4).

Fases del procedimiento de implantacin de aplicaciones


El procedimiento de puesta en produccin de nuevas aplicaciones es el siguiente:
1. Solicitud de un cdigo de aplicacin a suport@caib.es (ver Captulo 2).
2. Desarrollo de la aplicacin.
3. Solicitud de instalacin de la aplicacin en el entorno de pruebas de la DGIDT,
enviando una peticin a suport@caib.es (ver Captulo 3).
4. Validacin y test por parte de los usuarios en el entorno de pruebas de la
DGIDT.
5. Solicitud de instalacin de la aplicacin en el entorno de produccin, enviando
una peticin a suport@caib.es (ver Captulo 3).

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Captulo 2
Solicitud de cdigo de aplicacin
Antes de comenzar el desarrollo de una nueva aplicacin es necesario solicitar un cdigo a la
DGIDT. La peticin se har enviando un correo electrnico a la direccin suport@caib.es
adjuntando el documento de inicio de proyecto debidamente cumplimentado con la la
siguiente informacin:

Peticin de asignacin de cdigo de aplicacin


Nombre y descripcin de la nueva aplicacin
URL de custdia del PPT autoritzat pel director general de la DGIDT
Conselleria y direccin general
Datos de contacto en la Conselleria, en la DGIDT y en la empresa desarrolladora.
Datos tcnicos

Como respuesta, el personal de la DGIDT remitir la siguiente informacin mediante el


documento de inicio de proyecto:

Cdigo asignado a la aplicacin.


Prefijo para los nombres de los objetos.
Usuario propietario de las tablas, usuario del pool de conexiones y base de datos de
pruebas.
Versiones de software a utilizar.
Estndar de nomenclatura a seguir y plantilla del cuaderno de carga, para enviar las
peticiones de instalacin a suport@caib.es.

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Captulo 3
Procedimiento de despliegue de aplicaciones
3.1. Flujo de operaciones para la puesta en produccin o pruebas de
aplicaciones nuevas

Creacin de los documentos entregables y envo a la DGIDT (ver apartado 3.3):


Revisin de la aplicacin por parte de la DGIDT en los tres mbitos siguientes:

Cumplimiento de estndares de BBDD

Cumplimiento de estndares J2EE

Cumplimiento de estndares de Seguridad


Si el paso anterior se supera con xito, es decir, se validan estndares por parte de la
DGIDT, se crea la base de datos en pruebas, se crean los roles de seguridad en el
single-sign-on (de pruebas) del Govern Balear, se crean los enlaces de pruebas en la
intranet/extranet y se despliega la aplicacin en los servidores de pruebas (nunca
directamente en produccin).
Se notificar al usuario que hizo la peticin de instalacin de los posibles problemas
detectados o de la correcta instalacin en pruebas de la aplicacin, as como de los
detalles particulares de la misma.
El responsable funcional o informtico de la conselleria enva peticin para asignar los
roles de seguridad de pruebas a los usuarios que testearan la aplicacin
El responsable del fichero de datos 1 de la aplicacin valida funcionalmente la versin
desplegada y enva una peticin firmada a la DGIDT para el pase a produccin de la
versin.
Se crea la base de datos en produccin, se crean los roles de seguridad en el
single-sign-on del Govern Balear, se crean los enlaces de produccin en la
intranet/extranet y se despliega la aplicacin en los servidores de produccin.
Se notificar al usuario que hizo la peticin de instalacin de los posibles problemas
detectados o de la correcta instalacin en produccin de la aplicacin, as como de los
detalles particulares de la misma.
El responsable funcional de la conselleria o direccin general enva peticin firmada por
el responsable del fichero (aplicacin) para asignar los roles de seguridad a los usuarios
de produccin
Para los pases a produccin ser necesario especificar en el cuaderno de carga (apartado
Descripcin de los cambios) el identificador del ltimo CAI de preproduccin, del que se
debern tomar los ficheros EAR Nota: los pases a produccin se realizarn siempre utilizando los
ficheros EAR instalados en preproduccin.

Segn LOPD
http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Ilustracin 1 - Flujo de operacin para la instalacin de aplicaciones nuevas

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

3.2. Flujo de operaciones para la puesta en produccin o pruebas de


aplicaciones existentes
Para la actualizacin y evolucin de las aplicaciones que ya estn en produccin, tambin son
de obligado cumplimiento los pasos especificados anteriormente, es decir, la obligatoriedad
de realizar previamente los correspondientes pasos al entorno de preproduccin, con el
objetivo de asegurar la calidad y cumplimineto de requisitos de la nueva versin.
De esta forma, es necesario el envo de los entregables:

Instrucciones precisas del procedimiento de actualizacin (cuaderno de carga).

Los nuevos ejecutables (fichero .ear), juntamente con los fuentes actualizados.

Si hay modificaciones en la base de datos (cambios de estructura de una tabla,


nuevas tablas, nuevos procedimientos, etc.), tendrn que incluirse, siempre que sea
necesario, todas las sentencias DDL de creacin/borrado de objetos que puedan
afectar a los cambios a realizar, con diferentes ficheros para cada tipo de objeto a
modificar, siguiendo las indicaciones especificadas en el punto 3.4.1.

Es responsabilidad del desarrollador incluir todos los procedimientos necesarios para


mantener la integridad de la aplicacin actualizada (en cuanto a este punto, tener en cuenta
sobre todo la creacin de sinnimos y permisos sobre los nuevos objetos).
Una vez el responsable de la aplicacin ha validado la versin en el entorno de
preproduccin, podr autoritzar su pase a produccin mediante el envo de una peticin
firmada.

Hay que tener en cuenta que en el caso de los binarios, siempre se pasarn a
produccin los que en ese momento estn en preproduccin (es decir, los enviados
en el ltimo CAI de preproduccin). En cualquier caso, en el CAI de produccin se
deber indicar el CAI de preproduccin al que hace referencia.

Para la ejecucin de los scripts en el entorno de produccin se tendr que indicar en


el cuaderno de carga del pase a produccin los nmeros de CAI que se ejecutaron en
el entorno de preproduccin.

En el caso en que no se tenga que instalar alguno de los CAIs ejecutados en el


entorno de preproduccin se tendr que explicar en el cuaderno de carga el motivo
de no realizarlo.

Si algn script tiene que ser distinto (por ejemplo algn parmetro de una tabla de
configuracin) del ejecutado en preproduccin se tendr que indicar en el cuadeno
de carga de pase a produccin y adjuntar el nuevo fichero.

Si la peticin consiste en modificar o consultar datos de produccin, se tendrn que


enviar los scripts a ejecutar junto con el cuaderno de carga.

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Segn la criticidad y volumen de usuarios de la aplicacin, por norma general:

La DGIDT exige que el paso a produccin se haga como mnimo 15 das despus de
la ltima instalacin en el entorno de preproduccin.

Se solicitar a la DGIDT la asignacin de una fecha para instalar la aplicacin en el


entorno de produccin. Esta peticin se tendr que solicitar con suficiente antelacin
para dedicar los recursos necesarios y la DGTIC pueda evaluar el impacto

3.3. Entregables

Todas las solicitudes de paso a produccin o pruebas tendrn que ser enviadas a la
direccin de correo suport@caib.es y debern tener anexados los siguientes documentos:

Cuaderno de carga

Fichero comprimido (ZIP, RAR o similar) conteniendo TODOS los


ficheros necesarios para realizar la instalacin (ver Apartado 3.4 para ms
informacin):

Scripts a ejecutar

Fichero .ear

Cdigo fuente de la aplicacin

Documentacin

Dicho cuaderno de carga debe tener el nombre siguiente:


INaammdd.doc (si el cuaderno contiene parte de BD y JavaEE)
SWaammdd.doc (si solamente contiene parte JavaEE)
BDaammdd.doc (si solamente contiene parte de BD)

donde aa es el ao, mm es el mes y dd es el da de envo de la peticin a la direccin


de correo suport@caib.es.

El correo que se enviar a suport@caib.es deber indicar como subject o asunto:


INaammdd {PRE|PRO} Cdigo_de_aplicacin (si contiene parte de BD y JavaEE)
SWaammdd {PRE|PRO} Cdigo_de_aplicacin (si slo contiene parte JavaEE)
BDaammdd {PRE|PRO} Cdigo_de_aplicacin (si slo contiene parte de BD)

donde INaammdd es el nombre del cuaderno de carga, {PRE|PRO} indica el entorno de


la instalacin (Preproduccin o Produccin) y 'Cdigo_de_aplicacin' el cdigo de
aplicacin asignado por la DGIDT .
La plantilla del cuaderno de carga se detalla en el Captulo 4. Cuaderno de carga.

3.4. Descripcin de los ficheros entregables


Los elementos que hay que entregar para la instalacin de una aplicacin en pruebas o
produccin son los siguientes:
http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

3.4.1. Scripts de generacin de los objetos de base de datos Oracle


Tienen que contener todas las sentencias DDL y DCL necesarias para crear el esquema
completo de base de datos correspondiente a la aplicacin. Se comprobar que verifiquen las
normas de nomenclatura y seguridad que se especifican en este documento, as como en el
documento de Estndar de desarrollo de aplicaciones Base de datos.
Las sentencias DDL y DCL deben clasificarse en diferentes archivos segn el siguiente criterio:
-

Creacin de tablas: Slo contendr las sentencias de creacin de tablas.

Creacin de constraints: Slo contendr las sentencias de creacin de constraints.

Creacin de ndices: Slo contendr las sentencias de creacin de ndices.

Creacin de secuencias: Slo contendr las sentencias de creacin de secuencias.

Creacin de triggers: Slo contendr las sentencias de creacin de triggers.

Creacin de procedimientos y funciones: Slo contendr las sentencias de creacin


de procedimientos y funciones.

Creacin de paquetes: Slo contendr las sentencias de creacin de paquetes.

Creacin de sinnimos: Slo contendr las sentencias de creacin de los sinnimos


pblicos de la aplicacin.

Creacin de permisos: Slo contendr las sentencias de asignacin de permisos


(GRANT) . sobre los objetos del propietario de la aplicacin al usuario del pool de
conexiones, WWW_xxxxxx y a los roles de Base de Datos.

Otras: un archivo por cada tipo de objetos diferentes a crear en la base de datos.

En general se pueden incluir ms de un objeto del mismo tipo en cada archivo (por ejemplo,
todas las tablas en el mismo archivo), siempre y cuando el tamao del archivo sea reducido.
En el caso de procedimientos, funciones y paquetes, al ser stos ms largos, se tienen que
enviar en archivos separados.
En el caso de tener que ejecutar sentencias DML, estas sentencias se ejecutarn como ltimo
paso de la instalacin, despus de haber ejecutado todas las sentencias DDL. No se pueden
mezclar sentencias DDL y DML en un mismo archivo.
Todos los archivos tendrn la extensin .sql y debern comenzar por el nmero
correspondiente al orden de ejecucin de la instalacin (ejemplo: 01-taules.sql, 02-vistes.sql,
03-procediments.sql, ).
NOTA: Tiene que incluirse una estimacin del tamao necesario del tablespace o tablespaces
requeridos por la aplicacin, tanto en desarrollo como en produccin, as como una
estimacin del crecimiento anual de la aplicacin en produccin.

3.4.2. Aplicacin J2EE (fichero ear)


Adjuntar el fichero ear que contiene la aplicacin.

3.4.3. Roles de la aplicacin J2EE


En caso de que la aplicacin est protegida con uno o varios roles, deber indicarse su
creacin, incluyendo el nombre de cada uno de los roles y su descripcin.

http://dgtic.caib.es >

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

3.4.4. Fuentes de la aplicacin


Se debern entregar siempre los archivos fuente de la aplicacin. NO se pasar a produccin
ningn programa que no adjunte los archivos fuente actualizados.

3.4.5. Publicacin de la aplicacin


Se deber indicar en el cuaderno de carga los entornos dnde se publica la aplicacin, el
nombre del/los enlaces y su ubicacin en el rbol (Conselleria, Direccin General,
Aplicacin). El Govern Balear tiene tres entornos de publicacin:

Intranet: Personal del Govern Balear.


Extranet: Personal del Govern Balear y entidades colaboradoras o perifricas.
Internet: Pblico en general o entidades no conectadas a la red del Govern Balear.

3.4.6. Informacin adicional


Las instrucciones de instalacin deben incluir toda la informacin necesaria para la correcta
configuracin de la aplicacin sobre el servidor de aplicaciones.

3.4.7. Documentacin
Debern entregarse, siempre, como mnimo:

Manual de instalacin, operacin, mantenimiento y copias de seguridad.

Manual de usuario.

Estudio de consumos de cada mdulo software: CPU, memoria, disco y ancho de


banda de red. Juntamente con la previsin de crecimiento de los datos a 3 aos vista.

Informacin tcnica referente a los datos de carcter personal usados en la


aplicacin, especificando el nombre de la tabla, el nombre del campo y el tipo de
dato de carcter personal que contiene.

Estudio de la concurrencia en el acceso a datos y mdulos software: elementos


crticos, bloqueos entre usuarios y situaciones de dead-lock.

3.5. Normas generales

Las solicitudes de instalacin tienen que cumplir todos los requerimientos


especificados en el Apartado 3.1 o 3.2, segn convenga.

Cualquier peticin que no se realice a travs de la cuenta de correo suport@caib.es y


en los trminos establecidos en este documento NO ser tenida en cuenta.

Solamente se pasarn a produccin las solicitudes firmadas por una persona


autorizada.

http://dgtic.caib.es >

10

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

Captulo 4
Cuaderno de carga
En la web de estndares de la DGIDT, http://dgtic.caib.es/estandards, se puede encontrar un
ejemplo/plantilla de cuaderno de carga para las peticiones de instalacin de aplicaciones.
A continuacin se describe brevemente el modo de cumplimentar los campos del cuaderno
de carga disponible en la web de estndares de la DGIDT.

4.1. Cumplimentacin del cuaderno de carga


4.1.1. Cabecera
CODI DAPLICACI
Campo en el que se indica el CODIGO de la aplicacin a la que corresponde el objeto que se
va a instalar o sustituir. Dicho cdigo coincide con el asignado por la DGIDT antes de
comenzar el desarrollo.
PERSONA/ES DE CONTACTE
Campo en el que se indicarn la persona o personas de contacto por si surgiera algn
problema durante la ejecucin de alguno de los pasos del cuaderno de carga. Si el cuaderno
de carga implica diferentes responsables (por ejemplo, base de datos y servicios web) se
indicar el responsable de cada rea.
TELFON/S DE CONTACTE
En este campo se indicarn los telfonos donde se podrn localizar a las personas de
contacto definidas en el apartado anterior.
DATA DEL QUADERN DE CRREGA
En este campo se indicar la fecha en que se cre el cuaderno de carga.
EXECUCI DE LA INSTALLACI
Se indicar el USUARIO responsable de la instalacin en produccin. Tanto se podr poner el
nmero de usuario como una abreviatura del nombre de la persona. Si hay ms de una
persona implicada en el proceso (responsable de base de datos, responsable de servicios
web, ) de cada uno de ellos.
NOTA: a rellenar por parte de la DGIDT.
DATA DE LA INSTALLACI
Se indicar la fecha en la que se ha efectuado la instalacin en produccin.
NOTA: a rellenar por parte de la DGIDT.

http://dgtic.caib.es >

11

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

OBSERVACIONS GENERALS
Se tienen que indicar las observaciones que afecten a todo el proceso de instalacin. No se
trata de un campo de descripcin de la instalacin, generalmente slo se tienen que indicar
en el momento en que se produzca un cambio en el mtodo de instalacin de la aplicacin:
cambio de versin de JBoss, primer despliegue de un web-service, etc.
DESCRIPCI DELS CANVIS
En este apartado se debern detallar los cambios que se han realizado con respecto a la
ltima versin de la aplicacin.
Si se trata de un pase a produccin, en este apartado, adems de especificar los cambios, se
deber indicar el cdigo del pase a preproduccin del cual obtener los ficheros EAR. Nota: La
indicacin del CAI de preproduccin deber hacerse al principio del apartado de descripcin de cambios.

4.1.2. Lista de tareas


N
Numeracin de los pasos de la instalacin en orden ascendente. Se debe incluir un paso para
cada una de las tareas a realizar.
OBJECTE
Nombre del objeto a instalar (script SQL con las sentencias de creacin de objetos, fichero
.ear a desplegar, ...).
El nombre del archivo no podr tener espacios en blanco ni caracteres especiales.
Los scripts de ejecucin en base de datos debern comenzar por el nmero correspondiente
al orden de ejecucin de la instalacin (01-taules.sql, 02-vistes.sql, 03-procediments.sql, ) y en el
cuaderno de carga se tiene que poner el caracter @ al principio del nombre de archivo para
facilitar su ejecucin en SQL*Plus.
USUARI@BD
Se indicar el usuario y la base de datos sobre el que se debern de ejecutar los scripts de
BBDD, con el formato USUARIO@BBDD.
DESTINACI DELS OBJECTES
Se indicar donde se tienen que instalar los objetos especificados en el cuaderno de carga
(servidor de aplicaciones, ruta completa de los objetos, etc.)
OBSERVACIONS ESPECFIQUES A LA INSTALLACI
Un pequeo comentario de cmo se tiene que instalar el objeto en cuestin.
MUY IMPORTANTE:
Si la solitud requiere la instalacin de un .ear y es necesario, se debern
especificar otros recursos necesarios para el correcto funcionamiento, recursos

http://dgtic.caib.es >

12

Estndar de desarrollo de aplicaciones > Procedimiento para la implementacin de aplicaciones

tales como Mail Service, ficheros de properties, etc... Tambin se deber


especificar:

Enumeracin y descripcin de los ROLES de la aplicacin

Descripcin del enlace a publicar y dnde desplegar la aplicacin (en


la intranet/extranet/internet).

http://dgtic.caib.es >

13