Guía 17

Guía 17

DAWM / Proyecto04

</link>

Actividades previas

  1. Acceda a Render y obtenga una cuenta con GitHub.
  2. Active su cuenta desde el enlace en el correo electrónico.
  3. Complete su perfil con su información básica.

Actividades en clases

Render - Despliegue desde GitHub

  1. En el Dashboard Render, seleccione la opción Web Services.

  2. Conecte el servicio web con el repositorio remoto restapi.

  3. En la configuración, cambie el valor de Start Command por node server.js.

  4. En la sección Instance Type, seleccione la opción gratuita Free.

  5. En la sección Environment Variables:
    • Haga clic en Add from .env.
    • Pegue todo el contenido el archivo .env del proyecto restapi.
    • Haga clic en Add Variables.
  6. Haga click en Deploy Web Service.

  7. (STOP 1) Acceda a la opción Events del servicio web e inspeccione el proceso de despliegue.

Render - URL del servicio web

  1. Identifique el URL del servicio web.

     https://restapi-<ID>.onrender.com/

  2. Agregue la ruta /documentation a la URL del servicio web y acceda a la página con la documentación en Swagger:

     https://restapi-<ID>.onrender.com/documentation

  3. (STOP 2) Compruebe el endpoint GET de la documentación en Swagger e identifique el error en la respuesta.

REST API - host

  1. Copie en solo el host (restapi-<ID>.onrender.com) del URL del servicio web.
  2. En el archivo de configuración de ./swagger.js:
    • Modifique la clave “host” coloque el host del servicio web.
    • Agregue la clave “schemes” coloque el valor [“https”].
     ...

 const doc = {
   ...
   //"host": 'localhost:5500',
   "host": 'restapi-<ID>.onrender.com',
   "schemes": [
     "https"
   ],
   ...
 };

 ...

  3. Desde la línea de comandos, genere el archivo de configuración (./swagger_output.json) de Swagger, con el comando:

     npm run swagger
  4. Versione local y remotamente el repositorio restapi
  5. Acceda a la opción Events del servicio web e inspeccione el proceso de despliegue.

  6. (STOP 3) Compruebe el endpoint GET de la documentación en Swagger e identifique la respuesta exitosa.

Documentación

Fundamental

Términos

despliegue, URL, host, path

Referencias