Ir al contenido

Esta página es una traducción automática de la página en inglés, que es la versión de referencia. Leer la página en inglés

Visión general de un servidor de mycroblog

La primera página que conviene leer antes de poner en marcha un servidor. mycroblog es un microblog que federa con el resto del fediverso mediante ActivityPub; my es su software de servidor, un único binario que contiene el servidor, el procesador de trabajos, el cliente web y los comandos que se ocupan de ellos. Esta página muestra de qué se compone un servidor, qué eliges mediante la configuración, cómo un servidor pequeño crece hasta uno grande y qué leer a continuación.

La arquitectura de un servidor de mycroblog: los clientes llegan a los procesos my por HTTPS; los procesos usan las partes elegidas por configuración y los servicios externos al servidor que activas. Las secciones de abajo describen cada parte.

De arriba abajo en el diagrama:

  • Quién se conecta. Las personas usan el cliente web en su navegador (puede instalarse como aplicación), las aplicaciones y los bots usan la API de cliente, y otros servidores del fediverso entregan y obtienen publicaciones por ActivityPub. Todos llegan al servidor por HTTPS.
  • Delante del servidor. Por defecto my habla HTTP sin cifrar, así que un proxy inverso o un balanceador de carga termina HTTPS delante de él. En una sola máquina, my puede servir HTTPS por sí mismo en su lugar (servir HTTPS desde el servidor). Una CDN delante de los archivos multimedia es opcional.
  • Los procesos my. Cada proceso ejecuta my serve, y su role dice lo que ejecuta: web el servidor HTTP, worker el worker de jobs, que entrega publicaciones, obtiene de otros servidores, envía correo, procesa multimedia y ejecuta los jobs periódicos, y all, el valor predeterminado, ambos en un solo proceso.
  • Las partes que eliges. Cada parte en el centro del diagrama tiene un ajuste que elige su adaptador, enumerado en la sección siguiente.
  • Servicios externos al servidor. El CAPTCHA, el chat de voz, los pagos, los plugins y la importación de costes de la nube permanecen desactivados hasta que los configuras, y el servidor llama entonces al servicio que nombras.

Cada parte es un ajuste de la referencia de configuración, definido en un archivo TOML o como variable de entorno (MY_ y la clave en mayúsculas, como MY_DATABASE). La primera opción de cada lista es el valor predeterminado. Donde una parte guarda datos, elígela antes del primer arranque: los datos no se mueven solos cuando cambia el ajuste.

Parte Ajuste Opciones Sigue leyendo
Base de datos database sqlite (un archivo), postgres (PostgreSQL y servicios compatibles) Base de datos, copia de seguridad
Cola de jobs queue db (una tabla en la base de datos), inline (ejecuta cada job de inmediato en el mismo proceso, para pruebas y desarrollo), cloudtasks (Google Cloud Tasks despierta al servidor para cada job; necesita PostgreSQL) La cola de jobs
Almacén clave-valor, para cachés, límites de tasa y las respuestas guardadas durante un día para escrituras reenviadas kv db (una tabla en la base de datos), memory (cada proceso por su cuenta), valkey (Valkey u otro servidor con protocolo Redis, compartido por todos los procesos) kv
Almacenamiento de multimedia blob fs (un directorio), s3 (Amazon S3, Cloudflare R2, MinIO, Garage y otros almacenes compatibles con S3), gcs (Google Cloud Storage) Archivos de Docker Compose, copia de seguridad de la multimedia
Procesamiento de multimedia media_image, media_video, media_audio, uno para cada tipo de archivo native (en el servidor), plugin (un plugin tuyo convierte los archivos de ese tipo) Convertir multimedia
Stream en tiempo real entre procesos stream hub (dentro de un proceso), postgres (LISTEN / NOTIFY), valkey, sns (Amazon SNS y SQS), pubsub (Google Cloud Pub/Sub) stream
Gestor de claves, que cifra las claves privadas de las cuentas key_manager local (una clave de cifrado de claves que guardas tú), gcpkms (Google Cloud KMS), awskms (AWS KMS), plugin Gestionar la clave
Correo mail none, smtp, ses (Amazon SES), plugin Enviar correo
CAPTCHA captcha none, turnstile (Cloudflare Turnstile), hcaptcha, recaptcha (Google reCAPTCHA v2) CAPTCHA
Chat de voz voice off, p2p (de navegador a navegador, con TURN de voice_turn: none, coturn o cloudflare), livekit, sora Chat de voz
Pagos de mecenas payments none, stripe, payjp (PAY.JP) Mecenas, Stripe, PAY.JP
Plugins plugin_<kind>_address ninguno por defecto; una dirección para cada tipo: translator, search, billing, mailer, media_image, media_video, media_audio, key_manager y los hooks de decisión inbound.status, local.status, inbound.follow, signup.check, media.check, inbound.actor, local.profile Plugins, hooks de decisión
Traducción de publicaciones translator_<provider>_*, plugin_translator_address ninguno (solo la traducción del propio navegador); libretranslate, deepl, google (Google Cloud Translation), aws (Amazon Translate) o un plugin tuyo delante del servicio que elijas Traducir publicaciones, un plugin traductor
Búsqueda de texto completo de publicaciones search none; o elasticsearch, opensearch o meilisearch (motores de búsqueda); o plugin, un plugin tuyo delante de otro motor Búsqueda de texto completo, un plugin de búsqueda
CDN para multimedia media_origin sin definir (el servidor sirve la multimedia desde su propio origen), o el origen de tu CDN Servir multimedia mediante una CDN
Costes de la nube billing_sources ninguno, o cualquiera de aws (AWS Cost Explorer), gcp (la exportación de facturación o el presupuesto de Google Cloud), cloudflare (los cargos de uso de Cloudflare), plugin Importar los costes de la nube
Métricas metrics_exporter none, prometheus, otlp (OpenTelemetry), emf (CloudWatch) Métricas, alertas
Trazas traces_exporter none, otlp Trazas
Informes de errores errors_exporter none (solo la línea de registro y los grupos de errores), sentry (Sentry, GlitchTip, Datadog), otlp Informe de errores

El binario publicado y la imagen de contenedor contienen todos los adaptadores de la tabla.

my config check informa de todos los problemas de la configuración a la vez, antes de que inicies el servidor (lista de comprobación de producción).

Tres pasos de un servidor pequeño a uno grande: un proceso con SQLite y el sistema de archivos, luego PostgreSQL y almacenamiento de objetos detrás de una CDN, y luego procesos web y worker separados con un broker de streams. La lista de abajo describe cada paso.

  1. Empieza pequeño. Un proceso con role = all, con SQLite, con la multimedia en el sistema de archivos y los valores predeterminados para el resto: la cola y el almacén clave-valor en la base de datos, y el stream en tiempo real dentro del proceso. Los archivos de Docker Compose de deploy/docker inician esta configuración en una máquina (desplegar con Docker Compose). Sirve para un servidor personal o pequeño. stream = hub llega solo al proceso en el que se ejecuta, así que esta configuración se queda en un proceso.
  2. Saca los datos. PostgreSQL para la base de datos, un bucket compatible con S3 o Google Cloud Storage para la multimedia, y una CDN delante de la multimedia. El servidor sigue siendo un proceso, pero ya no depende de un disco, y los procesos del paso siguiente pueden compartir los datos. Decide esto antes del primer arranque si puedes: mover los datos desde SQLite y el sistema de archivos después es un trabajo aparte (qué copiar enumera lo que hay que mover).
  3. Escala horizontalmente. Ejecuta procesos con role = web para las solicitudes y role = worker para los jobs, tantos como necesite cada uno, y divide los workers por tipo de job (dividir los workers). Con más de un proceso, el stream en tiempo real necesita un broker que llegue a todos los procesos (postgres, valkey, sns o pubsub), y el almacén clave-valor debería compartirse (db o valkey), ya que memory mantiene separados los límites de tasa y las respuestas a escrituras reenviadas de cada proceso. La cola de jobs permanece en PostgreSQL, o pasa a Google Cloud Tasks (Cloud Tasks).

El despliegue en Cloud Run es un ejemplo de una configuración entre el segundo y el tercer paso: role = all en Cloud Run, PostgreSQL en Neon, multimedia en Cloud Storage, Cloud Tasks para los jobs y Pub/Sub para el stream, sin ninguna instancia en ejecución mientras nadie usa el servidor.

Lee las guías para operadores en este orden:

  1. Primeros pasos: ejecuta el servidor o despliégalo en Cloud Run, y repasa después la lista de comprobación para producción antes de abrirlo a los usuarios.
  2. Configura la instancia: sus configuraciones, el registro, los proveedores de inicio de sesión externos, el correo electrónico, CAPTCHA, la CDN, las vistas previas de enlaces y los motores de búsqueda y rastreadores de IA.
  3. Activa funciones: la moderación, los relés, los webhooks, los complementos y los ganchos de decisión, el chat de voz, la búsqueda de texto completo, los mecenas y sus pagos, y la importación de costos de la nube.
  4. Mantenlo en el día a día: la monitorización, las alertas, los informes de errores, el mantenimiento, la copia de seguridad, la base de datos, la clave de cifrado de claves y los administradores y roles.
  5. Aspectos legales y cierre: las plantillas de política de privacidad y de registro de tratamiento, y cerrar el servicio.

La referencia de configuración enumera todos las configuraciones, y la referencia de trabajos todos los trabajos que ejecutan los procesos de trabajo.

Para LLM y agentes de programación:llms.txt,llms-full.txt, llms-small.txt

Analítica de este sitio