<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: MILTON H FLORES CHINO</title>
    <description>The latest articles on DEV Community by MILTON H FLORES CHINO (@milton_hfloreschino_123).</description>
    <link>https://dev.to/milton_hfloreschino_123</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4245176%2F4b81b43e-095c-44f8-9fa5-c900c5468e4d.jpg</url>
      <title>DEV Community: MILTON H FLORES CHINO</title>
      <link>https://dev.to/milton_hfloreschino_123</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/milton_hfloreschino_123"/>
    <language>en</language>
    <item>
      <title>Pruebas de API con Newman: de 0 a 121 aserciones en un pipeline que despliega en Vercel</title>
      <dc:creator>MILTON H FLORES CHINO</dc:creator>
      <pubDate>Sun, 15 Nov 2026 07:08:05 +0000</pubDate>
      <link>https://dev.to/milton_hfloreschino_123/pruebas-de-api-con-newman-de-0-a-121-aserciones-en-un-pipeline-que-despliega-en-vercel-2ke2</link>
      <guid>https://dev.to/milton_hfloreschino_123/pruebas-de-api-con-newman-de-0-a-121-aserciones-en-un-pipeline-que-despliega-en-vercel-2ke2</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Actividad Grupal 2: API Testing&lt;/strong&gt;: Calidad y Pruebas de Software (SI-784), Universidad Privada de Tacna.&lt;br&gt;
Autores: Milton H. Flores Chino y Manuel Andre Dongo Palza.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;Repositorio:&lt;/strong&gt; &lt;a href="https://github.com/miltom123/si784-grupal2-api-testing" rel="noopener noreferrer"&gt;https://github.com/miltom123/si784-grupal2-api-testing&lt;/a&gt;&lt;br&gt;
&lt;strong&gt;API en producción:&lt;/strong&gt; &lt;a href="https://si784-api-envios.vercel.app" rel="noopener noreferrer"&gt;https://si784-api-envios.vercel.app&lt;/a&gt;&lt;br&gt;
&lt;strong&gt;Video (≤ 5 min):&lt;/strong&gt; &lt;a href="https://youtu.be/XAjGJB6H0Fw" rel="noopener noreferrer"&gt;https://youtu.be/XAjGJB6H0Fw&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/XAjGJB6H0Fw" width="710" height="399"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;




&lt;h2&gt;
  
  
  El problema
&lt;/h2&gt;

&lt;p&gt;Probar una API "a mano" con Postman sirve el primer día. Al tercer cambio ya nadie repite los 20 clics, y los errores llegan a producción. Para este trabajo nos pusimos una regla simple: &lt;strong&gt;ningún cambio llega a producción si no pasan las pruebas, y las mismas pruebas se repiten contra la URL pública después de desplegar.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Para eso construimos una API pequeña y la probamos con dos herramientas:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Newman&lt;/strong&gt;, la versión de línea de comandos de Postman. Cubre las pruebas funcionales y de contrato, y es el tema de este artículo.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;k6&lt;/strong&gt; para las pruebas de carga. Mi compañero Manuel lo explica en su artículo.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  La API bajo prueba
&lt;/h2&gt;

&lt;p&gt;Es una API REST sin estado que &lt;strong&gt;cotiza envíos entre departamentos del Perú&lt;/strong&gt;. Está hecha con Node.js 20 y &lt;a href="https://hono.dev" rel="noopener noreferrer"&gt;Hono&lt;/a&gt;.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Método&lt;/th&gt;
&lt;th&gt;Ruta&lt;/th&gt;
&lt;th&gt;Qué hace&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/v1/health&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Estado y versión&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/v1/departamentos?zona=&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;25 departamentos con su zona&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/v1/departamentos/{codigo}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Un departamento (404 si no existe)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;POST&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/v1/cotizaciones&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Calcula el precio del envío&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/v1/openapi.json&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Contrato OpenAPI 3&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Las reglas de negocio tienen suficientes detalles para que valga la pena probarlas:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Tarifa base de S/ 8 en la misma zona y S/ 12 entre zonas.&lt;/li&gt;
&lt;li&gt;S/ 2.50 por cada 0.5 kg iniciado.&lt;/li&gt;
&lt;li&gt;Recargo de selva, servicio express ×1.6 y seguro del 1 %.&lt;/li&gt;
&lt;li&gt;IGV del 18 %.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Los errores siempre tienen la misma forma:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"error"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"code"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"VALIDACION"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"message"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"..."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"campo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"pesoKg"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pruébala tú mismo:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -X POST https://si784-api-envios.vercel.app/v1/cotizaciones \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{"origen":"TAC","destino":"ARE","pesoKg":2.3}'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Por qué Newman
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;La colección es un archivo JSON&lt;/strong&gt; versionado en el repositorio, junto al código que prueba.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Corre en cualquier CI&lt;/strong&gt; con &lt;code&gt;npx newman run&lt;/code&gt;, sin abrir Postman.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Tiene reporteros&lt;/strong&gt; de consola, JUnit y HTML (&lt;code&gt;newman-reporter-htmlextra&lt;/code&gt;), así los resultados quedan como artefactos del pipeline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;La misma colección&lt;/strong&gt; se ejecuta contra &lt;code&gt;localhost&lt;/code&gt; y contra producción. Solo cambia la variable &lt;code&gt;baseUrl&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Diseño de la colección: 22 peticiones en 4 carpetas
&lt;/h2&gt;

&lt;p&gt;En vez de editar a mano un JSON de 1000 líneas, la colección &lt;strong&gt;se genera&lt;/strong&gt; con un script (&lt;a href="https://github.com/miltom123/si784-grupal2-api-testing/blob/main/tests/postman/generar-coleccion.mjs" rel="noopener noreferrer"&gt;&lt;code&gt;generar-coleccion.mjs&lt;/code&gt;&lt;/a&gt;) a partir de una lista legible de casos. Las aserciones que se repiten se escriben una sola vez:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;cotizacionValida&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
  &lt;span class="nf"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;200&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="sb"&gt;`pm.test('cumple el esquema de cotización', () =&amp;gt; pm.response.to.have.jsonSchema(${s(esquemaCotizacion)}));`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="sb"&gt;`pm.test('IGV es el 18 % del subtotal', () =&amp;gt; { const d = pm.response.json().desglose; pm.expect(d.igv).to.be.closeTo(d.subtotal * 0.18, 0.011); });`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="sb"&gt;`pm.test('total = subtotal + IGV', () =&amp;gt; { const r = pm.response.json(); pm.expect(r.total).to.be.closeTo(r.desglose.subtotal + r.desglose.igv, 0.011); });`&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Las cuatro carpetas siguen técnicas clásicas de diseño de casos:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Salud y catálogo.&lt;/strong&gt; Health check, listado, filtro por zona en minúsculas, zona inválida (400) y departamento inexistente (404).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cotizaciones válidas (partición de equivalencia).&lt;/strong&gt; Misma zona, distinta zona con express, y selva con valor declarado. Cada caso verifica &lt;strong&gt;montos exactos&lt;/strong&gt;: por ejemplo, Tacna → Arequipa con 2.3 kg debe costar &lt;strong&gt;S/ 16.82&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Valores límite.&lt;/strong&gt; 0.1 kg y 50 kg se aceptan; 0.09 kg, 50.01 kg y un valor declarado de 10 001 devuelven &lt;code&gt;422&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Errores y robustez.&lt;/strong&gt; Campos faltantes, tipo incorrecto (&lt;code&gt;"2"&lt;/code&gt; en lugar de &lt;code&gt;2&lt;/code&gt;), JSON mal formado (400), &lt;code&gt;Content-Type: text/plain&lt;/code&gt; (415) y ruta inexistente (404).&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Tres trucos que valen la pena
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;1. Validar el contrato con JSON Schema, no solo el status:&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'el error sigue el contrato'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;have&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;jsonSchema&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;esquemaError&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'señala el campo pesoKg'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;error&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;campo&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;eql&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'pesoKg'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;2. Aserciones a nivel de colección&lt;/strong&gt;, que se ejecutan después de &lt;strong&gt;cada&lt;/strong&gt; petición:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'responde en menos de 3 s'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;responseTime&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;be&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;below&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;3000&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'responde JSON'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;headers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'Content-Type'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;include&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'application/json'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;3. Comparar dos respuestas con &lt;code&gt;pm.sendRequest&lt;/code&gt;.&lt;/strong&gt; Probamos una propiedad del negocio, "express siempre cuesta más que estándar", lanzando una segunda petición desde el script de pruebas:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sendRequest&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'baseUrl'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="s1"&gt;'/v1/cotizaciones'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'POST'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="cm"&gt;/* ... servicio: 'express' */&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;err&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;test&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'express &amp;gt; estándar'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;expect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;res&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;to&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;be&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;above&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;pm&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Ejecutarla en local
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install
npm start          &lt;span class="c"&gt;# API en http://localhost:3000&lt;/span&gt;
npm run test:api   &lt;span class="c"&gt;# newman + reportes HTML y JUnit en reports/&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;│              requests │   22 │   0 │
│            assertions │  121 │   0 │
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  El pipeline: probar → desplegar → volver a probar
&lt;/h2&gt;

&lt;p&gt;El workflow de GitHub Actions (&lt;a href="https://github.com/miltom123/si784-grupal2-api-testing/blob/main/.github/workflows/ci-cd.yml" rel="noopener noreferrer"&gt;&lt;code&gt;ci-cd.yml&lt;/code&gt;&lt;/a&gt;) tiene tres jobs encadenados:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;git push a main
   └─▶ Job 1: unitarias + Newman + k6 smoke (contra localhost)
         └─▶ Job 2: vercel deploy --prod
               └─▶ Job 3: Newman + k6 (contra la URL pública)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Pruebas locales.&lt;/strong&gt; Levanta la API dentro del runner y corre las pruebas unitarias (&lt;code&gt;node:test&lt;/code&gt;), Newman y un smoke de k6.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Despliegue.&lt;/strong&gt; Usa la CLI de Vercel con el secreto &lt;code&gt;VERCEL_TOKEN&lt;/code&gt;. El job obtiene el dominio de producción desde la API de Vercel y lo expone como &lt;code&gt;output&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pruebas contra producción.&lt;/strong&gt; Recibe esa URL y ejecuta &lt;strong&gt;la misma colección&lt;/strong&gt;:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Pruebas funcionales con Newman (producción)&lt;/span&gt;
  &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="s"&gt;npx newman run tests/postman/envios.postman_collection.json \&lt;/span&gt;
      &lt;span class="s"&gt;--env-var baseUrl="$BASE_URL" \&lt;/span&gt;
      &lt;span class="s"&gt;--reporters cli,htmlextra,junit,json \&lt;/span&gt;
      &lt;span class="s"&gt;--reporter-htmlextra-export reports/newman-produccion.html&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Con &lt;code&gt;jq&lt;/code&gt;, el resultado JSON de Newman se convierte en una tabla del resumen de la ejecución. Así se ve sin descargar nada. Los reportes HTML quedan como artefactos.&lt;/p&gt;

&lt;h2&gt;
  
  
  Resultados en producción
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Ejecutadas&lt;/th&gt;
&lt;th&gt;Fallidas&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Peticiones&lt;/td&gt;
&lt;td&gt;23 (22 + 1 &lt;code&gt;sendRequest&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Aserciones&lt;/td&gt;
&lt;td&gt;121&lt;/td&gt;
&lt;td&gt;0&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Mientras desarrollábamos, la propia corrida de Newman detectó una aserción de &lt;code&gt;Content-Type&lt;/code&gt; que se serializaba mal al generar la colección. Por eso las aserciones exactas sobre montos usan valores redondeados a centavos y &lt;code&gt;closeTo&lt;/code&gt; donde hay cálculos con decimales.&lt;/p&gt;

&lt;h2&gt;
  
  
  Lecciones
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Genera la colección desde código.&lt;/strong&gt; Los cambios se revisan en un diff legible y nadie edita a mano el JSON exportado.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Prueba el contrato, no solo el status.&lt;/strong&gt; Un &lt;code&gt;200&lt;/code&gt; con un campo de menos también es un bug.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Repite las pruebas después de desplegar.&lt;/strong&gt; Lo que pasa en &lt;code&gt;localhost&lt;/code&gt; puede fallar en la plataforma, por enrutamiento, cabeceras o variables de entorno.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Valores límite y errores&lt;/strong&gt; fueron la mitad de los casos y donde aparecieron más sorpresas.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;¿Y el rendimiento? Eso lo cubre k6. Lo explica mi compañero Manuel en su artículo; mientras tanto, el script está en &lt;a href="https://github.com/miltom123/si784-grupal2-api-testing/blob/main/tests/k6/carga.js" rel="noopener noreferrer"&gt;&lt;code&gt;tests/k6/carga.js&lt;/code&gt;&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>testing</category>
      <category>api</category>
      <category>postman</category>
      <category>githubactions</category>
    </item>
    <item>
      <title>Respaldo cifrado y restauración verificada para Azure Cosmos DB con GitHub Actions</title>
      <dc:creator>MILTON H FLORES CHINO</dc:creator>
      <pubDate>Sun, 15 Nov 2026 01:23:31 +0000</pubDate>
      <link>https://dev.to/milton_hfloreschino_123/respaldo-cifrado-y-restauracion-verificada-para-azure-cosmos-db-con-github-actions-g6b</link>
      <guid>https://dev.to/milton_hfloreschino_123/respaldo-cifrado-y-restauracion-verificada-para-azure-cosmos-db-con-github-actions-g6b</guid>
      <description>&lt;p&gt;&lt;em&gt;Actividad Grupal 02-U2: NoSQL Backup Strategy · Base de Datos II (SI-783) · Universidad Privada de Tacna&lt;/em&gt;&lt;br&gt;
&lt;em&gt;Autor: Milton H. Flores Chino · Equipo: Yerry Maycol Tarqui Collatupa y Milton H. Flores Chino&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Una copia de seguridad solo vale si se puede restaurar. Con esa idea armamos una estrategia de respaldo para una base NoSQL en &lt;strong&gt;Azure Cosmos DB&lt;/strong&gt;: una app de productos en ASP.NET Core, una herramienta propia (&lt;strong&gt;BackupTool&lt;/strong&gt;) que genera respaldos cifrados en &lt;strong&gt;Azure Blob Storage&lt;/strong&gt;, y flujos de &lt;strong&gt;GitHub Actions&lt;/strong&gt; que respaldan todos los días y restauran con verificación. Al final borramos todos los datos a propósito y los recuperamos.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repositorio público:&lt;/strong&gt; &lt;a href="https://github.com/Yerrytc/tg2-nosql-backup-yerrytc" rel="noopener noreferrer"&gt;https://github.com/Yerrytc/tg2-nosql-backup-yerrytc&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Aplicación publicada (Azure App Service):&lt;/strong&gt; &lt;a href="https://app-tg2-backup-yerrytc.azurewebsites.net" rel="noopener noreferrer"&gt;https://app-tg2-backup-yerrytc.azurewebsites.net&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ejecuciones de GitHub Actions:&lt;/strong&gt; &lt;a href="https://github.com/Yerrytc/tg2-nosql-backup-yerrytc/actions" rel="noopener noreferrer"&gt;https://github.com/Yerrytc/tg2-nosql-backup-yerrytc/actions&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Video (4 min 32 s):&lt;/strong&gt; &lt;a href="https://youtu.be/zM_CLWn9cGs" rel="noopener noreferrer"&gt;https://youtu.be/zM_CLWn9cGs&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/zM_CLWn9cGs" width="710" height="399"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;

&lt;h2&gt;
  
  
  Tres capas de protección
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Capa&lt;/th&gt;
&lt;th&gt;Cómo se implementa&lt;/th&gt;
&lt;th&gt;Qué cubre&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Respaldo nativo&lt;/td&gt;
&lt;td&gt;Cosmos DB con política &lt;code&gt;Periodic&lt;/code&gt;: cada 240 min, retención de 48 h (Terraform)&lt;/td&gt;
&lt;td&gt;Recuperación administrada por Azure&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Respaldo lógico propio&lt;/td&gt;
&lt;td&gt;BackupTool exporta los documentos, los comprime, los cifra y los sube a Blob Storage&lt;/td&gt;
&lt;td&gt;Copias bajo control del equipo, restaurables en otro contenedor&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Retención&lt;/td&gt;
&lt;td&gt;Política de ciclo de vida de Storage: borra respaldos con más de 30 días&lt;/td&gt;
&lt;td&gt;Evita acumular copias viejas&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;La segunda capa es la que construimos nosotros, y es la que explico en detalle.&lt;/p&gt;

&lt;h2&gt;
  
  
  El formato del respaldo
&lt;/h2&gt;

&lt;p&gt;BackupTool lee todos los documentos del contenedor &lt;code&gt;productos&lt;/code&gt;, les quita los metadatos internos de Cosmos DB (&lt;code&gt;_rid&lt;/code&gt;, &lt;code&gt;_self&lt;/code&gt;, &lt;code&gt;_etag&lt;/code&gt;, &lt;code&gt;_attachments&lt;/code&gt;, &lt;code&gt;_ts&lt;/code&gt;) y los guarda en un JSON con un &lt;strong&gt;manifiesto&lt;/strong&gt;: versión, fecha, base, contenedor y cantidad de documentos. Antes de comprimir calcula el &lt;strong&gt;SHA-256&lt;/strong&gt; de ese JSON, que sirve como huella para comparar al restaurar.&lt;/p&gt;

&lt;p&gt;Luego comprime con GZip y cifra con &lt;strong&gt;AES-256-GCM&lt;/strong&gt;. La clave no se guarda: se deriva de una frase secreta con &lt;strong&gt;PBKDF2-SHA256 (200 000 iteraciones)&lt;/strong&gt; y una sal aleatoria por archivo.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="kt"&gt;byte&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="nc"&gt;Cifrar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;byte&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="n"&gt;clave&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;sal&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;RandomNumberGenerator&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;GetBytes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;16&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;nonce&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;RandomNumberGenerator&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;GetBytes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;12&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Rfc2898DeriveBytes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Pbkdf2&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;clave&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sal&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;200000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;HashAlgorithmName&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;SHA256&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;32&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="kt"&gt;byte&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Length&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;tag&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="kt"&gt;byte&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;16&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;using&lt;/span&gt; &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;aes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;AesGcm&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;16&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="n"&gt;aes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Encrypt&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nonce&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;d&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;tag&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Encoding&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="no"&gt;ASCII&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;GetBytes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"TG2B"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Concat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sal&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Concat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;nonce&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Concat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tag&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Concat&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ToArray&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Así queda cada archivo &lt;code&gt;.json.gz.enc&lt;/code&gt;:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Bytes&lt;/th&gt;
&lt;th&gt;Contenido&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;0–3&lt;/td&gt;
&lt;td&gt;Firma &lt;code&gt;TG2B&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4–19&lt;/td&gt;
&lt;td&gt;Sal de PBKDF2&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;20–31&lt;/td&gt;
&lt;td&gt;Nonce de AES-GCM&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;32–47&lt;/td&gt;
&lt;td&gt;Etiqueta de autenticación&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;48 en adelante&lt;/td&gt;
&lt;td&gt;Datos comprimidos y cifrados&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;AES-GCM no solo oculta los datos: si alguien modifica un solo byte del archivo, el descifrado falla. Por eso un respaldo alterado nunca se restaura en silencio.&lt;/p&gt;

&lt;p&gt;El archivo se sube al contenedor &lt;strong&gt;privado&lt;/strong&gt; &lt;code&gt;backups&lt;/code&gt; con la cantidad de documentos y el SHA-256 como metadatos del blob.&lt;/p&gt;

&lt;h2&gt;
  
  
  Restaurar y verificar
&lt;/h2&gt;

&lt;p&gt;La restauración hace el camino inverso: descarga el respaldo indicado (o el más reciente), lo descifra, lo descomprime, recalcula el SHA-256 y escribe los documentos con &lt;code&gt;UpsertItemAsync&lt;/code&gt;. Al final cuenta los documentos del contenedor de destino y lo compara con el manifiesto:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;docs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Count&lt;/span&gt; &lt;span class="o"&gt;!=&lt;/span&gt; &lt;span class="n"&gt;esperado&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt; &lt;span class="n"&gt;esperado&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;throw&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;Exception&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"La verificacion fallo: se esperaban "&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;esperado&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="s2"&gt;" documentos"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="nc"&gt;Console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;WriteLine&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"VERIFICACION OK: "&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;esperado&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="s2"&gt;" documentos recuperados"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Si no coincide, el proceso termina con error y el flujo de GitHub Actions queda en rojo. Por defecto restaura en un contenedor nuevo (&lt;code&gt;productos_restaurado&lt;/code&gt;), así se puede revisar la copia sin tocar los datos en uso.&lt;/p&gt;

&lt;h2&gt;
  
  
  Automatización con GitHub Actions
&lt;/h2&gt;

&lt;p&gt;El repositorio tiene seis flujos: &lt;code&gt;ci&lt;/code&gt;, &lt;code&gt;infra&lt;/code&gt; (Terraform), &lt;code&gt;deploy&lt;/code&gt;, &lt;code&gt;backup&lt;/code&gt;, &lt;code&gt;restore&lt;/code&gt; y &lt;code&gt;desastre&lt;/code&gt;. El de respaldo corre solo todos los días:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;schedule&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;cron&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'17 10 * * *'&lt;/span&gt;   &lt;span class="c1"&gt;# 10:17 UTC = 5:17 a. m. en Perú
&lt;/span&gt;  &lt;span class="na"&gt;workflow_dispatch&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En cada ejecución inicia sesión en Azure, obtiene la llave de Cosmos DB y la cadena de conexión de Storage con la CLI, las &lt;strong&gt;enmascara&lt;/strong&gt; en los registros (&lt;code&gt;::add-mask::&lt;/code&gt;) y ejecuta BackupTool. La frase de cifrado es el secreto &lt;code&gt;BACKUP_PASSPHRASE&lt;/code&gt; del repositorio, así que ninguna llave está en el código.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcwh9pvc8keaf8utyyxls.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcwh9pvc8keaf8utyyxls.png" alt="Programación diaria del respaldo" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  La prueba: respaldar, destruir y recuperar
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;1. Datos iniciales.&lt;/strong&gt; La app publicada en Azure tenía 6 productos guardados en Cosmos DB.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo8um95qnnalxkmx7w5r0.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo8um95qnnalxkmx7w5r0.png" alt="Seis productos en la app" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;2. Respaldo.&lt;/strong&gt; &lt;code&gt;backup.yml&lt;/code&gt; terminó en 42 s: 6 documentos, archivo &lt;code&gt;productos-20261026-015040.json.gz.enc&lt;/code&gt; de 515 bytes y SHA-256 &lt;code&gt;a719492f…dfdac08&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd294xnwpmjb4vv0wx67a.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fd294xnwpmjb4vv0wx67a.png" alt="Registro del respaldo" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;El archivo cifrado quedó en el contenedor privado &lt;code&gt;backups&lt;/code&gt;:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F7ghgl7gh660f9lfk8myq.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F7ghgl7gh660f9lfk8myq.png" alt="Respaldo cifrado en Blob Storage" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Desastre simulado.&lt;/strong&gt; &lt;code&gt;desastre.yml&lt;/code&gt;, que solo corre si se escribe la confirmación &lt;code&gt;BORRAR&lt;/code&gt;, eliminó todos los productos. La app quedó vacía:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fvnjk0jk3mbyk7ygxb8hb.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fvnjk0jk3mbyk7ygxb8hb.png" alt="App sin datos" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;4. Recuperación.&lt;/strong&gt; &lt;code&gt;restore.yml&lt;/code&gt; con el último respaldo y destino &lt;code&gt;productos&lt;/code&gt; terminó en 40 s. El SHA-256 coincidió con el del respaldo original y la verificación pasó:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhcz4n00tinqkrgvhr76v.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhcz4n00tinqkrgvhr76v.png" alt="Registro de la restauración" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Los 6 productos volvieron a aparecer en la app:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5daip4nrvg0o02n81gze.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F5daip4nrvg0o02n81gze.png" alt="App restaurada" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Lo que aprendí
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Un respaldo sin prueba de restauración es una suposición.&lt;/strong&gt; La verificación por cantidad y SHA-256 convierte la recuperación en algo comprobable.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cifrar antes de subir&lt;/strong&gt; protege los datos aunque alguien acceda al contenedor, y AES-GCM además detecta archivos alterados.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dos vías de recuperación&lt;/strong&gt; (nativa de Azure y lógica propia) evitan depender de una sola.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automatizar con cron&lt;/strong&gt; quita el factor humano: el respaldo ocurre aunque nadie se acuerde.&lt;/li&gt;
&lt;li&gt;Todo funciona con &lt;strong&gt;Cosmos DB serverless, App Service F1 y una cuenta de Storage pequeña&lt;/strong&gt;, con costo mínimo.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Cumplimiento de la actividad
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Requisito&lt;/th&gt;
&lt;th&gt;Dónde&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Base NoSQL&lt;/td&gt;
&lt;td&gt;Azure Cosmos DB (API NoSQL)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Repositorio público&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/Yerrytc/tg2-nosql-backup-yerrytc" rel="noopener noreferrer"&gt;https://github.com/Yerrytc/tg2-nosql-backup-yerrytc&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Despliegue por automatización&lt;/td&gt;
&lt;td&gt;GitHub Actions + Terraform (&lt;code&gt;infra.yml&lt;/code&gt;, &lt;code&gt;deploy.yml&lt;/code&gt;, &lt;code&gt;backup.yml&lt;/code&gt;, &lt;code&gt;restore.yml&lt;/code&gt;)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nube pública&lt;/td&gt;
&lt;td&gt;Microsoft Azure: App Service, Cosmos DB y Blob Storage&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Video ≤ 5 min&lt;/td&gt;
&lt;td&gt;&lt;a href="https://youtu.be/zM_CLWn9cGs" rel="noopener noreferrer"&gt;https://youtu.be/zM_CLWn9cGs&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

</description>
      <category>azure</category>
      <category>nosql</category>
      <category>database</category>
      <category>githubactions</category>
    </item>
    <item>
      <title>Reproducir un error 500 en PHP con Nuclei y GitHub Actions</title>
      <dc:creator>MILTON H FLORES CHINO</dc:creator>
      <pubDate>Sun, 15 Nov 2026 00:54:47 +0000</pubDate>
      <link>https://dev.to/milton_hfloreschino_123/reproducir-un-error-500-en-php-con-nuclei-y-github-actions-1bnb</link>
      <guid>https://dev.to/milton_hfloreschino_123/reproducir-un-error-500-en-php-con-nuclei-y-github-actions-1bnb</guid>
      <description>&lt;p&gt;&lt;em&gt;Actividad Grupal 1 · Vulnerability Scanning Tools · Calidad y Pruebas de Software (SI-784) · Universidad Privada de Tacna&lt;/em&gt;&lt;br&gt;
&lt;em&gt;Autor: Milton H. Flores Chino · Equipo: Milton H. Flores Chino y Manuel Dongo Palza&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Abrigando Corazones es una aplicación PHP de una campaña solidaria en Tacna. En la actividad de Calidad y Pruebas de Software, revisamos qué ocurre cuando el enrutador recibe un valor con un tipo distinto del esperado. Usamos &lt;strong&gt;Nuclei&lt;/strong&gt; para convertir ese caso en una prueba repetible y llevarla al workflow del proyecto.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repositorio público:&lt;/strong&gt; &lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones" rel="noopener noreferrer"&gt;https://github.com/manuelandredp-gif/abrigando-corazones&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Aplicación pública:&lt;/strong&gt; &lt;a href="https://abrigandocorazones.site.je/impacto?i=1" rel="noopener noreferrer"&gt;https://abrigandocorazones.site.je/impacto?i=1&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Workflow de escaneo y despliegue:&lt;/strong&gt; &lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones/blob/main/.github/workflows/deploy-infinityfree.yml" rel="noopener noreferrer"&gt;deploy-infinityfree.yml&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;
  
  
  Preparar el entorno de prueba
&lt;/h2&gt;

&lt;p&gt;La última comprobación local se hizo el 14 de noviembre de 2026 con el commit &lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones/tree/4dffd5e464042d70598a7aed6cf1c61aaed641d0" rel="noopener noreferrer"&gt;&lt;code&gt;4dffd5e&lt;/code&gt;&lt;/a&gt;, PHP 8.4.27 y Nuclei 3.11.1. La copia se ejecutó en &lt;code&gt;127.0.0.1:8788&lt;/code&gt;, con correo y métricas desactivados. La web pública se usó como referencia del proyecto. Las peticiones de prueba se hicieron al servidor local.&lt;/p&gt;
&lt;h2&gt;
  
  
  Ejecutar el escaneo
&lt;/h2&gt;

&lt;p&gt;La plantilla de Nuclei compara dos peticiones HTTP. Primero verifica que la ruta normal funcione. Después envía el parámetro &lt;code&gt;url&lt;/code&gt; como arreglo. La coincidencia exige que ambas respuestas cumplan la condición &lt;code&gt;status_code_1 == 200 &amp;amp;&amp;amp; status_code_2 == 500&lt;/code&gt;.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Petición en el servidor local&lt;/th&gt;
&lt;th&gt;Resultado&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;GET /contacto&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;HTTP 200. Se cargó la página de contacto.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;GET /?url%5B%5D=contacto&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;HTTP 500. El parámetro &lt;code&gt;url&lt;/code&gt; llegó como arreglo.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Nuclei registró una coincidencia. En el log de PHP apareció un &lt;code&gt;TypeError&lt;/code&gt; en la línea 9 de &lt;code&gt;app/core/Router.php&lt;/code&gt;. El enrutador pasa el valor de &lt;code&gt;url&lt;/code&gt; directamente a &lt;code&gt;trim()&lt;/code&gt;, que espera una cadena:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="nv"&gt;$rawUrl&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;isset&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$_GET&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'url'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="nf"&gt;trim&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$_GET&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'url'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'/'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;''&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones/blob/4dffd5e464042d70598a7aed6cf1c61aaed641d0/app/core/Router.php#L7-L12" rel="noopener noreferrer"&gt;Ver la línea del enrutador revisada&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Clasificamos el hallazgo como &lt;strong&gt;bajo&lt;/strong&gt; en la plantilla porque la prueba demostró un error de servidor en esa petición, con alcance limitado al caso reproducido.&lt;/p&gt;

&lt;p&gt;La corrección propuesta es comprobar el tipo de &lt;code&gt;url&lt;/code&gt; antes de normalizarlo y devolver HTTP 400 al recibir un arreglo. La prueba de regresión debe mantener el 200 de la ruta válida y comprobar que desaparece el 500 en la entrada inválida.&lt;/p&gt;

&lt;h2&gt;
  
  
  Integrar Nuclei al flujo de publicación
&lt;/h2&gt;

&lt;p&gt;El &lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones/blob/main/.github/workflows/deploy-infinityfree.yml" rel="noopener noreferrer"&gt;workflow&lt;/a&gt; empaqueta el commit, excluye la configuración local y verifica la sintaxis de PHP. Luego levanta la copia del paquete, ejecuta Nuclei y guarda &lt;code&gt;resultados-nuclei.jsonl&lt;/code&gt; como artefacto de la ejecución. La preparación y el escaneo se verificaron localmente con 47 archivos PHP validados y un hallazgo reproducido.&lt;/p&gt;

&lt;p&gt;La etapa de publicación se activa manualmente desde GitHub Actions. Está configurada para transferir el paquete a InfinityFree por FTP con TLS y comprobar en el servidor un marcador con el commit. La &lt;a href="https://github.com/manuelandredp-gif/abrigando-corazones/actions/runs/43648336426" rel="noopener noreferrer"&gt;ejecución #2&lt;/a&gt; quedó bloqueada por facturación en GitHub antes de iniciar el trabajo. La web ya estaba disponible en InfinityFree y la subida automatizada queda pendiente.&lt;/p&gt;

&lt;h2&gt;
  
  
  Conclusión
&lt;/h2&gt;

&lt;p&gt;Lo más útil de la prueba fue poder relacionar una respuesta de la aplicación con una línea de código. La plantilla permite repetir esa comprobación cuando el equipo cambie el enrutador.&lt;/p&gt;

</description>
      <category>security</category>
      <category>testing</category>
      <category>php</category>
      <category>githubactions</category>
    </item>
    <item>
      <title>Construir y desplegar una app NoSQL con Azure Cosmos DB, Terraform y GitHub Actions</title>
      <dc:creator>MILTON H FLORES CHINO</dc:creator>
      <pubDate>Sat, 14 Nov 2026 23:00:06 +0000</pubDate>
      <link>https://dev.to/milton_hfloreschino_123/construir-y-desplegar-una-app-nosql-con-azure-cosmos-db-terraform-y-github-actions-42o</link>
      <guid>https://dev.to/milton_hfloreschino_123/construir-y-desplegar-una-app-nosql-con-azure-cosmos-db-terraform-y-github-actions-42o</guid>
      <description>&lt;p&gt;En el curso de &lt;strong&gt;Base de Datos II&lt;/strong&gt; (Universidad Privada de Tacna) nos pidieron construir y desplegar una aplicación con una base de datos NoSQL, &lt;strong&gt;sin usar Redis, MongoDB, Neo4j ni Prometheus&lt;/strong&gt;. Con mi compañero Yerry Tarqui elegimos &lt;strong&gt;Azure Cosmos DB (API NoSQL)&lt;/strong&gt;, una base de documentos JSON administrada, y armamos una app de tareas que se despliega sola en Azure cada vez que hacemos &lt;code&gt;push&lt;/code&gt;.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Repositorio público:&lt;/strong&gt; &lt;a href="https://github.com/Yerrytc/tg1-nosql-tareas-yerrytc" rel="noopener noreferrer"&gt;https://github.com/Yerrytc/tg1-nosql-tareas-yerrytc&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;App publicada:&lt;/strong&gt; &lt;a href="https://app-tg1-nosql-yerrytc.azurewebsites.net" rel="noopener noreferrer"&gt;https://app-tg1-nosql-yerrytc.azurewebsites.net&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Video (menos de 5 min):&lt;/strong&gt; &lt;a href="https://youtu.be/7J8stjhJkiA" rel="noopener noreferrer"&gt;https://youtu.be/7J8stjhJkiA&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/7J8stjhJkiA" width="710" height="399"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;

&lt;h2&gt;
  
  
  ¿Por qué Cosmos DB?
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Es &lt;strong&gt;NoSQL de documentos&lt;/strong&gt;: cada tarea se guarda como un JSON, sin esquema fijo.&lt;/li&gt;
&lt;li&gt;Tiene &lt;strong&gt;nivel gratuito&lt;/strong&gt; (1000 RU/s y 25 GB), suficiente para un proyecto académico.&lt;/li&gt;
&lt;li&gt;Se consulta con una sintaxis parecida a SQL (&lt;code&gt;SELECT * FROM c&lt;/code&gt;), así que la curva de aprendizaje es corta.&lt;/li&gt;
&lt;li&gt;Se crea completamente desde Terraform, lo que nos permitió automatizar todo.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Arquitectura
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Navegador -&amp;gt; Azure App Service (ASP.NET Core .NET 10) -&amp;gt; Azure Cosmos DB (API NoSQL)
                     ^
GitHub Actions: ci.yml (build + validate), infra.yml (Terraform), deploy.yml (dotnet publish)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Pieza&lt;/th&gt;
&lt;th&gt;Tecnología&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Backend y página web&lt;/td&gt;
&lt;td&gt;ASP.NET Core minimal API (.NET 10)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Base de datos&lt;/td&gt;
&lt;td&gt;Azure Cosmos DB, base &lt;code&gt;tareasdb&lt;/code&gt;, contenedor &lt;code&gt;tareas&lt;/code&gt;, partición &lt;code&gt;/id&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Infraestructura como código&lt;/td&gt;
&lt;td&gt;Terraform (&lt;code&gt;azurerm&lt;/code&gt; 4.x) con estado remoto en Azure Storage&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Automatización&lt;/td&gt;
&lt;td&gt;GitHub Actions&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nube pública&lt;/td&gt;
&lt;td&gt;Azure App Service (plan F1 gratuito)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  1. El modelo de datos
&lt;/h2&gt;

&lt;p&gt;Un documento es una tarea. Cosmos DB necesita un &lt;code&gt;id&lt;/code&gt; y una clave de partición; usamos el mismo &lt;code&gt;id&lt;/code&gt; como partición porque cada tarea se lee y se escribe de forma independiente.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Tarea&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;Id&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Guid&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;NewGuid&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ToString&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nc"&gt;Titulo&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;bool&lt;/span&gt; &lt;span class="nc"&gt;Hecha&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt; &lt;span class="nc"&gt;Fecha&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;get&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;set&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;DateTime&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;UtcNow&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En Cosmos DB queda así:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"3f2c..."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"titulo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Desplegar con GitHub Actions"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"hecha"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"fecha"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"2026-11-13T..."&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  2. Conexión con el SDK de Cosmos DB
&lt;/h2&gt;

&lt;p&gt;Instalamos el paquete &lt;code&gt;Microsoft.Azure.Cosmos&lt;/code&gt; y, al arrancar, la app crea la base y el contenedor si no existen. El endpoint y la llave llegan por variables de entorno (&lt;code&gt;Cosmos__Endpoint&lt;/code&gt;, &lt;code&gt;Cosmos__Key&lt;/code&gt;), nunca están en el código.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;cfg&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Configuration&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;GetSection&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"Cosmos"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;cli&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;CosmosClient&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;cfg&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"Endpoint"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;cfg&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"Key"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;opt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;db&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;cli&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;CreateDatabaseIfNotExistsAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;cfg&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"Database"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="s2"&gt;"tareasdb"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Database&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;con&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;CreateContainerIfNotExistsAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;cfg&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"Container"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="s2"&gt;"tareas"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"/id"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Container&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El repositorio usa las operaciones nativas de Cosmos DB:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight csharp"&gt;&lt;code&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="kt"&gt;List&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;Listar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;q&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;GetItemQueryIterator&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"SELECT * FROM c ORDER BY c.fecha DESC"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="kd"&gt;var&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="kt"&gt;List&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;while&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;q&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;HasMoreResults&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;AddRange&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;q&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;ReadNextAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;async&lt;/span&gt; &lt;span class="nc"&gt;Task&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;Crear&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Tarea&lt;/span&gt; &lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt;
    &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;CreateItemAsync&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;PartitionKey&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;Resource&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  3. La API
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Método&lt;/th&gt;
&lt;th&gt;Ruta&lt;/th&gt;
&lt;th&gt;Qué hace&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/health&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;estado y cantidad de tareas&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;GET&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/api/tareas&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;lista las tareas&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;POST&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/api/tareas&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;crea &lt;code&gt;{ "titulo": "..." }&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;PUT&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/api/tareas/{id}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;actualiza título o estado&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;DELETE&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/api/tareas/{id}&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;elimina&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;La página &lt;code&gt;wwwroot/index.html&lt;/code&gt; consume esa API para agregar, marcar y eliminar tareas.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzjwj83j0fqoqk9o9amzy.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzjwj83j0fqoqk9o9amzy.png" alt="App local" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  4. Infraestructura como código con Terraform
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;infra/main.tf&lt;/code&gt; crea todo lo necesario en Azure:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"azurerm_cosmosdb_account"&lt;/span&gt; &lt;span class="s2"&gt;"db"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt;              &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"cosmos-tg1-yerrytc"&lt;/span&gt;
  &lt;span class="n"&gt;offer_type&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Standard"&lt;/span&gt;
  &lt;span class="n"&gt;kind&lt;/span&gt;              &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"GlobalDocumentDB"&lt;/span&gt;
  &lt;span class="n"&gt;free_tier_enabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
  &lt;span class="n"&gt;consistency_policy&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;consistency_level&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"Session"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="c1"&gt;# ...&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"azurerm_cosmosdb_sql_container"&lt;/span&gt; &lt;span class="s2"&gt;"tareas"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt;                &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tareas"&lt;/span&gt;
  &lt;span class="n"&gt;database_name&lt;/span&gt;       &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;azurerm_cosmosdb_sql_database&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;tareas&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;
  &lt;span class="n"&gt;partition_key_paths&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"/id"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="c1"&gt;# ...&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"azurerm_linux_web_app"&lt;/span&gt; &lt;span class="s2"&gt;"app"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"app-tg1-nosql-yerrytc"&lt;/span&gt;
  &lt;span class="n"&gt;site_config&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;application_stack&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;dotnet_version&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10.0"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="n"&gt;app_settings&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;Cosmos__Endpoint&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;azurerm_cosmosdb_account&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;endpoint&lt;/span&gt;
    &lt;span class="nc"&gt;Cosmos__Key&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;azurerm_cosmosdb_account&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;db&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;primary_key&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Lo interesante es que &lt;strong&gt;Terraform pasa la llave de Cosmos DB directamente a la configuración de la Web App&lt;/strong&gt;, así que nadie tiene que copiarla a mano.&lt;/p&gt;

&lt;h2&gt;
  
  
  5. Despliegue automatizado con GitHub Actions
&lt;/h2&gt;

&lt;p&gt;Tenemos tres flujos:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;ci.yml&lt;/code&gt;&lt;/strong&gt;: en cada push compila el proyecto y ejecuta &lt;code&gt;terraform validate&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;infra.yml&lt;/code&gt;&lt;/strong&gt;: cuando cambia &lt;code&gt;infra/&lt;/code&gt;, ejecuta &lt;code&gt;terraform init&lt;/code&gt; y &lt;code&gt;terraform apply&lt;/code&gt; con un service principal guardado en los secretos del repositorio.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;deploy.yml&lt;/code&gt;&lt;/strong&gt;: cuando cambia &lt;code&gt;src/&lt;/code&gt;, publica la app y comprueba que responde.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;dotnet publish src/TareasApi/TareasApi.csproj -c Release -o publicar&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;azure/login@v2&lt;/span&gt;
  &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;creds&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.AZURE_CREDENTIALS }}&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;azure/webapps-deploy@v3&lt;/span&gt;
  &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;app-name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;app-tg1-nosql-yerrytc&lt;/span&gt;
    &lt;span class="na"&gt;package&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;publicar&lt;/span&gt;
&lt;span class="p"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s"&gt;probar la aplicacion publicada&lt;/span&gt;
  &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt;
    &lt;span class="s"&gt;for i in 1 2 3 4 5 6 7 8 9 10; do&lt;/span&gt;
      &lt;span class="s"&gt;if curl -fs https://app-tg1-nosql-yerrytc.azurewebsites.net/health; then exit 0; fi&lt;/span&gt;
      &lt;span class="s"&gt;sleep 15&lt;/span&gt;
    &lt;span class="s"&gt;done&lt;/span&gt;
    &lt;span class="s"&gt;exit 1&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;El último paso es un &lt;em&gt;smoke test&lt;/em&gt;: si &lt;code&gt;/health&lt;/code&gt; no responde, el flujo falla y nos enteramos al instante.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhl7ywwsrcgy959u0rnx1.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhl7ywwsrcgy959u0rnx1.png" alt="Despliegue exitoso" width="799" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  6. Resultado en la nube
&lt;/h2&gt;

&lt;p&gt;Los recursos quedan en un solo grupo de recursos de Azure, y desde el Data Explorer se ven los documentos JSON que guarda la app:&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftk1tkbclilzv5qj8q73f.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftk1tkbclilzv5qj8q73f.png" alt="Documentos en Cosmos DB" width="799" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;La app pública funciona en &lt;a href="https://app-tg1-nosql-yerrytc.azurewebsites.net" rel="noopener noreferrer"&gt;https://app-tg1-nosql-yerrytc.azurewebsites.net&lt;/a&gt; y &lt;code&gt;/health&lt;/code&gt; responde:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"estado"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"ok"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"base_datos"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Azure Cosmos DB"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"tareas"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;4&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftkdh0urlg5hkjjm5iwkj.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ftkdh0urlg5hkjjm5iwkj.png" alt="App publicada" width="800" height="513"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Lo que aprendimos
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Elegir bien la clave de partición&lt;/strong&gt; es la decisión de diseño más importante en Cosmos DB. Para una app de tareas, &lt;code&gt;/id&lt;/code&gt; reparte la carga de forma uniforme.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Los secretos no van en el código&lt;/strong&gt;: Terraform los entrega a App Service como configuración y GitHub los guarda como secretos cifrados.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Automatizar desde el principio&lt;/strong&gt; ahorra tiempo: después del primer &lt;code&gt;terraform apply&lt;/code&gt;, cada cambio llega a producción con un simple &lt;code&gt;git push&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;El plan &lt;strong&gt;F1 gratuito&lt;/strong&gt; se "duerme" tras un rato sin uso, por eso la primera petición puede tardar unos segundos.&lt;/li&gt;
&lt;/ol&gt;

&lt;h2&gt;
  
  
  Cumplimiento de la actividad
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Requisito&lt;/th&gt;
&lt;th&gt;Dónde&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Repositorio público&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/Yerrytc/tg1-nosql-tareas-yerrytc" rel="noopener noreferrer"&gt;https://github.com/Yerrytc/tg1-nosql-tareas-yerrytc&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Despliegue por automatización&lt;/td&gt;
&lt;td&gt;GitHub Actions (&lt;code&gt;ci.yml&lt;/code&gt;, &lt;code&gt;infra.yml&lt;/code&gt;, &lt;code&gt;deploy.yml&lt;/code&gt;) + Terraform&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Nube pública&lt;/td&gt;
&lt;td&gt;Microsoft Azure (App Service + Cosmos DB)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Video ≤ 5 min&lt;/td&gt;
&lt;td&gt;&lt;a href="https://youtu.be/7J8stjhJkiA" rel="noopener noreferrer"&gt;https://youtu.be/7J8stjhJkiA&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;BD NoSQL sin Redis/MongoDB/Neo4j/Prometheus&lt;/td&gt;
&lt;td&gt;Azure Cosmos DB (API NoSQL)&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;&lt;strong&gt;Equipo:&lt;/strong&gt; Yerry Maycol Tarqui Collatupa y Milton H. Flores Chino — Base de Datos II, Escuela Profesional de Ingeniería de Sistemas, Universidad Privada de Tacna.&lt;/p&gt;

</description>
      <category>azure</category>
      <category>nosql</category>
      <category>terraform</category>
      <category>githubactions</category>
    </item>
  </channel>
</rss>
