azureOpenSourceDayMeanHolBackend

Código expressjs y nodejs para la solución del backend corriendo en Azure.

Parte I: Construir Solución Backend en Azure

El código final github puede ser descargado desde acá

Instalamos y ejecutamos Swaggerize

1. Creamos una nueva carpeta que se llame backend
2. Instalamos los modulos de npm “yo” y “generator-swaggerize”
   1. npm install -g yo
   2. npm install -g generator-swaggerize
3. Descargamos el archivo api.json en nuestro directorio, será nuestra definición de API
4. Navegamos a la nueva carpeta y ejecutamos el comando “yo swaggerize”, esto inicializará el proyecto y nos hará unas cuantas preguntas:
   1. yo swaggerize
   2. Para como llamar el proyecto “listaContactos”, “path to swagger document” ingresa api.json y para “Express, Hapi o Restify” ingresa express
5. Nos posicionamos en nuestra carpeta del nuevo proyecto y ejecutamos el comando:
   1. npm install
6. Luego instalamos y guardamos el modulo jsonpath
   1. npm install --save jsonpath
7. Luego instalamos y guardamos el modulo swaggerize-ui
   1. npm install --save swaggerize-ui

Luego modificamos el código generado

1. Descarga el código final del repositorio publico https://github.com/feranto/azureOpenSourceDayMeanHolBackend
2. Copia la carpeta /azureOpenSourceDayMeanHolBackend/listaContactos/lib dentro de tu carpeta listaContactos
3. Reemplaza el código dentro de handlers/contacts.js con el siguiente código:

'use strict';

 var repository = require('../lib/contactRepository');

 module.exports = {
     get: function contacts_get(req, res) {
         res.json(repository.all())
     }
 };

4. Reemplaza el código dentro de handlers/contacts/{id}.js con el siguiente código

'use strict';

 var repository = require('../../lib/contactRepository');

 module.exports = {
     get: function contacts_get(req, res) {
         res.json(repository.get(req.params['id']));
     }    
 };

5. Reemplaza el código dentro de server.js con el siguiente codigo

'use strict';

 var port = process.env.PORT || 8000; // first change

 var http = require('http');
 var express = require('express');
 var bodyParser = require('body-parser');
 var swaggerize = require('swaggerize-express');
 var swaggerUi = require('swaggerize-ui'); // second change
 var path = require('path');

 var app = express();

 var server = http.createServer(app);

 app.use(bodyParser.json());

 app.use(swaggerize({
     api: path.resolve('./config/swagger.json'), // third change
     handlers: path.resolve('./handlers'),
     docspath: '/swagger' // fourth change
 }));

 // change four
 app.use('/docs', swaggerUi({
   docs: '/swagger'  
 }));

 server.listen(port, function () { // fifth and final change
 });

Probamos la API generada

1. Finalmente podemos correrlo localmente utilizando el siguiente comando node server.js

2. Podemos navegar a http://localhost:8000/contacts y veremos la salida JSON de la lista de contactos

3. Podemos navegar a http://localhost:8000/contacts/2 y veremos la salida JSON del contacto con ID 2

4. Podemos navegar a http://localhost:8000/swagger y veremos la configuración swagger

5. Podemos navegar a http://localhost:8000/docs y veremos la documentación de nuestra API

Creamos una API APP en Azure

1. Navegamos hasta el portal de azure
2. Seleccionamos Nuevo > Web + Mobile > API App.

3. Ingresamos un nombre para la App
4. Creamos un nuevo grupo de recurso para nuestra app con el nombre que deseemos
5. Creamos un nuevo App Service Plan para nuestra app

6. Le ponemos el nombre que deseemos al app service plan
7. En la locación del app service plan, escogemos el que está mas cercano a nosotros
8. Hacemos click en Pricing tier > View All > F1 Free.

9. Confirmamos que todo este ok y seleccionamos Crear

Configurar Deployment usando Git

1. Después de que la API app ha sido creada exitosamente, hacemos click en App Services > {tu API app} y veremos los settings de nuestra app:

2. En el panel de settings, buscamos la opción de "Deployment Options" > Choose Source > Local Git Repository, y luego presionamos Ok.

3. Una vez que hemos conectado nuestro repositorio Git, nos mostrará los deployments activos.

Probar la API corriendo en Azure

1. Copiamos la URL de de nuestra API

2. Utilizando un client REST como Postman o Fiddler intentamos acceder al endpoint de /contacts, la URL sería https://{your API app name}.azurewebsites.net/listadoContactos/contacts

3. Finalmente podemos probar la documentación de nuestra API visitando /docs