Suite de Tests para Integradores

Contenido

Introducción Instalación de Docker Ejecución del aplicativo Ejecución del aplicativo para Mac M1 Actualización del aplicativo Ejemplos

Para colaborar con las pruebas de los servicios que implementan los Carriers, Mercado Envíos desarrolló una herramienta para realizar testeos en las etapas tempranas de desarrollo.

Esta herramienta ejecuta una serie de tests que intentan reproducir las diversas situaciones que suelen darse en producción con el objetivo de minimizar errores, maximizar la calidad del producto final y reducir tiempos de desarrollo.

Gracias a que está implementada sobre Docker, puede ser ejecutada con facilidad por el carrier y en cualquier ambiente y etapa del desarrollo.

Instalación de Docker

La suite de tests de Mercado Envíos utiliza Docker para ejecutarse. Puedes instalar Docker desde aquí:

Instalar Docker para Windows 10
Para Windows 7 se deberá instalar docker toolbox
Instalar Docker para Mac
Instalar Docker para Ubuntu "apt install docker.io"
Instalar Docker para otros

Nota:

Si tienes Windows o Mac OS, te recomendamos que uses las últimas versiones de cada sistema operativo (Windows 10 y Mac OS High Sierra respectivamente) para ejecutar Docker en forma nativa y evitar así el uso de virtualizadores como VirtualBox.

Ejecución del aplicativo

Una vez instalado Docker, puedes descargar y ejecutar la aplicación con el siguiente comando:

docker run -d --name cit -p 8090:8090 -p 8091:8091 mercadolibre/carrier-integration-tests

Nota:

Si tienes Mac M1 use el siguiente comando:

docker run -d --name cit -p 8090:8090 -p 8091:8091 mercadolibre/carrier-integration-tests:latest-m1

Ingresando a localhost:8090 verán lo siguiente:

Todas las variables se puede completar en la UI, pero también existe la posibilidad de completarlas por comando:

docker run -d --name cit -p 8090:8090 -p 8091:8091 -e SITE_ID=MLA -e SERVICE_ID=1024 -e SERVICE_NAME=examplecarrier mercadolibre/carrier-integration-tests

Variable	Descripción
SITE_ID	MLA para Argentina, MLB para Brasil, MLC para Chile, MCO para Colombia, MLM para México y MLU para Uruguay
SERVICE_ID	Valor numérico que te provee Mercado Libre por cada servicio
SERVICE_NAME	El nombre del servicio, generalmente el nombre de la empresa

Otras variables

Variable	Descripción
CARRIER_CLIENT_ID	Identifica a Mercado Libre como cliente
CARRIER_CONTRACT	Identifica el contrato por cada servicio
CARRIER_ACCOUNT	Similar al contrato, identifica distintas cuentas de Mercado Libre
CARRIER_USER	Usuario para Mercado Libre
CARRIER_PASSWORD	Contraseña para Mercado Libre
SERVICE_LOGISTIC	Representa el tipo de operatoria del envío. Valores posibles: drop_off, cross_docking o fulfillment.

Luego de ejecutar la aplicación, es posible verificar el estado de la misma corriendo el comando:

docker ps -a

Una vez iniciado el sistema, puedes acceder a él desde cualquier browser ingresando la dirección: localhost:8090

Para detener la aplicación usa este comando:

docker stop cit

Para iniciarla nuevamente:

docker start cit

Actualización del aplicativo

Para actualizar la aplicación, es necesario eliminar el viejo container antes de descargar la nueva imagen. Los siguientes comandos muestran como hacerlo:

docker stop cit docker rm cit docker pull mercadolibre/carrier-integration-tests:latest docker run -d --name cit -p 8090:8090 -p 8091:8091 -e SITE_ID=MLA -e SERVICE_ID=1024 -e SERVICE_NAME=examplecarrier mercadolibre/carrier-integration-tests

Nota:

Es recomendable actualizar periódicamente el aplicativo para obtener los últimos casos de prueba.

Ejemplo

El siguiente video muestra como instalar docker y ejecutar el aplicativo desde Linux