Este documento proporciona una guía paso a paso para desplegar los servicios de WebService API y la WEB de Photo&Film4You utilizando Docker y Docker.
Antes de comenzar, asegúrate de que tienes instalado Docker y Docker Compose. Estas herramientas son necesarias para crear y gestionar tus contenedores. Consulta los siguientes enlaces para obtener instrucciones de instalación:
- Docker: Obtener Docker
- Docker Compose: Instalar Docker Compose
El proyecto debería tener la siguiente estructura de carpetas:
Photo&Film4You/
└── WebService/
└── web-photofilm/
└── docker-compose.yml (Para la API y la WEB)
Para levantar el proyecto, únicamente tendremos que levantar el docker. Dependiendo de si se utiliza windows o linux puede ser que docker compose lleve guión o no. En el caso de Windows, necesitaremos tener instalado Docker desktop.
- Desde el directorio raíz ejecuta el comando:
docker-compose up --build
Este docker levanta los siguientes servicios:
- Servicio del cliente (nginx)
- Base de datos de los usuarios (postgres)
- Base de datos de los productos (postgres)
- Coordinación de los servicios (zookeper)
- Servicio web de los usuarios (userws)
- Servicio web de las noficaciones (notificationws)
- Servicio web de los productos (productws)
- Procesamiento de datos (kafka)
Es necesario entrar dentro de ./WebService
:
y en cada uno de los tres servicios sera necesario ejecutar los sigueintes comoandos, uno para cada nombre de servicio
java -jar productcatalog-0.1.0.jar --server.port=18081
java -jar user-0.1.0.jar --server.port=18082
java -jar notification-0.1.0.jar --server.port=18083
-
Acceder al directorio web
cd ./web-photofilm
-
Instalar las dependecias maven
npm install
-
Iniciar en modo desarollo
npm run start
-
Inciar en modo test
npm run test
-
Compilar las dependencias web manualmente
npm run build
-
Confirma que la API está operativa accediendo a uno de sus 3 servicios:
- Product Catalog App:
http://localhost:18081/endpoint
- User App:
http://localhost:18082/endpoint
- Notification App:
http://localhost:18083/endpoint
- Web App con la tienda:
http://localhost
- Web App con la tienda en modo desarollo:
http://localhost:4200
Esta guía proporciona instrucciones sobre cómo importar colecciones de Postman desde el directorio POSTMAN
en nuestro repositorio.
- Asegúrate de tener Postman instalado en tu sistema.
- Debes tener acceso al directorio
POSTMAN
que contiene las colecciones de archivos.json
de Postman.
-
Abrir Postman:
Inicia la aplicación Postman en tu computadora.
-
Acceder a la Función de Importación:
En la esquina superior izquierda de la aplicación, encontrarás el botón
Import
. Haz clic en él. -
Seleccionar Archivos para Importar:
Se abrirá una ventana con varias opciones para importar. Puedes arrastrar y soltar los archivos directamente en esta ventana, o puedes hacer clic en el botón
File
para abrir un cuadro de diálogo de selección de archivos. -
Navegar al Directorio
POSTMAN
:Utiliza el cuadro de diálogo para navegar al directorio donde se encuentra el repositorio y luego entra en la carpeta
POSTMAN
. -
Seleccionar los Archivos de Colección:
Elige los archivos de colección
.json
que desees importar. Puedes seleccionar múltiples archivos manteniendo presionadoCtrl
(oCmd
en MacOS) mientras haces clic en cada archivo. -
Importar los Archivos:
Una vez que hayas seleccionado los archivos, haz clic en el botón
Open
en el cuadro de diálogo para proceder con la importación. -
Revisar las Colecciones Importadas:
Después de importar, las colecciones aparecerán en la barra lateral izquierda de Postman bajo la pestaña
Collections
. -
Listo:
Ahora puedes hacer clic en cualquier colección para ver las solicitudes individuales y comenzar a trabajar con ellas.
- Formato Incorrecto: Asegúrate de que los archivos que intentas importar son
.json
y están formateados correctamente para su uso en Postman. - Versiones Antiguas de Postman: Si estás utilizando una versión antigua de Postman que no puede importar los archivos correctamente, considera actualizar a la última versión.
- Para ver los logs de un servicio:
docker-compose logs -f NOMBRE_DEL_SERVICIO
- Para detener los contenedores:
docker-compose down
- En caso de error al levantar un contenedor, en especial kafka: Intenta volver a levantar ese contenedor individual
Si tienes problemas o preguntas acerca del despliegue, no dudes en contactar al equipo de desarrollo a través de los issues del repositorio del proyecto.