ANEXO D MANUAL DE DESPLIEGUE

Transcripción

1 ANEXO D MANUAL DE DESPLIEGUE La aplicación funciona con 3 componentes fundamentales que son web2py, postgresql y Ansible, durante el desarrollo de la aplicación se hizo uso de la herramienta git para el manejo de cambios de la aplicación. Las capturas de pantalla presentadas son de CentOS y en algunas ocasiones de Ubuntu pero el proceso de instalación es similar en otras distribuciones Enterprise Linux. Se darán algunas indicaciones de cómo se instala el prototipo en Ubuntu pero sin las respectivas capturas de pantalla. ANSIBLE: Se usará la versión gratuita del software que únicamente incluye el manejo por línea de comandos, la cual puede ser instalada de varias maneras, mediante el gestor de paquetes del sistema, pip (sistema de gestión de paquetes de Python), mediante la compilación del código fuente y archivos Tarball de versiones específicas. - Mediante el gestor de paquetes: Para distribuciones EL (CentOS, Red Hat, Fedora) se puede descargar directamente del gestor de paquetes siempre y cuando se cuente con EPEL instalado. Una vez instalado EPEL bastará descargar el paquete con el gestor de paquetes como se haría con cualquier otra aplicación sudo yum install ansible o sudo dnf install ansible (para Fedora >= 22), como se muestra en la figura 63.

2 Figura 1 Instalar Ansible en CentOS. Fuente Autores En el caso de Ubuntu el comando es similar pero no se deben agregar repositorios extra, entonces bastará con ejecutar sudo apt-get install ansible. Figura 2 Instalar Ansible en Ubuntu. Fuente Autores

3 Ésta fue la manera como se instaló Ansible en el servidor y es la manera recomendada por Ansibleworks.. Mediante PIP: Primero que todo para instalar PIP se ejecuta el comando sudo easy_install pip. Figura 3 Instalar pip en CentOS. Fuente Autores Por último se ejecuta pip install ansible Otros métodos: Las demás maneras para instalar Ansible se encuentran explicadas detalladamente en la documentación oficial de Ansible incluye explicaciones para Sistemas operativos como Gentoo, FreeBSD, Mac OSX, Solaris y Arch Linux. POSTGRESQL: Existen muchas guías para cada distribución Linux sobre cómo instalar y configurar éste motor de bases de datos, algunas que se usaron

4 anteriormente fueron X1 y X2, sin embargo se explicará cómo realizar el proceso de instalación de una manera que resulta ser más sencilla, rápida y fácil de replicar en una distribución CentOS usando una de las herramientas ya instaladas, Ansible. Cuando se desea realizar alguna tarea de administración de sistemas con Ansible, es una buena idea buscar en el repositorio en línea de Ansible: Ansible Galaxy o sencillamente en la web por roles que hagan lo que se necesita, es muy probable que se encuentre un rol apropiado para nuestros requerimientos. Una vez ubicado un rol que sea útil se puede instalar desde la línea de comandos o descargando los archivos desde el repositorio en github del desarrollador, después de ello puede que se tenga que modificar levemente algunos archivos o crearlos, pero dichas modificaciones por lo general se encuentran explicadas detalladamente en la descripción del rol, en este caso se utilizará un rol llamado postgresql-on-el6 del usuario lesovsky, el cual está disponible en Ansible Galaxy o en su correspondiente repositorio en Github. Al acceder al rol en Ansible Galaxy podemos ver una ventana con dos pestañas, la primera contiene información básica sobre el rol como las plataformas para alas que tiene soporte, la versión mínima de Ansible y el comando para instalar el rol mediante la línea de comandos, ésta información se encuentra en el archivo main.yml que se encuentra en la carpeta meta del rol. La segunda pestaña muestra el contenido del archivo readme.md del repositorio en Github y contiene instrucciones sobre cómo configurar y usar el rol, no existe una manera estándar de escribir dicho archivo así que la facilidad para usar el rol dependerá de la capacidad para explicarlo del autor y por supuesto del conocimiento en Ansible de la persona que lo descarga.

5 Figura 4 Ejemplo Ansible-Galaxy. Fuente Ansible-Galaxy Si se descarga el rol usando la línea de comandos el rol se descargará por defecto a /etc/ansible/roles/ como se muestra en la ilustración. Figura 5 Instalación postgresql con ansible-galaxy. Fuente Autores

6 Posteriormente se debe abrir una línea de comandos (en caso de haber descargado el rol desde la página web de github) y cambiar la ubicación a la carpeta del rol. El contenido de la carpeta debe ser exactamente el mostrado en la figura 67. Figura 6. Árbol de contenido ansible-galaxy. Fuente Autores Los archivos a modificar serán role.yml, defaults/main.yml, tasks/install.yml. En el primer archivo sólo debemos modificar la primera línea no comentada por el grupo al cual se le desea aplicar la configuración, por defecto se ejecuta en localhost: - host: localhost Si por alguna razón se desea instalar postgresql en varias máquinas a la vez debemos modificar dicha línea por:

7 - hosts: all También se puede usar el nombre del grupo al que se desea aplicar el rol, el manejo de grupos se encuentra documentado en la página oficial de Ansible por el momento podemos dejar la línea en su valor por defecto ya que se va a asumir que se está ejecutando el rol desde la máquina en la que se dejará funcionando el servidor. Ahora con defaults/main.yml se modificarán las líneas: # Basic settings el_version: 7 postgresql_version: 9.4 postgresql_contrib: yes Por los requerimientos de la instalación, por ejemplo si se desea una versión anterior a la 9.4 sólo se debe modificar la segunda línea, los valores disponibles son 9.4, 9.3, 9.2, 9.1, 9.0 y 8.4. Más adelante en el archivo se encuentran las configuraciones de usuarios y bases de datos, por defecto aparecerán los siguientes datos: Figura 7 Archivo YML de configuración para instalar postgresql con Ansible. Fuente Ansible-Galaxy

8 Para agregar un nuevo usuario bastará con copiar la línea de ejemplo y modificarla levemente, el guion al principio es requerimiento para las listas en el lenguaje usado por Ansible, en este orden de ideas un nuevo usuario puede ser: - {name: "otrousuario", pass: "newpass1234", flags: LOGIN, NOSUPERUSER"} Si se desea agregar una nueva bandera de postgresql, se debe agregar al texto entre comillas correspondiente, esta sintaxis es similar a los diccionarios de datos en python y es precisamente eso, un diccionario. Se pueden agregar cuantos usuarios se necesiten, basta con agregar más campos a la lista como en el ejemplo para otrousuario. En cuanto a las bases de datos también se pueden agregar las que sean requeridas, basta copiar y modificar la linea de ejemplo como se muestra a continuación: - {name: "prueba", owner: "otrousuario", template: "template0", encoding: "{{ postgresql_encoding }}", collate: "{{ postgresql_locale }}", ctype: "{{ postgresql_locale }}" } Los demás parámetros en el archivo pueden ser modificados si el administrador lo requiere pero para la instalación de la aplicación no será necesario. Por último, el archivo tasks/install.yml debe ser modificado únicamente si al ejecutar el playbook surge un error al momento de instalar el motor de bases de datos:

9 Figura 8 Salida ejecución playbook. Fuentes Autores Este error se debe a un error a evaluar algunas variables, por algún error de escritura que el autor no solucionó al momento de elaborar ésta guía, en dado caso las lineas: Figura 9 Playbook instalación Postgresql. Fuente Ansible-Galaxy Deben ser remplazadas por: Figura 10 Modificación playbook instalación postgresql. En el parámetro pkg debe copiarse la línea con la dirección del repositorio correspondiente a la distribución del sistema, dichas direcciones se

10 encuentran en el archivo /vars/repo.yml con direcciones para CentOS, RedHat y Scientific_linux. Una vez realizados estos cambios bastará con ejecutar el comando: ansible-playbook role.yml La salida completa resulta muy larga como para ser incluida en la guía, en caso de errores Ansible detendrá le ejecución informando del error y la posible causa, algunas veces mostrará advertencias cuando no se usa una nueva convención como colocar las variables entre corchetes dobles. Al final de la ejecución se presenta un resumen corto, en el caso de ejemplo anterior con dos usuarios (postgres, otro usuario) y dos bases de datos (db1, prueba), la salida correspondiente es la siguiente: Figura 11 Resumen ejecución playbook. Fuente Autores Si se definieron más equipos destino, éstos aparecerán en la lista, el primer campo ok indica que 21 tareas se ejecutaron sin realizar cambios en el sistema dado que dichos cambios ya se habían hecho, el segundo parámetro indica que las tareas realizaron 10 cambios en el sistema. Los últimos dos parámetros indican si un equipo no fue alcanzable por la conexión ssh y si alguna tarea presento un error, en caso de que un equipo no sea alcanzado resulta conveniente ejecutar el comando anterior agregando -vvvv al final, para que Ansible muestre una salida más detallada de todo lo que hace, incluyendo el establecimiento de la conexión ssh. Si una tarea falló debe revisarse el archivo.yml correspondiente.

11 GIT: Sólo es necesario instalarlo desde el gestor de paquetes: - CentOS: sudo yum install git-all o sudo yum install git - Ubuntu: sudo apt-get install git-all o sudo apt-get install git La segunda opción resulta más rápida y para la instalación de la aplicación resulta más que suficiente. Una vez instalado git se realizará un clone del repositorio remoto ubicado en: Figura 12 Clonar repositorio del proyecto. Fuente Autores Tras cambiar a la carpeta recién creada al realizar el clone, se debe ejecutar el comando git submodule update --init recursive Figura 13 Clonar el submodule de web2py. Fuente Autores

12 Si no se hiciera esto al tratar de iniciar la aplicación se produciría un error por algunas dependencias faltantes. Antes de iniciar la aplicación se debe modificar de manera manual con cualquier editor (Nano, vi, gedit.) un archivo ubicado en applications/datos/models/db0.py: Se debe modificar la linea marcada por los datos de conexión a la base de datos local, la sintaxis es: STR_DAL ="postgres://{{ usuario }}:{{ contraseña }}@localhost/{{ nombre_base_datos }}" Además la línea con la variable mig, debe ser cambiada por mig = True, esto, para que web2py intente crear la base de datos en su primera ejecución, una vez creada la base de datos en la primera ejecución debe ser cambiada de nuevo a mig = False. Figura 14 Creación o migración de tablas a través de Web2py. Fuente Autores Se probó la aplicación con el motor Postgresql, sin embargo ésta debería funcionar en cualquier motor de base de datos manejado por la capa de abstracción de base de datos (DAL) de web2py, con algunos cambios en la aplicación original, algunos de los motores de bases de datos soportados por DAL son SQLite, MySQL, Oracle, MSSQL, FireBird, DB2, Informix, Ingres, Cubrid, Sybase, Teradata, SAPDB, MongoDB, IMAP.