https://github.com/mlezcano1985/rokketlabs-demo-nodejs
Simple API REST usando NodeJS con ExpressJS
https://github.com/mlezcano1985/rokketlabs-demo-nodejs
Last synced: 12 months ago
JSON representation
Simple API REST usando NodeJS con ExpressJS
- Host: GitHub
- URL: https://github.com/mlezcano1985/rokketlabs-demo-nodejs
- Owner: mlezcano1985
- Created: 2019-06-28T15:04:18.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-30T18:04:20.000Z (over 3 years ago)
- Last Synced: 2025-02-24T13:48:46.418Z (over 1 year ago)
- Language: JavaScript
- Size: 216 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Demo API REST utilizando ExpressJS
# Descripción
Simple aplicación desarrollada en ExpressJS que expone 2 endpoints.
- GET: `/angular/issues`: Muestra información asociada a los issues de angular en GitHub.
- GET: `/nodejs/articles`: Muestra información asociada a artículos relacionados con NodeJS.
# Cómo empezar?
- Clonar o descargar el repositorio.
- Abrir un terminal en la raíz del proyecto.
# Ejecutar la API con Docker
- Instalar [Docker](https://docs.docker.com/compose/install/) en dependencia de su sistema operativo.
- Abrir un terminal en la raíz del proyecto.
- Ejecutar el comando `npm run start-docker` para que la se inicien los contenedores de node y mongodb. Aparecerá un log en la consola para indicar que la app y la bd están en ejecución.
- Correr migración para insertar datos de prueba en la bd de mongo con el comando `npm run migrate`.
- Abrir el browser para probar los endpoint expuestos.
- Lista de issues de Angular: [http://localhost:3000/angular/issues](http://localhost:3000/angular/issues).
- Lista de artículos de NodeJS: [http://localhost:3000/nodejs/articles](http://localhost:3000/nodejs/articles).
# Ejecutar la API sin Docker
- Instalar versión estable de [NodeJS](https://nodejs.org/es/download/).
- Instalar versión estable de [MongoDB](https://www.mongodb.com/download-center/community) local. Para este demo se utilizó la versión 4.0.4 en Window x64. En caso de utilizar otro servidor de mongo puede editar la cadena de conexión en el fichero _migrate-mongo-config.js_, ubicado en la raíz del proyecto, sustituyendo su cadena de conexión por la existente: _localhost:27017_ .
- Instalar dependencias usando el comando `npm install`.
- Ejecutar el comando `npm start` para iniciar la API. Aparecerá un log en la consola para indicar que la app y la bd están en ejecución.
- Correr migración para insertar datos de prueba en la bd de mongo con el comando `npm run migrate`.
- Abrir el browser para probar los endpoint expuestos.
- Lista de issues de Angular: [http://localhost:3000/angular/issues](http://localhost:3000/angular/issues).
- Lista de artículos de NodeJS: [http://localhost:3000/nodejs/articles](http://localhost:3000/nodejs/articles).
# Comandos disponibles
- `npm start`: Inicia la api.
- `npm run test`: Ejecuta las pruebas unitarias.
- `npm run migrate`: Ejecuta migraciones pendientes en la bd de mongo.
- `npm run migrate-down`: Revierte la última migración en la bd de mongo.
- `npm run migrate-status`: Muestra el estado de las migraciones existentes.
- `npm run start-docker`: Inicia los contenedores de node y mongodb.
# Pruebas unitarias
Se realizaron pruebas unitarias a ambos endpoints. Se verificó el estado y el json de la respuesta.
Para ejecutar las pruebas ejecute el comando `npm run test`.