RESTBase está en proceso de quedar obsoleto. See RESTBase/deprecation for details.

RESTBase es un proxy de caché/almacenamiento que respalda a la API REST de Wikimedia . Su configuración está basada en especificaciones de Swagger, y su backend primario de almacenamiento utiliza Cassandra. Potencia rest_v1, la API REST de contenido de Wikimedia utilizada por el Editor visual para recuperar el HTML de las páginas para su edición. Por motivos de rendimiento (T95229), también se dispone de puntos de acceso de servicio en cada wiki, p. ej., en este wiki.

Como proxy, RESTBase no realiza por sí mismo ningún procesamiento significativo de contenido. En cambio, solicita transformaciones de contenido de servicios de backend cuando sea necesario, y generalmente (dependiendo de la configuración) las almacena para que su recuperación posterior. Para puntos de acceso estáticos de gran volumen, la mayoría de las peticiones se atenderán directamente desde el almacenamiento.

Sus backends de almacenamiento exponen una API de almacenamiento RESTful similar a Amazon DynamoDB y Google DataStore. La implementación primaria utiliza Apache Cassandra. Algunas características notables son índices secundatios mantenidos automáticamente y algún soporte ligero de transacciones. Se ha desarrollado un backend SQLite y es el backend predeterminado en el paquete.

RESTBase emite automáticamente métricas statsd de todas las peticiones de almacenamiento y del backend. Esto proporciona un buen nivel base de rendimiento e instrumentación de errores en una arquitectura de microservicios.

Casos de uso

Nuestro primer caso de uso es acelerar el Editor Visual reduciendo el tamaño del HTML y eliminar las fallas de caché Varnish. RESTBase almacena los metadatos de Parsoid de forma separada del HTML de la página, lo que reduce el tamaño de este último en alrededor del 40%. RESTBase solo proporciona este HTML al Editor Visual, lo que reduce significativamente la latencia de transferencia por la red y de procesamiento. A más largo plazo, nuestro objetivo es reducir el tamaño del HTML al de la salida del analizador actual PHP para adecuarlo a las visitas regulares de páginas. Esto tiene el potencial de pasar a la edición visual de forma instantánea y libre de cualquier desplazamiento.

Si el tiempo de análisis no es una preocupación urgente para tu wiki (por ejemplo, no tiene plantillas complejas ni un gran número de transclusiones), entonces acceder directamente a Parsoid puede tener más sentido que introducir una dependencia en RESTBase.

Otro caso de uso que nos interesa particularmente es proporcionar una API de edición a nivel de sección para las microcontribuciones y guardados extremadamente rápidos del Editor Visual, aún más rápidos que en el caso del wikitexto.

Documentación

• Consulta los puntos de acceso de la API
• Visión general
• Arquitectura
• Consulta la documentación
• Proceso de despliegue
• Lista de usuarios actuales

Instalación

• RESTBase/Installation

Véase también

• Consulta el código fuente
• Sigue las discusiones sobre la arquitectura de RESTBase uniéndote y consultando el proyecto RESTBase-architecture
• Informa de incidentes en Phabricator, proyecto 'RESTBase'
• RESTBase/Alternative architectural options considered
• RESTBase/Table storage backend options
• Solicitudes de comentarios originales: Storage service (talk) y Content API (talk)

Referencias