Exportar e importar replays

Un buen conjunto de grabaciones es trabajo que vale la pena conservar: los fixtures contra los que corre una suite de tests, las respuestas capturadas de un backend difícil de alcanzar, los payloads afinados a mano de una demo. Exportar empaqueta los replays de un servicio en un archivo; importar descomprime ese archivo dentro de cualquier servicio, en cualquier simulación.

Qué contiene el archivo

Un solo documento JSON, mockzilla.replays/v1, comprimido con gzip al exportar. Lleva las dos mitades de la configuración de replay de un servicio:

• los ajustes de replay del servicio: encendido o apagado, TTL, replay automático, solo upstream,
• cada endpoint exportado con su clave de coincidencia,
• las grabaciones, con estado, tipo de contenido y el cuerpo de la respuesta en base64.

{
  "format": "mockzilla.replays/v1",
  "replay": {
    "enabled": true,
    "duration": "24h",
    "endpoints": {
      "/pets/{petId}": {
        "GET": {
          "match": { "path": ["petId"], "query": [], "body": [] },
          "recordings": [
            {
              "match": { "path:petId": "42" },
              "source": "manual",
              "status": 200,
              "contentType": "application/json",
              "body": "eyJpZCI6NDIsIm5hbWUiOiJSZXgifQ=="
            }
          ]
        }
      }
    }
  }
}

El documento no nombra ninguna simulación ni ningún servicio: se importa al servicio al que lo apuntes. Descarga un archivo de ejemplo, en el diálogo de importación, te da uno chico y válido para empezar.

Exportar

En Replays, elige el servicio, marca los endpoints que quieres llevar y haz clic en Exportar en la barra que aparece. El número de al lado es la cantidad de grabaciones que lleva la selección.

La descarga se llama <servicio>-replays.json.gz. Entran hasta 500 grabaciones en una exportación; con acceso de lectura alcanza para hacer una.

Importar

Haz clic en Importar sobre los ajustes, y después suelta el archivo, búscalo, o pega una URL. Funcionan .json y .json.gz, hasta 10 MB.

• Omitir si hay conflicto decide qué pasa cuando el destino ya tiene una grabación bajo el mismo endpoint y los mismos valores de coincidencia: conservar la que ya está (lo que viene por defecto) o pisarla con la importada.
• Al terminar, el diálogo informa cuántas grabaciones se importaron y cuántas se omitieron.

Una importación trae la configuración con ella: las claves de coincidencia y los ajustes del servicio del archivo aterrizan en la simulación junto con las grabaciones. Como en todo Replays, las grabaciones se sirven al instante, mientras que la configuración viaja con el próximo despliegue. Importar cambia la simulación, así que hace falta el rol de editor.

Mover replays de un lado a otro

Como el archivo no depende del servicio, la misma exportación siembra muchos lugares:

• La simulación de alguien del equipo: exportas desde la tuya, esa persona importa en la suya, y las dos corren contra fixtures idénticos.
• Una simulación nueva: recreas una sim, importas, y las grabaciones y las claves de coincidencia vuelven sin reproducir nada de tráfico.
• Un conjunto canónico compartido: guarda el archivo exportado donde tu equipo guarda archivos, una wiki, un bucket o un repo, y deja que cada quien lo importe desde la URL. Actualizar el archivo actualiza lo que trae la próxima importación.

Consulta Grabar y ver replays para saber cómo se hacen y se comparan las grabaciones en primer lugar.