Embed Size (px)
Citation preview
Manual de Despliegue
ONTSI
Versión 1.1
___________________________________________________________________________________
Manual de Despliegue 2
Hoja de control documental
Realizado por Everis Fecha 02/11/2018
Revisado por everis Fecha 02/11/2018
Aprobado por Fecha
Control de versiones
Versión Fecha Descripción
1.0 02/11/2018 Versión inicial del documento.
Lista de distribución
Nombre Rol Organización
Daniel Ortega Cliente Red.es
Oficina de Certificación Proveedor SIA
Explotación Proveedor SIA
Equipo de Desarrollo Proveedor everis
___________________________________________________________________________________
Manual de Despliegue 3
Índice
1. OBJETIVOS DEL DOCUMENTO .................................................... 5
2. DOCUMENTOS RELACIONADOS .................................................. 6
3. REQUERIMIENTOS Y CARACTERÍSTICAS DE LA IMPLANTACIÓN 7
3.1. MÉTODO DE IMPLANTACIÓN ............................................................... 7
3.1.1. Ámbito geográfico ....................................................................... 7
3.1.2. Ámbito temporal ......................................................................... 7
3.2. ENTORNO TECNOLÓGICO ................................................................... 7
3.2.1. Hardware ................................................................................... 7
3.2.2. Software .................................................................................... 7
3.2.3. Comunicaciones .......................................................................... 7
4. INSTALACIÓN Y CONFIGURACIÓN DEL SOFTWARE DE BASE ..... 8
4.1. CAPA DE PRESENTACIÓN: SERVIDOR WEB ........................................... 8
4.1.1. Configuración del servidor ............................................................ 8
4.1.2. Configuración de Certificados de Seguridad .................................... 8
4.1.3. Conexión con Balanceador de Carga .............................................. 8
4.1.4. Seguridad .................................................................................. 8
4.1.5. Otras configuraciones especiales ................................................... 8
4.2. CAPA SERVIDORES DE APLICACIÓN .................................................... 8
4.3. BASE DE DATOS................................................................................ 8
4.4. ADMINISTRACIÓN Y GESTIÓN DE USUARIOS........................................ 9
4.4.1. Activar / Desactivar usuario .......................................................... 9
5. ELEMENTOS A IMPLANTAR ....................................................... 10
5.1. RESUMEN DE ELEMENTOS ................................................................. 10
5.2. DETALLE DE ELEMENTOS A IMPLANTAR .............................................. 10
6. PROCEDIMIENTO DE IMPLANTACIÓN ...................................... 11
6.1. PRECONDICIONES GENERALES .......................................................... 11
6.2. TIPOS DE INSTALACIONES ................................................................ 12
6.3. INSTRUCCIONES INSTALACIÓN Y/O CONFIGURACIÓN .......................... 13
6.3.1. Aplicación del tag en Certificación, Portales y Producción ................. 13
___________________________________________________________________________________
Manual de Despliegue 4
6.4. COMPROBACIÓN DE LA INSTALACIÓN ................................................ 14
6.4.1. Comprobación de la instalación en Certificación y Portales ............... 14
7. PROCEDIMIENTOS DE CARGA DE DATOS ................................. 15
7.1. DATOS DE PARAMETRIZACIÓN .......................................................... 15
7.2. DATOS INICIALES ............................................................................ 15
8. GLOSARIO DE TÉRMINOS ........................................................ 16
ANEXO I: INSTRUCCIONES SOBRE LA ADMINISTRACIÓN O CONSOLA 17
ANEXO II: INSTRUCCIONES SOBRE EL CÓDIGO FUENTE ................ 20
ANEXO III: MARCHA ATRÁS ........................................................... 21
___________________________________________________________________________________
Manual de Despliegue 5
1. OBJETIVOS DEL DOCUMENTO
El objetivo de este documento es facilitar la implantación de los cambios
realizados en el portal de ONTSI detallados en el siguiente punto del
documento.
___________________________________________________________________________________
Manual de Despliegue 6
2. DOCUMENTOS RELACIONADOS
A continuación se muestra una lista de documentos relacionados con el
despliegue del tag 20181029_PortalONTSI_2.4.2.
Nombre Descripción
1_Catalogo_Requisitos Catálogo de requisitos del portal ONTSI.
3_Plan_Pruebas Plan de pruebas del portal ONTSI.
___________________________________________________________________________________
Manual de Despliegue 7
3. REQUERIMIENTOS Y CARACTERÍSTICAS DE LA
IMPLANTACIÓN
3.1. MÉTODO DE IMPLANTACIÓN
3.1.1. Ámbito geográfico
No procede.
3.1.2. Ámbito temporal
No procede.
3.2. ENTORNO TECNOLÓGICO
3.2.1. Hardware
No procede.
3.2.2. Software
No procede.
3.2.3. Comunicaciones
No procede.
___________________________________________________________________________________
Manual de Despliegue 8
4. INSTALACIÓN Y CONFIGURACIÓN DEL
SOFTWARE DE BASE
4.1. CAPA DE PRESENTACIÓN: SERVIDOR WEB
4.1.1. Configuración del servidor
No procede.
4.1.2. Configuración de Certificados de Seguridad
No procede.
4.1.3. Conexión con Balanceador de Carga
No procede.
4.1.4. Seguridad
No procede.
4.1.5. Otras configuraciones especiales
No procede.
4.2. CAPA SERVIDORES DE APLICACIÓN
No procede.
4.3. BASE DE DATOS
No procede.
___________________________________________________________________________________
Manual de Despliegue 9
4.4. ADMINISTRACIÓN Y GESTIÓN DE USUARIOS
Para realizar las tareas de administración es necesario un usuario con role
administrador que se debe activar si se encuentra en la base de datos (y
desactivar al acabar las pruebas) o crear dicho usuario.
1. Comprobar si existe el usuario ejecutando la siguiente consulta sobre la
base de datos:
select * from users where name="nombreusuario";
En caso de que obtenga un resultado el usuario ya se encuentra creado
y por tanto hay que activarlo, en caso contrario hay que crearlo.
2. Crear usuario si no existe ejecutando las siguiente instrucciones drush
situados en la ruta donde se encuentra desplegado el portal:
a. Comprobar los roles que existen y guardar el role name de
administrador:
drush rls
b. Crear el usuario:
drush ucrt "nombreusuario" --mail="[email protected]" --
password="password"
c. Añadir al usuario el role administrador con el role obtenido en 2.a.
drush urol "administrator" "nombreusuario"
4.4.1. Activar / Desactivar usuario
Para activar o desactivar el usuario se deben ejecutar las siguientes
consultas sobre la base de datos:
Activar UPDATE users SET status=1 WHERE
name=”nombreusuario”;
Desactivar UPDATE users SET status=0 WHERE
name=”nombreusuario”;
___________________________________________________________________________________
Manual de Despliegue 10
5. ELEMENTOS A IMPLANTAR
5.1. RESUMEN DE ELEMENTOS
Nombre Ruta
Carrusel.tpl.php
{directorio
raíz}/modules/custom/ontsi_carrusel/the
me/
carousel_lang {directorio raíz}/modules/custom/features
/
filefield_paths {directorio raíz}/modules/contrib/
printfriendly {directorio raíz}/modules/contrib/
5.2. DETALLE DE ELEMENTOS A IMPLANTAR
Como se trata de un parche, el sistema de subida consiste en
añadir/sustituir los archivos que se entregan en el tag por los que se
encuentran en este momento en el portal en la ruta especificada en el
punto anterior 5.1 “RESUMEN DE ELEMENTOS”.
___________________________________________________________________________________
Manual de Despliegue 11
6. PROCEDIMIENTO DE IMPLANTACIÓN
6.1. PRECONDICIONES GENERALES
Disponer de una copia de los archivos que se van a sustituir antes
de iniciar la sustitución de archivos. En el archivo Cambios.txt que
se encuentra en este tag se indica la información sobre versiones y
estados de tags.
o Será necesaria para el procedimiento de marcha atrás.
El portal se deberá certificar con la versión 7.60 de Drupal que se
corresponde con el tag 20181019_core_v10.5.0
(https://svn.red.es/repos/drupal_core/tags/20181019_core_v10.5.0/).
La versión del Core en Producción es la 7.60 ya que se encuentra
compartiendo Core con Dominios y Red.es
Debe desplegarse sobre Debian 7.
El portal comparte Core en PRE con Red.es.
El portal comparte Core con Dominios y Red.es en Producción.
El portal debe ser desplegado por subdirectorio.
___________________________________________________________________________________
Manual de Despliegue 12
6.2. TIPOS DE INSTALACIONES
Se definen dos tipos de instalaciones para implementar los tags:
o Completa
o Parcial
Esta diferencia en la forma de aplicar los tag se debe a la necesidad de
agilizar el despliegue en caso de que los cambios se puedan aplicar sin
necesidad de hacer un volcado completo. Pese a ello, si Explotación,
lo considera oportuno, puede modificar el tipo de instalación.
Desde desarrollo se indica el proceso que se ha seguido en el entorno de
Integración para crear el tag adaptando la documentación a los
entornos de Certificación, Portales y Producción.
A continuación se describen los dos tipos de instalaciones:
o Completa: Es aquella que tiene modificaciones sustanciales y en la
que se precisa que se realice el proceso desde un volcado completo
que incluya todo el portal.
o Parcial: Es aquella que tiene modificaciones no sustanciales
(modificar un archivo, un módulo, una hoja de estilos…) y en la que
no se precisa que se realice el proceso desde un volcado completo
que incluya todo el portal, por lo que desde desarrollo se entrega un
tag con los archivos a aplicar. Dichos archivos deberán ser aplicados
sobre la última versión del portal.
Instalación del tag en Pro: Desde desarrollo se indica (6.3.2) el
proceso de instalación paso a paso en los entornos (el mismo para
todos, teniendo presente los detalles que hay que tener en cuenta en
Producción). Sin embargo, se podría trasladar el entorno de Pre de a Pro
(volcado completo de archivos y base de datos) cuando se trata de una
instalación completa, si previamente se ha puesto el entorno de
Producción en modo “Read-only” para evitar que los editores puedan
crear nuevo contenido. Como se ha mencionado anteriormente, si desde
Explotación se considera que se debe realizar siguiendo otra
metodología serán ellos los encargados de realizarlo.
En caso que se desee que desde desarrollo se amplíe o modifique este
criterio, la descripción del proceso o el método en sí mismo, se puede
comunicar al equipo de desarrollo a través del canal de comunicación
habitual.
___________________________________________________________________________________
Manual de Despliegue 13
6.3. INSTRUCCIONES INSTALACIÓN Y/O CONFIGURACIÓN
A continuación se exponen los pasos a realizar, a nivel general, para
instalar las nuevas características en el portal. En este caso, y ya que se
debe a la aplicación de un parche se trata de una instalación de tipo
Parcial (Ver 6.2).
En los siguientes apartados se detallarán expresamente los cambios que se
tienen que realizar en el código fuente. En este parche la única tarea
administrativa que se requiere es la limpieza de caché.
Durante el proceso de pasos que se describe a continuación se puede hacer
referencia a anexos que se incluyen al final de este documento con
información relevante a cerca de la instalación.
6.3.1. Aplicación del tag en Certificación, Portales y Producción
Paso Descripción
1 Asegurar de disponer una copia de los archivos a
modificar (svn, copia..)
2
Aplicar el tag:
Dentro del entorno a actualizar, sustituir/añadir los
archivos/directorios que se indican en el punto 5.1
“RESUMEN DE ELEMENTOS” y que se encuentran adjuntos
en este tag en la carpeta “0_Codigo_Fuente/src”.
3 Realizar la tarea administrativa o de consola que se indica
en el Anexo I.
4 Realizar la comprobación de la instalación (ver 6.4.1.
Comprobación de la instalación en Certificación y Portales).
___________________________________________________________________________________
Manual de Despliegue 14
6.4. COMPROBACIÓN DE LA INSTALACIÓN
6.4.1. Comprobación de la instalación en Certificación y Portales
Asegurar que el portal se sigue mostrando de forma adecuada y no se
genera ningún error al acceder.
___________________________________________________________________________________
Manual de Despliegue 15
7. PROCEDIMIENTOS DE CARGA DE DATOS
7.1. DATOS DE PARAMETRIZACIÓN
No procede.
7.2. DATOS INICIALES
No procede.
___________________________________________________________________________________
Manual de Despliegue 16
8. GLOSARIO DE TÉRMINOS
No procede.
___________________________________________________________________________________
Manual de Despliegue 17
ANEXO I: INSTRUCCIONES SOBRE LA
ADMINISTRACIÓN O CONSOLA
Una vez que se han realizado todos los cambios a nivel de código fuente, se deben
ejecutar los siguientes pasos a nivel de administración para concluir la instalación
del tag.
1. Ejecutar los siguientes comandos desde la consola de Linux (situados en el
directorio de instalación de ONTSI):
drush cc all
2. En caso de no poder realizar la acción desde la consola de Linux, limpiar caché
desde el panel de administración, como usuario administrador:
1. /admin/config/development/performance
3. Ejecutar los siguientes comandos desde la consola de Linux (situados en el
directorio de instalación de ONTSI):
drush pm-enable carousel_lang
4. Ejecutar pasos 1 y 2
5. Acceder a admin/structure/views/view/carrusel
6. Pulsar sobre Contenido:idioma
___________________________________________________________________________________
Manual de Despliegue 18
7. Seleccionar: Español
8. Pulsar en Aplicar(Todas las presentaciones)
9. Ejecutar los siguientes comandos desde la consola de Linux (situados en el
directorio de instalación de ONTSI):
drush updb
10. Ejecutar pasos 1 y 2
___________________________________________________________________________________
Manual de Despliegue 19
___________________________________________________________________________________
Manual de Despliegue 20
ANEXO II: INSTRUCCIONES SOBRE EL CÓDIGO
FUENTE
El tag “20181102_PortalONTSI_2.4.2” se encuentra en la dirección del repositorio:
https://svn.red.es/repos/drupal_sites_ontsi/tags/20181102_PortalONTSI_2.4.2
Contiene los siguientes directorios:
1. 0_Codigo_Fuente
a. src
2. 1_Documentacion
a. 1_Catalogo_Requisitos
i. Catalogo_Requisitos.doc
ii. Catalogo_Requisitos.pdf
b. 2_Manual_Despliegue
i. Manual_Despliegue.doc
ii. Manual_Despliegue.pdf
c. 3_Plan_Pruebas
i. Plan_Pruebas.doc
ii. Plan_Pruebas.pdf
d. 4_Plan_de_Riesgos
i. Plan_de_Riesgos.doc
ii. Plan_de_Riesgos.pdf
3. Cambios.txt
___________________________________________________________________________________
Manual de Despliegue 21
ANEXO III: MARCHA ATRÁS
Para realizar el plan de marcha atrás, en primer lugar será necesario disponer de la
versión previa de los archivos sustituidos.
Una vez se disponga de la copia de los archivos bastará con sustituir esos archivos
por los que hay actualmente. Para la instalación de los mismos, se puede consultar
el “Manual de Despliegue”.
