Despliegue código en seis lenguajes, sobre un runtime que controla la caja.

Métricas clave

Los números que dimensionan la integración.

89 interfaces tipadas servicios en 16 paquetes de tipos compartidos

180 funciones de la plataforma superficies de servicio declaradas en el OS

10 s hot-swap micro service Rust, desde fin de compilación hasta primera llamada en dispositivo

<5% sobrecarga del contenedor CPU/RAM; ~10 MB RSS. Sobre de presupuesto del contenedor MCM.

Instalación

Añada el SDK con un comando.

Dos librerías cliente de referencia cubren Rust y Python. Otros lenguajes alcanzan los servicios MOS4 a través del puente MQTT — sin SDK específico del lenguaje requerido.

cargo add mos-sdk-client

pip install mos-sdk-client

Lua, Go, C y C++ alcanzan la misma superficie de servicios a través del puente MQTT en proceso — ver la documentación de quickstart para ejemplos por lenguaje.

Puente MQTT

Cualquier cliente. Cualquier lenguaje. Sin SDK Munic.

MOS4 embebe un broker MQTT en proceso. Los payloads se aceptan como JSON plano o como el formato binario tipado; el JSON se transcodifica en la entrada. Un catálogo de servicios retenido permite a los clientes descubrir los servicios disponibles en el momento de la conexión.

sequenceDiagram
  participant Py as Contenedor Python<br/>(paho-mqtt)
  participant MQ as Broker MQTT<br/>(en proceso)
  participant Svc as Servicio MSP
  Py->>MQ: PUBLISH mos/rpc/MspService/LoadGraph<br/>payload JSON o tipado
  Note over MQ: transcodificar JSON a llamada tipada en la entrada
  MQ->>Svc: llamada tipada LoadGraph(graph)
  Svc-->>MQ: respuesta
  MQ-->>Py: PUBLISH mos/rpc/MspService/LoadGraph/reply
  Note over Py,MQ: cualquier librería cliente MQTT, cualquier lenguaje — sin SDK Munic requerido

import json
import paho.mqtt.client as mqtt

client = mqtt.Client()
client.connect("localhost", 1883)

# Publicar a cualquier interfaz de micro service a través del puente MQTT
client.publish(
    "mos/rpc/MspService/LoadGraph",
    payload=json.dumps(graph_json),
)

Autoría de micro service Rust

Una anotación. Treinta líneas.

Los desarrolladores Rust que escriben un micro service nativo anotan un struct con #[component] y añaden una llamada build.rs. El framework genera el despacho de servicio, la creación de proxy, el cableado de ciclo de vida, los accesores de configuración, la instrumentación de observabilidad y un fake para pruebas unitarias.

use mos_sdk::component;

#[component]
pub struct MyService {
    config: MyConfig,
}

#[async_trait::async_trait]
impl provided::my::MyServiceServer for MyService {
    async fn do_thing(&self, req: Request) -> Result<Response> {
        // su lógica — observabilidad y ciclo de vida son cableados por el framework
        Ok(Response { ok: true })
    }
}

// build.rs — una sola llamada genera el trait de servidor, proxy, fake, métricas
fn main() {
    build_api::generate_component_code(env!("CARGO_MANIFEST_DIR"), "src");
}

Los fakes generados compilan sin un daemon MOS4 en ejecución — las pruebas unitarias se ejecutan en cualquier host.

Consola

Un binario. Shell, REST, web, serial.

Flujos impulsados desde la nube

Llame a cualquier micro service desde la nube a través del puente RPC.

El puente RPC enruta las llamadas JSON de clientes externos a cualquier servicio MOS4 registrado — incluidos los contenedores. method ListServices() expone el catálogo en vivo en tiempo de ejecución. Casos de uso: depuración remota, desbloqueo de situaciones de campo poco frecuentes y flujos híbridos donde un agente AI o un servicio en la nube impulsa el dispositivo. Ver Micro services para superficies del lado de la nube y patrones de integración.

El puerto RPC interno no está expuesto por defecto. El acceso externo se realiza a través del puente MQTT o el puente RPC — sin exposición directa de puerto para herramientas.

Lo que usted aporta vs lo que aportamos

División honesta.

Preguntas frecuentes

Preguntas habituales

• ¿Qué lenguajes incluyen imágenes base preconstruidas?

  Python, Rust, C, C++, Go y Lua — seis runtimes de lenguaje con ejemplos de contenedores OCI y presupuestos de tamaño de imagen aplicados en CI en 15 pares (lenguaje, escenario).

• ¿Cómo funciona el puente MQTT?

  MOS4 embebe un broker MQTT en proceso — no se requiere un broker externo. Los payloads se aceptan como JSON plano o como el formato binario tipado; el JSON se transcodifica en la entrada. Un catálogo de servicios retenido permite a los clientes descubrir los servicios disponibles en el momento de la conexión. Cualquier librería cliente MQTT, cualquier lenguaje — alcanza los servicios MOS4 sin SDK Munic requerido.

• ¿Qué tan rápido es el hot-swap?

  10 segundos desde el fin de la compilación hasta la primera llamada de servicio exitosa en un dispositivo real. Cuando un nuevo proceso registra un micro service con un component.id existente, el master detiene la instancia anterior, inyecta el estado serializado e inicia el reemplazo. Sin reflash. El hot-swap es una característica de los micro services Rust; los contenedores (Python, C, C++, Go) siguen una ruta de actualización OTA diferente.

• ¿Cuál es el presupuesto de sobrecarga del contenedor?

  El sobre de presupuesto del contenedor MCM es inferior al 5% de sobrecarga de CPU/RAM y aproximadamente 10 MB de RSS por contenedor. La CLI autónoma mcm está preinstalada en las imágenes de producción.

• ¿Está expuesto el puerto RPC interno para herramientas directas?

  El puerto RPC interno no está expuesto por defecto. El puente RPC enruta las llamadas JSON de clientes externos a cualquier servicio MOS4 registrado; use el puente MQTT o el puente RPC para acceso externo.

• ¿Para qué sirve el puente RPC?

  El puente RPC llama a cualquier servicio MOS4 — incluidos los contenedores — desde la nube mediante API. Casos de uso: depuración remota, desbloqueo de situaciones de campo poco frecuentes y flujos híbridos donde un agente AI impulsa el dispositivo. No se necesita código de protocolo ni de conexión más allá de el servicio y un endpoint del lado de la nube.

Herramientas para desarrolladores

Herramientas con IA para desarrolladores de MOS4.

El paquete de desarrollador de MOS4 amplía el SDK con un conector MCP, un linter de configuración, lectores de logs y consultas de grafo de proyecto — para que las herramientas de IA que su equipo ya usa entiendan la plataforma. Disponible con ingeniería.