Configurar el multi-entorno en las vistas de datos

Configurar el multi-entorno en las vistas de datos

Resumen

La plataforma permite configurar múltiples entornos para los métodos de las APIs. La configuración del multi-entorno se realiza a nivel de la vista de datos: en ella se seleccionan los orígenes de datos que corresponden a cada entorno, y la ejecución de uno u otro depende del dominio por el que se invoca el método. Por ejemplo, puede seleccionar un origen desde archivo CSV para el entorno de desarrollo, un servicio web de pruebas para el entorno de staging y el servicio web productivo para producción. En este video ve dónde se definen los dominios de la cuenta, cómo asignar un origen por entorno en la vista, cómo publicar la versión de la API en un entorno y cómo la misma ruta responde distinto según el dominio.

Antes de comenzar

  • Cree previamente los orígenes de datos que usará en cada entorno de ejecución. Puede repetir un mismo origen en varios entornos.
  • Los dominios por entorno se configuran en Configuraciones › Dominios. Para dominios propios, los registros CNAME deben apuntar a la plataforma antes de guardarlos.

Dominios de la cuenta

En Configuraciones › Dominios se definen el dominio del portal para desarrolladores, el de WebSocket, el del gateway SOAP y el subdominio de producción. Debajo, la tabla Dominios de las APIs lista un dominio por entorno, cada uno con su nombre, su tipo (Development, Staging, Production) y el subdominio asignado. Con Agregar dominio se suma un entorno nuevo.

Configurar la vista por entorno

Cree una vista a partir de cualquiera de los orígenes y, en el paso Entorno del asistente, elija cómo proceder:

  • Usar el mismo origen de datos para todos los entornos: la vista ejecuta siempre el origen con el que la creó.
  • Usar diferentes orígenes de datos por tipo de entorno: se muestra una fila por entorno (dev, staging, prod, preview) para elegir el origen de cada uno.

Guarde y publique la vista. Siempre podrá editarla y modificar el origen que corresponde a cada entorno. Una vez publicada, en la ficha de la vista puede ejecutarla en cada entorno haciendo clic en los entornos debajo del título Entorno; al hacerlo se ejecuta el origen correspondiente.

Publicar la versión de la API en un entorno

En la ficha de la API, la pestaña Dominios de la versión lista los dominios de la cuenta con una casilla Activo por entorno. Marque los entornos en los que debe estar disponible la versión y guarde. Luego cree el método sobre la vista configurada y publique la versión.

Resultado esperado

Una vez publicado el método, puede ejecutarlo en los diferentes entornos mediante el dominio definido para cada uno. En el video, la misma ruta devuelve las ventas de producción cuando se llama por el dominio de producción y las ventas de prueba cuando se llama por el dominio de desarrollo.

Errores frecuentes

  • El dominio de desarrollo responde que el método no existe: la versión de la API no está activa en ese entorno. Revise la pestaña Dominios y vuelva a publicar.
  • Todos los entornos devuelven los mismos datos: la vista usa el mismo origen para todos. Edítela y elija Usar diferentes orígenes de datos por tipo de entorno.
  • Falta un origen en el paso Entorno: todos los entornos de la cuenta requieren un origen; puede repetir el de producción en los que no use.

Artículos relacionados