SIU-Sanaviron-Quilmes/version1.0.0/instalar sq test

De SIU
Revisión del 11:36 4 sep 2017 de Esassone (discusión | contribuciones) (Configuración)
Saltar a: navegación, buscar
Siu-sanaviron-quilmes.png

Esquema de instalación del entorno de testing de SIU-Sanavirón-Quilmes

En esta sección se va a encontrar información sobre:

  • Requisitos para la instalación.
  • Configuración para inicializar el entorno.

Requisitos

Git: apt-get install git-core

Docker CE: https://docs.docker.com/engine/installation/

Docker Compose: https://docs.docker.com/compose/install/

SIU-Guaraní 3.13

SIU-Pilagá 3.0.1

Instalación

Creación del entorno

  1. Posicionarse en la ubicación deseada para la instalación del entorno de testing:
  1. cd /usr/local/proyectos/sanaviron_quilmes/

El proyecto está disponible en https://hub.siu.edu.ar

git clone https://hub.siu.edu.ar/sanaviron-quilmes/testing.git
  1. Ahora tenemos el path:
    /usr/local/proyectos/sanaviron_quilmes/testing/
    Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto TESTING>.

Crear archivo de configuración

cp <path proyecto TESTING>entorno.env.template <path proyecto TESTING>entorno.env

Una vez descargado, ejecutar en la carpeta 'bin' del mismo:

<path proyecto TESTING>/bin/sh sq_crear_entorno_testing

Configuración

Agente de cobranzas

Para utilizar el agente de cobranzas MercadoPago deberá tener en cuenta que este realizará notificaciones que deberán ser capturadas por las API's de los componentes Unidad de venta y G.C.O. Para ello deberá tener acceso a una ip pública para que MercadoPago realice las notificaciones.

Comúnmente los ambientes de testing no se encuentran disponibles al público por ello el proyecto testing dispone de un dispatcher para que MercadoPago pueda realizar las notificaciones y este las redireccione al ambiente de testing.

Puede encontrar el dispatcher en la siguiente carpeta y ubicarlo en un servidor publico

<path proyecto TESTING>/templates/dispatcher_notificacion_mp.php

Creación de cuentas de Test:

Ingrese a Mercadopago con la cuenta madre. Una vez logueado diríjase a la siguiente URL para obtener las credenciales

# Diríjase al tab 'Checkout básico'
https://www.mercadopago.com/mla/account/credentials

Una vez obtenidos el CLIENT_ID y el CLIENT_SECRET deberá editar el archivo:

<path proyecto TESTING>/bin/mp_test_user.php

# Configurar los datos de la cuenta madre de Mercadopago
export MP_MC_CLIENT_ID=
export MP_MC_CLIENT_SECRET=

Se deberán crear 2 cuentas de test asociadas a una cuenta 'madre', una actuará como compradora y otra como vendedora.

En el próximo paso crearemos los 2 usuarios de test

# Ejecutar 2 veces este comando
<path proyecto TESTING>/bin/mp_test_user.php

#El comando generará como salida un user y pass de mercadopago.
#Ejemplo: {"id":271639683,"nickname":"TETE000000","password":"qatest0000","site_status":"active","email":"test_user_000000@testuser.com"}

Guardar cada linea generada como salida de la ejecución.

Nota: Recomendamos que elimine las credenciales del archivo 'mp_test_user.php' ya que no serán necesarias nuevamente.

Ingresar nuevamente a Mercadopago con la cuenta 'vendedora' (El usuario es el nickname).

Una vez logueado diríjase a la siguiente URL para obtener las credenciales de la cuenta vendedora de test.

# Diríjase al tab 'Checkout básico'
https://www.mercadopago.com/mla/account/credentials

Guardar las credenciales (CLIENT_ID y CLIENT_SECRET), para su posterior uso.

Nota: Puede ingresar a https://www.mercadopago.com.ar/developers/es/solutions/payments/custom-checkout/test-cards para utilizar tarjetas de crédito de test.

Configurar el entorno

Editar el archivo <path proyecto TESTING>entorno.env y definir los siguientes valores:

# Configuraciones
#=======================================
export DISPOSITIVO_RED='eth0';
export DISPATCHER_ACTIVO=true;
export DISPATCHER_URL='http://IP_PUBLICA/dispatcher_notificacion_mp.php?sender=';

# Pilaga
#=======================================
export API_PILAGA_URL='http://127.0.0.1/pilaga/rest/';
export API_PILAGA_USUARIO='toba';
export API_PILAGA_PASSWORD='toba';
export API_PILAGA_METHOD='digest';

# Guarani
#=======================================
export API_GUARANI_URL='http://127.0.0.1/guarani/3.13/rest/';
export API_GUARANI_USUARIO='toba';
export API_GUARANI_PASSWORD='toba';
export API_GUARANI_METHOD='digest';

# MercadoPago
#=======================================
export MP_CLIENT_ID=1111111111111111;
export MP_CLIENT_SECRET=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA;

SIU-Guaraní

El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:

# Gestión
<path gestion>/lib/toba/instalacion/i__desarrollo/p__guarani/rest/sanaviron/cliente.ini


# Autogestión
<path autogestion>/instalacion/servicios_web_config.php (apartado 'consumidos')
<path autogestion>/instalacion/config.php ('url_sq_pagos')

Uso

Iniciación del entorno

La inicialización del entorno supone una instalación completa del entorno Sanavirón-Quilmes (Núcleo, Unidad de venta, G.C.O y SQ-Pagos). Por ello cada vez que iniciemos el entorno se eliminaran las instalaciones y datos existentes para dar lugar a una nueva instalación.

Para iniciar el entorno ejecutamos:

# Opcionalmente podemos iniciar con una versión especifica, por ejemplo la versión 1.0.8
<path proyecto TESTING>/bin/sh sq_iniciar_entorno 1.0.8

Luego de iniciado el entorno puede verificar el funcionamiento de los módulos ingresando en las siguientes urls:
Núcleo: http://127.0.0.1:4001/sq_nucleo/
Unidad de venta: http://127.0.0.1:4002/sq_uv/

Para conectarse a la base de datos el usuario y password es postgres:
Núcleo: puerto 4431
Unidad de venta: puerto 4433

Carga de datos

La inicialización del entorno se genera con los datos básicos de los componentes Núcleo y Unidad de venta. Si se desean cargar datos de una base existente, por ejemplo, de producción se pueden agregar en la siguiente estructura de directorios:

# En la siguientes carpetas puede agregar un dump sql de una base de datos (la carpeta solo admite un solo archvio sql)
<path proyecto TESTING>/datos/nucleo/
<path proyecto TESTING>/datos/unidad-venta/

# Dentro de las carpetas existe un directorio 'bases' que puede utilizarlo para almacenar dump's que no serán utilizados en la carga de datos.
Nota: Recuerde que al cargar los dump's de datos estos deberán se consistentes con los de los módulos SIU-Guaraní y SIU-Pilagá

Para cargar los datos ejecutamos:

<path proyecto TESTING>/bin/sh sq_cargar_datos

Terminal de los contenedores

Para ingresar a una terminal en los contenedores puede hacerlo de la siguiente forma:

# Para listar los contenedores activos
sudo docker ps
# En la columna NAMES se describe el nombre del contenedor

# Para ingresar a la terminal de un contenedor
<path proyecto TESTING>/bin/sh docker-connect <nombre-contenedor>