Versiones y actualizaciones
DeviceChain se distribuye como un conjunto de imágenes de contenedor precompiladas y versionadas, más un chart de Helm. No necesita compilar nada para ejecutarlo: descargue una versión publicada, instale el chart y actualice in situ con una actualización progresiva.
- Una instancia creada por la
v0.16.0o cualquier versión anterior no puede actualizarse a una posterior, porque no registró ninguna declaración de lo que es la instancia. Consulte Actualizar desde una versión anterior. - La
v0.19.0, para una instancia cuyo almacén de eventos guarda más de 4 000 000 de filas aún sin comprimir, o una tabla de más de 500 fragmentos cuyos eventos más antiguos no se pueden eliminar: su primer arranque reconstruye las claves del almacén de eventos sobre esas filas y se niega por encima de esos límites. Si actualiza desde lav0.17.xo lav0.18.x, lea antes sus notas.
Si está en cualquiera de ellos, lea la sección correspondiente antes de hacer nada más.
Las versiones posteriores a v0.23.0 escriben los eventos en una forma que v0.22.0 y anteriores
no pueden leer. Si viene de v0.22.0 o anterior, actualice primero cada instancia a v0.23.0, y
solo después a una versión posterior. Consulte
El formato de los eventos en el bróker.
Modelo de versionado
Cada versión es una única etiqueta git de versión semántica (vX.Y.Z). Ese único número cubre
todo en conjunto: cada imagen de servicio, el operador, el chart de Helm y la CLI
dcctl se publican todos con la misma versión. No hay desfase de versión por servicio
del que preocuparse: un despliegue es un único número coherente.
Dos comandos mueven todo ello, y cuál mueve qué se decide por el tiempo de vida de cada
cosa. El operador es un solo controlador por clúster, compartido por todas las instancias que
haya en él, así que dcctl install lo mueve junto con el resto de los requisitos previos del
clúster. El documento de configuración, la versión desplegada del chart y las imágenes de los
servicios pertenecen a una instancia, así que dcctl upgrade mueve esos, instancia por
instancia. Consulte Actualizaciones progresivas para el
procedimiento.
- Las versiones estables son
vX.Y.Z(por ejemplo,v1.2.0). La etiqueta:latestsigue a la versión estable más reciente. - Las versiones preliminares son
vX.Y.Z-rc.N(por ejemplo,v1.2.0-rc.1). Estas nunca mueven:latest.
Estabilidad previa a 1.0
v1.0.0 es la primera versión estable, y la política de versiones y actualización se aplica desde ella. Hasta la v1.0.0, cualquier versión —incluida una versión de parche— puede cambiar APIs, esquemas o
comportamiento sin una capa de compatibilidad. Esto es deliberado: mientras el modelo de datos aún se
está asentando, preferimos un cambio limpio antes que cargar con una capa de compatibilidad que
tendríamos que mantener para siempre.
Cada cambio disruptivo se indica al principio de las notas de esa versión. Léalas antes de actualizar. Son la lista autorizada; el número de versión por sí solo no le indica si una versión es segura para su despliegue.
En concreto, antes de la v1.0.0 debe esperar que una versión pueda:
- endurecer la validación, de modo que una solicitud que antes tenía éxito ahora sea rechazada, por lo general porque se estaba aceptando silenciosamente o descartando silenciosamente
- cambiar o eliminar un campo GraphQL, en lugar de marcarlo obsoleto durante un ciclo
- alterar el esquema de la base de datos de formas que una reversión no deshará
- reemplazar por completo la línea base de migraciones, lo que elimina por entero la ruta de
actualización en lugar de limitarse a hacerla unidireccional. Cuando eso ocurre, las notas de la versión lo
indican al principio, y la única vía es recrear la instancia. La
v0.9.0y lav0.10.0son versiones de este tipo - dejar de admitir la actualización desde una instancia más antigua por un motivo que no
tiene nada que ver con el esquema: la versión posterior a la
v0.16.0lee un registro de lo que es una instancia que las versiones anteriores nunca escribieron, y se niega en lugar de inventárselo - negarse a una actualización in situ por encima de un límite de tamaño de los datos: la
v0.19.0rechaza un almacén de eventos con más de 4 000 000 de filas aún sin comprimir, o una tabla de más de 500 fragmentos, y lo indica al principio de sus notas
La propiedad de "actualizar in situ con una actualización progresiva" descrita arriba describe la mecánica de una actualización progresiva. No es una promesa de que sus llamadas a la API existentes conserven el mismo significado a través de un incremento de versión previo a 1.0.
A partir de la v1.0.0, esta sección se reemplaza por una promesa de compatibilidad de versionado semántico: cambios disruptivos solo en una versión mayor. Consulte Política de versionado y actualización.
Debido a que las versiones son frecuentes antes de la disponibilidad general (GA), la versión menor marca un hito (una funcionalidad o subsistema significativo que se lanza) y la versión de parche lleva el ritmo continuo de correcciones y endurecimiento. Una versión de parche no es automáticamente una actualización de bajo riesgo durante este período; nuevamente, las notas de la versión son las que se lo indican.
Imágenes
Las imágenes se publican en el Registro de Contenedores de GitHub público bajo
ghcr.io/devicechain-io, por ejemplo, ghcr.io/devicechain-io/device-management. Son
multiarquitectura (linux/amd64 y linux/arm64) y se construyen sobre una base distroless sin
privilegios de root, por lo que se ejecutan como un usuario sin privilegios, sin shell y con una superficie de ataque mínima.
Debido a que el registro es público, no se requieren credenciales para descargar las imágenes publicadas.
Instalación de una versión específica
Fije la etiqueta de imagen a la versión que desea:
DC_ROOT_KEY, más abajo, es la clave raíz del almacén de secretos de la instancia:
la requieren todos los perfiles, se genera una sola vez con openssl rand -base64 32 y se
pasa sin cambios en cada instalación y actualización. Consulte
Desplegando con Helm para saber por qué.
Sustituya <version> por una etiqueta realmente publicada —la
página de versiones las lista, y un
valor no publicado falla al descargar la imagen, no en el momento de la instalación—.
helm install dc deploy/helm/devicechain \
--set instance.id=devicechain \
--set instance.config.infrastructure.secrets.rootKey="$DC_ROOT_KEY" \
--set image.tag=<version>
El chart de Helm en sí también se publica como un artefacto OCI, por lo que puede instalarlo sin una
copia local del repositorio. La versión del chart es la versión publicada sin la v inicial
—--version 0.16.0 instala la versión v0.16.0—, así que no hay un número aparte que buscar;
helm show chart oci://ghcr.io/devicechain-io/charts/devicechain imprime la última, y
--version rechaza cualquier valor que nunca se haya publicado:
helm install dc oci://ghcr.io/devicechain-io/charts/devicechain \
--version <chart-version> \
--set instance.id=devicechain \
--set instance.config.infrastructure.secrets.rootKey="$DC_ROOT_KEY" \
--set image.tag=<version>
El chart también está publicado en Artifact Hub, que muestra cada versión publicada junto con sus valores predeterminados y sus plantillas renderizadas.
Actualizar una instalación hecha solo con el chart
Una instancia instalada con helm install en lugar de dcctl bootstrap se actualiza con
helm upgrade, y conserva una trampa que la ruta de dcctl no tiene.
dcctl upgrade no se aplica a ella. Ese comando vuelve a leer del clúster la declaración de
una instancia y su documento de configuración, y una instalación hecha solo con el chart no
tiene ninguno de los dos.
El release de abajo se llama dc porque ese es el nombre que eligió el helm install de más
arriba. Una instancia instalada con dcctl bootstrap lleva un release con el nombre de la
instancia —devicechain se instala como dc-devicechain—, así que cualquier comando helm
dirigido a una de esas necesita ese nombre en su lugar.
helm get values dc -n default -o yaml > dc-values.yaml
helm upgrade dc deploy/helm/devicechain \
-n default \
-f dc-values.yaml \
--set image.tag=<new-version>
rm dc-values.yaml # este archivo contiene los secretos de su instancia
--set image.tag=… por sí solo no funcionaráLa regla de Helm es la trampa. Una actualización que no pasa ningún valor reutiliza los que
ya están en la versión desplegada. Pero en cuanto pasa cualquier valor —incluido el único
--set que cambia la versión, que es justamente el objetivo de una actualización— Helm parte
de los valores predeterminados del chart y todo lo que usted fijó al instalar desaparece. Eso
incluye la clave raíz de la instancia, sin la cual los secretos almacenados de una instancia en
funcionamiento no se pueden leer.
Cuando eso ocurre no se corrompe nada, porque el chart se niega a renderizar sin la clave raíz:
Error: UPGRADE FAILED: execution error at (devicechain/templates/instance-config.yaml:21:4): instance.config.infrastructure.secrets.rootKey is required: every instance seals its token-signing key under it, along with any integration credentials it stores, and user-management cannot start without it. Set it to a base64 256-bit key (openssl rand -base64 32); dcctl bootstrap mints one automatically.
--reuse-values también funciona, pero conserva en silencio entradas obsoletas cuando los
valores predeterminados del chart cambian entre versiones, así que es preferible volcar los
valores y pasarlos con -f, donde puede verlos.
Una instalación que monta su configuración de instancia desde un Secret que el chart no
escribe —fijado con instance.existingSecret, el patrón que producen External Secrets y
sealed-secrets— tiene ahora que cumplir cuatro condiciones, y helm upgrade hace fallar el
renderizado en lugar de continuar cuando alguna no se cumple. Cuando eso ocurre, nada cambia
en la release; el rechazo es todo el efecto.
-
El Secret debe llamarse
dci-<instance.id>-config, en el namespace de la instancia. Cualquier otro nombre se rechaza, porquedcctlvuelve a leer la configuración exactamente por ese nombre para decidir si una instancia ya existe, y trata un Secret ausente como una instalación nueva: una nueva ejecución acuñaría una nueva clave raíz y nuevas credenciales de base de datos y de broker sobre una instancia en funcionamiento. Si su Secret está bajo otro nombre, créelo de nuevo bajo este (eltarget.namede External Secrets, elmetadata.namede un sealed secret) antes de actualizar. -
instance.existingSecretChecksumes obligatorio: el sha256 del documento bajo la claveinstancedel Secret, como 64 caracteres hexadecimales en minúsculas. El chart no puede leer su Secret, así que esto es lo que reinicia los pods cuando la configuración cambia; sin él, una credencial rotada se aplicaría sin problemas, no reiniciaría nada e informaría éxito. Vuelva a calcularlo cada vez que el documento cambie:kubectl get secret dci-<instance.id>-config -n dci-<instance.id> \-o jsonpath='{.data.instance}' | base64 -d | sha256sum | cut -d' ' -f1 -
networkPolicy.externalConfigPortses obligatorio mientrasnetworkPolicy.enabledesté activado, con las clavesnatsyrdbrepitiendo los puertos del broker y de la base de datos que nombra su documento. De lo contrario el chart los tomaría de sus propios valores predeterminados, y un puerto que no coincida bloquea en silencio la salida de los propios servicios, lo que se presenta como una caída del broker o de la base de datos. -
metrics.natsBrokerHostes obligatorio mientrasmetrics.natsPodMonitoresté activado: el nombre de host del broker tal como lo nombra su documento (el nombre corto del Service para un broker en el namespace de esta instancia,<service>.<namespace>para uno en otro lugar). Decide qué namespace vigila el PodMonitor; un valor predeterminado que no coincida no monitoriza nada. O bien fijemetrics.natsPodMonitor=false.
Cada error de helm nombra el valor que necesita y por qué. Las dos transformaciones que el
chart aplica normalmente al escribir el documento —el bloque infrastructure.shutdown y la
eliminación de infrastructure.aiInference cuando esa área no está desplegada— siguen
correspondiéndole a usted reproducirlas, como hasta ahora.
Actualizaciones progresivas
Actualizar consiste en dos comandos —uno para el clúster y luego uno por cada instancia
que haya en él—, y el chart y los servicios están diseñados para avanzar pod por pod, de modo que un
área con más de una réplica sigue sirviendo mientras se actualiza. Hay cinco excepciones, todas documentadas más abajo: la transición a la
ingesta duradera, que sigue siendo una actualización corriente pero tiene un efecto secundario
visible; la v0.9.0, la v0.10.0 y cualquier instancia creada por la v0.16.0 o una
versión anterior, a las que no se puede actualizar en absoluto; y la v0.19.0 para una
instancia cuyo almacén de eventos guarda más de 4 000 000 de filas aún sin comprimir, o una
tabla de más de 500 fragmentos cuyos eventos más antiguos no se pueden eliminar
(Comprueba el número de filas). Consulte las notas de la
versión a la que va a migrar antes de ejecutarlo:
dcctl install local --version <new-version>
dcctl upgrade local devicechain --version <new-version>
Ejecuta ambos con el dcctl de la versión a la que vas a pasar: un dcctl instala y actualiza solo a su propia versión, y dcctl upgrade se niega si la instalación del clúster la hizo uno más antiguo. Da a dcctl install los mismos ajustes con los que se instaló el clúster, como --ha o --compact. Se niega a cambiarlos mientras una instancia se ejecuta en el clúster; consulta Volver a ejecutar install.
La actualización se ha ensayado a mano en un clúster local: una instancia instalada con --ha se
actualizó in situ con tráfico MQTT en marcha (cuatro dispositivos publicando con QoS 1, 20 mensajes por
segundo entre todos, con infrastructure.nats.mqttFailClosed desactivado, como lo está por defecto), su
broker se reinició dos veces y los dispositivos se reconectaron tras cada reinicio. En un ensayo, todos los
mensajes que el broker había confirmado seguían almacenados después (11 009 de 11 009). En otro se perdieron
11 de 11 262 mensajes confirmados, todos mientras se reiniciaba un servidor del broker y el stream de captura
MQTT cambiaba de líder. Con mqttFailClosed desactivado, espere una breve ventana de pérdida como esta en
cada reinicio del broker, con cualquier volumen de tráfico; vea
MQTT: el bróker de la plataforma. Los
ensayos son manuales. La comprobación automática de actualización que condiciona cada versión se ejecuta
sin tráfico.
No se ha medido una actualización bajo carga sostenida de producción en un clúster de tamaño de producción,
así que DeviceChain no promete una actualización sin interrupción. Prevea una breve interrupción donde se
reemplace un pod: un área con una sola réplica y cada servidor del broker. Sin --ha, el único servidor del
broker se reinicia y el broker no está disponible mientras tanto. Un dispositivo que envía mientras está
desconectado debe reintentar.
Una versión de DeviceChain es un único número que abarca las imágenes de los servicios, el
chart, el operador y dcctl. Los dos comandos se lo reparten según a qué pertenece cada cosa:
dcctl install mueve el clúster. El operador —su namespace, sus CRD, su RBAC y su
controlador— se aplica a partir de manifiestos incrustados en dcctl. No forma parte del
chart de Helm, así que nada dentro del chart puede alcanzarlo. Se aplica el flujo renderizado
completo y no solo la imagen del controlador, porque los CRD van en él: un esquema que se
quedara en la versión con la que se arrancó la instancia descartaría en silencio cualquier
campo que añadiera una versión posterior. Este comando mueve además el resto de los requisitos
previos compartidos del clúster; consulte
Instalar el clúster.
dcctl upgrade mueve una instancia, y no mueve nada de lo compartido:
- la infraestructura de la instancia: su bróker de mensajería (NATS) y su almacén de eventos, aplicados desde la configuración de OpenTofu que trae esta versión, de modo que un cambio en cualquiera de los dos llega a las instancias existentes y no solo a las nuevas. Consulte Qué aplica una actualización a la infraestructura;
- el documento de configuración del que cada servicio lee sus credenciales y sus
endpoints, recompuesto a partir del chart de esta versión y escrito por
dcctl, que es su dueño; - la versión desplegada de Helm que ejecuta los servicios, que los hace avanzar a las imágenes nuevas y espera a que cada área termine.
El orden importa, y la actualización lo comprueba. El operador es lo que define la
declaración de la instancia, así que tiene que estar en la versión nueva antes de mover una
instancia a ella. dcctl upgrade lee el operador que lleva el clúster y rechaza una
instancia cuyo clúster no tenga operador alguno, o cuyo operador sea identificablemente el de
otra versión, nombrando el comando de instalación que hay que ejecutar primero. No aplica el
operador él mismo: en un clúster con varias instancias eso movería el controlador de todas
las demás como efecto secundario de actualizar una, en silencio.
Hay un caso que la comprobación del operador deja pasar con un aviso en lugar de rechazarlo. dcctl install
marca con una identidad las definiciones que aplica; un operador puesto en el clúster a
mano no la lleva, y dcctl no puede distinguir una instalación manual deliberada de una que
un dcctl más antiguo sobrescribió. En lugar de pasar por encima de una decisión que no puede
ver, esa comprobación imprime una nota con el comando de instalación y continúa. Si no
instalaste el operador a mano, toma esa nota como el rechazo que habría sido y ejecuta
dcctl install antes de seguir. La comprobación de instalación de más abajo es independiente
y sigue aplicándose: un clúster en el que dcctl install nunca terminó no tiene registro de
instalación, y su actualización se rechaza hasta que se ejecute dcctl install.
La actualización también comprueba que la instalación se ejecutó, y solo avanza a la versión de su propio dcctl. Las definiciones de un operador pueden seguir iguales entre versiones mientras su controlador cambia, así que la comprobación del operador por sí sola no detecta que se omitió dcctl install. Por eso dcctl upgrade lee además el registro de instalación del clúster, que nombra el dcctl que terminó por última vez dcctl install, y se niega cuando ese es anterior al dcctl que hace la actualización, cuando una instalación empezó y no terminó, o cuando el clúster no tiene un registro utilizable. El rechazo nombra el comando de instalación que hay que ejecutar antes y no cambia nada. Repetir la actualización con la versión que se instaló no se rechaza, ni tampoco un clúster instalado por un dcctl más nuevo. Un dcctl compilado desde el código fuente no se compara. Desde esta versión, un dcctl upgrade normal con una versión de parche más nueva de dcctl también necesita dcctl install antes.
Un --version explícito se rige por la misma regla, en ambos sentidos, en dcctl upgrade y en dcctl install. Se rechaza una versión anterior a la del dcctl que se ejecuta, porque su chart y su configuración de infraestructura son los de su propia versión y se planificarían alrededor de imágenes que nunca los han visto; para retroceder, cuando las notas de esa versión lo permitan, usa el dcctl de la versión anterior. También se rechaza una versión más nueva que la del dcctl que se ejecuta, y instalarla con este dcctl no ayudaría: el registro de instalación nombra el dcctl que ejecutó la instalación, no el --version que recibió. Obtén el dcctl de la versión más nueva, ejecuta dcctl install con él y después actualiza. No se ven afectados --version igual a la versión del dcctl en ejecución, ni una etiqueta de un registro propio (--registry). Una actualización sin --version solo se rechaza cuando la instancia está declarada en una versión más nueva que la del dcctl en ejecución. Ninguno de los dos rechazos tiene una forma de omitirse.
Ejecute cualquiera de los dos con --dry-run primero si quiere ver qué movería. dcctl upgrade toma el clúster de destino del propio registro de la instancia en lugar de
adivinarlo, y dice cuál es.
Un agente de borde en el enlace ascendente de pasarela publica en el espacio de nombres de pasarela. Una plataforma cuyo event-sources no conoce ese espacio de nombres, con infrastructure.nats.mqttFailClosed activado, confirma esos mensajes en el broker y los descarta, y nada en el agente lo muestra. Termine de actualizar el clúster y cada instancia (todas las réplicas de event-sources y de device-management, y las concesiones del broker) antes de reiniciar cualquier agente en una versión que lo use. Un agente cuyo broker no se ha actualizado no puede suscribirse a sus avisos y no informa de su enlace ascendente como conectado.
dcctl upgrade conserva aquello sobre lo que la instancia está funcionando: las contraseñas
propietarias de las bases de datos, la autoridad y los inicios de sesión del bróker, el secreto
entre servicios, la clave raíz del almacén de secretos y —cuando el clúster los ejecuta— la
contraseña de administrador del panel de monitoreo y la credencial del almacén de objetos de
respaldo interno del clúster. Un cambio de versión no puede convertirse en un cambio de
credenciales.
Esto está verificado, no solo afirmado. Se comprobó la actualización de una instancia en funcionamiento comparando un resumen criptográfico (digest) de cada una de esas credenciales antes y después, y lo único que había cambiado era la etiqueta de imagen: en todos los servicios, en la consola y en el operador.
Como las conserva por diseño, no rota nada. Si necesita cambiar una credencial, una actualización no lo hará — y para varias de ellas hoy no existe un procedimiento admitido.
El perfil, la topología y las áreas funcionales habilitadas provienen de la propia declaración
de la instancia —lo que dcctl bootstrap registró en el clúster—, no de flags escritos aquí.
Cambiar lo que una instancia es es una pregunta distinta con respuestas distintas: subir el
número de réplicas, por ejemplo, no vuelve a replicar los streams de mensajería que se crearon
con el número anterior. Para añadir un área funcional a una instancia en marcha, usa
dcctl enable-area, que la registra en esa declaración.
Una cosa queda además deliberadamente fuera de este comando: no toca los datos de las bases de datos más allá de dejar que los servicios ejecuten sus propias migraciones, y nunca cambia el tamaño de un volumen.
El ajuste del operador se conserva
Una actualización no cambia la forma de una instancia, pero sí conserva el ajuste que le diste. Un archivo de valores pasado a dcctl bootstrap --values o a dcctl upgrade --values se registra en la instancia y lo aplica de nuevo cada actualización posterior; --reset-values lo elimina. Consulta Ajustar una instancia.
La confirmación MQTT a prueba de fallos se conserva del mismo modo: --mqtt-fail-closed en dcctl bootstrap o dcctl upgrade se registra en la instancia, y una actualización que omite el indicador conserva lo registrado, activado o desactivado. Consulta MQTT con fail-closed.
Las credenciales aprovisionadas se conservan
Las credenciales que diste a dcctl con un archivo, las claves precompartidas de LwM2M y las contraseñas del broker de Sparkplug, se guardan en Secrets que dcctl escribe él mismo, fuera de la versión de Helm. Una actualización no los toca y no lee nada secreto de la versión. La primera actualización de una instancia aprovisionada con claves LwM2M por una versión anterior las traslada a su propio Secret antes de que cambie la versión; las revisiones anteriores del historial de Helm siguen teniendo los valores antiguos, así que rota las claves después si eso te importa. Los ajustes que pusieras a mano en el bloque lwm2m-ingest de la versión ya no se conservan entre actualizaciones (solo las identidades y su proyección); ponlos en un archivo de valores indicado con --values. Quitar una clave, o todo el Secret en una retirada, espera a que la release haya terminado bien, así que una actualización fallida nunca deja un pod que sigue en ejecución sin una clave que lee cuando su contenedor se reinicia; si la release termina bien y solo falla esa limpieza, dcctl avisa con el comando que la termina.
Qué aplica una actualización a la infraestructura
Antes de mover los servicios, dcctl upgrade aplica la configuración de OpenTofu de la
instancia, la misma que aplicó dcctl bootstrap al crearla. Esa configuración contiene los
servidores NATS de la instancia y su almacén de eventos: la imagen, los ajustes y la ubicación
de la base de datos, y su configuración de respaldo y archivado. La actualización planifica
primero y muestra lo que va a cambiar; con --dry-run muestra el plan y se detiene. Necesita
tofu en el PATH, como un bootstrap, y preparar la configuración consulta el registro de
proveedores (o su réplica) por sus proveedores; una ejecución en seco también lo hace, en el
directorio de trabajo local en el que planifica.
Conserva aquello con lo que funciona la instancia. Conserva todas las credenciales, como se indica arriba. El volumen de JetStream y el del almacén de eventos conservan su tamaño. Si esta versión crea otro tamaño para las instancias nuevas, la actualización lo dice, y Volumen del almacén de eventos muestra cómo ampliar uno usted mismo. El almacén de eventos conserva la ruta bajo la que archiva, y un almacén restaurado conserva el archivo desde el que se restauró.
Se niega, sin cambiar nada, cuando:
- Esta máquina no tiene el estado de la instancia. El estado de la configuración vive en
~/.devicechain/instances/<instancia>/en la máquina que la creó. Ejecute allí la actualización, o copie antes ese directorio. Contiene credenciales, así que manténgalo privado (modo0700). - El plan borraría o reemplazaría algo que gestiona la configuración, como el bróker o el almacén de eventos. El rechazo dice qué. Las notas de una versión así explican cómo pasar a ella. Esto juzga los recursos que gestiona la configuración; un objeto que desaparece dentro de uno de ellos se muestra como un cambio de ese recurso.
- El plan acortaría la ventana de recuperación del almacén de eventos o dejaría de declarar un lector de analítica que nada de lo que lee esta actualización declara. Son valores puestos a mano, y aplicar sin ellos podaría respaldos o dejaría sin gestionar la contraseña de un lector. Declárelos como se describe abajo y vuelva a ejecutar la actualización.
- El plan desactivaría los respaldos del almacén de eventos. Ninguna declaración lo deja
pasar:
dcctldecide si los respaldos están activos según cómo se instaló el clúster.--skip-infrastructuremueve los servicios y deja el almacén de eventos como está. - El bróker o el almacén de eventos no está sano antes de empezar, por ejemplo un servidor que no está listo o un almacén a mitad de una conmutación por error. Recupérelo primero. La única excepción es un bróker cuyo último despliegue gradual no terminó, con algunos servidores ya en los ajustes nuevos y uno de ellos sin estar listo. Solo una aplicación puede cambiar los ajustes hacia los que avanza, así que la actualización aplica sobre él, lo indica junto al plan y espera a que los ajustes nuevos terminen de desplegarse. Un bróker al que le falta un servidor con los ajustes que ya ejecutan todos, por ejemplo tras perder un nodo, se sigue rechazando.
- El plan cambia la imagen del almacén de eventos y sus ajustes a la vez en un almacén de más de una instancia, algo que rechaza el operador de la base de datos. El rechazo indica el orden en que aplicarlos.
--skip-infrastructure mueve solo los servicios, como hacían las actualizaciones anteriores a
esta versión, y al terminar dice lo que dejó sin aplicar.
Valores que usted mismo dio a la configuración. Una actualización aplica la configuración con
los valores de dcctl, como hace un bootstrap. Un valor se conserva cuando está declarado en un
archivo terraform.tfvars o *.auto.tfvars junto al estado de la instancia, en
~/.devicechain/instances/<instancia>/infra/instance/, o en una variable de entorno
TF_VAR_<nombre>: OpenTofu lee ambos en cada aplicación que ejecuta dcctl. Un valor pasado a
mano con -var no se conserva. Entre los valores que se indica fijar así están
backup_retention_tsdb, timescale_analytics_readers (consulte
Acceso SQL y BI) y los del bróker nats_cpu_request,
nats_memory_request y nats_memory_limit. Una solicitud o un límite del bróker que la
actualización bajaría se muestra como aviso junto al plan.
Esto solo funciona para una variable que dcctl no pasa por sí mismo, porque OpenTofu deja que un
-var en la línea de órdenes prevalezca sobre esos archivos y sobre TF_VAR_. dcctl pasa, en
cada aplicación:
- en una instancia instalada con
--compact, las solicitudes del brókernats_cpu_requestynats_memory_request, y los tamaños de sus volúmenes. Fijar esas solicitudes enterraform.tfvarsno tiene efecto en una instancia compacta.nats_memory_limitno está entre ellas. - según cómo se instaló el clúster, si los respaldos de base de datos están activos
(
enable_database_backups), la clase de instantánea (backup_snapshot_class) y la ubicación de las bases de datos en los nodos. Cámbielos condcctl install, no en ese archivo.
Los avisos y rechazos de la actualización indican en qué caso está cada valor.
Lo que ve una instancia en marcha:
- Los servidores NATS se reinician cuando cambian sus ajustes. Con
--hase reinician de uno en uno; cada uno está Ready antes de que se detenga el siguiente. Sin--hase reinicia el único servidor y el bróker no está disponible mientras tanto, normalmente alrededor de un minuto. Los servicios y los dispositivos se reconectan solos; las publicaciones hechas entretanto se rechazan. Si el nodo no tiene sitio para las nuevas solicitudes del servidor, este queda enPending: con--halos otros dos siguen atendiendo, pero sin--hael bróker sigue caído hasta que haya sitio, y la actualización falla tras hasta 15 minutos diciéndolo. - La devolución de llamada de autenticación de dispositivos va cifrada y sus claves cambian de
sitio. La contraseña de un dispositivo cruzaba el bróker en claro hacia cualquier servicio que
escuchara.
dcctl upgradecrea un Secret llamadodci-<instancia>-calloutcon la semilla de firma de la devolución de llamada y una nueva semilla de cifrado, montado solo endevice-management; la configuración de la instancia conserva únicamente sus mitades públicas. La primera actualización que lo hace aplica el bróker en dos pasos para que los dispositivos sigan conectando: primero se despliegan los servicios con un respondedor que lee solicitudes cifradas y sin cifrar, y solo después se vuelve a aplicar el bróker con el cifrado activado. Ese segundo paso es un reinicio progresivo más de los servidores NATS. Los dispositivos conectados al servidor que se reinicia se reconectan solos, en segundos con--ha; sin--hael bróker no está disponible el minuto habitual. Si el segundo paso falla, los dispositivos siguen conectando, y ejecutardcctl upgradede nuevo lo termina. - Todos inician sesión una vez más, y el estado de inicio de sesión pasa a una cuenta propia. Los
tokens de actualización, los códigos de autorización OAuth, los registros de inicio de sesión único
y la limitación de intentos vivían en la cuenta NATS que comparten todos los servicios, donde
cualquier credencial de servicio podía leerlos o copiarlos a un stream propio.
dcctl upgradecrea una credencial nueva y un Secret llamadodci-<instancia>-identityque guarda su contraseña y se monta solo enuser-management. El bróker recibe una cuentaIDENTITYaparte, a la que solo esa credencial puede entrar y que no comparte nada con la otra cuenta. Los buckets antiguos se eliminan, no se copian: sus tokens eran legibles por todos los servicios, así que trasladarlos mantendría viva la exposición. Todas las sesiones anteriores a la actualización terminan: las personas vuelven a iniciar sesión en la consola y los paneles, y los clientes MCP y OAuth vuelven a autorizar. Los tokens de acceso ya emitidos siguen funcionando hasta que caducan, 15 minutos por defecto. Mientrasuser-managementse actualiza, un inicio de sesión o una renovación de token que llegue a un pod que aún ejecuta la versión anterior puede fallar con un error durante unos segundos; al reintentarlo funciona. Nada se pierde en silencio:user-managementregistra los buckets que eliminó la primera vez que arranca, ydcctl upgradelo indica al terminar. El bróker se reinicia una vez, servidor a servidor con--ha, para añadir la cuenta.user-managementse niega a arrancar si la instancia dice que la cuenta existe y falta su contraseña, en lugar de recurrir a la cuenta compartida. - Cada área recibe una credencial propia para el bróker. Hasta ahora todos los servicios entraban
al bróker de mensajes con una sola credencial compartida, de modo que cualquier pod podía presentar,
y cualquier fuga de su configuración exponía, la credencial de todos.
dcctl upgradecrea una credencial por cada área que usa el bróker, y otra para la administración del bróker, y guarda cada una en un Secret llamadodci-<instancia>-nats-<área>que se monta solo en el pod de esa área.mcpyai-inferencenunca abren una conexión con el bróker y no montan ninguna. Cada credencial queda limitada a lo que usa su área, y a nada más: los streams en los que escribe, los consumidores con los que lee (con nombre exacto, así que un área no puede reescribir, tomar mensajes de ni confirmar los de otra), los buckets clave-valor que abre y sus propios subjects de respuesta. Una credencial ya no puede publicar en los streams de otra área, escribir en la caché de otra ni suscribirse a las respuestas de otra. Los permisos se generan a partir de las mismas declaraciones contra las que se comprueban los servicios, así que no pueden quedar por detrás de lo que un servicio hace. La credencial compartida sigue en su sitio junto a las nuevas durante esta actualización, con los permisos que siempre tuvo, de modo que los servicios que aún no se han reiniciado siguen conectándose; hasta la siguiente actualización sigue en la configuración que lee cada pod, así que un pod aún puede presentarla, y esto todavía no es una frontera frente a un servicio comprometido. Ejecutedcctl upgradeuna vez más para retirarla. Cuando cada área ya usa su propia credencial y la actualización anterior terminó, esa actualización elimina la credencial compartida del bróker y de la configuración de la instancia, con un reinicio más del bróker, y su resumen final indica qué fase se ejecutó (o por qué no retiró la credencial). Una instancia nueva nunca tiene una credencial compartida. Una vez retirada, no se admite volver a una versión anterior: ejecute de nuevo eldcctl upgrademás reciente. Dos permisos son más amplios a propósito: event-sources conserva permisos de actualización sobre los almacenes MQTT del bróker, y user-management puede purgar los datos de un tenant eliminado en todos los streams, salvo los consumidores con los que event-sources conserva la durabilidad de los mensajes confirmados. Una instalación que ejecuta el chart sin dcctl y aporta su propio bróker puede imprimir los mismos permisos condcctl broker permissions. El bróker se reinicia una vez, servidor a servidor con--ha, para añadir los usuarios. Un área se niega a arrancar si la instancia dice que las credenciales existen y falta la suya, en lugar de recurrir a la compartida. Las credenciales existentes nunca se reemplazan: una actualización crea solo las que faltan. - Los streams y buckets los crea ahora una única credencial de administración, antes de que los servicios
se actualicen. La configuración de un stream decide qué se almacena bajo qué subject, de modo que dejar que
cada servicio creara y cambiara los streams que usa permitía que cualquiera de ellos remodelara un stream para
capturar o falsificar mensajes. El chart ejecuta ahora un job,
<instancia>-broker-admin, antes de cada instalación y actualización (un hook de Helm pre-install y pre-upgrade). Entra con la credencial de administración del bróker, que ningún Deployment monta, y hace lo que antes hacía cada servicio por su cuenta al arrancar: crea lo que falta, restablece los subjects, la ventana de duplicados, la política de descarte, los límites de tamaño y el número de réplicas de lo que existe y, para el único stream de captura que una versión anterior creó con otra retención, espera a que su lector lo vacíe antes de recrearlo como se declara. Esa espera puede tardar unos minutos. Un servicio ya no crea ni cambia nada: comprueba que cada stream y bucket que abre coincide con lo que declara su versión, y se niega a arrancar, indicando el stream y en qué difiere, cuando falta alguno o es incorrecto. Si el job falla, la actualización falla antes de que se actualice ningún servicio, ydcctl upgrademuestra el log del job; los servicios de la versión anterior siguen funcionando.dcctl broker reconcile <instancia>ejecuta de nuevo el mismo job, que es también la forma de recuperar un stream o bucket borrado a mano. Las credenciales de área ya no tienen derecho a crear, actualizar ni borrar un stream o bucket, con dos excepciones que se mantienen a propósito: event-sources conserva sus derechos sobre los almacenes MQTT propios del bróker, y user-management conserva el derecho a borrar las copias antiguas de los buckets de inicio de sesión. Las reproducciones del stream resolved-events que hace event-processing (su puesta al día tras un reinicio, el relleno de huecos en vivo y la vista previa de reglas) leen ahora el stream por secuencia, lo que no crea ningún consumidor en el bróker, así que ningún área tiene derechos sobre los consumidores de otra área en un stream de mensajes; el job de administración activa para ello las lecturas directas del stream. Con esto cambian dos comportamientos. La vida útil de los buckets de caché queda fijada en cinco minutos, porque los crea el job y ya no se la pide a cada servicio; los ajustes de tiempo de vida de la caché de device-management limitan solo cuánto tiempo conserva una réplica una entrada en su propia memoria. Y un número de réplicas aumentado en la configuración de la instancia surte efecto cuando se ejecuta el job, en la siguiente actualización, y no en cada reinicio de pod. Un pod de la versión anterior que se reinicia después de actualizar el bróker pero antes de que el job se haya ejecutado es rechazado cuando intenta reconfigurar un stream; avance a la versión nueva y arrancará. Una instalación que ejecuta el chart sin dcctl necesita tener listos el namespace y el Secret de la credencial de administración antes de la primera instalación, porque el job se ejecuta antes de que el chart cree nada; puede desactivar el job conbrokerAdmin.enabled=falsey crear los streams y buckets por su cuenta con la imagendc-broker-admin. - El almacén de eventos se reinicia cuando cambian sus pods, por ejemplo por una imagen o una
ubicación nuevas. Un cambio solo de ajustes se recarga sin reinicio. Con
--hase reinician primero las réplicas en espera y después el rol primario pasa a una de ellas. Sin--hase reinicia la única instancia, y event-management no puede almacenar eventos hasta que vuelva. Esos eventos esperan en el stream de ingesta y se reintentan, y uno solo se abandona tras unos cuatro minutos de reintentos fallidos. - Los dos pueden reiniciarse a la vez. Se aplican juntos, y la actualización espera a que ambos estén sanos antes de mover los servicios.
Una versión que cambie la imagen del almacén de eventos llega ahora por este paso a las instancias existentes: sus instancias se reinician con ella. Las notas de una versión así dicen qué más necesita.
Se reparte el liderazgo del broker
Reiniciar de forma gradual los servidores del broker deja al reiniciado en último lugar sin liderar ningún stream
ni consumidor, mientras los demás lideran todo; con una carga medida, eso casi duplicó la latencia de confirmación
de publicación. Cuando los servicios ya se han reiniciado, una actualización que tocó el broker pide al líder de cada
stream y consumidor sobrecargado que ceda el liderazgo a una réplica al día, e imprime cuántos lidera cada servidor
antes y después. Los movimientos se hacen de uno en uno, y cada uno espera a que el nuevo líder esté al día antes del siguiente. El paso está acotado y es de mejor esfuerzo: si no puede terminar, avisa y la actualización sigue
siendo correcta.
Los streams con datos de dispositivo ya confirmados al dispositivo no se reequilibran deliberadamente nunca: los streams MQTT del broker, el stream de captura de dispositivos y todo stream en el que escribe un servicio de ingesta. Un cambio de líder en ellos ha perdido mensajes que se habían dicho seguros a los dispositivos, así que ninguna ganancia de latencia lo compensa y no hay opción para incluirlos. Su desequilibrio se resuelve en el siguiente reinicio del broker, o por sí solo. dcctl broker rebalance <instance> ejecuta el mismo paso a demanda, para un broker reiniciado de otro modo.
Antes de equilibrar, el stream que transporta cada evento resuelto se aparta del servidor que lidera la captura de dispositivos o el stream de entrada, que el equilibrado por sí solo podía dejar en un mismo servidor. El resumen termina indicando dónde se lideran esos streams: el de eventos resueltos aparece como "separated"; como "SHARED" cuando ninguna réplica al día está en un servidor libre (menos servidores que streams de este tipo, un servidor libre que no tiene réplica de él, como con cinco servidores y tres réplicas, o réplicas retrasadas); y como "NOT CONFIRMED" cuando el movimiento falló o se omitió. Los streams de captura y de entrada nunca se mueven, así que si un mismo servidor lidera ambos, la línea lo indica como información, y se resuelve en el siguiente reinicio del broker.
Qué más comprueba una actualización
Dos cosas viajan con ella, porque un cambio de versión es lo que le ocurre de forma fiable a una instancia en funcionamiento, y un calendario no.
El certificado del bróker. El bróker de mensajería sirve un certificado válido durante un
año, emitido por una autoridad que dcctl acuña en el arranque inicial y conserva en el
clúster. Una actualización vuelve a emitir ese certificado cuando está dentro de sus últimos 30
días, o cuando ya no cubre todos los nombres por los que los bróker se llaman entre sí —que es
lo que le hace escalar una instancia a un certificado que, por lo demás, sigue holgadamente en
vigor. La reemisión se hace bajo la misma autoridad, así que nada tiene que volver a
confiar en nada. Cuando solo cambia el certificado, el bróker no se reinicia: intercambia el
certificado en caliente, y la actualización espera, hasta cinco minutos, a que todos los bróker
informen del vencimiento del certificado nuevo. Si un bróker no ha cambiado en ese tiempo, la
actualización avisa y reinicia los bróker para que ninguno siga sirviendo el certificado
antiguo. Los bróker se reinician de inmediato cuando cambia algo más que el certificado: la
autoridad o el número de servidores. Si la actualización cambia además la imagen o la
configuración del bróker, ese cambio ya los reinicia. Fuera de esas condiciones la comprobación
se ejecuta y no hace nada.
Ese certificado lo acuña y lo renueva dcctl, no cert-manager, que emite los certificados web
de la instancia y no interviene en el del bróker. El certificado del bróker está en el Secret
dc-nats-tls del namespace de la instancia, y es dcctl upgrade quien lo reescribe. Un bróker
al que se entrega un certificado nuevo bajo la misma autoridad lo sirve a las conexiones nuevas
sin recargar su configuración, así que el cambio de certificado no corta las sesiones MQTT que
ya mantiene. Un reinicio que sí haga la actualización es un reinicio progresivo corriente, un
bróker cada vez, y reconecta los dispositivos como cualquier reinicio del bróker.
Una instancia arrancada antes de que dcctl conservara esa autoridad no puede tener su
certificado reemitido en sitio. La actualización lo indica y continúa en lugar de fallar;
recrear la instancia es lo que acuña una autoridad y un certificado nuevos.
El depósito (escrow) de la clave raíz. Cada actualización comprueba que el artefacto de depósito de esta instancia siga protegiendo la clave sobre la que la instancia está realmente funcionando. Esa comprobación no necesita contraseña: el artefacto registra una huella de la clave que protege, así que compararla con la que está en uso no abre nada.
| Qué encuentra | Qué hace |
|---|---|
| El artefacto protege la clave en uso | Lo indica y lo deja intacto |
| El artefacto protege una clave distinta | Avisa con claridad. Lo más habitual es que pertenezca a una instancia anterior con el mismo nombre, y restaurar desde él recuperaría un clúster incapaz de leer sus propios secretos |
| No hay artefacto | Escribe uno, si usted pasó --escrow-passphrase-file (o fijó DCCTL_ESCROW_PASSPHRASE). Si no, avisa de que la única copia de la clave raíz está dentro del clúster |
Así es como una instancia creada al principio con --no-escrow obtiene un depósito más tarde.
Ninguno de esos desenlaces hace fallar la actualización: un problema de depósito trata de un
desastre futuro y la actualización que tiene delante trata de la instancia en funcionamiento, y
un operador que no puede actualizar rodeará la comprobación en lugar de arreglarla.
helm upgradeEl procedimiento era: volcar a un archivo los valores de la versión desplegada actual con helm get values, volver a pasarlos con -f junto a la nueva etiqueta de imagen, borrar el archivo
porque contenía sus secretos, y después mover el operador por separado.
Ese baile existía únicamente porque la versión desplegada de Helm era donde vivían las
credenciales generadas de la instancia, y Helm parte de los valores predeterminados del chart
en cuanto se le pasa cualquier valor —de modo que una actualización que no las trasladara a
mano las perdía. Ahora dcctl es el dueño del documento de configuración, la versión desplegada
ya no contiene esas credenciales, y el paso que le decía que escribiera sus secretos en un
archivo simplemente desaparece.
El hueco que aquella forma dejaba abierto era una actualización que se detenía tras la mitad
de helm: dejaba los servicios nuevos ejecutándose contra el controlador con el que se arrancó
la instancia por primera vez, indefinidamente y sin ningún error que lo indicara. Eso es lo que
cierra el rechazo descrito más arriba: los dos comandos siguen siendo dos, porque el operador
pertenece al clúster y la versión desplegada pertenece a la instancia, pero dcctl upgrade
lee ahora qué operador lleva el clúster y lo dice: rechaza cuando puede distinguirlos, y avisa
cuando no puede.
Lo que hace que el despliegue sea seguro:
- Aumentar antes de terminar. Los Deployments usan por defecto una estrategia
RollingUpdateconmaxUnavailable: 0ymaxSurge: 1, de modo que un pod nuevo debe pasar su sonda de disponibilidad/readyzantes de que se elimine un pod antiguo, y la capacidad nunca disminuye durante el despliegue. Cuatro áreas se distribuyen en cambio constrategy: Recreatey una sola réplica, porque solo uno de sus pods puede servir a la vez:event-processing(el motor de reglas es un escritor único),mcp(la sesión de un cliente vive en el pod que la abrió),sparkplug-ingest(un Sparkplug Host por pod) ylwm2m-ingest(un socket CoAP/UDP por pod). En ellas, todos los pods antiguos se detienen antes de que arranque el nuevo, así que un despliegue tiene una breve brecha por diseño; y el chart rechazaRecreatecon más de una réplica. - Apagado ordenado / drenaje de conexiones. Cuando se le pide a un pod que termine, primero
informa "no listo" (de modo que el Service deje de enrutarle nuevas solicitudes), espera una breve
ventana de drenaje para que ese cambio se propague, y solo entonces termina el trabajo en curso y
se apaga. Configure la ventana con
shutdownDrainSeconds(por defecto5), mantenida de forma segura por debajo determinationGracePeriodSeconds(por defecto30). Ambos forman un único presupuesto y los servicios lo verifican: el drenaje puede ocupar como máximo la mitad del período de gracia, porque la ventana solo espera — terminar las solicitudes en curso, drenar los consumidores del bróker y cerrar el pool de base de datos ocurren después de ella, y el kubelet envía SIGKILL cuando el período de gracia expira, haya terminado eso o no. Una ventana mayor se rechaza al arrancar el servicio (y endcctl bootstrap, antes de instalar nada), en lugar de descubrirse cuando un pod ya se está apagando. PongashutdownDrainSeconds: 0para omitir el drenaje por completo, lo que encaja con una ejecución de una sola instancia sin ningún Service del que retirarse. - Migraciones de esquema coordinadas. Los servicios ejecutan migraciones de base de datos bajo un bloqueo a nivel de base de datos, de modo que cuando varias réplicas se inician a la vez, exactamente una aplica las migraciones y el resto espera; sin condiciones de carrera, sin DDL duplicado.
Para seguir sirviendo durante un despliegue, ejecute replicas: 2 (o más) para cada área que
pueda servir desde más de un pod, de modo que el despliegue siempre tenga un pod activo sirviendo tráfico.
Una sola réplica igualmente tiene una breve brecha mientras se reemplaza su único pod.
Configúrelo globalmente con --set replicas=2, o por área bajo
functionalAreas.<area>.replicas. Las cuatro áreas de un solo pod mencionadas arriba son la excepción:
mcp, sparkplug-ingest y lwm2m-ingest rechazan más de una réplica con cualquier estrategia, y
event-processing acepta una segunda réplica solo como reserva en caliente, con strategy: RollingUpdate
configurada junto a ella; en cualquier otro caso el renderizado falla y explica por qué. Un
PodDisruptionBudget se genera automáticamente para cualquier área con más de una réplica, de modo que
los drenajes de nodo no puedan expulsar a todas las réplicas a la vez.
Los techos de tasa los aplica cada réplica por separado, de modo que dos réplicas de event-sources,
outbound-connectors o ai-inference pueden admitir hasta el doble del techo de un inquilino. Consulte
Gobernanza.
El formato de los eventos en el bróker
Cada evento que envía un dispositivo cruza el bróker dos veces como mensaje en un flujo retenido:
una vez tal como se recibió, y otra resuelto contra su dispositivo.
infrastructure.messaging.wireFormat en la configuración de la instancia define cómo se codifican
esos mensajes:
| Valor | Codificación |
|---|---|
compact | El valor por defecto desde v0.24.0. Cada instante como un recuento de nanosegundos y el sello de cada credencial de dispositivo en binario. Alrededor de un tercio más pequeño por mensaje, lo que significa menos disco, red y retención del bróker por evento. |
legacy | Cada instante como texto y cada sello en su forma de texto, byte a byte lo que escribían v0.22.0 y anteriores. v0.23.0 lo escribe por defecto. |
Cualquier otro valor, incluido Compact, se rechaza: el servicio no arranca y su registro nombra
la clave. Forma parte de la configuración montada, como el
nivel de registro, y se establece de la misma forma.
- Todas las versiones desde
v0.23.0leen ambos. Los mensajes escritos en la formalegacyantes de una actualización siguen en los flujos retenidos y se leen como antes, incluida la vista previa de repetición de una regla de detección sobre una ventana que empezó antes de la actualización. - Actualice pasando por
v0.23.0, no directamente desdev0.22.0o anteriores.v0.22.0y anteriores solo leenlegacy: un servicio en una de ellas descarta un mensajecompact, o lo aparta como fallido, así que una actualización gradual desde una de ellas directamente a una versión que escribecompactpierde los eventos escritos mientras los pods antiguos y nuevos funcionan a la vez. Actualice primero cada instancia av0.23.0, espere a que todos los pods la ejecuten y solo entonces actualice a la versión posterior. En una instalación con el chart puede, en su lugar, establecerlegacypara la actualización y quitarlo cuando todos los pods se hayan renovado.dcctlno tiene opción para establecerlo. - Volver atrás a
v0.23.0no requiere nada en cuanto al formato: lee los mensajescompactque escribió una versión posterior. - Volver atrás a
v0.22.0o anterior requiere establecerlegacyprimero, y que los consumidores hayan vaciado de los flujos todo mensajecompact.
Sobres de eventos
Un sobre de eventos lleva varios eventos de un mismo tenant en un único mensaje del flujo
resolved-events (y, para los eventos tal como se recibieron, del flujo inbound-events), en lugar de
un mensaje por evento. Reduce el trabajo que hace el bróker por evento. Lo activan dos ajustes, y
ambos están desactivados por defecto: infrastructure.messaging.envelopes.resolved
(device-management escribe los eventos resueltos como sobres) e
infrastructure.messaging.envelopes.inbound (event-sources escribe los eventos de entrada como
sobres, esperando como máximo inboundLingerMillis, 5 por defecto y 10 como máximo, a un segundo
evento de un tenant con mucho tráfico). Se establecen en un archivo de valores bajo
instance.config.infrastructure.messaging.envelopes; consulte Ajustar una instancia.
Leer no es un interruptor: desde v1.1.0 todos los servicios leen sobres y mensajes de un solo
evento por igual, sean cuales sean los valores; los valores solo deciden si un servicio los
escribe. Todas las reglas siguientes valen para cualquiera de los dos y para ambos.
- Cuándo es seguro activarlo. Cuando todos los pods de la instancia ejecutan
v1.1.0o posterior, y no antes. Un pod de una versión anterior no puede leer un sobre y lo aparta como fallido, y los eventos que contiene se pierden para ese pod. Actualice primero, espere a que todos los pods se hayan renovado y entonces establezca el valor. - Qué hace el motor de detección con un duplicado. En casos raros, como una confirmación
perdida durante un reintento, un evento llega dos veces al flujo. El almacenamiento de eventos y
el estado de los dispositivos ya lo absorben. Con el valor activado, el motor de detección
también recuerda la identidad de cada evento que aplicó durante los últimos diez minutos
aproximadamente de tiempo del bróker (el intervalo de reentrega de la propia plataforma), omite
una segunda copia y la cuenta en
detect_duplicate_events_skipped_total. Una tasa sostenida distinta de cero significa que algo aguas arriba está almacenando eventos dos veces. Con el valor desactivado el motor de detección no guarda esa memoria y su coste y comportamiento no cambian. La identidad es la que usa el almacenamiento de eventos, de modo que dos lecturas idénticas de un mismo dispositivo en el mismo nanosegundo se cuentan una sola vez en ambos. - Qué cuesta. Con unos 20 000 eventos por segundo la memoria guarda unos 12 millones de
identidades, unos 540 MB (extrapolado), solo en el líder de detección (un suplente la construye
al asumir el cargo). Medido, añadió unos 190 MB con 6 000 eventos por segundo y unos 300 MB con
12 000, aproximadamente 45 a 55 bytes por identidad; con 5 000 eventos por segundo, calcule unos
150 MB. Con un ajuste activado, dimensione
event-processingcomo se describe en Dimensionamiento de los servicios. Por encima de unos 25 000 eventos por segundo se aplica un tope y la memoria cubre menos de diez minutos (unos 2,7 minutos con 100 000 por segundo). Tras un reinicio o un cambio de líder, el motor de detección vuelve a leer los últimos diez minutos del flujo antes de continuar, así que ese paso tarda más en un flujo con mucho tráfico; se informa endetect_guard_prime_secondsydetect_guard_prime_events_total, ydetect_guard_prime_partial_totalcuenta las veces que el flujo ya no llegaba tan atrás. - Qué no cubre. Una copia que llega más de diez minutos después de la primera, por ejemplo cuando se recrea un consumidor de entrada y vuelve a entregar desde su inicio, el motor de detección la aplica una segunda vez, lo que puede contarla dos veces en una regla de conteo o de ventana.
- Desactivarlo. Establezca el valor en
false. Los sobres que ya están en el flujo permanecen hasta que caducan o se consumen, y se siguen leyendo. - Pasar a una versión anterior a
v1.1.0.dcctl upgraderegistra cuándo se activa el valor y, cuando se desactiva, registra la posición del mensaje más reciente de los flujos de entrada y resuelto. Pasar a una versión anterior av1.1.0se rechaza mientras el valor esté activado, mientras alguno de los flujos conserve un mensaje anterior a la desactivación, mientras falte el registro de cuándo se desactivó (ejecutedcctl upgradeuna vez más en la versión actual para crearlo) y cuando se encuentra un sobre en una muestra de los flujos (el mensaje retenido más antiguo y los 256 más recientes de cada uno, lo que también detecta un valor cambiado fuera dedcctl). También se niega cuando no puede comprobarlo o cuando el destino no es una etiqueta de versión. Una ejecución que no cambia de versión nunca se rechaza.--allow-envelope-downgradeomite el rechazo con una advertencia: un servicio de la versión anterior aparta un sobre como fallido y los eventos que contiene se pierden para ese servicio.
Actualizar desde una versión anterior
Una instancia inicializada con la v0.16.0, o con cualquier versión anterior, no puede actualizarse a una versión posterior. dcctl upgrade se niega en lugar de intentarlo, y esa negativa no cambia nada: la release de Helm, el operador y todas las filas quedan como estaban. Lo mismo vale para las dos versiones anteriores a las que no se podía llegar in situ, la v0.9.0 (la cadena de migraciones de cada servicio sustituida por una única línea base congelada) y la v0.10.0 (una clave primaria nueva en las tablas de eventos): una instancia tan antigua como para necesitar cualquiera de las dos queda por debajo de este límite.
dcctl bootstrap registra una declaración, un objeto de alcance de clúster que dice qué es la instancia: su perfil, su topología, cómo se expone y qué áreas funcionales ejecuta. dcctl upgrade la lee para saber qué desplegar. Las versiones hasta la v0.16.0 incluida no escribían ninguna, así que no hay nada que leer, y la negativa lo dice:
instance "devicechain" IS in this cluster — named by the DeviceChain Helm releases in this
cluster — and it carries no declaration, so it was built by a release older than the one
that began recording them.
No hay ninguna capa de compatibilidad, y antes de la v1.0.0 no la habrá: una declaración inventada a posteriori sería una conjetura aplicada sobre una instancia en funcionamiento. Si una versión posterior sube este límite, sus notas lo indican.
Para pasar a una versión posterior, recree la instancia y el clúster que la contiene:
# Exporte antes lo que necesite: esto descarta las bases de datos.
dcctl destroy local devicechain --without-state # elimina la instancia; el clúster antiguo va después
kind delete cluster --name devicechain # y el clúster que preparó la versión anterior
dcctl install local # prepara un clúster nuevo
dcctl bootstrap local devicechain
Para un clúster al que se accede con --kube-context, que dcctl nunca elimina, pase ese --kube-context también a destroy, recree el clúster con lo que lo creó y páselo además a install y bootstrap. dcctl upgrade imprime esta receta cuando se niega.
Ahora dcctl guarda su estado local en ~/.devicechain/instances/<instance>/. Las versiones anteriores lo guardaban en ~/.devicechain/<instance>/, que el nuevo dcctl no lee, no lista ni elimina, de modo que destroy deduce el clúster a partir del nombre de la instancia y necesita --without-state. Cuando la instancia ya no exista, elimine usted mismo ese directorio antiguo (rm -rf ~/.devicechain/<instance>; contiene el estado de la infraestructura en texto claro) y no toque ~/.devicechain/escrow/: allí vive el artefacto de custodia de la clave raíz, que sigue abriendo las copias de seguridad de la base de datos de esa instancia (Recuperación ante desastres).
La protección de destrucción protege las bases de datos frente a una
operación corriente de helm, no frente a un dcctl destroy deliberado. Si la instancia
contiene telemetría, definiciones de dispositivos o paneles que le importan, vuélquelos antes
de empezar.
Cuando esté en una versión que registra una declaración, las actualizaciones normales in situ se reanudan.
Versiones recientes
Las tres versiones menores más recientes (v1.4, v1.3 y v1.2) se documentan completas, de la más nueva a la más antigua. También se conservan más abajo las notas detalladas de v0.27.0 a v0.24.0.
v1.4.0 — downlinks LoRaWAN confirmados, la carga útil propia de un dispositivo por MQTT y notificaciones que nombran el dispositivo
v1.4.0 es una actualización in situ desde v1.3.0: dcctl install para el clúster y después un dcctl upgrade por cada instancia, como se describe para v0.17.0. Usa el dcctl de la nueva versión para ambos comandos, y pasa a dcctl install los ajustes con los que se instaló el clúster, como --cluster, --kube-context, --ha, --compact y --database-node-selector, además de --version. Durante la actualización se ejecutan diez migraciones añadidas (dos en device-management, cuatro en notification-management, dos en outbound-connectors y dos en user-management); agregan tablas y columnas. La migración de la marca de tiempo de notificación al despejar también fija notify_on_clear_since = updated_at donde notify_on_clear es true y notify_on_clear_since IS NULL. Consulta Cambios de esquema y vuelta atrás. Si vienes de v1.2.0 o anterior, lee primero las notas de v1.3.0 y síguelas con --version v1.4.0.
dcctl install local --version v1.4.0
dcctl upgrade local devicechain --version v1.4.0 --dry-run
dcctl upgrade local devicechain --version v1.4.0
Se aplica la política de versiones y actualización. Esta versión amplía las interfaces cubiertas (nuevos campos, operaciones y valores de enumeración GraphQL, un nuevo tema MQTT, nuevas banderas de dcctl y un nuevo --size) y no elimina ninguna. Las nuevas operaciones de propuesta y aprobación de agentes están en el nivel de vista previa, donde todavía pueden cambiar en una versión menor; las notas de la versión indicarán entonces qué cambió. Los valores de Helm que añade esta versión no están cubiertos por la política de compatibilidad, y cada uno está desactivado, o conserva el comportamiento de v1.3.0, por defecto.
Novedades:
dcctlrechaza las actualizaciones en el orden equivocado. Consulta Se exige el orden de actualización.- Las audiencias de tokens ya no pueden fijarse en
observe, como anunciaban las notas dev1.3.0. Consulta Las audiencias de tokens ya no pueden fijarse en observe. - Una política de notificación puede avisar cuando se despeja una alarma, y las notificaciones de alarma nombran el dispositivo y pueden enlazar con él. Consulta Notificaciones que nombran el dispositivo.
- Un dispositivo puede publicar su propia carga útil por su conexión MQTT para el decodificador de su perfil, y el fragmento de conexión de la consola puede mostrarlo. Requiere activación. Consulta La carga útil propia de un dispositivo por MQTT.
- Los comandos LoRaWAN se pueden confirmar, en ChirpStack v4 y The Things Stack v3, y una definición de comando puede llevar un codificador declarativo de carga útil. Consulta Downlinks LoRaWAN confirmados.
- La medición de ingesta puede compensar el retraso causado por una pausa de la plataforma. Requiere activación. Consulta Medición de ingesta con crédito por retraso.
- Un tamaño
perf-16k, correcciones deperf-12ky un ajuste relacional demax_wal_size. Consulta Dimensionamiento. - Acciones de agentes, en vista previa. Un agente de IA puede proponer reconocer o despejar alarmas, y las personas aprueban desde sus propias sesiones. La aprobación final ejecuta un ACK o CLEAR de alarma. Consulta Acciones de agentes (vista previa).
- Una forma admitida de acceder desde un clúster local a un servicio de tu propia máquina:
--dev-allow-egress. Consulta Tráfico saliente en desarrollo local. - La página de paneles de Grafana tiene capturas de los ocho paneles, y los paneles cuentan los mensajes en tránsito. Consulta Otros cambios en esta versión.
Antes de actualizar
Lo que exige actuar, en el orden en que hacerlo:
- Elimina
infrastructure.tokenAudience.enforcement: observeantes de actualizar, si tu instancia lo fija en algún sitio. Un servicio se niega a arrancar con este valor ydcctl upgradese niega antes de cambiar nada. Consulta Las audiencias de tokens ya no pueden fijarse en observe. - Ejecuta siempre
dcctl installcon eldcctlde la nueva versión antes dedcctl upgrade.dcctl upgradelee ahora el registro de instalación del clúster y se niega, antes de escribir nada, si eldcctlque terminó por última vezdcctl installes anterior al que actualiza, si una instalación comenzó y nunca terminó o si falta el registro. Esto incluye una versión de parche: undcctl upgradesin banderas con una versión de parche más reciente dedcctlnecesita primero undcctl installcon esedcctl. Undcctl upgradesin banderas, que vuelve a aplicar la versión declarada de la instancia, también se rechaza si esa versión es más reciente que eldcctlque ejecutas. Consulta Se exige el orden de actualización. - Un
--versionexplícito debe ser la versión de tu propiodcctl, tanto parainstallcomo paraupgrade. Para pasar a otra versión, usa eldcctlde esa versión. No afecta a una etiqueta de registro personalizado, a--buildni aenable-area. - Activa las nuevas funciones opcionales solo cuando termine el despliegue, y cada una en una actualización propia. Cada una está desactivada por defecto, y un pod de
v1.3.0que sigue en marcha no la conoce:- Fija
infrastructure.nats.mqttDeviceUplinksen una actualización propia, una vez instaladav1.4.0. Consulta La carga útil propia de un dispositivo por MQTT para saber qué hace un pod anterior con ella: uno que se reinicia mientras está activo se detiene al arrancar. - Fija
agentActuation.enableden una actualización aparte, una vez terminado el despliegue dev1.4.0. Consulta Acciones de agentes (vista previa). - Fija
eventSources.ingestMetering: lagCreditsolo cuando todos los pods deevent-sourcesseanv1.4.0. Consulta Medición de ingesta con crédito por retraso. - Activa el downlink LoRaWAN (
functionalAreas.outbound-connectors.config.lpwanDownlink.enabled) solo tras el despliegue, si aún no está activo: un podv1.3.0deevent-sourcesque se reinicie mientras está activo se detiene ante la clave de configuración quev1.4.0deriva de él. - Usa
--dev-allow-egresssolo tras el despliegue: una entrada añadeinfrastructure.egress.devAllowedDestinationsa la configuración de la instancia, que un podv1.3.0que se reinicie rechaza. Consulta Salida para desarrollo local.
- Fija
- Si el downlink LoRaWAN ya está activado (
functionalAreas.outbound-connectors.config.lpwanDownlink.enabled), un pod deevent-sourcesdev1.3.0que se reinicia durante el despliegue se detiene conunknown field "lpwanDownlink".v1.4.0añade esa clave a la configuración que recibeevent-sources(la deriva el chart; no se fija a mano), y un pod dev1.3.0rechaza una clave que no conoce. Un pod que no se reinicia no se ve afectado, y el despliegue sustituye uno detenido por un pod dev1.4.0, que arranca. Con el downlink desactivado, como está por defecto, nada cambia paraevent-sources. - Comprueba
linkBaseUrlen los canales webhook genérico, Slack, Teams y PagerDuty. Ahora se valida al guardar el canal (se rechaza una consulta o un fragmento), y un valor no válido almacenado omite los enlaces al entregar tras la actualización, pero la notificación se sigue enviando. Consulta Notificaciones que nombran el dispositivo. - Cambia los identificadores OAuth que empiecen por
dcsa_(sin distinguir mayúsculas), incluida la configuración precargada. El prefijo identifica cuentas de servicio y puede colisionar con la lista de clientes de la política de agentes. Consulta Comprobaciones más estrictas de operaciones existentes. - Si una instancia está registrada con
--size perf-12k, espera dos cambios en las especificaciones de los pods en su próximodcctl upgrade:device-managementsolicita 400m de CPU (antes 500m), yevent-sourcestiene un límite de memoria de 256Mi (antes 512Mi). Los pods se reinician como en cualquier despliegue. Consulta Dimensionamiento. - En una primera conexión admitida sin conocer el estado OCSP, espera que
devicechain_devicemanagement_x509_ocsp_unavailable_allowed_totalsuba uno, en lugar de dos. La primera conexión de un dispositivo ejecutaba el paso OCSP dos veces y contaba ambas; la serie cuenta conexiones, como dice su texto de ayuda, y ahora lo hace. Las decisiones de admisión y rechazo, el nombre y las etiquetas no cambian. Vuelve a ajustar la referencia de un panel o una alerta que hayas calibrado con el ritmo duplicado. - Revisa los scripts frente a las comprobaciones más estrictas siguientes, incluidos los comandos LoRaWAN en bruto y los tiempos de espera de consulta del decodificador HTTP.
Valores de Helm y ajustes de dcctl nuevos, cada uno desactivado o sin cambios por defecto:
| Valor | Por defecto | Función |
|---|---|---|
eventSources.ingestMetering | legacy | lagCredit selecciona el control con crédito por retraso. Se renderiza como variable de entorno en los pods de event-sources. |
instance.config.infrastructure.nats.mqttDeviceUplinks | false | Permite a cada dispositivo publicar en su propio tema de uplink y añade el subject de uplink al stream de captura. Se configura con dcctl --values. |
agentActuation.enabled bajo functionalAreas.user-management.config | false | Interruptor de instancia para acciones de agentes, el primero de tres. Es una clave del documento de configuración, no un valor por defecto de values.yaml; ausente significa desactivado. |
postgres_max_wal_size_mib (variable OpenTofu de la raíz del clúster) | 0 | max_wal_size del almacén relacional; 0 conserva el valor por defecto de PostgreSQL de 1 GB. |
Se exige el orden de actualización
Un dcctl install --version o dcctl upgrade --version explícito ahora rechaza una versión publicada distinta, anterior o posterior, a la del dcctl en ejecución. Una actualización sin banderas conserva la versión declarada, pero rechaza una declaración posterior a la herramienta. Usa el dcctl de la versión de destino, ejecuta dcctl install con los ajustes del clúster y después actualiza cada instancia. El binario y la versión que instala deben coincidir para que la herramienta conozca sus migraciones y su orden.
dcctl upgrade también exige un registro de instalación completada por un dcctl al menos tan reciente como él mismo. Un registro ausente o ilegible, una instalación sin terminar o una instalación completada más antigua se rechazan antes de escribir. Los scripts que antes omitían la instalación deben ejecutarla primero, incluso para un parche.
Esta versión también admite -i / --instance en los comandos que hablan con la API de la plataforma (events failed, attr, dead-letters, presence, product, tenant-deletion, test y device register). Sin --server, --instance usa el host y el ajuste TLS de la declaración; un --server o --tls explícito tiene prioridad.
Comprobaciones más estrictas de operaciones existentes
- Identificadores de clientes OAuth. Al guardar y en la configuración precargada se rechaza ahora el prefijo
dcsa_, sin distinguir mayúsculas. Cambia esos identificadores: el prefijo identifica cuentas de servicio, incluidas las de agentes, y podría confundirse con una o colisionar con la lista de clientes de la política. - Enlaces de notificaciones. Guardar un canal webhook genérico, Slack, Teams o PagerDuty rechaza ahora un
linkBaseUrlcon consulta o fragmento. Elimínalos de la URL base: los enlaces se construyen añadiendo una ruta. Una URL base no válida almacenada omite los enlaces al entregar; la notificación se sigue enviando. - Envío LoRaWAN. Cada envío lee ahora el vocabulario de comandos publicado y el codificador, incluidos los comandos en bruto sin codificador. Un fallo de consulta deja la entrega pendiente de reintento; un comando definitivamente ausente de un vocabulario restringido se rechaza como no enviado. Mantén publicada la definición y restablece la consulta. Un comando pendiente usa el codificador vigente al enviarse, nunca uno almacenado al ponerse en cola.
- Consulta del decodificador HTTP del dispositivo. La cancelación del solicitante deja ahora de esperar la consulta. La consulta compartida al backend continúa para llenar la caché, pero tiene un límite propio de 10 segundos para no ejecutarse indefinidamente. Los scripts pueden ver una cancelación anterior o un fallo de consulta reintentable; reintenta este último en vez de interpretarlo como ausencia de decodificador.
Las audiencias de tokens ya no pueden fijarse en observe
Las notas de v1.3.0 lo anunciaban. infrastructure.tokenAudience.enforcement: observe, aceptado en v1.2.0 y v1.3.0 para desactivar la aplicación obligatoria, se rechaza:
- Un servicio se detiene al arrancar, indicando la clave, si la configuración de la instancia la fija.
- El esquema de valores del chart lo rechaza, tanto en los valores de Helm como en un archivo de superposición de valores de
dcctl. dcctl upgradese niega antes de cambiar nada si la superposición registrada en la instancia, los valores con los que se instala la versión o el documento deinstance.existingSecretaún lo fijan.
Elimina la clave (sin definir significa enforce) o fíjala en enforce, y después actualiza. En una instancia gestionada por dcctl cuya superposición registrada la fija, ejecuta dcctl upgrade con --reset-values, o con --values <file without the key>; una ejecución sin ninguno de los dos se rechaza, indicando esos dos comandos. Si proporcionas el documento tú mismo (instance.existingSecret), elimina la clave de tu documento antes de ejecutar helm upgrade, porque los servicios la rechazan al arrancar y un helm upgrade corriente no puede mirar dentro de tu Secret; actualiza también instance.existingSecretChecksum. Antes de actualizar, comprueba que {__name__=~"devicechain_[a-z0-9]+_token_audience_checks_total", verdict="would_reject"} y devicechain_usermanagement_oauth_resource_checks_total{verdict="would_reject"} no muestren nuevos incrementos durante un período de tráfico representativo en la instancia v1.3, o los clientes que representan serán rechazados. La serie would_reject y las alertas TokenAudienceWouldReject y OAuthResourceWouldReject se mantienen por compatibilidad y ya no pueden activarse. unscopedClientCredentials no cambia.
Notificaciones que nombran el dispositivo
notifyOnClear. Una política puede notificar cuando se despeja una alarma que anunció; la opción está desactivada por defecto. El aviso solo va a canales y destinatarios que entregaron una notificación en ese ciclo. Las horas de silencio descartan el aviso de despeje en lugar de retenerlo. Tras reclamarlo se entrega como máximo una vez: una caída entre reclamar y enviar puede perderlo. Los reintentos de recogida fallida esperan dos minutos y terminan 30 minutos después del despeje.- Las notificaciones nombran el dispositivo. Los payloads webhook llevan
deviceToken,deviceNameydeviceTypeTokencuando se conocen. Los resúmenes de Slack, Teams, PagerDuty y correo muestran el nombre del dispositivo; eltextdel webhook genérico nombra el dispositivo por su token, y el nombre que escribe el dispositivo solo está en el campo estructuradodeviceName, de modo que un nombre no puede inyectar marcado en una herramienta de chat que muestretext. Para publicar en Slack, usa el canal nativo de Slack en lugar de un webhook genérico. Las renotificaciones temporizadas y los despejes tardíos usan el origen almacenado; las filas antiguas sin él omiten esos campos. Se incluyenoriginatorTypeyoriginatorIdcuando se conocen. - Enlaces. Los canales webhook genérico, Slack, Teams y PagerDuty pueden fijar
linkBaseUrl. Los payloads webhook genéricos añadenalarmUrly, si se conoce el dispositivo,deviceUrl; los mensajes nativos pueden enlazar al dispositivo. Consulta Comprobaciones más estrictas de operaciones existentes antes de guardar un canal existente. - Texto. Se escapan los caracteres de control de Slack (
&,<,>) y se neutralizan las menciones y enlaces de Teams en el texto escrito por dispositivos o inquilinos. Los nombres de los resúmenes se reducen a una línea y a 120 caracteres; los payloads estructurados conservan el nombre almacenado. Los asuntos de correo no ASCII se codifican según RFC 2047; los ASCII no cambian.
La carga útil propia de un dispositivo por MQTT
Un dispositivo puede publicar sus propios bytes en {instance}/{tenant}/devices/{device}/uplink y el decodificador del perfil de su tipo de dispositivo los convierte en eventos, la misma capacidad que ofrecía la ruta HTTP uplink en v1.3.0. El dispositivo se autentica al conectar y su concesión firmada nombra solo su propio tema de uplink, así que una carga útil nunca puede decodificarse como si fuera de otro dispositivo. Una carga útil en events sigue sin ser leída nunca por un decodificador.
Requiere activación: con infrastructure.nats.mqttDeviceUplinks desactivado, como está por defecto, la concesión es exactamente la que emitían las versiones anteriores y el broker rechaza publicar en el tema. Los errores terminales de procesamiento de la carga útil se registran como decodificaciones fallidas con su causa y se cuentan en la nueva devicechain_eventsources_device_uplink_messages_total{result}; los descartes por límite de tasa se confirman por separado, y los de la etapa de mensajes no pasan por este contador. También hay una nueva consulta del plano de servicio, brokerAssertedDeviceDecoder.
Actívalo en una actualización propia, una vez instalada v1.4.0. Activarlo también hace que el stream de captura declare el subject de uplink. mqttDeviceUplinks es una clave del documento de configuración compartido de la instancia, así que mientras está activado, un pod de v1.3.0 de cualquier área que arranque o se reinicie se detiene al arrancar con unknown field "mqttDeviceUplinks", antes de cualquier comprobación del stream. Un pod de v1.3.0 que no se reinicia sigue en marcha, con estos efectos: un pod de event-sources que ya está en marcha confirma y descarta un subject ajeno a sus dos, así que una carga útil en bruto que le llegue se pierde; y un pod de device-management rechaza el uplink que no puede ubicar, que se vuelve a entregar. Con él desactivado, el stream de captura es exactamente el que declara v1.3.0, así que no afecta a un pod que se reinicie a mitad del despliegue. Las concesiones de publicación existentes persisten hasta la reconexión o la caducidad del token de sesión, pero desactivar el ajuste elimina los uplinks de la captura durante la reconciliación, por lo que seguir publicando puede perder cargas útiles.
Con dcctl, fíjalo en un archivo de superposición --values: instance.config.infrastructure.nats.mqttDeviceUplinks: true; las actualizaciones posteriores lo conservan. Consulta la guía de decodificadores de carga útil y la Referencia del protocolo de dispositivos. La pestaña Enviar datos de un dispositivo en la consola ofrece ahora una opción Carga útil en bruto junto al JSON de eventos, con el curl de la ruta HTTP y el mosquitto_pub del tema. No puede ver si el operador ha activado alguno de los dos, así que cada comando indica el ajuste que necesita.
Downlinks LoRaWAN confirmados
- ChirpStack v4. Un comando con
"confirmed": truepermanece enSENThasta que el servidor de red lo resuelve, en lugar de responderse al poner el downlink en cola. Los eventosackytxackde ChirpStack llegan a la URL de integración entrante ya configurada para los uplinks. Una confirmación resuelve el comando comoSUCCESSFUL; un tiempo de espera de confirmación agotado sin confirmación, o no recibir nada antes del plazo, lo resuelve comoTIMEOUTcon entrega desconocida, nunca «no entregado», porque el dispositivo puede haberlo recibido. El plazo es el primero entre la caducidad del comando y las 24 horas desde su puesta en cola. Un evento que no puede asociarse a un downlink pendiente por el identificador del elemento de cola, la integración y el DevEUI se descarta y se cuenta endevicechain_outboundconnectors_lpwan_ack_reports_total, nunca se asocia por conjetura. - The Things Stack v3. El downlink también llega a dispositivos detrás de un servidor de red The Things Stack v3. Crea un conector
lorawan_downlinkconnetworkServer: "tts_v3"y el identificador de la aplicación; el dispositivo necesita un aliastts.device-id. Los downlinks confirmados se resuelven a partir de los eventos webhookdownlink_ack,downlink_nack,downlink_sentydownlink_failed, que debes activar en el webhook de la aplicación con rutas que empiecen pordownlink(por ejemplo,/downlink-ack). Un fallo solo da un resultado definitivo de no entregado si demuestra que la trama nunca se transmitió; los fallos inciertos terminan enTIMEOUTcon entrega desconocida. - Un codificador de carga útil en una definición de comando. Una definición de comando puede llevar un
encoderdeclarativo opcional que convierte los parámetros tipados del comando en la carga útil de la aplicación, el reflejo de los decodificadores de uplink: unfPort, unconfirmedestático opcional y campos ordenados (bytes constantes, enteros de ancho fijo de 8, 16 o 32 bits en cualquiera de los dos órdenes de bytes conscaleyoffset, booleanos y campos de bits empaquetados). Se valida al crear o actualizar la definición y al publicar el perfil, así que un codificador incorrecto falla de forma explícita e indica el comando. Se permiten entradas fraccionarias cuando scale/offset produce un entero dentro del rango y de la tolerancia de coma flotante del codificador. Los valores fuera de esos límites, los valores ausentes y los tipos incorrectos hacen que se rechace el comando como no enviado. Una definición sin codificador conserva el contrato de hex o base64 en bruto. Un comando pendiente usa el codificador publicado vigente al enviarse, también tras una nueva publicación; cada envío vuelve a consultar el vocabulario. Un fallo de consulta aplaza la entrega para reintentar, en lugar de usar un codificador obsoleto. Consulta la guía de integraciones entrantes.
La función necesita functionalAreas.outbound-connectors.config.lpwanDownlink.enabled, como en v1.3.0. No envíes downlinks confirmados hasta que termine el despliegue, para que todos los pods de outbound-connectors lean el nuevo stream de confirmaciones. Un pod de v1.3.0 que sigue en marcha rechaza "confirmed": true y responde al comando como no enviado, así que no puede dejar un comando atascado; un pod que se detiene entre poner el downlink en cola y registrarlo deja el comando en SENT hasta que el barrido de caducidad lo resuelve como TIMEOUT. Para ChirpStack, los downlinks confirmados necesitan que la integración HTTP envíe ack (y, opcionalmente, txack) a la URL de integración; para The Things Stack, activa los eventos de downlink anteriores. Un informe del servidor de red que outbound-connectors no logra procesar en ningún intento de entrega no se registra como mensaje fallido (dead letter): su downlink se resuelve en el plazo, como se describe arriba.
Medición de ingesta con crédito por retraso
Tras una pausa breve de la plataforma (una pausa del broker de mensajes, un lector detenido, una etapa de decodificación lenta), el tráfico en cola de un inquilino que se mantuvo dentro de su techo se lee en una ráfaga, y la parte que no cabía en la cuota disponible se descartaba después de haber dicho al dispositivo que el mensaje había llegado. Un nuevo modo de medición elimina ese problema.
- Requiere activación y no es el valor por defecto.
eventSources.ingestMeteringsigue enlegacy, y seguirá así hasta que se haya medido el modo en un entorno de pruebas de kind y en una ronda en la nube. Ponlo enlagCreditpara usar el nuevo control, y de nuevo enlegacypara volver al anterior. Es un valor de Helm que se renderiza en los pods deevent-sourcescomo variable de entorno, así que un pod de una versión anterior nunca lo ve. Un valor no reconocido detiene el pod al arrancar. La actualización solo avanza. - Qué hace. El tráfico nuevo se sigue contando cuando lo lee el pod, pero la cuota de un inquilino crece con lo que su tasa acumula durante el retraso medido de los lectores, hasta el tiempo que cubre su ráfaga (nunca más de 5 segundos). A un inquilino que supera su techo se le sigue descartando el exceso, y una cola más antigua que esa cobertura se drena como antes.
- Qué no cambia. Los descartes por encima del techo, por una banda de sobrecarga o por el descarte estricto se cuentan en los contadores de límite de tasa existentes como antes. HTTP y las integraciones entrantes conservan sus límites. Los techos siguen siendo por réplica.
- Cómo mide. Cada réplica estima el desfase entre las marcas de anexado del broker y su propio reloj, y cuánto se retrasa cada lector, a partir de la información de entrega que el broker ya envía, y pregunta al broker unas cuatro veces por segundo si un stream sin actividad tiene algo en cola. Una réplica que arranca durante una pausa aún no ha medido el reloj del broker, así que durante los primeros momentos de esa pausa puede conceder menos crédito del debido.
- Métricas nuevas, vacías en modo
legacyy ninguna con una etiqueta de inquilino:devicechain_eventsources_ingest_shed_cause_total{stream,route,cause},devicechain_eventsources_ingest_lag_credit_seconds{stream},devicechain_eventsources_reader_lag_seconds{stream},devicechain_eventsources_append_skew_seconds{stream}ydevicechain_eventsources_append_skew_clamped_total{stream}. Alertas nuevas, sin activarse en modolegacy:IngestShedBeyondLagCrediteIngestAppendSkewLarge.
Dimensionamiento
perf-16kes un nuevo valor de--sizepara 16 000 eventos por segundo sostenidos: NATS solicita 6 CPU y 6Gi, el almacén de eventos tiene unmax_wal_sizede 40960 MiB en un volumen de 260Gi,event-processingusa 2 CPU y 1536Mi, y el volumen de JetStream es de 36Gi para la tasa de diseño. La configuración medida sostuvo 16 000 eventos por segundo sin pérdidas; 20 000 eventos por segundo se almacenan sin pérdidas, pero superan el objetivo de latencia, así que se documenta como techo de rendimiento y no hay unperf-20k. Los valores deperf-16kse derivan de la rampa medida y aún no se han ejecutado tal como están escritos; la página de dimensionamiento lo indica.- Se corrige
perf-12k:device-managementsolicita 400m de CPU (antes 500m) yevent-sourcestiene un límite de memoria de 256Mi (antes 512Mi, con un máximo medido de 81 MiB de memoria residente). Una instancia registrada conperf-12kincorpora ambos cambios en su próximodcctl upgrade. - Un
max_wal_sizerelacional. La nueva variable de OpenTofu en la raíz del clústerpostgres_max_wal_size_mib(por defecto0, que equivale al 1 GB propio de PostgreSQL, por lo que no cambia ninguna instalación existente) lo fija mediante la definición del clúster. El plan rechaza una asignación superior a la cuarta parte depostgres_storagecuando el almacenamiento se expresa como una cantidad entera en Mi, Gi o Ti; otros formatos omiten esta comprobación. El almacén relacional pertenece al clúster, así quedcctl bootstrap --sizeno lo escribe: indícalo al instalar conTF_VAR_postgres_max_wal_size_mib, con unTF_VAR_postgres_storagesuficientemente grande.dcctlno conserva este ajuste: undcctl installposterior sin él restablece el valor por defecto de PostgreSQL. Repítelo en cada instalación. La página de dimensionamiento indica el valor con el que se midió cada tamaño.
Consulta Dimensionamiento.
Acciones de agentes (vista previa)
Un agente de IA puede proponer reconocer o despejar alarmas. En esta vista previa, desactivada por defecto, la aprobación final ejecuta el ACK o CLEAR como la persona que aprueba, en una transacción de base de datos después de volver a consultar la política de agentes con las credenciales de esa persona. Si la alarma se activó de nuevo o se eliminó, cambiaron las dependencias o la política rechaza la acción (incluidos el interruptor del inquilino, el de instancia o la admisión del cliente), la propuesta termina REFUSED y no cambia ninguna alarma. Las filas de auditoría identifican a la persona que aprueba, en nombre de quién actúa y la propuesta. Las aprobaciones desde la consola también registran el cliente del agente; si el token de quien aprueba tiene su propio client_id, prevalece esa declaración. No hay modo automático. Consulta Propuestas y aprobaciones.
- Activa solo tras el despliegue. El interruptor de instancia
agentActuation.enabled, la suspensión por inquilino del operador y la política de agentes del inquilino controlan las decisiones.v1.3.0no tiene API de agentes, tablas de políticas ni operaciones de suspensión: las solicitudes de agentes fallan en esos pods y no se ejecuta nada. Los pods dev1.4.0respetan los interruptores. Activa el de instancia en una actualización separada cuando todos los pods seanv1.4.0. Quienes iniciaron sesión antes de la actualización deben volver a iniciarla antes de que su agente pueda proponer: un inicio de sesión anterior av1.4.0no lleva época de sesión, y una propuesta hecha con él se rechaza comoPROPOSER_SESSION_ENDED. Tras volver a iniciar sesión, el agente propone de nuevo. - Bandeja Approvals de la consola (vista previa). Las personas pueden listar propuestas, leer su detalle, aprobar o rechazar y usar el interruptor de emergencia del inquilino. Si se requiere autenticación reforzada, la consola ofrece iniciar sesión de nuevo y vuelve a la propuesta. La política, las propuestas y el estado local de decisión se restablecen al cambiar el inquilino, usuario o sesión. La confirmación de la aprobación final indica que, al aprobar, la acción se ejecuta en tu nombre, y la bandeja muestra después el resultado:
EXECUTEDcon el resultado,REFUSEDcon el motivo (incluidoDEPENDENCY_CHANGEDcuando las alarmas cambiaron) oCONCURRENT_APPROVALcuando otra persona está decidiendo la misma propuesta, tras lo cual se actualiza. Frente a un servidor que aún devuelve el código obsoletoEXECUTION_NOT_AVAILABLE, indica que la aprobación no se registró y que ninguna alarma cambió. - Se vuelven a comprobar las aprobaciones. Quien aprueba necesita el permiso de escritura de la acción, un rol aprobador y un segundo factor reciente. Las aprobaciones anteriores solo cuentan mientras sus autores sigan siendo aptos y su segundo factor siga vigente. Cambiar quién tiene un rol cambia qué aprobaciones cuentan.
- El interruptor de emergencia actúa en la siguiente decisión. Se acepta
setAgentActuation(enabled: false)incluso si no se puede leer o validar la política. Una decisión aún no alcanzada rechaza la ejecución si está apagado; una acción que ya pasó esa decisión puede completarse. El interruptor no deshace acciones ejecutadas. Reactivarlas requiere un segundo factor reciente. Es un control a nivel de aplicación. - Las otras acciones no se ejecutan. Solo las propuestas de ACK/CLEAR de alarma tienen una ruta de ejecución en esta vista previa; los comandos y despliegues no. Las herramientas MCP no ejecutan acciones.
- Vigencia del proponente. La plataforma vuelve a comprobar el inicio de sesión original y los permisos actuales. Un solicitante que no sea el proponente ni
agent:adminrecibe el motivo genéricoPROPOSER_NOT_IN_STANDING; los motivosPROPOSER_almacenados también se generalizan. - Los destinos de una propuesta deben ser tokens de alarma válidos.
proposeAlarmActionrechaza un destino que no sea un token bien formado, de modo que una propuesta almacenada no puede llevar texto libre que una lectura posterior presentaría como un identificador de la plataforma. - Obsolescencia. Ya no se devuelve
EXECUTION_NOT_AVAILABLEy queda obsoleto; permanece en el vocabulario.
Tráfico saliente en desarrollo local
dcctl bootstrap y dcctl upgrade aceptan --dev-allow-egress <address-or-CIDR> (repetible o separado por comas; none lo borra) para que un webhook o conector de un clúster local pueda acceder a un servicio de tu propia máquina o LAN. Se rechaza salvo que el contexto de Kubernetes empiece por kind- o k3d-, o sea minikube, docker-desktop o rancher-desktop (también con guion y sufijo de perfil). Es una clave aparte, infrastructure.egress.devAllowedDestinations, y el allowedDestinations del operador sigue sin poder ajustarse. Las direcciones de metadatos de la nube, los rangos de loopback, enlace local y multidifusión, y los demás rangos que nunca se permiten siguen bloqueados incluyas lo que incluyas, y una entrada que se solape con alguno hace fallar dcctl desde el principio. Se registra en la instancia para que las actualizaciones posteriores lo conserven, dcctl instances lo muestra como DEV EGRESS ALLOWED, y cada servicio que lo usa registra un aviso al arrancar. Consulta Conectores salientes. Configúralo solo cuando todos los pods sean v1.4.0: un pod v1.3.0 que se reinicie rechaza una configuración que incluya alguna entrada.
Otros cambios en esta versión
Nada de lo que aparece aquí requiere actuar.
- La página de paneles de Grafana tiene capturas de los ocho paneles de una instancia
v1.3.0bajo una carga sintética constante, con una interrupción programada mediante un script. - Los paneles de cola pendiente cuentan los mensajes en tránsito. El cálculo alternativo del broker cuenta juntos los mensajes en espera y los recogidos pero aún sin confirmar, así que los mensajes que recogió un lector reiniciado siguen contándose; se corrigieron los paneles de cola de ingesta, persistencia, estado de dispositivos, mensajería, entrega y procesamiento de eventos. Los indicadores de OOM de la plataforma y de entregas rechazadas o en horario de silencio muestran
0, en lugar de «Sin datos», mientras su servicio responsable está en marcha. - La recogida de despejes de notificación informa como parcial, en lugar de fallida, una pasada que entregó y después agotó su presupuesto, y cuenta una sola vez a un inquilino cuyas dos lecturas fallaron.
- Un fallo al eliminar el downlink pendiente de un inquilino eliminado se registra como
store_failed, y el barrido de confirmaciones descarta las filas de un inquilino eliminado antes de reclamarlas. - Paneles y alertas para las funciones de esta versión. Los paneles Ingest, Command Delivery y Delivery añaden paneles para los uplinks MQTT de dispositivos, los acuses y downlinks LoRaWAN, los informes de downlink de integraciones, la ingesta con crédito de retraso, OCSP y la recogida de despejes, y siete alertas nuevas tienen entradas en el runbook:
LpwanAckReportsAnomalous,LpwanAckSettlementFailing,LpwanDownlinkTrackingFailing,IntegrationDownlinkReportsDiscarded,DeviceUplinkMessagesFailing,X509OcspUnavailableAllowedandNotificationClearPickupFailing. - Una lectura de base de datos rechazada devuelve un error en lugar de un pánico por puntero nulo.
- Un token de agente ya no puede cambiar el nombre del perfil de una persona:
updateProfilerechaza los tokens de agente. - Compilado con Go 1.27.4. Los binarios e imágenes de
v1.4.0se compilan con Go 1.27.4, que corrige una vulnerabilidad ennet/httpde la biblioteca estándar.
Cambios de esquema y vuelta atrás
Las siguientes migraciones son aditivas y se añaden al final. Las columnas nuevas admiten nulos o tienen valores por defecto y las tablas nuevas empiezan vacías. Esto permite que coexistan pods durante la actualización; no es una vía de vuelta atrás.
- Política de agentes (
user-management, migración20261109120000). Dos tablas nuevas,iam_agent_policies(una fila de cabecera por inquilino) eiam_agent_policy_versions(versiones publicadas que solo se añaden), y la bandera de agente eniam_service_accounts. No se precarga ninguna fila: un inquilino sin política publicada tiene desactivada la actuación de agentes. - Interruptor de desactivación del inquilino (
user-management, migración20261109130000). Tres columnas eniam_agent_policies:tenant_actuation_off, que no admite nulos y tiene false como valor por defecto, yactuation_off_atyactuation_off_by, que admiten nulos.v1.3.0no tiene operaciones de políticas de agentes. - Propuestas de agentes (
device-management, migración20261125090000). Una tabla nueva,agent_proposals. - Codificador de comandos (
device-management, migración20261109000100). Una columna que admite nulos,encoder, en las definiciones de comandos. - Notificar al despejar (
notification-management, migraciones20261109000100,20261109000200y20261110000100). Una columnanotify_on_clearcon valor por defecto false en las políticas, columnas por ciclo y un índice parcial en la tabla de estado, ynotify_on_clear_sinceque admite nulos en las políticas, fijada enupdated_atsolo dondenotify_on_cleares true ynotify_on_clear_since IS NULL. - Origen del estado de notificación (
notification-management, migración20261110000200). Seis columnas que admiten nulos en la tabla de estado:originator_type,originator_id,device_token,device_name,device_type_tokenysource_at. Sin rellenar filas existentes. - Confirmaciones pendientes (
outbound-connectors, migraciones20261109120000y20261110120000). Una tabla nueva,lpwan_pending_acks, y una columnadevice_refque admite nulos en ella.
La actualización solo avanza; no hay vuelta a v1.3.0. Una actualización fallida se repara ejecutando de nuevo dcctl upgrade con el dcctl de v1.4.0. Esa herramienta rechaza --version v1.3.0. Sigue la política de versiones y actualización.
Problemas conocidos
- Un downlink LoRaWAN confirmado sobre el que el servidor de red nunca informa se resuelve al llegar su plazo, como
TIMEOUTcon entrega desconocida. - Una escalada que ya hubiera ganado su reclamación antes de que se marcara un despeje aún puede entregarse después de él, y los destinos de una escalada registrados después de que se reclamara el despeje no reciben ningún despeje.
dcctl bootstrap --sizeno escribe elmax_wal_sizerelacional. Fíjalo al instalar y repítelo en cada instalación; una ejecución sin él restablece el valor por defecto de PostgreSQL.- Las propuestas distintas de ACK/CLEAR de alarma no se ejecutan, aunque se aprueben; las herramientas MCP no ejecutan acciones.
- El interruptor de emergencia no revierte una acción ejecutada. Actúa en la siguiente decisión; una acción que ya la haya pasado puede completarse.
v1.3.0 — los comandos llegan a dispositivos HTTP y LoRaWAN, y cada entrega deja constancia
v1.3.0 es una actualización in situ desde v1.2.0: dcctl install para el clúster y después un dcctl upgrade por cada instancia, como se describe para v0.17.0. Pasa a dcctl install los ajustes con los que se instaló el clúster, como --cluster, --kube-context, --ha, --compact y --database-node-selector, además de --version. Durante la actualización se ejecutan diez migraciones añadidas (cinco en device-management, dos en command-delivery, dos en event-management y una en notification-management), y el diario de auditoría de cada área gana cuatro columnas que admiten nulos; agregan tablas, columnas que admiten nulos e índices, y no cambian ninguna fila existente. Consulta Cambios de esquema y vuelta atrás. Ejecuta dcctl install antes de actualizar la instancia, como arriba: además pasa Alertmanager a la configuración de enrutamiento que escribe dcctl (consulta Las alertas llegan a una persona). La audiencia de los tokens se aplica ahora por defecto: lee La audiencia de los tokens se aplica por defecto antes de actualizar, sobre todo si escribes tú mismo la configuración de la instancia. Si vienes de v1.1.0, lee primero las notas de v1.2.0 y sigúelas con --version v1.3.0.
dcctl install local --version v1.3.0
dcctl upgrade local devicechain --version v1.3.0 --dry-run
dcctl upgrade local devicechain --version v1.3.0
Se aplica la política de versiones y actualización. Esta versión amplía las interfaces cubiertas (nuevas consultas, mutaciones, campos y valores de enumeración GraphQL; nuevas rutas HTTP para dispositivos; nuevas banderas y comandos de dcctl; un nuevo tipo en el SDK de C#) y no elimina ninguna. Tres cosas de la propia política son nuevas en esta versión:
- Un nivel de vista previa. Una superficie nueva puede pasar sus primeras versiones menores en vista previa, donde todavía puede cambiar en una versión menor; las notas de la versión dicen entonces qué cambió y qué hacer. En esta versión las superficies en vista previa son las pruebas de reglas (la operación
evaluateRulesde la API de event-processing, los formatos de archivo de escenario y de prueba, ydcctl test) ydcctl product export,planyapplycon su formato de paquete (product.devicechain.io/v1alpha1). Puedes construir sobre ellas, y cualquier cambio se anunciará aquí. - El catálogo de herramientas MCP no está cubierto. Los nombres de las herramientas, sus entradas y la forma de sus resultados pueden cambiar en una versión menor, y esta los cambia: consulta Los resultados de las herramientas MCP indican su procedencia.
- Valores de Helm. Los valores que esta versión añade o cambia no están cubiertos por la política de compatibilidad, y esta sección es donde una versión menor lo indica. Cada valor nuevo está desactivado, o conserva el comportamiento de
v1.2.0, por defecto.
Novedades:
- La audiencia de los tokens se aplica por defecto, como anunciaron las notas de
v1.2.0. Una API rechaza con401un token vinculado a un recurso que no sirve, y el servidor de autorización rechaza coninvalid_targetuna solicitud de un recurso que la instancia no sirve. Los tokens vinculados a nada, que incluyen todos los inicios de sesión y todos los tokens de servicio, no se ven afectados, y los tokens MCP tampoco. Consulta La audiencia de los tokens se aplica por defecto. - Los comandos llegan a dispositivos que no mantienen una conexión. Un dispositivo que solo habla HTTP recoge sus comandos con un sondeo largo, confirma la recepción y responde. Un dispositivo detrás de un servidor de red ChirpStack v4 recibe su comando como un downlink LoRaWAN. Cada comando registra ahora cómo se observó su entrega, en todos los transportes. Consulta Comandos por HTTP y constancia de entrega y Downlink LoRaWAN.
- Las alertas llegan a una persona.
dcctl installydcctl upgradeenvían las alertas de la propia plataforma a un webhook, a una dirección de correo o a una configuración propia; un receptor de hombre muerto avisa cuando el propio sistema de alertas se calla; cada alerta enlaza con una entrada de la guía de alertas; y una instancia que no envía sus alertas a ningún sitio lo dice. Consulta Las alertas llegan a una persona. - Los webhooks salientes se pueden firmar, según la especificación abierta Standard Webhooks, para la acción de regla
httpCally para los canales de notificación webhook. Consulta Webhooks salientes firmados. - El endpoint HTTP de eventos dice la verdad antes. Un inquilino desconocido o una credencial que no se autentica se responden con
401de inmediato, el400de un documento rechazado señala el campo culpable y un evento aceptado lleva un recibo. Consulta El endpoint HTTP de eventos responde 401. - Un dispositivo puede enviar su propia carga útil para el decodificador de su perfil, en una nueva ruta opcional. Consulta La carga útil propia de un dispositivo, decodificada.
- Las conexiones con certificado se pueden comprobar con OCSP, por ancla de confianza, desactivado por defecto. Consulta OCSP para conexiones con certificado.
- El producto de un inquilino se puede guardar como archivos con
dcctl product export,planyapply(vista previa). Consulta Producto como código. - Las reglas de detección se pueden probar con pruebas unitarias con
dcctl testy la consultaevaluateRules(vista previa). Consulta Pruebas de reglas. - Se registra el uso diario de eventos de cada inquilino, y el operador puede leerlo. Consulta Uso de eventos por inquilino.
- Las campañas envían comandos según un calendario: cron, fechas de calendario, festivos y la salida o la puesta del sol en la posición instalada de cada dispositivo. Consulta Campañas y Posición instalada.
- Se registran las entregas de notificaciones, una fila por intento, con el estado de cada canal. Consulta El registro de entregas de notificaciones.
- Clasificación de alarmas en la consola: las alarmas enlazan con su dispositivo y muestran unidades, se pueden reconocer varias a la vez, un dispositivo tiene una pestaña de Alarmas y la página de inicio cuenta las alarmas y los dispositivos en línea. Los operadores también pueden anotar qué resultó ser una alarma. Consulta La consola busca dispositivos y clasifica alarmas y Disposiciones de alarmas.
- Términos de vocabulario en el modelo nativo: los tipos de dispositivo, activo, área y cliente, los tipos de relación y las métricas pueden llevar términos de Brick, SAREF, Smart Data Models y NGSI-LD. Consulta Vínculos semánticos.
- Los resultados de las herramientas MCP marcan como datos el texto escrito por dispositivos y usuarios, bajo un miembro
untrustedcon su procedencia. Consulta Los resultados de las herramientas MCP indican su procedencia.
Antes de actualizar
Lo que exige actuar, en el orden en que hacerlo:
- Comprueba si hay tokens vinculados al recurso equivocado y decide si te quedas fuera de la aplicación obligatoria durante esta versión menor. La audiencia de los tokens se aplica ahora por defecto. En la instancia
v1.2.0,{__name__=~"devicechain_[a-z0-9]+_token_audience_checks_total", verdict="would_reject"}ydevicechain_usermanagement_oauth_resource_checks_total{verdict="would_reject"}deben marcar cero; si es así, el nuevo valor por defecto no cambia nada para tus clientes. Si suministras tú mismo la configuración de la instancia (instance.existingSecret) y ejecutas el área MCP, añade antes el bloquetokenAudienceal documento, o los agentes de IA perderán el acceso MCP. Consulta La audiencia de los tokens se aplica por defecto. - Si enrutaste las alertas editando a mano el Secret del propio Alertmanager, pasa antes esa configuración a
dcctl install --alert-config <archivo>. Desde esta versión Alertmanager lee el Secretdc-alertmanager-configque escribedcctl, así que una configuración editada a mano deja de leerse cuando ejecutasdcctl install. Un clúster instalado con una versión anterior también necesita undcctl installantes de quedcctl upgradeacepte las banderas--alert-*. Consulta Las alertas llegan a una persona. - Ten en cuenta que
POST /{instanceId}/{tenant}/eventsresponde ahora401a un inquilino desconocido o a una credencial que no se autentica. Estas solicitudes se respondían con202y luego se rechazaban, así que sus eventos nunca se almacenaban. Un dispositivo que recibe401necesita que se corrija el nombre del inquilino o su credencial; un dispositivo cuyos eventos se almacenan no ve ningún cambio. Durante la actualización gradual, los pods antiguos siguen respondiendo202a estas solicitudes. Consulta El endpoint HTTP de eventos responde 401. - Activa el modo OCSP de un ancla de confianza solo cuando la actualización gradual haya terminado. Mientras no todas las réplicas de
device-managementejecuten esta versión, las antiguas no comprueban OCSP, así que un certificado que una réplica rechaza podría ser admitido por otra. Consulta OCSP para conexiones con certificado. - Activa también las demás funciones opcionales nuevas solo cuando termine el despliegue. Todas están desactivadas por defecto y por el mismo motivo: un pod de
v1.2.0que sigue en marcha no las conoce.- Pon el
commandChannelde un tipo de dispositivo enHTTP_PULLsolo cuando todas las réplicas de todos los servicios estén actualizadas; uncommand-deliveryanterior publica los comandos de ese dispositivo donde nadie los lee, y caducan. - Activa
httpIngest.deviceUplinkssolo cuando todas las réplicas dedevice-managementestén actualizadas; una anterior rechaza el uplink después de que se respondiera202. - Activa la firma de webhooks (
signingSecretRefen una acciónhttpCall,"signing": trueen un canal webhook) solo cuando todas las réplicas deoutbound-connectorsynotification-managementestén actualizadas; una anterior entrega sin firmar. - Crea las campañas con disparadores de salida o puesta del sol después del despliegue: una réplica de
user-managementdev1.2.0se niega a emitir el token que lee las posiciones instaladas, así que la planificación solar informa de un error y lo reintenta hasta que esa réplica desaparece.
- Pon el
- Mueve cualquier identificador de credencial Bearer de
httpCallque empiece porwebhook-signing/. Ese espacio de nombres queda reservado para los secretos de firma, y una regla que nombre un identificador así se rechaza al publicarla. Consulta Webhooks salientes firmados. - Actualiza los clientes MCP que leen texto libre del resultado de una herramienta. El nombre, la descripción y el identificador externo de un dispositivo, el nombre y la unidad de una métrica, la clave de una alarma y el nombre y el error de un comando están ahora bajo
untrusted, como{ "value": ..., "source": ... }. El catálogo de herramientas MCP no es una interfaz cubierta, así que esto llega en una versión menor. Consulta Los resultados de las herramientas MCP indican su procedencia. - Espera que
devicechain_eventprocessing_detect_late_samples_totalmarque más. Las lecturas tardías que descarta una ventana fija cerrada o una sesión cerrada ahora se cuentan, como ya se contaban las de los demás tipos de regla; hasta ahora se descartaban sin dejar rastro. Los resultados de la detección no cambian. Vuelve a ajustar la referencia de un panel o una alerta que hayas calibrado con el ritmo anterior. Consulta Pruebas de reglas. - Publica los perfiles y tipos de activo con vínculos semánticos después del despliegue. Durante la ventana gradual, un pod antiguo que atiende la publicación escribe una instantánea sin los vínculos. El borrador los conserva, y la siguiente publicación desde un pod actualizado los fija. Consulta Vínculos semánticos.
- Espera que la migración de
event-managementtarde más en un almacén de eventos grande. Construye un índice sobre la tabla de eventos fragmento a fragmento. Consulta Uso de eventos por inquilino. - Añade las nuevas alertas y métricas a tu enrutamiento y tus paneles.
devicechain_usermanagement_service_token_checks_totales nueva (detalles), igual que las series OCSP de las conexiones con certificado ydevicechain_notificationmanagement_ledger_writes_total. - No hay que hacer nada por el resto de esta versión. Todos los demás cambios son aditivos o están desactivados por defecto.
infrastructure.tokenAudience.enforcement: observese acepta solo en esta versión, como exclusión, yv1.4lo rechaza. Sigue vigente lo declarado obsoleto env1.2.0para una solicitudclient_credentialsque indica unresourcesin unscope.
Autoridades nuevas:
usage:reades una autoridad de nivel de sistema. Lee el uso de eventos de cada inquilino en la API de administración de event-management. El rol integradosuperusertiene*y por tanto la tiene; concédela a otro rol de sistema para que ese rol pueda leer el uso. Ningún rol de inquilino puede tenerla.location:installed:reades una autoridad de nivel de inquilino. Lee la posición instalada de un dispositivo o de un activo y nada más.location:readla implica, así que un rol que ya tienelocation:read(ytenant-admin, que tiene*) no necesita cambios. No forma parte de la base del rol de lectura: a un rol que deba ver las posiciones instaladas pero no la ubicación en vivo de los dispositivos se le concede sololocation:installed:read.
Valores de Helm nuevos, cada uno desactivado o sin cambios por defecto:
| Valor | Por defecto | Qué hace |
|---|---|---|
functionalAreas.device-management.config.callout.ocsp.enabled | false | El interruptor de la instancia para OCSP. Desactivado, no se consulta a ningún respondedor; consulta OCSP para las demás claves ocsp.*. |
functionalAreas.device-management.config.callout.ocsp.allowRequireCurrent | false | Permite que un ancla use REQUIRE_CURRENT. |
functionalAreas.event-sources.config.httpIngest.deviceUplinks | false | Sirve POST /{instanceId}/{tenant}/devices/{token}/uplink. |
functionalAreas.event-sources.config.httpIngest.maxCommandPollsPerTenant | 256 | Sondeos de comandos HTTP retenidos por inquilino y por réplica; uno más se responde con 429. No aparece en el values.yaml del chart; fíjalo si necesitas otro límite. |
functionalAreas.outbound-connectors.config.lpwanDownlink.enabled | false | Envía comandos a dispositivos LoRaWAN a través de su servidor de red. No aparece en el values.yaml del chart; fíjalo para activar la función. |
La audiencia de los tokens se aplica por defecto
Las notas de v1.2.0 lo anunciaron: lo que Los tokens se comprueban contra su recurso contaba como would_reject ahora se rechaza. Un infrastructure.tokenAudience.enforcement sin definir significa enforce, para las dos comprobaciones:
- Una API rechaza un token vinculado a un recurso que no sirve, con
401, la misma respuesta que para un token no válido. La API de un área acepta un token vinculado a nada, a esa área o a un servidor MCP registrado. - El servidor de autorización rechaza una solicitud de un recurso que esta instancia no sirve:
invalid_targeten el endpoint de autorización y en la concesiónclient_credentials, einvalid_grantpara una renovación o un código de autorización vinculados a un recurso que ya no se sirve. Un token de renovación rechazado así queda gastado, de modo que el cliente debe autorizarse de nuevo.
Los tokens vinculados a nada no se ven afectados. Eso incluye todos los inicios de sesión desde la consola, la aplicación de paneles, el SDK de C# y dcctl, y todos los tokens de servicio. Los tokens MCP están vinculados al servidor MCP, que el chart registra, así que tampoco se ven afectados. Con enforce, los rechazos se cuentan en las mismas series con verdict="rejected", y las dos alertas info, TokenAudienceWouldReject y OAuthResourceWouldReject, solo pueden dispararse en una instancia que haya fijado observe.
Así se ve un rechazo: una cuenta de servicio que pide un token vinculado a un área y lo usa en otra recibe un rechazo en la segunda.
TOKEN=$(curl -s -u "$CLIENT_ID:$CLIENT_SECRET" \
-d grant_type=client_credentials -d scope=read-only \
--data-urlencode "resource=https://dc.example.com/api/device-management" \
https://dc.example.com/api/user-management/oauth/token | jq -r .access_token)
# Aceptado: el token está vinculado a device-management.
curl -s -o /dev/null -w '%{http_code}\n' https://dc.example.com/api/device-management/graphql \
-H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-d '{"query":"{ __typename }"}'
# 401 con enforce: event-management no acepta un token vinculado a device-management.
curl -s -o /dev/null -w '%{http_code}\n' https://dc.example.com/api/event-management/graphql \
-H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
-d '{"query":"{ __typename }"}'
Una integración que llama a más de un área debe omitir el resource: todas las áreas aceptan un token sin vincular. Consulta Vincular un token a un recurso.
Antes de actualizar, comprueba en la instancia v1.2.0 si hay tráfico que la aplicación obligatoria rechazaría:
- El contador de las API es una serie por área, y su nombre lleva el área sin guiones:
devicechain_devicemanagement_token_audience_checks_total,devicechain_eventmanagement_token_audience_checks_total, etc. Selecciónalas todas con{__name__=~"devicechain_[a-z0-9]+_token_audience_checks_total", verdict="would_reject"}. El contador del servidor de autorización esdevicechain_usermanagement_oauth_resource_checks_total{verdict="would_reject"}. Los dos deben marcar cero, y las dos alertas deben estar en silencio. - Si alguno se mueve, los avisos con límite de frecuencia nombran al cliente:
Token audience is not accepted by this planeen el registro del área, yOAuth resource is not one this instance servesen el registro deuser-management. Cambia elresourceque envía ese cliente: omítelo o usa uno que la instancia sirva.
Para quedarte fuera durante esta versión menor, fija enforcement: observe antes de actualizar, para que ningún pod aplique la comprobación durante la actualización gradual. En los valores de Helm o en una superposición de valores de dcctl la clave es instance.config.infrastructure.tokenAudience.enforcement. v1.4 rechaza observe: un servicio se detiene al arrancar, y el esquema de valores del chart lo rechaza. Sin esa exclusión, los pods antiguos y los nuevos coinciden durante la actualización, así que durante unos minutos un token vinculado al recurso equivocado puede ser aceptado por una réplica de v1.2.0 y rechazado por una de v1.3.0.
instance.existingSecret pierde el acceso MCP salvo que el documento lo incluyaEl chart no escribe el bloque tokenAudience en una configuración que suministras tú. Con enforce, el área mcp comprueba al arrancar que su resourceUrl figura en infrastructure.tokenAudience.mcpResources, y se niega a arrancar si no figura, así que los agentes de IA pierden el acceso MCP. dcctl upgrade rechaza ese documento antes de que se renueve nada, pero un helm upgrade directo no puede mirar dentro de tu Secret. Antes de actualizar, añade el bloque al documento, con tu origen y la resourceUrl del servidor MCP exactamente como está configurada el área mcp, con el esquema y el host en minúsculas:
"infrastructure": {
"tokenAudience": {
"areaBaseUrl": "https://iot.example.com/api",
"mcpResources": ["https://iot.example.com/api/mcp"]
}
}
O fija "enforcement": "observe" en el mismo bloque. En los dos casos, fija instance.existingSecretChecksum al sha256 del nuevo documento instance; si no, no se renueva ningún pod y todos siguen leyendo el anterior.
- Si fijaste a mano
functionalAreas.mcp.config.resourceUrlcon una mayúscula en el esquema o el host, o con el identificador de un área, como<origin>/api/device-management,helm upgradeahora falla y explica por qué. Ponlo en minúsculas o cámbialo, o fijaobserve; conobserve, el chart deja ese valor fuera de la lista, como hacíav1.2.0. - Volver a
v1.2.0no exige nada por esto:v1.2.0lee el mismo bloque y usaobservepor defecto.
Las alertas llegan a una persona
Cada regla de alerta que incluye el chart lleva ahora un runbook_url que abre su entrada en la nueva Guía de alertas. Nada más de una regla cambia: nombres, expresiones, duraciones for y etiquetas son los mismos.
dcctl install y dcctl upgrade aceptan --alert-webhook, --alert-email (con --alert-smtp-host, --alert-smtp-from, --alert-smtp-user y --alert-smtp-password-file), --alert-config, --alert-watchdog-webhook y --clear-alert-routing. Alertmanager lee ahora su configuración del Secret dc-alertmanager-config del namespace monitoring, que dcctl install escribe antes de aplicar la pila de monitoreo. Volver a ejecutar dcctl install sin ninguna bandera --alert-* conserva el enrutamiento existente, y una primera instalación sin ellas escribe una configuración sin receptor, que es el comportamiento de las versiones anteriores. Indicar cualquier bandera --alert-* vuelve a declarar todo el enrutamiento. Con --alert-watchdog-webhook, la alerta Watchdog, que está siempre activa, va a ese receptor cada minuto, así que su silencio te dice que las alertas se han detenido.
Una instancia indica si alguien escucha en su nueva condición AlertsRouted, y dcctl instances list muestra ALERTS NOT ROUTED para una que no envía sus alertas a ningún sitio. La condición nunca hace que la instancia deje de estar lista.
Vuelve a ejecutar dcctl install una vez en un clúster instalado con una versión anterior antes de usar las banderas con dcctl upgrade; en caso contrario dcctl upgrade las rechaza, porque el Alertmanager anterior no lee ningún Secret nuestro. dcctl comprueba --alert-config en busca de los errores que dejarían las alertas sin enrutar, pero no es el analizador del propio Alertmanager: ejecuta antes amtool check-config sobre el archivo. Consulta Enrutar las alertas a una persona.
Comandos por HTTP y constancia de entrega
Un dispositivo que solo habla HTTP, como un sensor de batería que se despierta, informa y vuelve a dormir, ahora puede recibir comandos. Pon el commandChannel de su tipo de dispositivo en HTTP_PULL, y sus comandos esperan a que el dispositivo los pida:
GET /{instanceId}/{tenant}/devices/{device}/commands?wait=0..30retiene la solicitud hastawaitsegundos (25 por defecto) hasta que haya un comando pendiente;POST .../commands/{command}/ackconfirma la recepción, antes de que el dispositivo actúe;POST .../commands/{command}/responseresponde.
El dispositivo presenta su token de acceso en cada solicitud. Un tipo de dispositivo sin canal, o con PUBLISH, recibe sus comandos exactamente igual que antes. Un comando para un dispositivo que sondea puede llevar deliveryMode: ONEWAY (lo completa su confirmación) y puede fijar maxAttempts; para cualquier otro dispositivo esas opciones se rechazan con DELIVERY_OPTION_NOT_APPLICABLE. Cada réplica de event-sources retiene como máximo httpIngest.maxCommandPollsPerTenant sondeos de un inquilino (256 por defecto) y responde 429 por encima. El SDK de C# tiene un nuevo HttpCommandPuller.
Cada comando registra ahora la constancia de su entrega: deliveredTime y deliveryEvidence (DEVICE_ACK para la confirmación de un dispositivo que sondea, DEVICE_RESPONSE para una respuesta en cualquier transporte). No se añade ningún estado de comando. Consulta Dispositivos que recogen sus comandos por HTTP.
- Actívalo después del despliegue. Actualiza primero
device-management, y ponHTTP_PULLsolo cuando todas las réplicas de todos los servicios ejecuten esta versión. Una réplica decommand-deliveryya actualizada mientrasdevice-managementtodavía no lo está retiene los comandos de todos los dispositivos por los que pregunta, y los libera cuandodevice-managementresponde, así que los dispositivos normales sufren un retraso durante el solapamiento, nunca se envían al sitio equivocado. - La nueva ruta no se expone a través del ingress del chart, igual que
/events.
Downlink LoRaWAN
Un comando para un dispositivo que informa a través de una integración entrante se puede enviar ahora al dispositivo como un downlink LoRaWAN, encolado en su servidor de red ChirpStack v4. Esta primera versión acepta cargas útiles hex o base64 en bruto y envía downlinks sin confirmación; confirmed: true se rechaza, nunca se rebaja. El enlace es un conector publicado del nuevo tipo lorawan_downlink, y la clave de API de ChirpStack es el secreto sellado del conector. El éxito significa que el servidor de red encoló el downlink, no que el dispositivo lo recibiera.
Está desactivado salvo que functionalAreas.outbound-connectors.config.lpwanDownlink.enabled sea true; entonces el chart hace que command-delivery despache estos comandos, y rechaza una copia de esa bandera fijada a mano. La consulta connectorTypes lista un valor más. La primera vez que se activa, un comando despachado en los segundos anteriores a que arranque el adaptador caduca. Consulta Downlink LoRaWAN.
Webhooks salientes firmados
La acción de regla httpCall y el canal de notificación webhook pueden firmar lo que envían, según la especificación abierta Standard Webhooks. Una entrega firmada lleva webhook-id, webhook-timestamp y webhook-signature; el cuerpo no cambia, y una entrega sin firmar es exactamente la de antes. La plataforma genera el secreto de firma, que se muestra una sola vez y nunca vuelve a poder leerse, y se puede rotar con un solapamiento durante el cual las entregas llevan las dos firmas. Una entrega que debería firmarse y no puede se rechaza, nunca se envía sin firmar. Consulta Firmar los webhooks salientes.
- Activa la firma después del despliegue. Una réplica anterior de
outbound-connectorso denotification-managementignorasigningSecretRefysigning, y entrega sin firmar. webhook-signing/queda reservado. Una regla cuyo identificador de credencial Bearer esté bajo él se rechaza al publicarla; mueve antes el identificador.- Un secreto nuevo tarda hasta un minuto en llegar a todas las entregas
httpCall, porque el servicio de conectores guarda los secretos en caché.
El endpoint HTTP de eventos responde 401
POST /{instanceId}/{tenant}/events respondía 202 Accepted a solicitudes que nunca podían almacenarse: un nombre de inquilino con una errata o una credencial que no se autenticaba. Se rechazaban después, y al dispositivo se le había dicho que sus datos estaban a salvo. Ahora se rechazan en la entrada:
401para un inquilino desconocido y para una credencial que no se autentica (desconocida, caducada, con un secreto erróneo, de otro dispositivo, o ausente donde la instancia la exige). Todas las causas reciben el mismo estado, las mismas cabeceras y el mismo cuerpo,{"error":"unauthorized"}, así que el endpoint no revela qué inquilinos ni qué dispositivos existen. Los operadores distinguen las causas entotal_http_ingest_refused{source,reason}y en una línea de registro muestreada.400sigue siendo400para una carga útil mal formada. Un cuerpo que es JSON válido pero se rechaza lleva ahora un cuerpo JSON cuyoserrorsseñalan cada valor culpable con un JSON Pointer;messagees la frase que siempre llevó el cuerpo de texto plano. Un cuerpo que no es JSON conserva su400en texto plano.X-DC-Event-Iden un202, y en el400de un documento rechazado, es un recibo de la solicitud.
La comprobación falla en abierto: si los servicios a los que pregunta están lentos o no responden, la solicitud se acepta como antes y se juzga después. Una credencial que falla cinco veces seguidas deja de consultarse durante un tiempo (1 segundo, que se duplica hasta 60), así que el 401 no sirve para adivinar secretos. La respuesta en caché no es una autoridad: device-management sigue autenticando cada evento, así que una credencial recién desactivada se acepta en la entrada durante 30 segundos como mucho y después se rechaza como antes. Los rechazos en la entrada se cuentan y se registran, pero no son registros de eventos fallidos.
La carga útil propia de un dispositivo, decodificada
Un dispositivo que envía una carga útil binaria o un JSON propio del fabricante, en lugar del documento de evento de DeviceChain, puede publicarla en POST /{instanceId}/{tenant}/devices/{token}/uplink, y la lee el decodificador de carga útil del perfil de su tipo de dispositivo. El dispositivo presenta su propia credencial en las cabeceras X-DeviceChain-Credential-*, y se comprueba antes que nada: quien no la tiene recibe un único 401, exista o no el dispositivo y tenga o no decodificador. La decodificación, su presupuesto, su estado y sus muestras son los mismos que usa la ruta de las integraciones entrantes. Un tipo de dispositivo sin decodificador se responde con 422.
La ruta está desactivada salvo que functionalAreas.event-sources.config.httpIngest.deviceUplinks sea true. Actívala solo cuando todas las réplicas de device-management ejecuten esta versión: una réplica anterior rechaza ese uplink y lo registra como evento fallido después de que al dispositivo se le respondiera 202.
OCSP para conexiones con certificado
Un ancla de confianza puede ahora preguntar al respondedor OCSP de la autoridad de certificación si un certificado sigue siendo válido, como segunda fuente de revocación junto a las listas de revocación que subes. Está desactivado en todas partes por defecto: el interruptor de la instancia functionalAreas.device-management.config.callout.ocsp.enabled es false, y el nuevo ocspMode de cada ancla es OFF.
ENFORCE_KNOWNrechaza un certificado que el respondedor declara revocado y admite uno cuyo estado no puede conocer.REQUIRE_CURRENTrechaza cualquier certificado cuyo estado no puede confirmar. Además necesitacallout.ocsp.allowRequireCurrent: truey una URL de respondedor en el ancla (ocspResponderUrl).- Lo que cuesta. OCSP se ejecuta solo después de que hayan pasado las comprobaciones de cadena, caducidad, lista de revocación y revocación manual, así que un certificado ya rechazado no cuesta ninguna consulta. Las respuestas buenas se guardan en caché; una respuesta de revocado rechaza la conexión y nunca se guarda. Las demás claves bajo
callout.ocsp(fetchDeadline,maxInFlight,maxAge,failureTtl,cacheEntries,maxResponderHostsPerTenant) acotan las consultas, y sus valores por defecto están en elvalues.yamldel chart. - Lo que todavía no hace. Una respuesta de revocado rechaza cada conexión, pero no se almacena como revocación ni termina las sesiones ya abiertas; para eso, sube una lista o revoca el certificado.
- Resultados y métricas nuevos.
callout_x509_totalgana los resultadosocsp_revokedyocsp_unavailable, y cinco seriesx509_ocsp_*nuevas informan de las consultas, la caché, el cortocircuito y las conexiones admitidas sin respuesta.
Cambia las anclas a ENFORCE_KNOWN o REQUIRE_CURRENT solo cuando la actualización gradual haya terminado. Hasta entonces, las réplicas antiguas no comprueban OCSP, así que un certificado que una réplica rechaza podría ser admitido por otra. Con el interruptor de la instancia desactivado, un ancla en REQUIRE_CURRENT rechaza las nuevas conexiones con certificado, y la API se niega a activar un ancla.
Los resultados de las herramientas MCP indican su procedencia
El catálogo de herramientas MCP (nombres de herramientas, entradas y forma de los resultados) no está cubierto por la promesa de compatibilidad. La política de versiones lo incluye ahora entre lo que puede cambiar en una versión menor, y esta versión lo cambia.
Cada herramienta de lectura mantiene los tokens y los valores calculados por la plataforma en el nivel superior y pasa el texto libre a untrusted, como { "value": ..., "source": ... }, donde source es device-reported, operator o agent. Los campos que se mueven son el name, la description y el externalId de un dispositivo, el name y la unit de una métrica, el alarmKey de una alarma, y el name y el error de un comando. Un cliente que los lea debe leerlos ahí. Las clases que contiene un resultado se listan en _meta["io.devicechain/provenance"], y la descripción de cada herramienta dice que el texto bajo untrusted son datos, nunca instrucciones. Consulta Lo que ve un asistente.
También es nuevo, y aditivo: los tokens de acceso OAuth llevan un claim sid (la sesión de la concesión), el diario de auditoría registra el client_id y la sesión del token que hizo cada cambio, y la línea del registro de auditoría de MCP pasa a schema: 2, que añade scopes.
Se observa el techo de autoridad de los tokens de servicio
El endpoint que emite tokens de servicio comprueba ahora cada solicitud contra las autoridades que su llamante debería necesitar, y cuenta el veredicto en devicechain_usermanagement_service_token_checks_total{caller,verdict}. No rechaza nada y emite exactamente igual que antes. Un ritmo distinto de cero de over_ceiling, wildcard o unknown_caller señala un llamante que una versión posterior que aplique el techo rechazaría; hoy no se espera ninguno.
Producto como código (vista previa)
dcctl product export <dir> escribe el producto de un inquilino como archivos: tipos de dispositivo, perfiles con sus métricas, métricas calculadas, decodificadores de carga útil con sus vectores de prueba, comandos, reglas de detección y grafos del lienzo, paneles, conectores e integraciones. dcctl product plan <dir> muestra lo que cambiaría aplicar los archivos y no escribe nada (--fail-on-changes convierte la deriva en un código de salida), y dcctl product apply <dir> hace converger el inquilino con los archivos y publica lo que cambió. Los secretos nunca aparecen en un paquete: un conector nombra su credencial por identificador (env:NAME), y cada paquete se examina en busca de valores con aspecto de secreto. Solo se toca lo que nombra el paquete.
Es una superficie en vista previa: el árbol de comandos y el formato de paquete (product.devicechain.io/v1alpha1) pueden cambiar en una versión menor, y dcctl rechaza una versión de paquete que no conoce. Se ejecuta por completo en dcctl, a través de las API de inquilino publicadas, así que nada cambia en el servidor. Consulta Producto como código.
Pruebas de reglas (vista previa)
dcctl test <dir|archivo> ejecuta pruebas unitarias deterministas de las reglas de detección. Un scenario.yaml describe dispositivos y sus lecturas (constantes, un paseo aleatorio acotado, un calendario por escalones, o un archivo CSV o NDJSON) con fallos (huecos, duplicados, reordenaciones, ventanas sin conexión) y una semilla, y los archivos *.test.yaml dicen lo que debe ocurrir: una alarma activada o despejada dentro de un plazo, nunca activada, un comando o un webhook solicitado, etc. dcctl test imprime un informe, puede escribir XML JUnit (--junit) y sale con 0 cuando se cumplieron todas las expectativas, 1 cuando falló una y 2 cuando algo no se pudo juzgar. Una ejecución que no puede responder nunca sale en verde.
Usa una consulta nueva, evaluateRules (API de inquilino de event-processing, device:read), que ejecuta las reglas publicadas de un perfil, o un borrador, sobre los eventos de la solicitud, en tiempo de evento con la tolerancia de retraso de producción, y devuelve las transiciones, las acciones que solicitarían y por qué un resultado es parcial. No ejecuta nada y no toca ningún flujo. Los formatos de archivo (devicechain.io/ruletest/v1alpha1), la consulta y el comando están en el nivel de vista previa.
devicechain_eventprocessing_detect_late_samples_totalmarca más. Las lecturas tardías que descarta una ventana fija cerrada o una sesión cerrada ahora se cuentan, como las de los demás tipos de regla. Las detecciones no cambian; un panel o una alerta calibrados con el ritmo anterior necesitan una nueva referencia.
Uso de eventos por inquilino
event-management guarda un registro diario de lo que usó cada inquilino: los eventos que ingirió y los dispositivos que los enviaron (distintos, el máximo en una hora y la media horaria). Un operador lo lee con la consulta tenantEventUsage(tenant, from, to) en el nuevo endpoint /admin/graphql de event-management, de ámbito de instancia, que requiere un token de identidad con usage:read. El registro informa del uso y no impone nada.
- Los eventos se cuentan el día en que se recibieron, no el día con el que están fechados, así que una lectura tardía o recuperada nunca revisa un día terminado, y un duplicado reentregado se cuenta una vez.
- Una hora es definitiva 10 minutos después de cerrarse, y una hora definitiva no se reescribe nunca. Un día figura como
completecuando sus 24 horas son definitivas. Por eso, un evento almacenado más de 10 minutos después del final de la hora en que se recibió no se cuenta. - El registro empieza el día UTC en que se ejecuta por primera vez el servicio actualizado. Los días anteriores figuran como no completos. Los eventos recibidos después de la actualización pero fechados dentro de fragmentos que ya estaban comprimidos en ese momento no se cuentan.
- La actualización construye un índice sobre la tabla de eventos fragmento a fragmento, así que no bloquea las escrituras de toda la tabla, pero en un almacén grande la migración de
event-managementtarda más de lo habitual.
Campañas
Una campaña envía una serie de comandos, con una espera entre pasos, a los dispositivos de un grupo de entidades según un calendario: una expresión cron en una zona horaria con nombre, fechas y horas de calendario, o la salida o la puesta del sol más un desfase, calculadas para cada dispositivo a partir de su posición instalada. Los festivos suprimen un disparo; nunca lo mueven. Los cambios de horario de verano siguen una sola regla: una hora que cae en el salto de primavera se dispara en el salto, y una hora repetida se dispara una vez. Cada disparo se sigue por dispositivo (pendiente, despachado, rechazado u omitido, con un motivo), y retryCampaignFailed vuelve a enviar el comando del ciclo a los dispositivos cuyo comando no tuvo éxito. Los comandos pasan por la ruta habitual de lotes, así que las ventanas de mantenimiento se siguen aplicando. Todas las réplicas ejecutan el planificador, y la base de datos decide cuál envía cada comando, así que nada se envía dos veces.
- Una campaña no se puede editar. Bórrala y vuelve a crearla; una campaña recreada no envía nada que venciera antes de crearse.
- Los destinos son grupos. Usa un grupo dinámico para seleccionar los dispositivos de un área.
- Los disparadores solares necesitan que termine el despliegue. Mientras quede alguna réplica de
user-managementdev1.2.0, la planificación de un disparo de salida o puesta del sol informa de un error y lo reintenta.
Posición instalada
Un dispositivo o un activo que no se mueve, como una farola, una plaza de aparcamiento o un armario, puede tener ahora una posición instalada: setInstalledPosition y clearInstalledPosition (device:write), las columnas opcionales installedLatitude, installedLongitude, installedElevation e installedAccuracy de una importación de flota, y el campo installedPosition de Device y Asset. Leerla requiere la nueva location:installed:read, que location:read implica. Nunca recurre a una posición que haya informado el dispositivo. positionWithheld, en cada dispositivo y activo, le dice a quien llama que no puede ver la posición, sin revelar si existe. Un área puede nombrar su geocerca de límite (boundaryFenceToken); una geocerca que nombra un área no se puede borrar.
El registro de entregas de notificaciones
Cada intento de enviar la notificación de una alarma por un canal escribe ahora una fila: qué lo desencadenó, la política, el canal, los destinatarios, el resultado (SENT, FAILED, REFUSED o NOT_ATTEMPTED), el número de intento, la latencia y un código de error clasificado. Se lee con notificationAttempts (notification:read); NotificationChannel.deliveryHealth da el último éxito, el último fallo y los fallos consecutivos de cada canal. Las URL de entrega, que pueden ser credenciales en sí mismas, nunca se almacenan. Las filas se conservan 7 días por defecto.
El registro nunca retrasa un aviso: las filas se escriben en segundo plano desde una cola acotada, y una cola llena descarta la fila y la cuenta en devicechain_notificationmanagement_ledger_writes_total{outcome}. Así, una fila demuestra que hubo un intento; una fila que falta no demuestra nada.
Disposiciones de alarmas
setAlarmDisposition etiqueta el ciclo actual de una alarma como TRUE_POSITIVE, FALSE_POSITIVE o EXPECTED, con una nota opcional (alarm:write). Una etiqueta pertenece a un ciclo: cuando la alarma vuelve a activarse, el nuevo ciclo empieza sin etiqueta y los ciclos anteriores conservan la suya. Alarm.disposition lee la etiqueta del ciclo actual, y alarmDispositions lista todos los ciclos etiquetados. Etiquetar no cambia nada más de la alarma. Un miembro limitado a clientes lee las etiquetas de los ciclos que podía ver y no puede escribir ninguna.
Vínculos semánticos
Un inquilino puede vincular términos de un vocabulario al modelo que ya tiene: semanticTypes en los tipos de dispositivo, activo, área y cliente, semanticPredicate y semanticInverse en los tipos de relación, y semanticProperty y semanticPointClass en las métricas. Los vocabularios incluidos son Brick 1.4.4, SAREF 4.1.1 con SAREF4CITY y SAREF4BLDG, los Smart Data Models de alumbrado público, aparcamiento y medio ambiente, y los términos básicos de NGSI-LD. Un inquilino activa los que usa, y puede añadir prefijos propios, con setSemanticContext (device:write). Cada término se comprueba en existencia y tipo, se almacena como IRI completo, y se rechaza con INVALID_ARGUMENT nombrando el término; un cambio de contexto que dejaría sin explicar un vínculo almacenado se rechaza con SEMANTIC_CONTEXT_IN_USE. thingModel(includeSemanticTypes: true) añade la propiedad semántica y la clase de punto de cada métrica al @type de su propiedad; por defecto su salida no cambia.
- Durante la ventana gradual, un pod antiguo que publica un perfil o un tipo de activo escribe una instantánea sin los vínculos. El borrador los conserva, y la siguiente publicación desde un pod actualizado los fija.
La consola busca dispositivos y clasifica alarmas
La búsqueda de dispositivos y la de tipos de dispositivo aceptan un nuevo argumento opcional cada una, nameContains: una coincidencia de subcadena sin distinguir mayúsculas en el nombre o el token, donde % y _ se toman literalmente y un texto en blanco coincide con todo. Un cliente que no lo envía obtiene los mismos resultados que antes. En la consola, la lista de dispositivos tiene una búsqueda por nombre y un filtro por tipo de dispositivo, ambos guardados en la dirección de la página, y los selectores de tipo de los formularios de dispositivo, creación en lote, importación y perfil de aprovisionamiento buscan en el servidor mientras escribes, en lugar de leer los primeros 1.000 tipos.
La lista de alarmas enlaza cada alarma con su dispositivo, muestra los valores con la unidad que declara el perfil del dispositivo, reconoce varias alarmas seleccionadas en una sola solicitud y guarda sus filtros en la dirección de la página. Un dispositivo tiene una pestaña de Alarmas, y la página de inicio cuenta las alarmas activas por severidad y los dispositivos en línea y fuera de línea. Son cambios solo de la consola.
El reloj adelantado de un dispositivo ya no mueve la detección de otros inquilinos
La detección mantiene un único reloj lógico para toda la instancia, y antes seguía el tiempo de evento más reciente que había visto. La plataforma acepta tiempos de evento hasta cinco minutos por delante del reloj del servidor, de modo que un solo dispositivo con el reloj adelantado podía llevar ese reloj compartido por delante del tiempo real. Entonces los temporizadores de ausencia de todos los inquilinos se disparaban antes de tiempo y las lecturas con ventana de dispositivos con el reloj correcto se descartaban por tardías. Desde esta versión, un mensaje mueve el reloj compartido como máximo hasta el momento en que el broker lo almacenó, más la tolerancia de retraso configurada. El evento conserva su propio tiempo, por lo que sus lecturas se siguen ventaneando y ordenando en los instantes que informó el dispositivo, y la vista previa de repetición aplica el mismo límite.
- Los resultados de detección cambian solo en el caso que estaba mal. Un dispositivo cuyo reloj está dentro de la tolerancia del reloj del broker (5 segundos por defecto) se comporta como antes. Con un reloj más adelantado, las alarmas de ausencia de los demás dispositivos se disparan ahora en su plazo real, y los temporizadores del dispositivo adelantado esperan a que el tiempo real los alcance.
- Las instantáneas llevan una versión del reloj. Una instantánea de detección escrita por esta versión la registra, y restaurar una instantánea anterior sigue funcionando. En los primeros momentos tras la actualización, el reloj restaurado puede seguir tan adelantado como estaba; se corrige solo cuando el tiempo real lo alcanza, y el servicio registra una advertencia al restaurar una instantánea así. Durante una actualización gradual, un pod de la versión anterior que tome el relevo escribe instantáneas sin la versión y la ignora al leer, así que no hay que hacer nada.
- No cubre el caso contrario. Un dispositivo que sube lecturas antiguas (almacenar y reenviar) todavía puede ver cómo las reglas con ventana las descartan por tardías, porque el reloj compartido ya avanzó. Los relojes por dispositivo no forman parte de esta versión.
Agentes de borde
No hay que hacer nada; ambas cosas están desactivadas por defecto y no cambian nada hasta que se configura un agente para ellas.
- Un agente puede conservar un evento hasta que la plataforma lo haya aceptado. Con
uplink.retireOn: accept, el agente borra un evento almacenado solo cuando la plataforma informa de que lo aceptó de forma duradera, y lo vuelve a ofrecer si la plataforma lo descartó por superar el límite de ingesta del inquilino. El valor por defecto,puback, se comporta como antes. Actualiza la plataforma antes de pasar un agente aaccept: un agente en ese modo no puede conectarse a una plataforma anterior, y el error de conexión nombrauplink.retireOn. Cuando su cola local se acerca a su presupuesto, un agente también puede descartar eventos almacenados por clase de prioridad (local.priority.*). Consulta Retirar eventos cuando la plataforma los acepta. - La parte del agente del downlink de comandos a dispositivos situados detrás de él se entrega con
commands.enableddesactivado. La plataforma todavía no enruta comandos de pasarela, así que no tiene efecto en esta versión.
Documentación, hosts de ejemplo y notas para agentes
La documentación de los SDK de .NET y Unity y el comentario de documentación de DeviceChainClient.Origin usaban demo.devicechain.io como host de ejemplo, que no se resuelve; ahora usan devicechain.example.com. El SDK no tiene un host por defecto, así que no cambia ningún comportamiento. Una página nueva, API de dispositivos de un vistazo, da un comando para cada forma en que un dispositivo llega a la plataforma, y los paquetes @devicechain/client y @devicechain/widget-sdk y el SDK de .NET incluyen cada uno un AGENTS.md para agentes de programación. Una página nueva, Proceso de seguridad, describe cómo se tratan las vulnerabilidades (el objetivo para acusar recibo y clasificar es ahora de 24 horas) y qué publica cada versión.
Otros cambios en esta versión
No hay que hacer nada.
- LwM2M: información del dispositivo de los dispositivos que responden en TLV.
lwm2m.readDeviceInfoy la recogida de información del dispositivo al registrarse solo leían respuestas en texto plano, así que de un cliente que responde en LwM2M TLV a una lectura de un solo recurso, como hace Eclipse Leshan, no se registraba nada. Las respuestas TLV se decodifican ahora. - La matriz de transportes se genera a partir de una ejecución de conformidad en la que clientes de terceros (Eclipse Paho, curl, Eclipse Leshan y Eclipse Tahu) manejaron una instancia real, y cada celda se juzga por lo que almacenó la plataforma.
dcctl installya no exige el comandohelm. El chart se instala con la biblioteca de Helm dentro dedcctl;tofu(oterraform) sigue siendo necesario.dcctl bootstrap --valuesya no falla en una instancia nueva con "changed while the values overlay was being recorded". Una escritura de estado del operador movía la versión de la instancia mientras tanto;dcctlahora reintenta cuando solo se movió el estado, y sigue rechazando cuando cambió cualquier otra cosa. Lo mismo vale para el registro del front end y del interruptor de sobres de eventos.
Cambios de esquema y vuelta atrás
Se añaden las siguientes migraciones. Cada columna nueva admite nulos y cada tabla nueva empieza vacía, así que un servicio de v1.2.0 que se ejecute contra el esquema nuevo escribe filas que todavía puede almacenar.
- OCSP en las anclas de confianza (
device-management, migración20261113100000). Dos columnas que admiten nulos endevice_trust_anchors:ocsp_modeyocsp_responder_url. Un modo vacío se lee comoOFF. - Canal de comandos HTTP (
device-management, migración20261114120000). Una columna que admite nulos,command_channelendevice_types. Vacía se lee comoPUBLISH. - Constancia de entrega (
command-delivery, migración20261114120100). Cinco columnas que admiten nulos encommands:delivered_time,delivery_evidence,delivery_mode,max_attemptsydelivery_attempts. - Identidad en el diario de auditoría (todas las áreas). La tabla del diario de auditoría
audit_events, que cada área guarda junto a sus propias tablas, gana cuatro columnas que admiten nulos:client_id,session_id,on_behalf_ofyproposal. Se añaden al arrancar, como siempre se ha creado la propia tabla, y no mediante una migración numerada. - Uso de eventos (
event-management, migraciones20261107000000y20261108000000). Cinco tablas nuevas,tenant_usage_daily,tenant_usage_hourly,tenant_usage_devices,tenant_usage_ledgerytenant_usage_state, y un índice BRIN sobreevents.processed_time, construido fragmento a fragmento. - Registro de entregas de notificaciones (
notification-management, migración20261108000100). Una tabla nueva,notification_attempts, con tres índices. - Posición instalada (
device-management, migración20261112120000). Seis columnas que admiten nulos endevicesy enassets(installed_lat,installed_lon,installed_elev,installed_accuracy,installed_sourceeinstalled_updated_at), una enareas(boundary_fence_token) y un índice parcial sobre ella. - Disposiciones de alarmas (
device-management, migración20261114090000). Una tabla nueva,alarm_dispositions, cuyas filas se eliminan con su alarma. - Campañas (
command-delivery, migración20261116120000). Tres tablas nuevas,campaigns,campaign_cyclesycampaign_elements, con sus índices. - Vínculos semánticos (
device-management, migración20261120120000). Columnas que admiten nulos para los vínculos en las tablas de tipos, tipos de relación y métricas, y una tabla nueva,semantic_contexts.
No hay que deshacer nada en ninguna base de datos para volver a v1.2.0: las tablas, columnas e índices nuevos se quedan y los servicios de v1.2.0 los ignoran. Antes de volver atrás, devuelve el modo OCSP de cada ancla de confianza a OFF y el commandChannel de cada tipo de dispositivo a PUBLISH, y desactiva httpIngest.deviceUplinks, lpwanDownlink.enabled y la firma de webhooks, porque v1.2.0 no los conoce. Avanza cuando puedas: una actualización fallida se arregla volviendo a ejecutar dcctl upgrade.
Problemas conocidos
- La confirmación MQTT en modo de fallo cerrado está desactivada por defecto, como en
v1.2.0. La página del transporte MQTT indica los límites medidos con ella desactivada y activada. - Un cambio en la configuración del broker sigue desconectando a los dispositivos que admitió el callout de autenticación, hasta que la biblioteca del broker incluya la corrección de origen. Una renovación de certificado no lo hace.
eventSources.ingestMetering: lagCreditsigue sin estar disponible, y se rechaza al arrancar; consulta Medición de la ingesta. Llega, con activación opcional, env1.4.0.- OCSP todavía no almacena lo que averigua ni termina las sesiones abiertas, como se describe en OCSP para conexiones con certificado.
- Un evento almacenado más de 10 minutos después del final de la hora en que se recibió no se cuenta en el registro de uso del inquilino, y tampoco un evento recibido después de la actualización pero fechado dentro de un fragmento que ya estaba comprimido. Consulta Uso de eventos por inquilino.
v1.2.0 — decodificadores de carga útil que escribe cada inquilino, y una revocación que cierra sesiones
v1.2.0 es una actualización in situ desde v1.1.0: dcctl install para el clúster y después un dcctl upgrade por cada instancia, como se describe para v0.17.0. Pasa a dcctl install los ajustes con los que se instaló el clúster, como --cluster, --kube-context, --ha, --compact y --database-node-selector, además de --version. Durante la actualización se ejecutan ocho migraciones añadidas (cuatro en device-management, tres en device-state y una en user-management); agregan tablas, columnas que admiten nulos y parámetros de almacenamiento, y dos reparan una columna de device_states. Consulta Cambios de esquema y vuelta atrás. El nuevo campo spec.size de Instance se entrega con el operador, que dcctl install actualiza, así que ejecútalo antes de actualizar la instancia, como se indica arriba. Si vienes de v1.0.0, lee primero las notas de v1.1.0 y sigúelas con --version v1.2.0.
dcctl install local --version v1.2.0
dcctl upgrade local devicechain --version v1.2.0 --dry-run
dcctl upgrade local devicechain --version v1.2.0
Se aplica la política de versiones y actualización. Esta versión amplía las interfaces cubiertas (nuevas banderas de dcctl; nuevas consultas, mutaciones y campos GraphQL; un nuevo motivo de evento fallido; tres nuevos tipos de canal de notificación; un nuevo campo de Instance y una nueva opción del SDK de C#) y no elimina ninguna. Una forma de solicitud OAuth queda obsoleta y se sigue aceptando hasta la próxima versión mayor. Los valores de Helm que cambia esta versión no están cubiertos por la política de compatibilidad, y esta sección es donde una versión menor lo indica.
Novedades:
- Cada inquilino puede escribir sus propios decodificadores de carga útil. Un perfil de dispositivo lleva un decodificador escrito como expresiones, que convierte una trama LoRaWAN u otra trama binaria, un cuerpo JSON genérico o el objeto decodificado de un servidor de red en mediciones. Se escribe y se prueba en la pestaña Decodificador de la consola, la publicación exige que pasen sus vectores de prueba guardados, y se ejecuta en vivo sobre cada enlace ascendente de una integración entrante. Cada decodificador tiene un presupuesto, así que uno roto no inunda la plataforma, y su salud (decodificados, ignorados, fallidos, suprimidos) y sus últimos enlaces ascendentes fallidos están en la misma pestaña. Consulta Decodificadores de carga útil y Un decodificador que falla tiene un presupuesto.
- Los certificados X.509 se pueden revocar, y una revocación cierra las sesiones a las que afecta. Sube la lista de revocación (CRL) de una autoridad de certificación a un ancla de confianza, o revoca un certificado a mano; un ancla puede exigir una lista vigente. Revocar cierra las sesiones abiertas de los dispositivos afectados, con una segunda pasada entre 10 y 40 segundos después (
resweepAfter). El SDK de C# y el paquete de Unity pueden conectar ahora un dispositivo con un certificado de cliente. Consulta Listas de revocación X.509 y Revocar un certificado cierra las sesiones abiertas. - Las alarmas llegan de forma nativa a Slack, Microsoft Teams y PagerDuty, como canales de notificación propios, configurados en una nueva página de la consola. Consulta Canales de notificación nativos.
- Tres widgets de panel nuevos: una cuadrícula de estado para un grupo de dispositivos, una línea de tiempo de estados y símbolos SCADA (bomba, válvula, tanque, motor, ventilador, tubería, sensor, interruptor, luz). Consulta Tres widgets de panel nuevos.
- Tamaños predefinidos.
dcctl bootstrap --size perf-12kaplica el dimensionamiento medido en un clúster que sostiene 12.000 eventos por segundo; una instancia que no indica tamaño no cambia. Consulta Tamaños predefinidos. - La detección usa mucha menos memoria. Una regla de ausencia o de sesión guarda un temporizador por dispositivo en lugar de uno por evento (de 370 MiB a 2,6 MiB en un caso medido), y la protección contra eventos duplicados ocupa un 40 % menos a 20.000 eventos por segundo. Consulta Memoria de la detección.
- Se comprueba la audiencia de los tokens, en modo de observación. Los tokens vinculados a un recurso que esta instancia no sirve se cuentan y se registran, y en esta versión no se rechaza nada. Consulta Los tokens se comprueban contra su recurso.
- Correcciones que importan para los datos: el endpoint HTTP de eventos responde
500, no202, a un evento que no pudo construir, así que ya no se le dice a quien llama que un evento se almacenó cuando no fue así; una revocación que no puede identificar las sesiones a las que afecta lo indica (sessionsEnded: false) en lugar de informar éxito. La página de recuperación ante desastres clasifica ahora cada stream, cada bucket y el almacén de objetos según lo que una restauración les debe.
Lo que exige actuar, en el orden en que hacerlo:
-
Tenga en cuenta que dos límites de memoria son más altos.
device-managementtiene ahora un límite de 512Mi (antes 256Mi) yevent-processingtiene un límite de 768Mi (antes 384Mi) mientras cualquiera de los ajustes de sobres de eventos esté activado. Nada cambia paraevent-processingcon ambos ajustes desactivados. Las solicitudes de memoria no cambian, así que la planificación es la misma; cada límite es un techo que el pod puede usar. Consulte Límites de memoria. -
Revise cualquier límite de memoria que haya fijado usted. Un límite fijado en
device-managementoevent-processingconfunctionalAreas.<servicio>.resources.limits.memoryse usa tal cual, igual que unresources.limits.memorysuperior de nivel superior. Si el suyo está por debajo de las cifras de Dimensionamiento de los servicios para su flota o su ritmo de eventos, súbalo. -
Tenga en cuenta que
device-managementguarda más de la flota en memoria, y que su límite de memoria es 768Mi, no los 512Mi de arriba. Las cachés por dispositivo (inMemoryCache.perDeviceCacheMiB) son de 80 MiB cada una, antes 24, porque 24 MiB solo guardaban de 8.000 a 10.000 dispositivos. Cada réplica usa ahora más memoria con una flota de ese tamaño o mayor. Si fija usted el límite de memoria dedevice-management, compárelo con la regla de Dimensionamiento de los servicios. Si fija ustedperDeviceCacheMiB, su valor se usa tal cual. Consulte Dimensionamiento de cachés y bróker. -
Con sobres de eventos activados y 16.000 eventos por segundo o más, fije
event-processingen unos 1Gi. El mínimo de 768Mi no crece con el ritmo. Consulte Dimensionamiento de cachés y bróker. -
Aumente
nats_memory_limitsi el conjunto de trabajo de un servidor del bróker está en su límite blando, que los 4Gi por defecto alcanzan desde unos 12.000 eventos por segundo. Un servidor en ese punto va lento, no se reinicia. Consulte Dimensionamiento de cachés y bróker. -
dcctl bootstrapahora rechaza el estado local que pertenece a otro clúster. Incluye--dry-run. Si reconstruyó un clúster fuera dedcctly reutiliza un nombre de instancia, mueva antes~/.devicechain/instances/<nombre>; vea los detalles. -
Compruebe si algo solicita tokens para un recurso que esta instancia no sirve. Por defecto, esta versión cuenta esas solicitudes y las llamadas a la API que usan sus tokens, pero no rechaza ninguna.
v1.3las rechaza por defecto.infrastructure.tokenAudience.enforcement: observeconserva el comportamiento de esta versión durante esa versión menor, yv1.4rechazaobserveal arrancar y en el esquema de valores del chart. Consulte Los tokens se comprueban contra su recurso. -
Haga que las solicitudes
client_credentialsque indican unresourceindiquen también unscope. Una solicitud así se cuenta y se registra en esta versión y sigue funcionando. Solo se rechaza en la próxima versión mayor. Consulte Los tokens se comprueban contra su recurso. -
Si escribe usted mismo la configuración de la instancia (
instance.existingSecret), añadainfrastructure.tokenAudience. Cuando el área MCP está desplegada y el documento no incluye su recurso,dcctl upgrademuestra un aviso con el bloque que hay que añadir, y se niega a continuar cuandoenforcementesenforce. Consulte Los tokens se comprueban contra su recurso. -
Sepa que un pod de la
v1.1reiniciado durante la actualización progresiva no arrancará; espera a su sustituto. Dos cosas cambian antes de que se renueven los pods. La configuración de la instancia ahora llevainfrastructure.tokenAudience, y los servicios de lav1.1rechazan al arrancar una clave que no conocen. Y el paso del broker de la actualización (el hook pre-upgrade del chart) ajusta los streams y buckets del broker a lo que declara lav1.2, y un pod de lav1.1los comprueba al arrancar contra sus propias declaraciones, así que uno que arranque después de ese paso puede detenerse constream ... does not match what this build declares. Un pod de lav1.1que se reprograme, se expulse o se reinicie a partir de ese momento no arrancará hasta que lo sustituya un pod de lav1.2, lo que la actualización hace por sí sola; deje avanzar la actualización y no la detenga a medias. Los pods que ya se estaban ejecutando siguen funcionando. Consulte Los tokens se comprueban contra su recurso. -
Si fija usted mismo la
resourceUrldel servidor MCP, escriba su esquema y su host en minúsculas antes de la aplicación obligatoria. Consulte Los tokens se comprueban contra su recurso. -
Espere que los cambios de perfil y de tipo de dispositivo lleguen tarde a las réplicas actualizadas mientras dura el despliegue. Consulte Cambios de perfil durante una actualización progresiva.
-
Tenga en cuenta que los uplinks de los tipos de dispositivo con un decodificador de carga útil esperan en un flujo pequeño. Consulte Uplinks con decodificador e interrupciones de device-management.
-
Atienda un nuevo motivo de evento fallido,
DECODE_FAILED. Un cliente que use unswitchexhaustivo sobreFailedEventReasonverá un valor más. Consulte Un nuevo motivo de evento fallido. -
Espere que un decodificador de carga útil que falla deje de llenar los eventos fallidos. Para cada tipo de dispositivo, cada réplica de
device-managementregistra los primeros 20 fallos de decodificación y después 10 por minuto; el resto se confirma (ack) y se cuenta como suprimido, sin registrarse. Hay dos alertas nuevas,PayloadDecoderFailuresHighyPayloadDecoderSuppressing: añádalas a su enrutamiento de alertas. Consulte Un decodificador de carga útil que falla tiene un presupuesto. -
Sepa que
DeviceState.inactivityAlarmTimevuelve a ser lo que era antes dev1.1.0.v1.1.0lo derivaba delastDisconnectTime, de modo que informaba una hora para un dispositivo que pasó a desconectado por un informe de desconexión y nunca quedó en silencio. Vuelve a ser el instante en que el barrido de inactividad marcó el dispositivo como inactivo, y es nulo para un dispositivo que el barrido no ha marcado o que vuelve a estar activo. El campo sigue obsoleto, se elimina en la próxima versión mayor, ylastDisconnectTimesigue siendo el campo que hay que usar. El primer arranque dev1.2.0repara las filas que dejóv1.1.0: borra un valor residual en un dispositivo activo y rellena el valor desdelastDisconnectTimeen un dispositivo inferido que está inactivo y no lo tiene. Un dispositivo que un pod dev1.1.0marque como inactivo mientras el despliegue sigue en curso responde el instante en que ese pod lo marcó, leído delastDisconnectTime, como lo habría hechov1.0.0. Una segunda migración repasa después cualquier fila que un escritor dev1.1.0mantuviera bloqueada mientras corría la primera, reintentando durante unos treinta segundos. Una fila que siga bloqueada después se registra y se deja, y el campo responde correctamente por ella al leerse. -
Publique el decodificador de payload de un perfil solo cuando todas las réplicas de
device-managementejecuten esta versión. Una versión publicada mientras una réplica anterior sigue atendiendo puede quedarse sin su decodificador; consulte Decodificadores de payload. -
Tenga en cuenta que las listas de revocación de certificados X.509 son nuevas y opcionales. No hay que hacer nada para actualizar; lea Listas de revocación antes de subir una.
-
Compruebe el espacio libre del almacén de eventos antes de actualizar. En una instancia existente,
dcctl upgradesube elmax_wal_sizedel almacén de eventos a una quinta parte de su volumen (6,4 GiB con los 32Gi predeterminados, frente a 1 GiB), y el registro de escritura anticipada puede crecer ahora hasta ese tamaño, o más si el archivado se retrasa, en el volumen de datos. La actualización imprime un aviso cuando el valor sube y advierte si el volumen tiene menos espacio libre que el nuevo tamaño. Para conservar la asignación anterior, ejecutedcctl upgrade --event-store-max-wal-mib 1024. Consulte Asignación del registro de escritura anticipada del almacén de eventos. -
Si grafica los agentes de borde con el tablero incluido, rásquelos con el nombre de job
dc-edge-agent. Los paneles de proceso del tablero (memoria, CPU, goroutines, archivos abiertos) ahora seleccionan ese job, de modo que otro job en la misma máquina ya no suma sus propias series de proceso a los paneles de un agente. Con otro nombre de job esos paneles aparecen vacíos. Véase Tablero del agente de borde y el job de rascado. -
dcctl sim createahora rechaza un nivel existente que no declara un límite que debía cumplir. Con--tierque nombra un nivel que ya existe,dcctlsolo sube los límites que están por debajo de lo que piden el escenario o--tier-config, y no puede ver un valor por defecto que el nivel hereda. Hasta ahora un límite que el nivel omitía se leía como 0 y se fijaba en el mínimo, lo que podía sustituir un valor mayor heredado; ahora el nivel se rechaza y se nombra la clave que falta. Añada la clave al nivel (la mutaciónupdateTenantTierde la API de administración de user-management) o elija un nivel que la declare. Una ejecución dedcctl sim create --tier-configen lav1.1podía escribir esas claves en un nivel existente, como describen las notas de lav1.1.0; desde esta versión ya no lo hace. Un límitenullen--tier-configtambién se rechaza; antes se leía como 0. Consulte Otros cambios. -
Sepa que
dcctl upgradeahora puede fallar conupgrade incompletedespués de que el broker se reinicie. Cuando los servidores del broker están listos, la actualización vuelve a leer sus reclamaciones de volumen durante hasta dos minutos y falla si alguna tiene menos capacidad de la que solicita, porque el límite de almacenamiento de archivos del broker sigue a la solicitud. Termine o revierta el cambio de tamaño del volumen (kubectl -n <namespace> describe pvc) y ejecutedcctl upgradede nuevo. Consulte Otros cambios. -
Tenga en cuenta que revocar un certificado ahora termina las sesiones abiertas a las que afecta. Revocar una autoridad certificadora puede reconectar de golpe toda una flota. Vea Revocar un certificado termina las sesiones abiertas.
-
Tenga en cuenta que
POST /{instanceId}/{tenant}/eventsahora puede responder500. Un evento descartado al construir su mensaje (una credencial que presentó no se pudo sellar, o el evento no se pudo codificar) se respondía202y no se almacenaba en ningún sitio. Ahora se responde500, no se almacena, y un reintento falla igual; un cliente que reintentaba toda respuesta distinta de202debe dejar de reintentar un500. Consulte HTTP deja de responder 202 a un evento descartado. -
Crea canales de notificación de Slack, Teams y PagerDuty solo cuando termine el despliegue. Un pod de la
v1.1que siga en marcha omite un canal de un tipo nuevo, y nada lo reintenta. Consulta Canales de notificación nativos. -
No hace falta hacer nada por la nueva opción
--size.dcctl bootstrap --size perf-12kaplica un dimensionamiento de alto rendimiento medido, ydcctl install --size compactequivale a--compact, que se mantiene. Una instancia que no indica tamaño genera exactamente lo que generaba antes. Consulte Preajustes de tamaño. -
Sepa que
devicechain_eventprocessing_detect_pending_timersahora cuenta las claves armadas. Antes contaba cada temporizador que una regla de ausencia o de sesión había insertado y que aún no vencía, y crecía con la tasa de eventos; el motor ahora guarda una entrada por dispositivo armado, de modo que el indicador sigue el número de dispositivos y la memoria de las reglas de ausencia y de sesión ya no crece con la tasa de eventos. El nombre y la alerta no cambian; un panel o un umbral de alerta que ajustó a los valores anteriores, más altos, puede bajarse. Consulte Memoria de la detección. -
No hace falta hacer nada por
eventSources.ingestMetering. Es un valor nuevo de Helm cuyo valor por defecto,legacy, es la medición de ingesta que han usado todas las versiones. Consulte Medición de la ingesta.
Las partes de la detección se ejecutan en paralelo
El ajuste detectShards de event-processing (1 por defecto, de 1 a 64) divide por clave el estado del motor de detección. En v1.1.0 las partes se aplicaban una tras otra, de modo que un valor superior a 1 daba los mismos resultados y ninguna aceleración. A partir de esta versión cada parte se ejecuta en su propia goroutine, así que el trabajo propio del motor puede usar varios núcleos. Las detecciones, el reloj del tiempo del evento y el punto de control guardado son los mismos con cualquier valor, por lo que no hay nada que migrar y el ajuste puede cambiarse o revertirse en cualquier reinicio.
- No hay que hacer nada si dejó
detectShardsen 1. El motor es el mismo código de antes. - Si fijó
detectShardspor encima de 1, el pod de event-processing puede usar ahora hasta ese número de núcleos para el motor, además del bucle único que lee y planifica los mensajes. Compruebe el límite de CPU del pod antes de contar con ello, y lea Ejecutar el motor en más núcleos para ver si el motor es realmente su límite. - Hay dos alertas nuevas:
DetectShardSaturated(una parte es el límite de la velocidad de detección) yDetectShardInvariantViolated(las partes discreparon en un punto de control y este se rechazó). Se instalan con cualquier valor, pero solo pueden dispararse condetectShardssuperior a 1. Añádalas a su enrutado de alertas. Las acompaña un conjunto nuevo de métricasdetect_shard_*ydetect_barrier_wait_seconds; las dos sin etiqueta se exportan a 0 con 1. - La memoria crece con
detectShards. Cada parte retiene hasta 1024 mensajes en cola, así que un pod que ya funciona con un valor superior a 1 puede retener en memoria hastadetectShardsveces esa cantidad mientras el bucle va por delante de la parte más lenta. Compruebe el límite de memoria del pod antes de contar con el nuevo ajuste. - Volver atrás es un reinicio con el ajuste en el valor anterior. El punto de control es idéntico, así que no hay nada que deshacer.
Memoria de la detección
Dos partes de event-processing usaban memoria que crecía con la tasa de eventos. Ninguno de los dos cambios altera una detección, un punto de control ni un ajuste.
- Las reglas de ausencia y de sesión guardan un temporizador por dispositivo. Antes insertaban un temporizador por cada evento y dejaban el reemplazado hasta su vencimiento. Con 10.000 dispositivos a 12.000 eventos por segundo y una regla de ausencia de 5 minutos, el heap vivo del motor bajó de 369,9 MiB (3.660.015 temporizadores) a 2,6 MiB (10.000 temporizadores). Las ventanas deslizantes solo construyen las estructuras adicionales de mínimo y máximo cuando una regla las pide; con la misma carga, una media de 5 minutos pasó de 188,7 a 178,9 MiB, y más en una serie con tendencia. Un punto de control es byte a byte el que era, así que no se migra nada y volver atrás es un reinicio.
devicechain_eventprocessing_detect_pending_timersahora cuenta los dispositivos armados, como se describe en la lista anterior. - La protección contra eventos duplicados es más pequeña. Con los sobres de eventos activados ocupaba unos 188 MiB vivos a 20.000 eventos por segundo; ahora ocupa unos 113 MiB, unos 9,4 bytes por evento recordado a cualquier tasa, sin un salto de memoria cerca de 13.000 eventos por segundo. Los eventos que admite no cambian.
Los mínimos de memoria de Límites de memoria y Dimensionamiento de cachés y broker se midieron antes de estos cambios y no se reducen: dejan margen para las reglas con ventanas y para las tasas más altas.
Medición de la ingesta
El chart tiene un valor nuevo, eventSources.ingestMetering, que indica cómo event-sources mide un mensaje contra el techo de ingesta de su inquilino. Su valor por defecto, legacy, es la medición que usaron todas las versiones anteriores, así que nada cambia. El otro valor, lagCredit, está reservado para una medición que no recorta a un inquilino que se mantuvo dentro de su techo durante una parada breve de la plataforma. No está disponible en esta versión: event-sources se niega a arrancar con él en lugar de volver a legacy, así que deje el valor sin definir. Se entrega como variable de entorno de los pods de event-sources y a propósito no es una clave de la configuración de la instancia, de modo que un pod de la v1.1 que se reinicie durante la actualización nunca la ve. dcctl lo acepta en un overlay de --values.
Límites de memoria
Ambos límites estaban a un paso de lo que se midió que los servicios ocupan, en una prueba en Google Kubernetes Engine de hasta 16 000 eventos por segundo:
device-managementmantiene toda la flota de dispositivos en memoria en cada réplica. Su montón de Go fue de 154 MiB con 6 000 dispositivos y de 193 a 218 MiB con 12 000 a 16 000, frente a un límite de 256Mi cuyo límite blando (GOMEMLIMIT) es de 192 MiB. Una flota de unos 12 000 dispositivos alcanzaba por tanto el límite blando, y una mayor corría el riesgo de que el pod fuera terminado por superar su límite. El chart fija ahora el mínimo en 512Mi (límite blando de 384 MiB).event-processingcon sobres de eventos activados guarda la protección contra duplicados descrita en Sobres de eventos. Usó de 265 a 269 MiB con 4 500 a 6 000 eventos por segundo y 388 MiB con 12 000, con 353 MiB de montón de Go, frente a un límite de 384Mi con un límite blando de 288 MiB. Por encima de unos 8 000 eventos por segundo el pod habría quedado retenido en su límite blando, recolectando sin parar, o habría sido terminado. El chart fija ahora el mínimo en 768Mi (límite blando de 576 MiB) mientrasresolvedoinboundesté activado, y en 384Mi en caso contrario. La cifra anterior para la protección (unos 180 MB a 20 000 eventos por segundo) era de tres a cuatro veces demasiado baja; las cifras corregidas están en Sobres de eventos.
Ambos son mínimos, aplicados solo cuando el límite que se aplicaría de otro modo es menor. Un límite fijado en el servicio, o un límite de nivel superior mayor, se usa tal cual, y el límite blando sigue al límite que se aplique. El nuevo valor functionalAreas.<servicio>.memoryLimitFloorWithEnvelopes contiene el mínimo con sobres. dcctl fija eventEnvelopesEnabled a partir de la configuración de instancia que escribe. Si instala el chart usted mismo con instance.existingSecret, el chart no puede leer esa configuración: fije eventEnvelopesEnabled: true cuando active cualquiera de los ajustes de sobres.
Dimensionamiento de cachés y bróker
La ronda 30 en Google Kubernetes Engine (de 8.000 a 20.000 eventos por segundo, un servidor del bróker) encontró tres tamaños incluidos por defecto por debajo de la carga para la que están documentados.
- Las cachés por dispositivo de
device-managementson de 80 MiB, no de 24. Un dispositivo ocupa de 2,5 a 3,1 KB en la caché por token, así que 24 MiB guardaban de 8.000 a 10.000 dispositivos. Con 16.000 dispositivos la caché expulsó una entrada en el 73 % de las consultas, la CPU por evento pasó de 0,048 a 0,105 segundos de CPU por cada 1.000 eventos entre 8.000 y 16.000 dispositivos, y con 20.000 las lecturas pasaban al cubo clave-valor y agotaban el tiempo.DeviceLookupCacheTooSmallya saltaba desde 12.000 dispositivos; no cambia. 80 MiB guardan 27.000 dispositivos por token, la flota de 20.000 dispositivos a la que apuntan las tablas de dimensionamiento con una cuarta parte de margen. Para otras flotas, fijeinMemoryCache.perDeviceCacheMiBen 4 por cada 1.000 dispositivos que se resuelven por su token. La regla, con el límite de memoria que necesita, está en Dimensionamiento de los servicios y en Cachés que dejan de responder. - El mínimo de memoria de
device-managementes 768Mi (límite blando de 576 MiB), y sustituye a los 512Mi de Límites de memoria. Con el límite mayor, todas las cachés llenas ocupan unos 370 MiB vivos con el servicio, lo que habría dejado al límite blando de 512Mi (384 MiB) en 1,04 veces eso, y deja a 768Mi en 1,5 veces. Las reglas del mínimo son las mismas: un límite que fije usted en el servicio, o un límite superior de nivel superior, se usa tal cual. - El mínimo de
event-processingcon sobres activados sigue siendo 768Mi, y no crece con el ritmo. Su montón de Go fue de 441, 488, 511 y 516 MiB con 8.000, 12.000, 16.000 y 20.000 eventos por segundo (residente de 500 a 571 MiB), frente al límite blando de 576 MiB, así que desde unos 16.000 eventos por segundo sostenidos recolecta en el límite. Fije ahí unos 1Gi (functionalAreas.event-processing.resources.limits.memory). - El límite blando del límite de memoria de 4Gi del bróker se alcanza a unos 12.000 eventos por segundo. El conjunto de trabajo de un servidor fue de 1,9, 3,0, 3,8 y 4,8 GiB con 8.000, 12.000, 16.000 y 20.000 eventos por segundo, frente a un límite blando de 3,2 GiB. Por encima, no lo matan: el servidor recolecta sin parar, y a 12.000 eventos por segundo el tiempo de confirmación en el percentil 99 fue de 101 ms con 4Gi y de 25 ms con 20Gi. Aumente
nats_memory_limitcuando el conjunto de trabajo esté a menos del 10 % del 80 % del límite, y no solo después de unOOMKilled; cuente 0,35 GiB por cada 1.000 eventos por segundo para los que diseñe. Consulte El intermediario de mensajes.
dcctl bootstrap rechaza el estado local que pertenece a otro clúster
dcctl bootstrap (y dcctl bootstrap --dry-run) ahora se niega cuando el estado local de ese nombre de instancia, en ~/.devicechain/instances/<nombre>, se registró contra un clúster distinto del que el comando apunta. Antes se reescribía en silencio con la identidad del clúster nuevo y se planificaba sobre el estado de OpenTofu y las credenciales del broker del clúster anterior, lo que fallaba después con un mensaje sin relación (por ejemplo, la negativa a reducir un clúster de brokers que no existe). El rechazo nombra ambos clústeres e imprime el comando que lo resuelve. Si el clúster registrado ya no existe, mueva el directorio a otro lugar; contiene credenciales, así que conserve la copia en lugar de borrarla:
mv ~/.devicechain/instances/<nombre> ~/.devicechain/<nombre>.stale-state
Si el clúster registrado sigue en marcha, use otro nombre de instancia. Un registro de un dcctl anterior sin identidad de clúster no se rechaza. No cambió ningún comando ni opción de dcctl.
Los tokens se comprueban contra su recurso
Un cliente OAuth puede pedir un token vinculado a un recurso con el parámetro resource de las solicitudes de autorización y de token. Hasta ahora el servidor de autorización aceptaba cualquier valor y ninguna API miraba ese vínculo, así que un token vinculado a un recurso era aceptado por todas las API. Esta versión añade dos comprobaciones y por defecto, en esta versión ambas solo cuentan y registran. No se rechaza nada, salvo que usted establezca enforcement: enforce. Audiencia del token explica las reglas.
- El servidor de autorización comprueba el recurso solicitado. Los recursos permitidos son el servidor MCP de esta instancia, la API de cada área en
<origin>/api/<área>y lo que figure eninfrastructure.tokenAudience.externalResources. La comprobación se hace en el endpoint de autorización, en la concesiónclient_credentialsy en cada renovación. Un valor que no está en la lista se cuenta endevicechain_usermanagement_oauth_resource_checks_total{verdict="would_reject"}. También se cuentan, solo en el endpoint de autorización, un valor que no es una URLhttpsabsoluta (httpsolo para un host de loopback) y una solicitud con más de unresource. La concesiónclient_credentialsya rechaza esos dos casos. - Cada API comprueba la audiencia del token. La API de un área acepta un token sin vínculo, vinculado a esa área o vinculado al servidor MCP. Cualquier otro se cuenta en
devicechain_<área>_token_audience_checks_total{verdict="would_reject"}. Un token obtenido al iniciar sesión en la consola, la aplicación de paneles, el SDK de C# odcctlno tiene vínculo, así que no le afecta. Las llamadas del servidor MCP a las API llevan el vínculo MCP y se aceptan.
Ambos contadores vienen con una alerta info (TokenAudienceWouldReject y OAuthResourceWouldReject) y con un aviso limitado en frecuencia en el registro del servicio, que indica el cliente OAuth y el inquilino. Comprobaciones de la audiencia del token explica cómo leerlos.
v1.3 los rechaza por defecto. Una solicitud de autorización se devuelve a la dirección de redirección del cliente con invalid_target, una solicitud client_credentials responde invalid_target, una renovación o un código de autorización vinculados a un recurso que ya no se sirve responden invalid_grant, una solicitud cuyo resource difiere del de su código o token de renovación responde invalid_target, y una API responde 401. Un token de renovación rechazado porque su recurso ya no se sirve queda gastado: volver a observe o retroceder de versión restablece la configuración pero no esa sesión, y el cliente debe autorizar de nuevo. Si alguno de los contadores se mueve, localice el cliente en la línea de registro y cambie el resource que envía: omítalo o use uno de los valores anteriores. Si un servicio suyo valida tokens de la plataforma con el conjunto de claves publicado y pide tokens vinculados a sí mismo, añada su identificador a externalResources. Las API de la plataforma nunca aceptan un token vinculado a un recurso externo; tampoco lo acepta el endpoint userinfo del servidor de autorización.
- Para conservar el comportamiento de esta versión una versión menor más, establezca
infrastructure.tokenAudience.enforcement: observeantes de actualizar av1.3. Esta versión ya lo acepta, y establecerlo antes evita que ningún pod aplique la comprobación durante el despliegue.v1.4rechaza ese valor: un servicio se detiene al arrancar con una indicación de qué hacer, y el esquema de valores del chart lo rechaza para quehelm upgradese detenga antes de reiniciar ningún pod. - Para activar la aplicación obligatoria antes, establezca
enforcement: enforceen esta versión, lo que reinicia los pods una vez. Cuandov1.3cambie el valor por defecto, los pods antiguos y los nuevos coexisten durante el despliegue, así que durante unos minutos un mismo token puede ser aceptado por una réplica y rechazado por otra. Establecerlo antes lo evita.
El chart y dcctl escriben infrastructure.tokenAudience por usted, a partir del host del ingress y de la dirección del servidor MCP. No establezca areaBaseUrl ni mcpResources en instance.config: el renderizado lo rechaza. Un ingress sin TLS en un host distinto de localhost no tiene recursos de área, igual que no tiene servidor de autorización. Las claves que puede establecer son enforcement, unscopedClientCredentials y externalResources; consulte Configuración.
El registro del servidor MCP. mcp comprueba al arrancar que su resourceUrl figura en infrastructure.tokenAudience.mcpResources. Si no figura, mcp registra un Error en cada arranque e informa del medidor devicechain_mcp_token_audience_registered con valor 0, y las llamadas que reenvía se cuentan como rechazos que se habrían producido. Con enforcement: enforce se niega a arrancar.
- En una instancia que escribe el chart el chart siempre la incluye, así que el medidor vale 1. Las excepciones son una
functionalAreas.mcp.config.resourceUrlexplícita cuyo esquema o host contenga una letra mayúscula, y una que sea igual al identificador propio de un área de la plataforma, como<origin>/api/device-management. La lista solo admite esquema y host en minúsculas, y la comparación es byte a byte. Con observe el chart omite ese valor, con los síntomas anteriores, y conenforcehace fallar el renderizado. El propiomcpsigue aceptando el valor, así que cámbielo a una dirección en minúsculas que no sea la de un área antes dev1.3. - Si escribe usted mismo la configuración de la instancia (
instance.existingSecret), el chart no escribe el bloque. Cuando su documento no tiene bloquetokenAudience, o sumcpResourcesno incluye laresourceUrldel servidor MCP, el medidor se queda en 0 y el Error se repite en cada arranque mientras falte la entrada. Eso es permanente hasta que la añada. Cuando el área MCP está desplegada,dcctl upgrademuestra un aviso con el bloque que hay que añadir y, conenforce, se niega a continuar. Añada el bloque conareaBaseUrl: <origin>/apiymcpResources: [<la resourceUrl del servidor MCP>], y actualiceinstance.existingSecretChecksum.
Obsoleto: una solicitud client_credentials que indica un resource sin un scope. Ese token lleva todas las autoridades de los roles de la cuenta de servicio. Envíe un scope junto con el recurso (read-only, opcionalmente con location). Un token con ámbito lleva solo las autoridades de lectura del ámbito, así que una integración que necesita escribir debe omitir el resource. La falta de ámbito nunca es motivo de rechazo en esta versión, así que la solicitud sigue funcionando. Cada una se cuenta en devicechain_usermanagement_oauth_unscoped_client_credentials_total y se registra con su cliente, y se rechaza con invalid_scope en la próxima versión mayor. Hasta entonces, infrastructure.tokenAudience.unscopedClientCredentials: enforce se rechaza al arrancar. Consulte Cuentas de servicio.
Volver atrás. Los servicios de v1.1 rechazan el bloque tokenAudience al arrancar. dcctl genera la configuración de v1.1 sin él. Si escribe usted mismo la configuración, elimine el bloque y actualice instance.existingSecretChecksum antes de volver.
Un nuevo motivo de evento fallido
FailedEventReason incorpora DECODE_FAILED: un decodificador de carga útil rechazó un uplink de una integración. El inicio del texto del error indica el motivo (por ejemplo no_section, eval_error o invalid_output). Se registra en la primera entrega y no se reintenta, porque el mismo uplink y el mismo decodificador dan la misma respuesta. La política de versiones permite un nuevo valor de enumeración en una versión menor; un cliente con un switch exhaustivo sobre los motivos debe contemplarlo, y un event-management anterior muestra el número como UNKNOWN junto con su reasonCode. dcctl acepta DECODE_FAILED en --reason.
Un decodificador de carga útil que falla tiene un presupuesto
Un decodificador incorrecto para un dispositivo falla en cada uplink de ese dispositivo, y cada fallo era un registro de eventos fallidos. En un tenant con mucho tráfico eso es una avalancha de registros en un flujo compartido por toda la plataforma. Desde esta versión, device-management somete cada tipo de dispositivo a un presupuesto antes de escribir el registro:
- Registros. En cada réplica, para cada tenant y tipo de dispositivo, los primeros 20 fallos de decodificación se registran en los eventos fallidos (motivo
DECODE_FAILED, con el uplink archivado). Después se registran 10 más por minuto. El mensaje de origen de todos los demás fallos se confirma sin registro, y el fallo se cuenta como suprimido. Un fallo suprimido solo ocurre cuando ya se han escrito 20 registros de ese tipo de dispositivo, de modo que un decodificador roto nunca pasa inadvertido. - Muestras. En cada réplica, para cada tenant y perfil, se conserva un uplink fallido cada 10 segundos, y un perfil conserva los 20 más recientes. El panel de pruebas puede cargar uno en la prueba del decodificador, que da el resultado que tuvo en vivo. Una muestra es de mejor esfuerzo: la que no se puede guardar (falla la escritura, o el JSON recibido no se puede volver a codificar) se cuenta en
resolve_decode_samples_dropped_total, y su fallo se registra igualmente. - El presupuesto es por réplica, de modo que el total de un tenant crece con el número de réplicas. No se puede configurar nada.
- Cada uplink se cuenta una vez por entrega. La salud del decodificador del perfil suma, por minuto, los uplinks decodificados, ignorados, fallidos (registrados) y suprimidos (no registrados). Los recuentos de
payloadDecoderHealthsonFloaty noInt, porque un decodificador con mucho tráfico supera un entero de 32 bits en una semana; son números enteros, exactos hasta 2^53. Las consultaspayloadDecoderHealthypayloadDecoderSamplesde la API GraphQL dedevice-managementson nuevas, aditivas y requierendevice:write; los bytes de una muestra solo son accesibles mediantetestPayloadDecoderconsampleId, con el mismo permiso. Las filas de salud se conservan 7 días. - Los recuentos pueden quedarse cortos tras una caída. Los totales se escriben una vez por minuto, así que una caída pierde hasta un minuto de recuentos, nunca un registro de eventos fallidos. Tras una caída, o mientras el flujo de eventos fallidos no está disponible, un uplink reenviado puede contarse dos veces. Un fallo reenviado siempre se registra, y aun así consume un token del presupuesto.
- Hay dos alertas nuevas.
PayloadDecoderFailuresHighsalta cuando más del 5 % de los uplinks decodificados fallan durante 15 minutos, yPayloadDecoderSuppressingsalta cuando se suprimen más de 50 fallos en 10 minutos. No llevan etiqueta de tenant; el índice de eventos fallidos y la salud del decodificador del perfil indican el tenant y el perfil. Métricas nuevas:resolve_decode_suppressed_total,resolve_decode_samples_dropped_total,resolve_decode_health_flush_failures_total,resolve_decode_health_lost_totalyresolve_decode_unattributed_total. - No hay que hacer nada para actualizar. Las tablas las creó la migración anterior de esta versión y no se ejecuta ninguna migración nueva. Una réplica anterior a esta versión no escribe salud ni muestras y no aplica presupuesto a los fallos.
Uplinks con decodificador e interrupciones de device-management
Un uplink de un tipo de dispositivo que tiene un decodificador de carga útil viaja de event-sources a device-management por un flujo propio. Ese flujo es pequeño y de tamaño fijo (32 MiB), por lo que el volumen de JetStream predeterminado y la tabla de dimensionamiento publicada no cambian. Si device-management deja de leerlo, el flujo se llena en segundos con tasas altas y event-sources responde con un 503 a las solicitudes de esas integraciones. Un remitente que reintenta una entrega fallida entregará el uplink cuando el flujo se vacíe; uno que no reintenta, no. Los webhooks de The Things Stack solo reintentan una entrega fallida con su función opcional de reintentos de webhook (una función de Cloud Plus, en la que cualquier respuesta distinta de 2xx cuenta como intento fallido), y la integración HTTP de ChirpStack v4 no documenta ningún reintento, así que trate los uplinks que envíe durante una interrupción como no reenviados. Los uplinks ya aceptados (respondidos con 202) no se pierden. Los uplinks de tipos de dispositivo sin decodificador se atienden como antes y no se ven afectados. Ejecute más de una réplica de device-management, las suficientes para que reiniciar una no detenga la lectura, de modo que una interrupción dure poco.
Cambios de perfil durante una actualización progresiva
device-management guarda ahora en caché la resolución del perfil de cada tipo de dispositivo bajo una clave nueva, de modo que una réplica de esta versión nunca lee una entrada escrita por una réplica anterior (las entradas antiguas no llevarían el decodificador de carga útil). Todo cambio hecho en una réplica de esta versión elimina la entrada bajo ambas claves. Un cambio hecho en una réplica anterior elimina solo la clave antigua, así que las réplicas actualizadas siguen sirviendo lo que tienen hasta que caduca.
- Los cambios de perfil y de tipo de dispositivo hechos mientras se actualiza de forma progresiva pueden tardar hasta aproximadamente el doble del tiempo de vida de la caché en llegar a las réplicas actualizadas (unos 10 minutos con los 300 segundos predeterminados de
metricDefCacheTtlSecondseinMemoryCache.ttlSeconds). Esto abarca una publicación, una reversión, un cambio de perfil de un tipo de dispositivo y un cambio de geovalla. Cuando todas las réplicas ejecutan esta versión, los cambios surten efecto de inmediato como antes. - Publique el decodificador de carga útil de un perfil solo cuando todas las réplicas de
device-managementejecuten esta versión. Una versión publicada desde una réplica anterior no contiene el decodificador. - La copia en proceso de esta caché es mayor. Está limitada a 32 MiB por réplica (antes 4 MiB), porque una entrada con un decodificador de carga útil contiene sus programas compilados. Las entradas sin decodificador no cambian de tamaño. El límite es
inMemoryCache.profileResolutionCacheMiB, yinMemoryCache.profileResolutionTenantSharePercent(25 por defecto) limita cuánto puede ocupar un solo inquilino, de modo que un inquilino con muchos decodificadores grandes queda limitado a su parte y expulsa primero sus propias entradas. Cuando la caché entera de una réplica está llena, cede una entrada primero el inquilino que más ocupa, así que un inquilino dentro de su cuota conserva sus entradas mientras otro mayor tenga algunas que ceder. La cuota de un inquilino es el espacio donde sus decodificadores grandes deben caber juntos: un decodificador máximo se contabiliza en unos 6 MiB, así que la cuota por defecto de 8 MiB admite uno, y dos en uso a la vez en el mismo inquilino se turnan, compilando su decodificador de nuevo en cada lectura. Dimensione la caché y la cuota según el número de decodificadores grandes que un inquilino mantiene en uso.device-managementahora se niega a arrancar si la cuota de un inquilino (profileResolutionCacheMiBxprofileResolutionTenantSharePercent) es inferior a 7 MiB, que es lo que se contabiliza para el mayor decodificador que permiten los límites: una cuota menor no podría mantenerlo decodificado, y cada evento de su tipo de dispositivo lo compilaría de nuevo. Un decodificador menor necesita menos. Las réplicas exportanpayload_decoder_compiles_total, y el chart avisa conPayloadDecoderRecompileSustainedcuando una réplica compila más de una vez por segundo durante 15 minutos. Si fija usted mismo un límite de memoria, cuente los 28 MiB adicionales.
Decodificadores de payload
Un perfil de dispositivo puede llevar ahora un decodificador de payload: reglas, escritas como expresiones, que convierten una trama binaria, un cuerpo JSON genérico o el objeto decodificado de un servidor de red en mediciones. La nueva guía Decodificadores de payload los describe, y la referencia de funciones enumera las funciones de la biblioteca y los límites. No hay que hacer nada para actualizar, y un perfil sin decodificador se comporta exactamente como antes.
- La creación y la prueba están en esta versión. La página del perfil de la consola tiene una pestaña Decodificador. En la API GraphQL de
device-management,setDeviceProfileDecoderyclearDeviceProfileDecoderescriben el decodificador del borrador del perfil,testPayloadDecoderejecuta un decodificador sobre una entrada sin guardar nada ypayloadDecoderFunctionsenumera la biblioteca de funciones.DeviceProfile.decoderyDeviceProfileVersion.decoderson campos nuevos que admiten nulos. Todo es aditivo. - La decodificación de uplinks en vivo está en esta versión. Cuando el dispositivo del que trata un uplink de una integración de entrada tiene un tipo de dispositivo cuya versión de perfil lleva un decodificador,
device-managementdecodifica el uplink con él y no se guarda lo que decodificó el servidor de red. Event-sources busca y recuerda el decodificador de un tipo de dispositivo durante aproximadamente un minuto, así que hasta un minuto después de publicar uno, un uplink aún puede guardarse como lo decodificó el servidor de red. Un uplink de un tipo de dispositivo sin decodificador se guarda como antes. El uplink se carga a la asignación de ingesta del inquilino al aceptarse: como mínimo el máximo de lecturas del decodificador (más tres si la integración guarda métricas de enlace), más para un decodificador costoso de ejecutar, y nunca más de 256. Si un decodificador publicado entretanto produce más, las lecturas se guardan ydevice-managementcuenta el exceso. Una decodificación fallida no guarda nada y se registra como un evento fallido con el motivoDECODE_FAILED; consulte Un nuevo motivo de evento fallido. El endpoint de integración ahora también pregunta adevice-managementsi el tipo del dispositivo tiene un decodificador, y responde503cuando no puede obtener la respuesta y no recuerda ninguna de los últimos 15 minutos, en lugar de guardar lecturas que un decodificador debía producir. Frente a undevice-managementque no conoce la pregunta, algo posible durante la actualización progresiva, el uplink se guarda como antes. - La publicación depende del decodificador. Un perfil con decodificador se publica, o se vuelve a una versión suya, solo si el decodificador compila con las métricas de esa versión y pasan todos los vectores de prueba guardados. Un perfil sin decodificador no se ve afectado.
- La migración es aditiva. Añade una columna que admite nulos a los perfiles de dispositivo y dos tablas en las que
device-managementregistra la salud del decodificador y las muestras de fallos (consulte Un decodificador de carga útil que falla tiene un presupuesto). Una réplica anterior no las lee. - La puerta de prueba tiene un límite de frecuencia por réplica.
testPayloadDecoderpermite 10 peticiones por segundo por inquilino, con una ráfaga de 20, en cada réplica dedevice-management, así que el total de un inquilino crece con el número de réplicas. Una petición por encima del límite se rechaza conRATE_LIMITED. - Durante una actualización progresiva, publique un decodificador solo cuando todas las réplicas de
device-managementejecuten esta versión. Una versión publicada mientras la petición la atiende una réplica anterior se congela sin su decodificador, porque esa réplica no conoce el campo. Terminada la actualización, compruebe queDeviceProfileVersion.decoderestá presente en la versión que publicó y, si no lo está, publique de nuevo.
La consola muestra el estado de un decodificador
La pestaña Decodificador de un perfil de dispositivo muestra ahora las últimas 24 horas del decodificador del perfil: cuántos uplinks se decodificaron, se ignoraron, fallaron y no se registraron (consulte Un decodificador de carga útil que falla tiene un presupuesto), y los uplinks fallidos guardados como muestras, cada uno con un botón que lo carga en el panel de prueba. Un enlace abre la página Eventos fallidos filtrada por DECODE_FAILED; esa página ofrece ahora el motivo como filtro propio y lo acepta como ?reason=DECODE_FAILED. Ambas partes de la pestaña requieren device:write, igual que las consultas en que se apoyan. No hay que hacer nada para actualizar: es solo la consola y usa las consultas payloadDecoderHealth y payloadDecoderSamples ya descritas.
Listas de revocación X.509
Un tenant puede ahora guardar la lista de revocación (CRL) de una autoridad certificadora en un ancla de confianza, y cada ancla tiene un modo de revocación. Un ancla sin lista y sin revocación manual se comporta exactamente como antes.
- Una CRL se sube por GraphQL o con un
PUTen streaming, y la plataforma comprueba su firma contra el ancla. El tamaño admitido es el ajuste fijodeviceManagement.callout.revocation.maxCrlBytes(2 MiB por defecto, hasta 32 MiB). Dimensiónelo según el límite de memoria del pod. Verificar una CRL la analiza entera, y una subida alcanza un pico de entre 20 y 30 veces el tamaño de la CRL en heap: una lista de 2 MiB cuesta de 40 a 65 MiB, y una de 7 MB con 300 000 entradas unos 190 MiB.maxConcurrentWrites(1 por defecto) es cuántas subidas procesa a la vez una réplica. - Una CRL más antigua nunca puede sustituir a una más nueva, ni siquiera después de borrar la lista: se conserva el número de CRL más alto aceptado para cada emisor. Borrar un ancla de confianza descarta esos números con ella, junto con sus listas y sus entradas, de modo que un ancla recreada a partir de la misma CA empieza de nuevo y acepta una CRL que antes se rechazó. Un ancla solo puede borrarse cuando ninguna credencial ni perfil de aprovisionamiento depende de ella.
- Borrar un ancla de confianza se rechaza mientras tenga revocaciones manuales. Anúlelas primero (
unrevokeDeviceCertificate); son decisiones suyas y nunca se descartan en silencio. REQUIRE_CURRENTes opcional por ancla. La plataforma se niega a cambiar un ancla a ese modo mientras no tenga ninguna lista vigente, o mientras un certificado registrado haya sido emitido por una CA que no la tiene, porque todos esos dispositivos serían rechazados.- Durante una actualización gradual, las réplicas que aún no se han sustituido responden al callout de autorización del broker sin comprobar revocaciones, así que una revocación solo se aplica en todas partes cuando termina el despliegue. Volver a
v1.1.0deja las tablas sin leer: las revocaciones dejan de aplicarse.
Un certificado de cliente en el SDK de C#
El SDK de C# y el paquete de Unity ya pueden conectar un dispositivo con un certificado de cliente X.509. Es un cambio aditivo: nada cambia para una sesión que no lo configure, y no hace falta ninguna acción para actualizar.
- Asigne
MqttSessionOptions.ClientCertificatea unMqttClientCertificatecargado desde un PFX o desde archivos PEM. La sesión se conecta entonces con el usuario{tenant}:@x509y sin contraseña. Consulte Conectar desde el SDK de C#. - Solo se pueden presentar claves RSA y ECDSA, porque .NET no tiene Ed25519. La dirección del broker debe ser
ssl://; una dirección en texto plano se rechaza al construir la sesión.
Revocar un certificado termina las sesiones abiertas
Revocar un certificado, a mano o subiendo una CRL que lo nombra, ahora también termina las sesiones abiertas de los dispositivos a los que afecta. Antes, una sesión ya abierta seguía hasta que caducaba su token (hasta 12 horas por defecto). No cambia nada en una instancia que no revoca nada.
- Un certificado de dispositivo termina las sesiones de los dispositivos que lo tienen. La revocación de una autoridad certificadora es más amplia: cuando revoca una CA entregando su certificado, o una CRL nombra un intermedio que se vio usar a una credencial registrada, se terminan las sesiones de todos los dispositivos con una credencial de certificado bajo esa ancla de confianza. Esos dispositivos se reconectan solos; aquellos cuya cadena sigue siendo de confianza se admiten de inmediato. Una llamada termina por sí misma las sesiones de hasta unos 5 000 dispositivos, así que una revocación a nivel de CA puede reconectar a ese número a la vez; el resto se termina en segundo plano. En una instancia actualizada desde una versión anterior, una credencial registrada antes de la actualización no tiene un intermedio registrado, así que una CRL que añade una entrada que no coincide con ninguna credencial almacenada también termina las sesiones de esas credenciales antiguas, por si la entrada es un intermedio que usan.
- Las sesiones se terminan dos veces. Una al confirmarse la revocación y otra entre 10 y 40 segundos después. La segunda pasada alcanza a un dispositivo que se estaba admitiendo en el instante de la revocación. Vence pasado
deviceManagement.callout.revocation.resweepAfter, un ajuste fijo (10 segundos por defecto, hasta 5 minutos), y se ejecuta en el siguiente ciclo del reintento de cierre de sesiones, que corre cada 30 segundos, así que llega entre ese retraso y 30 segundos más tarde. El retraso debe superar el tiempo de espera de consulta del callout más los 5 segundos de autorización del broker, odevice-managementse niega a arrancar. Por eso una revocación a nivel de CA consulta dos veces a toda el ancla. - Una revocación por huella simple puede informar
sessionsEnded: falseen una instancia actualizada. Una credencial registrada antes de la actualización no tiene intermedio registrado, así que revocar un intermedio solo confingerprintSha256no puede saber qué sesiones afecta. La revocación se mantiene y las conexiones nuevas a través de él se rechazan, pero el resultado dicesessionsEnded: false. Repite la revocación con elcertificatePemdel intermedio para terminar las sesiones de todos los dispositivos del ancla. - Revocar puede tardar contra un respondedor lento. La llamada espera al servicio que termina las sesiones (
event-sources) hasta unos 90 segundos. Si no puede confirmarlo, la revocación sigue en pie y las conexiones nuevas se rechazan; el resultado indicasessionsEnded: false, la plataforma sigue reintentando y repetir la revocación o la subida vuelve a preguntar. - Durante una actualización gradual, los nuevos cierres de sesión llevan un motivo nuevo que
event-sourcesdebe entender. Hasta queevent-sourcesse haya reemplazado, estos cierres quedan pendientes y se reintentan, de modo que una revocación hecha a mitad de la actualización termina las sesiones abiertas cuandoevent-sourcesse haya actualizado. Los pods de la versión anterior ni toman estos cierres pendientes ni los eliminan.
Asignación del registro de escritura anticipada del almacén de eventos
El max_wal_size del almacén de eventos es ahora una quinta parte de su volumen, nunca por debajo del 1 GiB propio de Postgres, y una actualización lo aplica a un almacén existente con el volumen que ya tiene. Con los 32Gi predeterminados son 6,4 GiB, donde una instancia actualizada tenía 1 GiB. max_wal_size es un objetivo de frecuencia de los puntos de control, no un límite ni una reserva: el registro puede superarlo cuando los puntos de control no dan abasto o el archivado de WAL se retrasa. Sin embargo, reside en el volumen de datos, así que un almacén que ya está casi lleno tiene menos margen que ese, y un atasco prolongado del archivado puede usar más que ese valor.
dcctl upgradeavisa cuando el valor sube. El plan imprime una línea con el tamaño anterior y el nuevo. También lee el espacio libre del volumen del almacén de eventos e imprime una advertencia si es menor que el nuevo tamaño, o si no pudo leerlo. No se niega a continuar: un almacén con poco espacio libre puede estar sano al ritmo actual, la lectura del espacio libre es de mejor esfuerzo, y el remedio es una opción.- Para conservar una asignación menor, pase
--event-store-max-wal-miba la actualización, por ejemplodcctl upgrade local devicechain --event-store-max-wal-mib 1024para el 1 GiB anterior.--dry-runmuestra antes el efecto. Las actualizaciones posteriores conservan el valor cuando se omite la opción, y--event-store-max-wal-mib 0vuelve al valor derivado.--event-store-checkpoint-timeoutfija del mismo modo el intervalo entre puntos de control (15minpor defecto; un valor vacío,--event-store-checkpoint-timeout="", vuelve a él).dcctlregistra ambos antes de aplicar el cambio, de modo que una actualización que falla a medias y se repite sin las opciones los conserva. Ambos se aplican por recarga, sin reiniciar el almacén de eventos.dcctllos registra enzz-dcctl-event-store.auto.tfvars.json, junto al estado de OpenTofu de la instancia, en la máquina que ejecuta la actualización; consulte Ajuste del almacén de eventos. - Si gestiona usted mismo el OpenTofu de la instancia, fije
timescale_max_wal_size_mibytimescale_checkpoint_timeoutcomo antes.
HTTP deja de responder 202 a un evento descartado
El endpoint HTTP de eventos (POST /{instanceId}/{tenant}/events) respondía 202 Accepted a un evento descartado mientras se construía su mensaje de entrada: una credencial presentada que no se pudo sellar, o un evento que no se pudo codificar. Al llamante se le decía que sus datos estaban a salvo cuando no se habían almacenado en ningún sitio. Desde esta versión el endpoint responde 500 Internal Server Error a esos eventos, sin Retry-After y sin poner la causa en la respuesta.
- No hace falta hacer nada si ningún cliente ve un
500. Los casos son una clave de instancia ausente o con fallo en el servicio, o un evento que no se puede codificar, y ninguno ocurre en el funcionamiento normal. - Un cliente que reintenta toda respuesta distinta de
202no debe reintentar un500de este endpoint: la misma petición falla igual.503(con o sinRetry-After) y429conservan su significado. - Un contador nuevo,
total_msg_build_dropped{source,cause}, cuenta estos descartes en todos los transportes, concauseigual ano_tenant,no_transit_key,seal_failedomarshal_failed. Se exporta a 0 para cada fuente configurada. Cualquier valor mayor que 0 es un evento que no se almacenó. - Los endpoints de integración conservan su
202documentado cuando se descarta un mensaje.
Preajustes de tamaño
dcctl bootstrap tiene una nueva opción --size, y dcctl install acepta --size base y --size compact. No cambia nada salvo que la indique: una instancia sin tamaño genera byte por byte lo que generaba antes de este cambio, y --compact funciona exactamente igual que antes.
perf-12kes el primer tamaño. Establece réplicas, CPU y memoria de los cinco servicios más ocupados, las solicitudes y el límite de memoria del broker, los volúmenes de JetStream y del almacén de eventos y la asignación del registro de escritura anticipada del almacén de eventos, tal como se midieron en un clúster que sostiene 12 000 eventos por segundo con los sobres de eventos activados. Las cifras están en Elegir un tamaño.- Las instancias compactas existentes ganan
spec.size: "compact"en su próxima escritura. La declaración de una instancia creada con--compactse reescribe con el tamaño junto acompact: truela próxima vez quedcctlla escribe (una actualización lo hace); nada de la instancia cambia. - Queda registrado en la instancia (
spec.sizeen la declaración, vacío para base) y cadadcctl upgradelo vuelve a aplicar. Una versión que reajusta un tamaño cambia las instancias registradas con él en su siguiente actualización, y lo indica aquí. - Prevalecen sus propios ajustes. De menor a mayor prioridad: los valores por defecto del chart, el tamaño, lo que
dcctlcalcula por sí mismo, su superposición--valuesy, por último, una variable de OpenTofu que usted indique. Consulte Qué valor prevalece. - No activa nada más. Un tamaño no activa los sobres de eventos ni la confirmación MQTT a prueba de fallos, y con
--haavisa de que la combinación no se ha medido.
Tablero del agente de borde y el job de rascado
Los paneles de proceso del tablero del agente de borde seleccionan job="dc-edge-agent" además del agente. agent es una etiqueta externa global del colector de la máquina, así que un colector que también rasca otra cosa en la máquina (node exporter, por ejemplo) sumaba la memoria, la CPU, las goroutines y los archivos abiertos de ese proceso a los paneles de todos los agentes. La configuración de rascado documentada ya usa job_name: dc-edge-agent, de modo que un tablero importado con ella no necesita cambios. Si dio otro nombre al job, cámbielo en el colector o edite las cinco consultas de proceso y de runtime del tablero (process_* y go_goroutines) con su nombre de job. Vuelva a importar el tablero desde backend/edge/dc-edge-agent/dashboards/edge-agent.json para aplicar el cambio.
Lo que una instancia guarda fuera de sus bases de datos está clasificado
La página de Recuperación ante desastres ahora indica qué le debe una restauración a cada stream de mensajes, a cada bucket clave-valor y al almacén de objetos, en una tabla generada a partir de las declaraciones de la propia plataforma. Tres elementos necesitan su propia copia de seguridad: el stream de captura sin procesar, el stream de mensajes fallidos de las entregas salientes de conectores que no se pudieron realizar, y el almacén de objetos que guarda los artefactos de actualización y las imágenes de marca. Todo lo demás se reconstruye desde las bases de datos o dura poco. Esta versión no cambia ningún comportamiento ni incluye una herramienta de copia de seguridad para los streams. Añade la página, una prueba que falla cuando se añade un stream o un bucket sin clase, y la regla para el almacén de objetos: haz su copia después de la copia base de la base de datos con la que va.
Otros cambios en esta versión
Nada de esto requiere acción, salvo los dos elementos de dcctl de la lista anterior. Cada uno es una corrección o una adición a algo que ya se había publicado.
dcctl sim createy los niveles. Un nivel indicado con--tierque ya existe debe declarar todos los límites que nombran el escenario o--tier-config, ocreatelo rechaza y nombra la clave:dcctlsube límites y no puede ver un valor por defecto heredado. Un nivel quecreatecrea él mismo no se ve afectado. Unnullen--tier-configse rechaza en lugar de leerse como 0.dcctl upgradey los volúmenes del broker. Una reclamación cuyo único paso pendiente es la mitad del sistema de archivos de un cambio de tamaño, y cuyo pod de servidor del broker ya no existe, deja de rechazar la actualización para siempre: el StatefulSet que la actualización vuelve a crear termina el cambio de tamaño. Un cambio de tamaño en curso, una reclamación corta sin cambio de tamaño registrado, un fallo de cambio de tamaño en el nodo y un pod vivo siguen rechazándola. Tras el despliegue, la actualización comprueba las reclamaciones como se describe en la lista anterior.dcctl upgrade --mqtt-exposure <modo>sin--mqtt-hostconserva el host que la instancia ya registra; si no hay ninguno registrado, se sigue rechazando.dcctl sim.dcctl sim status,startystopaplican sangría al JSON de la API de control cuando la salida es un terminal; la salida canalizada no cambia. Las flotas simuladas pueden ejecutar la parte del dispositivo de una actualización por aire (--ota, con opciones para inyectar un hash incorrecto, una firma incorrecta, una descarga interrumpida y un dispositivo sin conexión).dcctl bootstrapydcctl sim createdicen más cuando la instancia no es la predeterminada. La líneaGraphQL:del resumen de bootstrap ahora lleva el mismo host y puerto que la líneaConsole:; antes omitía un puerto no predeterminado. Cuandodcctl sim create(osim destroy) no puede leer la contraseña del superusuario porque--instanceconserva su valor predeterminado,devicechain, ahora añade las instancias registradas en esta máquina y sugiere--instance <nombre>. Los indicadores, los valores predeterminados y la instancia sobre la que actúa cada comando no cambian.dcctl bootstrapydcctl upgradeimprimen una línea más cuando la ruta de ingesta MQTT no está configurada para fallar cerrada, indicando que los eventos confirmados pueden descartarse bajo una sobrecarga sostenida y nombrando--mqtt-fail-closed. Nada cambia a menos que actúe.dcctl broker rebalancemantiene en servidores distintos los dos flujos por evento más activos. Tras reiniciar el broker, los líderes deresolved-eventsy de los flujos fijos de ingesta podían acabar en un mismo servidor, algo que un equilibrio por número de flujos no veía. El paso ahora mueveresolved-eventsa un servidor que no lidere ningún flujo por evento cuando hay uno disponible, y su resumen lo indica como separado, compartido o no confirmado. Se conservan los campos del resumen de la v1.0.- Almacén de eventos: historial anterior al alcance de la política de refresco. Una lectura fechada más atrás de los últimos 30 días que refresca el rollup tras
bucketedMeasurements(store-and-forward, carga retroactiva) se guardaba y la devolvíameasurementEvents, pero nunca llegaba al rollup. Ahora un barrido cada hora la refresca, de modo que esa lectura aparece en las consultas agrupadas en aproximadamente una hora. No hay cambio de esquema. - Deshabilitar o eliminar un dispositivo termina sus sesiones del broker de forma fiable. Antes, el fin de sesión era un único intento tras guardar el cambio; si el broker no lo confirmaba, solo repetir la llamada lo reintentaba. Ahora se encola con el cambio y se reintenta en segundo plano, como ya ocurría con la revocación de credenciales, y volver a habilitar el dispositivo retira un fin pendiente.
- Fallos de encolado de comandos que significan «reintente». Cuando la plataforma no puede decidir un encolado porque un servicio que necesita no está disponible (la validación, la consulta de propiedad, la pertenencia a un grupo, un calendario de ventanas de mantenimiento), el error GraphQL lleva
extensions.code: UNAVAILABLE. El mensaje no cambia y sigue siendo un error, nunca un rechazo. - Detección: una alarma que se cierra por el desarme de un hombre muerto ya no queda activa cuando un punto de control o el fin del mandato del motor llegaban sin un mensaje posterior. El Resolved pendiente ahora se publica antes.
- Sobres de eventos (opcional): una ronda cuyo mensaje se expulsó del flujo se omite y se cuenta (
envelope_rounds_evicted_total,resolve_envelope_rounds_evicted_total), y un grupo de recorridos lleno ya no impide que un servicio se detenga. - Hay dos alertas nuevas,
SparkplugIngestLeaderMetricAbsentyLwm2mIngestLeaderMetricAbsent: un servicio de ingesta de borde desplegado que no exportaba series de líder dejaba en silencio las alertas de recuento de líderes existentes. Añádalas a su enrutamiento de alertas. El chart incluye dos tableros de Grafana nuevos, para la ingesta Sparkplug y LwM2M, y el repositorio incluye un archivo de panel para el agente de borde; consulte Tableros de Grafana. - La consola consulta el estado de los comandos de un dispositivo mientras alguno no ha terminado, da formato a los valores de alarma como los paneles, aplica el tema a los controles de zoom del lienzo de automatización y encabeza la lista de perfiles de dispositivo con el nombre.
- Paneles en un host con CSP estricta.
configureStrictCsp(desactivado por defecto, así que nada cambia) permite que el paquete de reproducción de tableros se ejecute constyle-src 'self'; consulte Escribir un widget personalizado. - Infraestructura. Con
nats_mqtt_capable_userssin definir, el módulo OpenTofu del broker ya no escribe unallowed_connection_typesnulo que el broker rechazaba; el reparador de certificados de las copias de seguridad del almacén de eventos vigila el espacio de nombres configurado del operador. dcctl upgradeacepta--yes(-y), igual quedcctl installydcctl bootstrap, y encuentra un escrow escrito con--escrow-file.--yesda por respondidas con sí las preguntas; una actualización no hace ninguna, así que no cambia nada, y un script ya puede pasarlo a los tres comandos.dcctl bootstrap --escrow-fileregistra dónde se escribió el artefacto y la comprobación del escrow de la clave raíz de la actualización mira allí, de modo que ya no informa de «sin escrow» para una instancia cuyo artefacto está en una ruta personalizada. Para una instancia creada antes, pase--escrow-fileuna vez a la actualización; ella registra la ruta.
Tres widgets nuevos para tableros
Tres widgets son nuevos en el menú Añadir widget, todos en Telemetría. Se suman a los existentes sin cambiar ninguno, y un tablero que no los use no se ve afectado.
- Cuadrícula de estado muestra un mosaico por dispositivo de un grupo para una medición, coloreado según la banda de umbral de la última lectura de cada dispositivo. Un dispositivo sin lectura se dibuja hueco y se cuenta aparte; nunca se muestra como correcto.
- Línea de estados muestra las mediciones de un dispositivo como carriles de estados discretos en el intervalo de tiempo del tablero, con los umbrales como estados. Cada tramo es el estado del promedio de un intervalo, y el widget lo indica.
- Símbolo SCADA dibuja una bomba, válvula, depósito, motor, ventilador, tramo de tubería, sensor, interruptor o luz en el estado que le da una medición: en marcha, detenido o con falla, con el sentido del flujo en una tubería, en modo claro y oscuro. Se queda quieto para quien pide movimiento reducido.
No requiere ninguna acción. Consulte Tableros para las opciones de cada uno.
Cambios de esquema y cómo volver atrás
Ocho migraciones añaden lo siguiente. Toda columna nueva admite nulos, así que un servicio de v1.1.0 que se ejecute con el esquema nuevo escribe filas que sigue pudiendo almacenar.
- Revocación X.509 (
device-management, migración20261105100000). Cuatro tablas nuevas:device_revocation_issuers,device_revocation_lists,device_revoked_certificatesydevice_credential_chain_links. Cuatro columnas nuevas:revocation_mode,revocation_stale_graceyrevocation_rowsendevice_trust_anchors, ynot_beforeenpending_session_kicks. Las anclas de confianza existentes dejanrevocation_modevacío, lo que se lee comoENTRIES: un certificado se rechaza solo cuando figura en la lista. - Decodificadores de carga útil (
device-management, migración20261110120000). Dos tablas nuevas,profile_decoder_healthsyprofile_decoder_samples, y una columna nueva,decoder_declarationendevice_profiles. - Cola de cierres por revocación (
device-management, migración20261111120000). Una tabla nueva,pending_revocation_kicks, y una columna nueva que admite nulos,kick_queued_atendevice_revoked_certificates. La tabla está separada de la cola de cierres de sesión existente para que una réplica dev1.1.0nunca lea ni elimine sus filas. - Marcadores de cierres por revocación (
device-management, migración20261112100000). Dos tablas nuevas,pending_revocation_expansionsypending_revocation_expansion_serials. Guardan, hasta que se escriben las filas de cierre por dispositivo, las revocaciones que todavía las deben, de modo que una revocación ya no retiene el ancla de confianza mientras encola un cierre para cada dispositivo que depende de ella. Una réplica dev1.1.0nunca las lee. - Almacenamiento de proyecciones (
device-state, migración20261104120000). No añade tablas ni columnas. Fija parámetros de almacenamiento (un factor de relleno de 75 y umbrales de autovacuum) endevice_states,latest_measurementsylatest_locations. Las filas que ya existen ganan el margen del factor de relleno solo a medida que se reescriben sus páginas, así que una instancia actualizada nota el cambio lentamente. - Tablas de ubicación (
user-management, migración20261105120000). Tres tablas nuevas:iam_partition_config,iam_vpartition_assignmentsyiam_tenant_vpartition_overrides. La migración no inserta filas; el primer arranque deuser-managementescribe la ubicación predeterminada (una fila eniam_partition_configy 64 filas eniam_vpartition_assignments) y crea el bucketdc_partition_placementen el broker de mensajes. - Reparación de la hora de alarma de inactividad (
device-state, migración20261106120000). No añade nada al esquema. Es una reparación solo de datos deinactivity_alarm_timeendevice_states, en lotes de 5.000, que restaura lo que la columna contenía antes dev1.1.0. No hay nada que deshacer al volver av1.1.0. - Reparación de la hora de alarma de inactividad, segunda pasada (
device-state, migración20261107120000). No añade nada al esquema. Recorre las filas que un escritor dev1.1.0tenía bloqueadas mientras se ejecutaba la primera pasada, reintentando durante aproximadamente medio minuto, y registra y deja una fila que siga bloqueada después. No hay nada que deshacer al volver av1.1.0.
Salvo esa ubicación predeterminada, las tablas nuevas empiezan vacías. No hay que deshacer nada en una base de datos para volver a v1.1.0: las tablas, columnas y parámetros de almacenamiento nuevos se quedan donde están y los servicios de v1.1.0 los ignoran, con una excepción: el borrado de inquilinos, más abajo. Avance cuando pueda: una actualización fallida se arregla ejecutando dcctl upgrade de nuevo. Para el cambio de configuración que exige volver atrás, consulte Los tokens se comprueban contra su recurso.
El borrado de un inquilino queda retenido mientras lo ejecuta una réplica de user-management de v1.1.0. Una réplica de v1.1.0 no conoce las tres tablas de colocación, y su purga relacional se niega a ejecutarse contra una tabla que no sabe clasificar. Mientras una de ellas ejecuta la purga, el almacén relacional informa de un error para el borrado, con una línea de registro y un fallo en el libro que nombran iam_partition_config, iam_vpartition_assignments o iam_tenant_vpartition_overrides, y tenant_purge_store_blocked{store="rdb",reason="error"} supera cero. El paso rechazado no borra nada de la base de datos y no se pierde nada; los demás almacenes sí se borran en la misma pasada. El borrado no puede terminar: el inquilino sigue en purging. Una réplica de esta versión lo retoma en su siguiente pasada y termina cuando se cumplen sus comprobaciones habituales. En una actualización progresiva ocurre solo cuando desaparece la última réplica de v1.1.0; tras volver a v1.1.0 queda retenido hasta que vuelva a avanzar. Si puede, inicie los borrados cuando la actualización haya terminado.
Canales de notificación nativos de Slack, Teams y PagerDuty
Los canales de notificación incorporan tres tipos: slack, teams y pagerduty. Son aditivos: no cambia nada para un canal smtp o webhook existente, y un webhook entrante de Slack al que llegas mediante un canal webhook sigue funcionando igual.
- No hace falta hacer nada para actualizar. Un canal de un tipo nuevo necesita un secreto (la URL del webhook, o la clave de enrutamiento de PagerDuty) y se rechaza al guardarlo sin él. Consulta Canales nativos de Slack, Teams y PagerDuty.
- Crea canales de Slack, Teams y PagerDuty solo cuando termine el despliegue. Los pods de la versión anterior que siguen en marcha durante la actualización no conocen los tipos nuevos: omiten un destino de esos tipos como
no_adaptery nada lo reintenta, así que una alarma que uno de ellos procese no se entrega al canal. - Ten en cuenta que los tipos nuevos salen por la misma protección que un webhook. Un destino en una dirección privada, de bucle local o de metadatos de nube se rechaza y se cuenta con
devicechain_notificationmanagement_deliveries_refused_total{reason="egress"}. - Ten en cuenta que la consulta
notificationChannelTypesahora lista tres tipos más, y que el esquema GraphQL solo cambia en sus descripciones. Un cliente que recorra exhaustivamente los tipos de canal verá tres valores más. - La consola tiene una nueva página de Canales de notificación para configurar canales de todos los tipos.
Problemas conocidos
- La confirmación MQTT con cierre ante fallo está desactivada por defecto, como en
v1.1.0. El transporte MQTT indica los límites medidos con ella desactivada y activada. - Un cambio en la configuración del broker sigue desconectando los dispositivos que admitió el callout de autenticación, hasta que la biblioteca del broker incluya la corrección de origen. Una renovación de certificado no lo hace. Hay una corrección prevista para una versión de parche.
eventSources.ingestMetering: lagCreditaún no está disponible; consulta Medición de la ingesta.
v0.27.0 — los dispositivos inician sesión con certificado y los comandos Sparkplug funcionan
v0.27.0 es una actualización in situ desde v0.26.0: dcctl install para el clúster y después un dcctl upgrade por cada instancia, como se describe para v0.17.0. Pasa a dcctl install los ajustes con los que se instaló el clúster, como --kube-context, --ha, --compact y --database-node-selector, además del nuevo --version. Si vienes de v0.25.2 o anterior, lee primero las notas de v0.26.0 y síguelas con --version v0.27.0.
dcctl install local --version v0.27.0
dcctl upgrade local devicechain --version v0.27.0 --dry-run
dcctl upgrade local devicechain --version v0.27.0
La versión permite que los dispositivos se autentiquen con un certificado X.509, hace utilizables los comandos Sparkplug B, renueva el certificado del broker sin desconectar las sesiones de los dispositivos y da a los usuarios de cliente paneles de áreas y activos. Lo que exige actuar, en el orden en que hacerlo:
- Si instalas el chart sin
dcctly el callout de autenticación del broker está activado, dale el acceso de sistema del broker. El callout ahora comprueba que una conexión con certificado la solicitó un servidor vivo del broker, y pide esa lista a la cuenta de sistema del broker. Sininfrastructure.nats.auth.sysUserysysPassword, device-management se niega a arrancar. Defínelos, o definecallout.issuerPinDisabled: truepara funcionar sin la comprobación (el servicio registra una advertencia). Una instalación condcctlya tiene el acceso. Consulta Anclar las solicitudes al broker. - Un
dcctl bootstrapejecutado de nuevo sobre una instancia con fuentes Sparkplug o identidades LwM2M debe decir qué hacer con ellas. (En una instancia en ejecución,dcctl bootstrapya se niega a reconstruirla; esto cubre el reintento de un bootstrap que no terminó.) Ahora se niega salvo que pases de nuevo el mismo archivo (--sparkplug-source,--lwm2m-identities) o las retires a propósito (--withdraw-sparkplug-sources,--withdraw-lwm2m-identities). Antes, repetir el bootstrap sin el indicador eliminaba las credenciales en silencio.dcctl upgradelas conserva, como antes. - Rota tus claves precompartidas de LwM2M después de actualizar. Consulta las claves de LwM2M salen de la release de Helm.
- Los ajustes que añadiste a mano al bloque
lwm2m-ingestde la release ya no se conservan en una actualización. Ponlos en un archivo de valores y pásalo con--values. - Si defines
extraSecretsen los valores del chart, su suma de verificación cambió.checksum/extra-secretsahora cubre el nombre y los nombres de clave de cada Secret, nunca los valores. Cambiar solo un valor ya no reinicia los pods; reinícialos tú cuando cambie un valor. - Un cliente GraphQL tipado debe aceptar
nullenProvisioningProfileSecretResult.issuedSecret. Un perfil de aprovisionamiento que nombra un ancla de confianza no tiene secreto. Todo perfil que lo tiene lo sigue devolviendo una vez, como antes. - Avanza desde esta versión; no retrocedas. Consulta Volver atrás.
Se ejecutan dos migraciones, una en el primer arranque del servicio que la posee, y cada una puede volver a ejecutarse si se interrumpe: en device-management, una tabla de anclas de confianza y columnas para el ancla en las credenciales y los perfiles de aprovisionamiento; en user-management, dos columnas anulables en el registro de purga del tenant que guardan cuándo se estableció que los datos estaban borrados y cuándo se comprobó por última vez. Ninguna reescribe una fila.
Los comandos Sparkplug B funcionan y dcctl acepta una fuente Sparkplug
En v0.26.0 se rechazaba una clave de comando con un punto, y los tipos de comando Sparkplug (sparkplug.write y los comandos de rebirth y reboot) se nombran así, de modo que no se podía crear ningún comando Sparkplug. Ahora una clave puede llevar espacios de nombres con puntos, y cada segmento sigue la misma regla de antes. Los comandos Sparkplug siguen desactivados hasta que los activas para una fuente, como en v0.26.0.
- Un comando rechazado dice por qué. Un comando rechazado antes de llegar al nodo (
FAILEDoNOT_DELIVERED) ahora guarda como respuesta un motivo legible por máquina, por ejemplocommands_not_enabled,node_offline,node_rebirthing,metric_not_writableoreboot_not_allowed. La consola explica cada uno. Lo que hayas escrito que dependiera del texto del error anterior debe usar el código de motivo. - Un nodo que nació antes de que existiera su tipo de dispositivo recibe una petición de rebirth. La plataforma recuerda el nodo y le pide un rebirth 10 segundos después del registro fallido, y luego con un intervalo que se duplica hasta un minuto, hasta que se registra. Dos métricas nuevas,
birth_recovery_pendingybirth_recovery_rebirths_total, lo muestran. dcctl bootstrapydcctl upgradeaceptan--sparkplug-source <archivo>. El archivo lista las fuentes, la contraseña del broker queda en un Secret quedcctlescribe por sí mismo, y las actualizaciones posteriores conservan ambos. Un bootstrap con el indicador activa el área; una actualización con él se niega si el área no está en ejecución y nombradcctl enable-area. Consulta Dar adcctluna fuente Sparkplug. Una superposición de--valuessigue sin poder definir una fuente.
Las claves de LwM2M salen de la release de Helm
Hasta ahora dcctl ponía cada clave precompartida de dispositivo LwM2M en los valores de la release de Helm, donde helm get values la mostraba y el historial de Helm la conservaba en cada revisión. Ahora dcctl escribe las claves en el Secret dci-<instancia>-lwm2m-identities por sí mismo, fuera de la release, y la release solo lleva el nombre del Secret y un sello que no se deriva de ninguna clave.
- La primera actualización traslada las claves. Las lee de la release una vez, escribe el Secret nuevo antes de cambiar nada más, elimina la entrada antigua de
extraSecretsy ejecuta la actualización de Helm. Los dispositivos conservan las claves que tienen. Los pods que siguen en ejecución las mantienen en su entorno hasta que se reinician. - Rota las claves después. Las revisiones que Helm registró antes de esta actualización (conserva hasta diez) siguen guardando los valores antiguos, igual que cualquier copia de seguridad de la release. Ejecuta
dcctl upgrade local <instancia> --lwm2m-identities <archivo>con claves nuevas; un archivo pasado de nuevo reescribe el Secret y reinicia los pods. Hasta que las revisiones antiguas caduquen, restringe quién puede leer Secrets en el namespace donde Helm guarda sus releases (default). dcctl upgradeincorpora--lwm2m-identitiesy--withdraw-lwm2m-identities, y el Secret de Sparkplug funciona igual. Un Secret quedcctlno escribió nunca se toca.- Reducir o borrar espera a la release.
dcctlañade claves antes de la release y quita las que nada referencia solo después de que tenga éxito. Una actualización fallida deja las claves antiguas para los pods en ejecución, y la siguiente ejecución termina el trabajo. Si el último paso falla tras una release correcta, la ejecución avisa con el comando exacto y no falla.
Autenticación por certificado
Los dispositivos pueden autenticarse en el broker de la plataforma con un certificado de cliente X.509, ya sea fijado a un dispositivo que creaste o registrado en la primera conexión mediante un perfil de aprovisionamiento por certificado. No se confía en nada hasta que añades un ancla de confianza, así que una actualización no cambia el comportamiento de ningún dispositivo. Los dispositivos con token y contraseña se conectan como antes. Lee Actualizar una instancia que ya está en marcha antes de añadir la primera ancla, y Conectar con un certificado para los pasos.
- La petición de certificado del broker ya no nombra un emisor aceptado. Un cliente Go o el simulador retenía un certificado cuyo emisor no figuraba en la lista del broker; ahora el broker no envía lista, así que el dispositivo presenta el certificado que tiene.
- Cada conexión con certificado se comprueba contra los servidores vivos del broker. Consulta Anclar las solicitudes al broker. La nueva alerta
DeviceX509IssuerPinUnavailableavisa ante una interrupción sostenida, no ante un reinicio del broker. - Con el chart llegan tres alertas y un histograma de latencia.
DeviceX509ChainFailuresSustained,DeviceX509JitRefusedSustainedyDeviceTrustAnchorsExpiringSoonpermanecen en silencio en una instancia sin anclas de confianza.callout_duration_seconds{path,result}y la alerta de avisoDeviceCalloutLatencyHighcubren todos los caminos del callout.
El certificado del broker se renueva sin desconectar dispositivos
- Un certificado TLS renovado ya no desconecta las sesiones MQTT. El broker aplica un certificado cambiado bajo la misma autoridad a las conexiones nuevas sin recargar su configuración, así que un dispositivo conectado sigue conectado. En una prueba, 30 sesiones mantenidas tras el callout de autenticación sobrevivieron a una rotación y la conexión siguiente recibió el certificado nuevo.
dcctl upgraderenueva el certificado hoja del broker sin reiniciarlo cuando el único motivo es la caducidad: la autoridad no cambia y el broker ya ejecuta el número de réplicas para el que se emite el certificado. Escribe el Secret y espera hasta cinco minutos a que cada pod del broker informe de la nueva caducidad. Si no puede confirmarse, avisa y reinicia el broker, de modo que un certificado antiguo nunca queda sirviéndose tras una renovación aparentemente correcta. Un cambio de autoridad, de nombres o de número de réplicas sigue reiniciándolo.- Un cambio en la configuración del broker sigue recargándolo, y una recarga sigue desconectando las sesiones de los dispositivos admitidos por el callout, hasta que la biblioteca del broker incluya una corrección de upstream que aún no está en ninguna versión.
dcctl upgradereinicia el broker en toda actualización que cambie su imagen o su configuración. - La biblioteca del broker es nats-server 2.15.2, una versión de seguridad; entre sus correcciones, el callout de autenticación ahora respeta los tipos de conexión que permite.
dc-nats-serverse construye sobre ella. La imagen de control para volver al broker upstream esnats:2.15.2-alpine; el ajuste que se usa esserver_image_tag = "2.15.2-alpine". - Tras una actualización que reinicia el broker,
dcctlreequilibra el liderazgo. El servidor reiniciado en último lugar solía no liderar ningún stream, y el p99 del acuse de publicación se duplicaba aproximadamente hasta que el liderazgo se movía. El último paso dedcctl upgradeahora mueve los líderes de streams y consumidores para igualar los servidores e imprime los líderes por servidor antes y después. Es de mejor esfuerzo: un fallo es una advertencia, nunca un fallo de la actualización.dcctl broker rebalance <instancia>hace lo mismo a petición, y la nueva alertaBrokerLeadershipImbalancedsalta cuando un servidor lidera menos de la mitad de la media.
Los despliegues de ingress conservan las solicitudes
Detrás de un balanceador de carga en la nube, los pods de Traefik e ingress-nginx ahora esperan antes de irse (drain_seconds, 40 por defecto) y un pod nuevo debe estar listo durante min_ready_seconds (15) antes de sustituir al siguiente, de modo que un despliegue ya no pierde solicitudes mientras la comprobación de salud del balanceador se pone al día. Los valores son variables de los módulos de OpenTofu de los controladores; 0 desactiva cada uno. En GKE, un bucle de una solicitud por segundo a través de un balanceador de carga en la nube durante despliegues de Traefik no registró solicitudes fallidas, mientras que la medición anterior sí las registró. Un clúster local, sin balanceador en la nube, no cambia. En un clúster en la nube, el primer dcctl install que lo aplique reinicia cada controlador una vez, con el drenaje más largo. Consulta qué cambia en el borde.
Usuarios de cliente y la consola
- Un usuario de cliente ve las áreas y los activos en los que están sus dispositivos visibles. La regla está en el almacén, junto al predicado del tenant: un área o activo aparece mientras un dispositivo que el solicitante puede ver tiene una relación seguida con él, y
anchorDeviceslista los dispositivos que hay en él. Los nombres de áreas y activos son visibles para quien pueda ver un dispositivo en ellos; sus demás campos se ocultan. Nada del propio grafo de relaciones se abre. - Las alarmas y el historial de eventos pueden filtrarse por ancla.
alarms,alarmCountsBySeverity,alarmCountsByDeviceTypey la suscripciónalarmStreamaceptan unanchoropcional (un cliente, un área o un activo), y la respuesta se limita al alcance del solicitante. Una alarma permanece bajo el área en la que estaba su dispositivo cuando se generó. Un ancla de cliente fuera del alcance del solicitante se rechaza. No hace falta migración. - La consola oculta lo que el servidor rechaza. A un usuario de cliente no se le ofrecen acciones de nuevo dispositivo, importación, cancelar comando ni escritura de paneles, y una tarjeta de estadística con la última lectura se rellena con el valor almacenado más reciente en lugar de esperar al siguiente.
El borrado de un tenant indica cuándo se han borrado los datos
El registro de borrado de un tenant incorpora erased, erasedAt y lastVerifiedAt. La afirmación solo se hace cuando todos los almacenes llevan limpios durante la ventana de asentamiento, se retira si algún almacén retrocede, y un libro vacío se lee como «aún se está comprobando», nunca como borrado. dcctl tenant-deletion status <token> [--wait] [--until erased|complete] termina con código distinto de cero hasta que los datos están borrados. La métrica tenant_purge_erased_total cuenta las afirmaciones. Consulta Saber que los datos están borrados y Cuánto tarda borrar un tenant grande para la medición y lo que no cubre.
El acuse MQTT con cierre ante fallo sigue siendo opcional
El acuse MQTT con cierre ante fallo (--mqtt-fail-closed) sigue desactivado salvo que lo actives, como en v0.26.0, y sigue siendo una opción hasta la 1.0. El transporte MQTT ahora indica sus límites medidos y las cotas de pérdida con él desactivado y activado. No cambia nada para una instancia que no lo define.
Volver atrás
Avanza desde esta versión; no retrocedas. Las dos migraciones nuevas añaden una tabla y columnas que v0.26.0 no conoce, y una instancia con LwM2M guarda sus claves en un Secret que v0.26.0 no lee. Una actualización fallida se corrige ejecutando dcctl upgrade de nuevo.
Problemas conocidos
- Un cambio en la configuración del broker sigue desconectando a los dispositivos admitidos por el callout de autenticación, hasta que la biblioteca del broker incluya la corrección de upstream. Una renovación de certificado no lo hace.
v0.26.0 — los dispositivos se registran solos y el front end pasa a Traefik
v0.26.0 es una actualización in situ desde v0.25.2: dcctl install para el clúster y después un dcctl upgrade por cada instancia, como se describe para v0.17.0. Pasa a dcctl install los ajustes con los que se instaló el clúster, como --kube-context, --ha, --compact y --database-node-selector, además del nuevo --version. Si vienes de v0.25.1 o v0.25.0, lee también las notas de las versiones intermedias.
dcctl install local --version v0.26.0
dcctl upgrade local devicechain --version v0.26.0 --dry-run
dcctl upgrade local devicechain --version v0.26.0
En un clúster con dos instancias del perfil default, añade --max-connections 700 a este dcctl install.
La versión incluye el autorregistro de dispositivos, las integraciones de entrada para servidores de red LoRaWAN y webhooks, un canal de comandos opcional hacia nodos Sparkplug B, la autenticación en dos pasos y el paso de ingress-nginx a Traefik. Elimina el filtro de credenciales en el cuerpo de MQTT. Lo que exige actuar, en el orden en que hacerlo:
- Un clúster con dos instancias del perfil default necesita un presupuesto de conexiones de base de datos mayor antes de actualizar. El presupuesto de un clúster nuevo es ahora
700; un clúster instalado con el valor anterior conserva600, y la actualización de la segunda instancia puede rechazarse. Vuelve a ejecutar eldcctl installcon el que se instaló el clúster añadiendo--max-connections 700: por ejemplodcctl install local --max-connections 700, más los indicadores con los que se instaló, como--kube-context,--ha,--compacty--database-node-selector. Consulta la nota de update-management más abajo y el presupuesto de conexiones. - Elimina
functionalAreas.event-sources.config.capture.bodyCredentialsi lo fijaste y quita--mqtt-body-credentialde los scripts. Consulta se elimina el filtro de credenciales en el cuerpo. - Revisa todo lo que automatice perfiles de aprovisionamiento y rota el secreto de cada perfil existente. Consulta Perfiles de aprovisionamiento.
- Los clientes de API que inician sesión deben tratar
MFA_CHALLENGE. Consulta Autenticación en dos pasos. - Si pasas una instalación existente a Traefik, comprueba el certificado del Gateway antes de retirar los objetos Ingress. Una instancia actualizada a través del cambio de emisor puede quedarse con un certificado
devicechain-tls-gatewayque la autoridad certificadora propia de la instancia no emitió. Comprueba su emisor y vuelve a emitirlo si no es la CA de la instancia; la comprobación es un paso de la guía de la migración, antes de retirar los objetos Ingress. - La pila de monitorización pasa a una nueva línea mayor (Prometheus 3). Consulta La pila de monitorización.
- Avanza desde esta versión; no retrocedas. La migración de device-management que sustituye por resúmenes los secretos de los perfiles de aprovisionamiento y de las reclamaciones de dispositivo no se puede deshacer, y el lector de captura pasa a un consumidor duradero nuevo (consulta Mensajería).
Se ejecutan seis migraciones, una en el primer arranque del servicio que la posee, y cada una puede volver a ejecutarse si se interrumpe: en device-management, autorregistro de dispositivos, resúmenes de secretos de alta, integraciones y alias de dispositivo; en user-management, el segundo factor y la dimensión de gobernanza del autorregistro. Al arrancar, device-management también convierte en resumen con clave todo secreto de perfil de aprovisionamiento y de reclamación de dispositivo almacenado; una reclamación abierta durante la actualización sigue funcionando con el secreto que se entregó a su titular.
Hasta ahora un perfil de aprovisionamiento se podía crear y editar, pero nada lo leía: ningún dispositivo podía registrarse con uno. Así que nada que funcionara ayer deja de funcionar porque una flota lo usara. Lo que cambia es cómo se crean los perfiles y qué necesitan.
La versión también añade la autenticación en dos pasos, que cambia la forma en que los clientes de la API inician sesión en una cuenta que la activa.
Perfiles de aprovisionamiento
- El servidor genera el secreto de aprovisionamiento.
createProvisioningProfileya no aceptaprovisionSecret. Devuelve{ profile, issuedSecret }donde antes devolvía el perfil, yissuedSecretse muestra una sola vez. Un script que seleccionatokendel resultado ahora debe seleccionarprofile { token }.updateProvisioningProfiletampoco acepta yaprovisionSecret.rotateProvisioningProfileSecret(token)es la única forma de reemplazar un secreto. Ambos cambios son incompatibles: regenera cualquier cliente construido contra el esquema anterior y revisa tus scripts. Las operaciones nuevas están en Perfiles de aprovisionamiento. - Los perfiles existentes se rechazan hasta que los rotes. El nuevo endpoint no acepta un secreto elegido por un operador, porque solo acepta uno que generó el servidor. Todo perfil que exista en el momento de la actualización responde
401 PROVISIONING_FAILEDa un registro, y la consola lo marca como Requiere rotación (secretIssuedesfalseen GraphQL). Rótalo, copia el secreto nuevo y entrégalo a la flota. Nada más del perfil cambia. Esta actualización no se puede deshacer. Los secretos de los perfiles de aprovisionamiento y de las reclamaciones de dispositivo se sustituyen por resúmenes en la base de datos, y esa migración se niega a revertirse (el texto en claro ya no existe, así que eliminar los resúmenes destruiría todos los secretos). Si debes volver a una versión anterior, restaura desde una copia de seguridad. - La clave de aprovisionamiento es única por inquilino, no en toda la instancia. Dos inquilinos pueden usar ahora la misma clave. La restricción de base de datos que la hacía global a la instancia se sustituye por una por inquilino.
- Un perfil puede tener un tope.
maxDeviceses nuevo y opcional. Un perfil que lo deja sin definir sigue sin tope.
Dispositivos
- Un perfil adopta un dispositivo existente solo si el dispositivo se reservó para él. Con ambas estrategias, incluida
ALLOW_NEW, un dispositivo que existe pero no se reservó para el perfil se rechaza con409 DEVICE_NOT_EARMARKED. Reserva conprovisioningProfileTokenencreateDeviceeimportDevices, o con el Perfil de aprovisionamiento esperado de la consola. Los dispositivos existentes no tienen reserva, y una reserva solo se puede fijar al crear el dispositivo:updateDeviceno tiene ese campo, y una fila deimportDevicespara un dispositivo existente cuya reserva difiere, incluido un dispositivo sin ninguna, es unCONFLICT. Por tanto, un perfil nunca puede adoptar un dispositivo creado antes de esta actualización. Ese dispositivo sigue funcionando con la credencial que ya tiene; para ponerlo bajo un perfil, crea un dispositivo nuevo reservado para él. - Un perfil no se puede eliminar mientras tenga credenciales emitidas, y un tipo de dispositivo no se puede eliminar mientras lo use un perfil. Ambos responden
REFERENCE_VIOLATION. Restablece o elimina antes los dispositivos.
Operación
- El endpoint necesita el ingress de la API.
POST /api/device-management/provisioning/{tenant}/registerse alcanza por la misma ruta/api/<area>que la API GraphQL. Una instancia coningress.enabled: falseno tiene camino público hasta él. dcctl bootstrapydcctl upgradeahora generaninfrastructure.http.trustedProxiesa partir del rango de pods del clúster, de modo que el límite por origen vea al dispositivo y no al controlador de ingress. La configuración de la instancia cambia, así que los servicios se reinician con el resto de la actualización progresiva. Revísalo si ejecutas tu propio controlador de ingress o estás detrás de un balanceador de carga: Direcciones de cliente y proxies de confianza. Sin él, todos los dispositivos comparten una sola asignación de peticiones por pod de ingress, que un desconocido puede agotar.- Configuración nueva, toda opcional, bajo la clave
provisioningde device-management:readDeadline,maxInFlight,maxConcurrentRegistrations,sourceBurstysourceEvery. Los valores por defecto están en los límites. - Métricas nuevas y tres alertas (
ProvisioningAuthFailuresSustained,ProvisioningRateLimited,ProvisioningMisconfigured) llegan con el chart. Están en silencio en una instancia que no usa el endpoint. Consulta Autorregistro de dispositivos. - Una nueva dimensión de gobernanza limita los registros que puede hacer un inquilino: por defecto una ráfaga de 500 y 20 por segundo, fijada por nivel o por inquilino. Consulta Gobernanza y cuotas.
El front end pasa de ingress-nginx a Traefik
Las instalaciones nuevas sirven su host con Traefik y rutas de la Gateway API, y ingress-nginx ya no se instala en un clúster que no lo tiene. Un clúster existente conserva ingress-nginx, sirviendo, y recibe Traefik a su lado. Nada cambia en el host hasta que lo muevas:
dcctl installinstala Traefik y las definiciones de la Gateway API a un lado deingress-nginx, con un balanceador de carga y una dirección propios.dcctl upgradeda a cada instancia un Gateway y rutas, y mantiene sus objetos Ingress a su lado mientrasingress-nginxesté en el clúster. Los dos usan certificados distintos: los objetos Ingress conservandevicechain-tlsy el Gateway usadevicechain-tls-gateway. Durante la ventana la actualización espera 30 segundos al certificado del Gateway y después avisa y continúa;--drop-legacy-ingressse niega hasta que estéReady, y--remove-legacy-ingresscomprueba todas las instancias.- Mueves el DNS a la dirección de Traefik cuando quieras. Entonces
dcctl upgrade --drop-legacy-ingressdeja de generar los objetos Ingress, ydcctl install --remove-legacy-ingressquitaingress-nginx. La eliminación se rechaza mientras algún objeto Ingress nombre todavía su clase. dcctl upgrade --ingress-controller nginxdevuelve una instancia aingress-nginxmientras esté instalado. La elección queda registrada y las actualizaciones posteriores la conservan;--ingress-controller autola borra.- Un emisor ACME que resuelve HTTP-01 a través de la clase de ingress
nginxsigue funcionando durante la ventana, y falla en sus renovaciones cuando se quitaingress-nginx. Déjalo como está hasta que el DNS apunte a Traefik, y entonces dale un solvergatewayHTTPRouteantes de--drop-legacy-ingressy--remove-legacy-ingress. Uno fijado antes falla. Un solver DNS-01 funciona en todo momento. - En AWS el Classic Load Balancer oculta las direcciones de cliente.
dcctl install --aws-nlb traefikda al Service de Traefik un Network Load Balancer (nginx,allynoneson los otros valores); cambiar un Service sustituye su balanceador y cambia su nombre de host. - Una instalación HA ejecuta dos réplicas de Traefik, repartidas entre nodos, con un PodDisruptionBudget que mantiene una en pie.
- En un clúster local no hay DNS que mover: el navegador llega al controlador que ocupe los puertos 80 y 443 del nodo.
ingress-nginxlos conserva hasta que--remove-legacy-ingressse los entrega a Traefik, así que ejecuta--drop-legacy-ingressy la eliminación seguidos: el host no responde entre ambos. Un clúster local nuevo tiene Traefik en los puertos desde el principio.
Todos los pasos, los comandos, los rechazos que puedes ver y el retroceso están en Pasar una instalación existente a Traefik. Los flags nuevos están en la referencia de dcctl.
Ingress-nginx conserva la dirección de cliente
Mientras ingress-nginx esté en el clúster, dcctl install fija ahora externalTrafficPolicy: Local en su Service LoadBalancer. Sin eso, todos los dispositivos de internet compartían un único cupo por nodo. Consulta Direcciones de cliente y proxies de confianza. El cambio tiene un coste en el momento en que se hace:
- El balanceador sigue enviando tráfico a los nodos que no ejecutan ningún pod del controlador hasta que su health check los marca como no sanos. Espera que el tráfico hacia esos nodos se interrumpa hasta entonces (decenas de segundos).
- Una instalación sin HA ejecuta una sola réplica del controlador, así que cada actualización del controlador es un corte breve. Una instalación HA ejecuta dos, repartidas entre nodos.
Las instancias autofirmadas conservan su certificado anterior
Una instancia que sirve un certificado autofirmado lo emite ahora desde una autoridad certificadora que crea el chart en el namespace de la instancia, y los clientes pueden confiar en esa autoridad mediante ca.crt en el Secret del certificado (TLS, flags e instalación en un portátil). Una instancia existente conserva su certificado hoja anterior hasta que se renueve. Elimina el Secret devicechain-tls para que se vuelva a emitir desde la autoridad de inmediato; los clientes deben entonces obtener de nuevo ca.crt de ese Secret.
Una instancia que ya pasó al Gateway sirve devicechain-tls-gateway para siempre, con un certificado hoja nuevo de la misma autoridad. Tras el paso, los clientes obtienen ca.crt de devicechain-tls-gateway.
Se elimina el filtro de credenciales en el cuerpo de MQTT
Una credencial en el cuerpo de un mensaje en el broker MQTT de la plataforma se rechaza ahora siempre. No queda nada que configurar:
capture.bodyCredentialse elimina, yevent-sourcesse niega a arrancar mientras esté fijada, con cualquier valor. El error nombra la clave y lo que hay que hacer. Si gestionas tú mismo los valores del chart, eliminafunctionalAreas.event-sources.config.capture.bodyCredentialantes de actualizar.dcctl bootstrapydcctl upgradeya no aceptan--mqtt-body-credential. Un script que lo pase falla: quita el flag. Es un cambio incompatible de la línea de comandos.- Una instancia gestionada por dcctl que estaba en
stripqueda en rechazo tras la actualización, y la actualización imprime un aviso. Los dispositivos que aún enviaban una credencial en el cuerpo dejan de recibirse. Vigílalos condevicechain_eventsources_total_msg_credential_in_mqtt_bodyy actualízalos como describe Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT. - El filtrado propio del agente de borde sobre las credenciales de las cargas de los dispositivos (
body_credentials_stripped_total) no cambia.
Se pueden perder mensajes MQTT durante la actualización
La actualización reinicia el broker de la plataforma, un servidor cada vez. En un ensayo del reinicio del broker de esta actualización con una compilación previa a la versión, en un clúster GKE de siete nodos (tres de servicios, tres de bases de datos y uno de generación de carga) instalado con --ha, cuyo broker ejecuta tres servidores, con dispositivos MQTT enviando QoS 1 a 300 mensajes por segundo todo el tiempo, 23 de 448.346 mensajes que el broker había confirmado no se almacenaron nunca. Las pérdidas se produjeron en ráfagas alrededor de cada uno de los tres reinicios de servidor del broker. La entrega QoS 1 al menos una vez no está garantizada durante un reinicio del broker: un dispositivo al que se envió un PUBACK no reenviará. Las mediciones anteriores están en Actualizaciones progresivas, el comportamiento del broker en MQTT: el bróker de la plataforma, y el ajuste de cierre seguro que lo cambia es --mqtt-fail-closed.
Autenticación en dos pasos
Una cuenta ya puede activar la autenticación en dos pasos: un código de una aplicación de autenticación después de la contraseña, con diez códigos de recuperación de un solo uso. Está desactivada en todas las cuentas hasta que su dueño la active, así que no cambia nada para quien no hace nada. La consola, la aplicación de paneles y la página de autorización MCP piden el código, y los inquilinos y los niveles pueden exigirla. La base de datos de user-management añade tablas para el factor y sus códigos de recuperación mediante una migración automática.
loginahora puede fallar conMFA_CHALLENGE, así que los clientes de la API deben gestionarlo. Para una cuenta con segundo factor, una contraseña correcta ya no devuelve un token:loginfalla con el código de errorMFA_CHALLENGEy un desafío enextensions, y el cliente termina con el nuevoverifyMfa(challenge, code). Un cliente que no lo conoce ve un inicio de sesión fallido con un mensaje legible, nunca un token. Las cuentas sin segundo factor inician sesión exactamente como antes. El SDK de C# lanzaMfaRequiredExceptiony añadeVerifyMfaAsync;dcctlañade--otpendead-letters,presenceysim. Consulta Iniciar sesión con autenticación en dos pasos.- La fila de auditoría
logincambió de significado. Ahora se escribe cuando un inicio de sesión se completa, con una etiquetapwd,pwd+otpopwd+recovery. Para una cuenta con segundo factor, el paso de la contraseña es una nueva filamfa_challenged, así que una consulta que contaba las filaslogincomo contraseñas aceptadas ahora cuenta inicios de sesión completados. Las filas nuevas registran la configuración, los restablecimientos, los intentos fallidos y bloqueados y el uso de códigos de recuperación. - Configurar el factor, y desactivarlo, termina las sesiones de la cuenta. Al configurarlo terminan todas las demás sesiones y la consola cambia la tuya por una nueva. Al desactivarlo terminan todas las sesiones, incluida la del llamante.
- Un inquilino puede exigirla, y un nivel puede fijar un mínimo con la clave de nivel
mfaRequired. A los miembros sin factor se les envía a configurarlo, y las sesiones que ya están dentro terminan en su siguiente renovación. Los superusuarios, las cuentas de servicio y las sesiones de inicio de sesión único no están sujetos al ajuste de un inquilino. - Un nuevo comando break-glass,
dcctl instances break-glass mfa-reset, restablece a un operador que ha perdido su factor y no puede iniciar sesión. Necesita credenciales del clúster, siempre sustituye la contraseña e imprime la nueva una sola vez. - Dos alertas nuevas,
MfaIdentityLockedyMfaVerificationFailuresSustained, y cuatro métricas llegan con el chart. Permanecen en silencio mientras nadie tenga un segundo factor. El remedio para un bloqueo es restablecer la contraseña, no el factor. Consulta Bloqueos del segundo factor. - Los nodos necesitan una sincronización horaria correcta. Un código es válido durante su intervalo de 30 segundos y uno a cada lado.
Las actualizaciones over-the-air pasan al perfil default
Las actualizaciones over-the-air forman parte del perfil default a
partir de esta versión, así que una instancia que ejecuta el sistema estándar incorpora el servicio
update-management al actualizarse. Nada más cambia en la actualización. Comprueba esto antes de empezar:
- Puede que haya que subir antes el presupuesto de conexiones de la base de datos relacional.
update-managementes un servicio más que usa la base de datos, así que una instancia de perfildefaultreserva ahora 320 conexiones, frente a 280. El presupuesto de un clúster nuevo es ahora700, que admite dos instancias de perfildefault. Un clúster instalado con el valor anterior de600lo conserva, y si aloja dos instancias de perfildefault, la actualización de la segunda puede rechazarse. Sube el presupuesto antes de actualizar volviendo a ejecutar eldcctl installcon el que se instaló el clúster, añadiendo--max-connections 700: por ejemplodcctl install local --max-connections 700, más los indicadores con los que se instaló, como--kube-context,--ha,--compacty--database-node-selector. Consulta el presupuesto de conexiones, que también explica lo que cuesta subirlo: las instancias de la base de datos se reinician una a una. - Si tu almacén de objetos es un volumen
ReadWriteOnceen un clúster al que apuntastedcctl, el servicio se ejecuta sin almacén. Un volumen así lo puede montar un solo servicio y los demás ya lo ocupan, así quedcctlactualiza la instancia conupdate-managementenupdates.objectStore: noneen lugar de rechazarla. La actualización lo indica. Declarar un artefacto y subir su contenido se rechazan conOBJECT_STORE_NOT_CONFIGURED, la consola muestra un aviso en las pantallas de Actualizaciones yupdateManagementInfo.objectStoreConfiguredesfalse. Una instancia no puede obtener un almacén al actualizar; para usar actualizaciones, vuelve a crearla con S3 o con un volumenReadWriteMany. Consulta Una instancia sin almacén de objetos. Un volumen compartible, S3 y un clúster que creódcctlno se ven afectados. - No se puede asignar ningún artefacto hasta que se registre un firmante. Por defecto solo se puede asignar
un artefacto firmado por un firmante activo, y en caso contrario la asignación se rechaza con
UNVERIFIED_ARTIFACT_REFUSED. Registrar un firmante requiere la autoridadartifact:trust. Sigue Firmar actualizaciones. - La base de descarga ahora se deriva.
updates.downloadBaseUrlestaba sin definir hasta que la establecías, de modo que ningún dispositivo recibía un enlace de descarga. Si la omites, el chart ahora deriva<origen>/api/update-managementdel host del ingress de la instancia, conhttpssi el TLS del ingress está activado. Un valor que definas sigue prevaleciendo, y una cadena vacía desactiva las descargas. Una instancia sin ingress no tiene origen del que derivarla, y la consola indica que las descargas no están configuradas. dcctl enable-area local <instancia> update-managementen una instanciadefaultinforma de que ya está activada. Las instancias de los perfilestelemetryeingest-onlysiguen sin incluirla.- Se llega a los mismos dispositivos que antes. Solo un dispositivo conectado por MQTT puede recibir una actualización gestionada. Los dispositivos solo HTTP, LwM2M y Sparkplug no se alcanzan; consulta Qué dispositivos se pueden actualizar.
Más sobre las actualizaciones over-the-air
Las actualizaciones quedan completas en esta versión más allá de entrar en el perfil default. Un dispositivo de referencia actualizable (ranuras A/B, un lanzador y reversión) se incluye en examples/ota-device. Cuatro alertas nuevas, UpdateDownloadsNotConfigured, UpdateReportsMostlyRefused, UpdateRolloutStepsFailing y UpdateAttemptsGoingUnknown, llegan con el chart y solo se generan en una instancia que tiene update-management; una instancia que no usa actualizaciones permanece en silencio. Consulta el runbook de alertas.
Comandos Sparkplug B (opcional)
DeviceChain ya puede enviar comandos a nodos y dispositivos Sparkplug: escribir una métrica, pedir a un nodo que rehaga su nacimiento (rebirth) o reiniciarlo, publicados en la sesión de Host Application que la plataforma ya mantiene con tu broker. Está desactivado de forma predeterminada y se activa por fuente con commands.enabled en los valores del chart (dcctl no admite fuentes Sparkplug, así que es un ajuste de valores de Helm). Sparkplug no tiene acuse de recibo de comandos: un comando se confirma cuando el nodo informa después del valor pedido, y uno que el nodo no informa termina como tiempo agotado, no como fallo. Las escrituras se limitan a las métricas que lista una fuente, los reinicios requieren un ajuste explícito y un cortacircuitos pausa una fuente cuyo broker rechaza la publicación. La credencial de broker de la fuente necesita permiso para publicar en los temas de comandos de nodo y de dispositivo. Tres alertas nuevas cubren comandos sin confirmar, un cortacircuitos abierto y fallos internos de comandos: SparkplugCommandsUnconfirmed, SparkplugCommandBreakerOpen y SparkplugCommandResponsesFailing.
No cambia nada en una instalación cuyas fuentes Sparkplug dejan commands.enabled desactivado. Cuando una fuente lo activa, el chart fija por sí mismo el indicador de capacidad de command-delivery; el renderizado falla si command-delivery no está desplegado, o si fijas functionalAreas.command-delivery.config.sparkplugCommands a mano.
Métricas calculadas
Las métricas calculadas siguen desactivadas: el techo de nivel que permite a un inquilino crearlas sigue siendo 0 de forma predeterminada, y esta versión no lo cambia. Cambian dos cosas a su alrededor. Revertir un perfil de dispositivo a una versión anterior ahora cumple el mismo techo que publicar: un inquilino cuyo techo se bajó después de publicar ya no puede reactivar una versión con más métricas calculadas de las que permite su nivel; la reversión se rechaza como LIMIT_EXCEEDED, y también cuando no se puede leer el techo. Revertir a una versión sin métricas calculadas nunca depende del techo. La consola ahora explica por qué una métrica calculada no puede combinar sus entradas. En hack/ se incluye un arnés para medir el coste de las métricas calculadas; es para mantenedores y no forma parte de una instalación.
Integraciones de entrada y alias de dispositivo
Una integración es un emisor autenticado de datos de dispositivo por HTTP de un inquilino, como un servidor de red LoRaWAN, con los tipos ChirpStack v4, The Things Stack v3, JSON genérico y binario genérico. El chart publica exactamente una ruta para ella en el front end de la instancia, POST /api/integrations/{tenant}/{integration}[/{messageType}], tanto por el Gateway como por los objetos Ingress. La ruta general de ingesta de dispositivos no se publica. Un inquilino puede tener cinco integraciones de forma predeterminada (la clave de nivel integrationsPerTenant, de 0 a 100). No se puede eliminar un tipo de dispositivo al que está acotada una integración. Los dispositivos se identifican con alias, y un uplink de un dispositivo que ya no tiene el alias con el que llegó se rechaza como IntegrationAliasMismatch, de modo que quitar o mover un alias surte efecto como mucho en cinco minutos, nunca en una hora. La consola incorpora una página de Integraciones, fragmentos de conexión, dispositivos sin registrar y alias de dispositivo.
La pila de monitorización
dcctl install actualiza la pila de monitorización (kube-prometheus-stack 65.1.1 a 92.13.1): Prometheus 2.54 a 3.15, Grafana 11.2 a 13.2 y Prometheus Operator 0.77 a 0.94. Prometheus, Alertmanager, Grafana, kube-state-metrics y el operador se reinician una vez cada uno. Los CRD del operador se actualizan con un trabajo previo a la actualización que descarga docker.io/busybox:1.37.0 y registry.k8s.io/kubectl, así que un clúster sin ruta a esos registros debe replicarlos. Grafana conserva su acceso de administrador, sus carpetas y sus paneles. En un clúster local Prometheus guarda sus datos solo en el disco del nodo, por lo que su historial empieza vacío. Quien tenga PromQL propio contra este Prometheus debe saber que es Prometheus 3: los selectores de rango son abiertos por la izquierda, . en una expresión regular coincide con un salto de línea y las etiquetas le de los histogramas clásicos se normalizan. Las reglas y paneles propios de DeviceChain se cargan sin errores de reglas.
Los paneles de Grafana del chart se completan: paneles de Ingesta, Mensajería, Persistencia y estado, Entrega y Plataforma, una vista general de la instancia que enlaza con cada uno y un estado de escalado a 0 en la vista general.
Mensajería y línea de comandos
- El lector de captura de dispositivos pasa a un consumidor duradero nuevo,
<instance>_event-sources_device-events-capture_unfiltered, creado sin filtro en el broker. Un lector retrasado sobre un consumidor filtrado caía a unos 2.000 eventos por segundo y no se ponía al día. Durante la actualización progresiva un pod antiguo deevent-sourcesconserva su propio consumidor. Para volver av0.25.xhay que borrar antes el consumidor nuevo (nats consumer rm <instance>_device-events-capture <instance>_event-sources_device-events-capture_unfiltered), o su lector de captura se queda reintentando; los selectores de alertas y paneles ya coinciden con ambos nombres. - REACT despacha los eventos derivados de forma concurrente, por dispositivo, donde un solo trabajador lo hacía en serie; un dispositivo colgado ya no cuesta a los demás de su carril sus intentos de entrega. No hay nada que configurar.
dcctl bootstrapydcctl upgradeincorporan--mqtt-fail-closed(y--mqtt-fail-closed=false) para activar y desactivar el acuse MQTT con cierre ante fallos; si se omite, se conserva la elección registrada. Además, cadadcctl upgraderechaza ahora, antes de cambiar nada, una configuración cuya reserva de streams no cabe en el techo de almacenamiento de archivos del broker.- OpenTofu actúa sobre el clúster que
dcctlresolvió. Su proveedor recibe ahora el mismo kubeconfig y contexto que el cliente, ydcctlse niega a ejecutarse cuando alcanzan clústeres distintos o cuando hay una variable de entorno que anula el proveedor (KUBE_HOST,KUBE_TOKENy similares).
Un broker que solicita certificados de dispositivo
El broker es ahora la compilación propia de DeviceChain de nats-server, dc-nats-server: la v2.15.1 original más un ajuste, aplicado al arrancar y en cada recarga, para que el listener MQTT solicite (sin exigir) un certificado de cliente TLS. Los dispositivos con token o contraseña no se ven afectados y todavía ningún dispositivo se autentica con certificado. La imagen se firma como las demás, se ejecuta como root igual que la imagen original y exporta dc_broker_mqtt_client_auth_request, dc_broker_mqtt_tls y dc_broker_info en el puerto 7778. La alerta nueva BrokerMqttClientAuthLost se dispara cuando un listener deja de solicitar certificados o cuando un pod del broker no es esta compilación. Para volver a la imagen original, fija server_image_repository = "nats" y server_image_tag = "2.15.1-alpine"; eso desactiva los dispositivos con certificado. Añade dc-nats-server a las imágenes que replicas.
dcctl fija el broker por el resumen (digest) que publicó la versión, de modo que una versión que no cambia nada del broker no lo reinicia. La primera actualización desde un dcctl anterior pasa la plantilla del pod de la etiqueta al resumen, lo que supone un reinicio progresivo. dcctl version imprime una línea broker:, con el resumen o by tag.
Problemas conocidos
- Tras un reinicio progresivo del broker, incluida esta actualización, el último servidor reiniciado no lidera ningún stream, y el p99 del acuse de publicación se duplica aproximadamente hasta que el liderazgo se reequilibra. Corregido en
v0.27.0:dcctl upgradereequilibra el liderazgo tras reiniciar el broker; consulta el certificado del broker se renueva sin desconectar dispositivos. - Una rotación de certificado TLS hace que el broker se recargue y desconecta la mayoría de las sesiones MQTT. Los dispositivos se reconectan solos. Corregido en
v0.27.0: el broker aplica el certificado renovado a las conexiones nuevas sin recargarse, así que las sesiones establecidas se mantienen. Un cambio en la configuración del broker sigue recargándolo, y una recarga sigue desconectando las sesiones de los dispositivos admitidos por el callout de autenticación hasta que la bibliotecanats-serverdel broker incluya la corrección de upstream. - Un despliegue del controlador de ingress pierde alrededor del 5 % de las solicitudes durante 28 a 40 segundos. Hazlo en una ventana tranquila. Corregido en
v0.27.0: ambos controladores drenan antes de que un pod se vaya y esperan antes de retirar uno antiguo, así que un despliegue ya no pierde solicitudes detrás de un balanceador de carga en la nube; consulta qué cambia en el borde.
v0.25.2 — la emisión de tokens de servicio sale del puerto público
v0.25.2 es un parche de seguridad de v0.25.1. No hay migración, y no cambia ninguna API, tema ni
permiso. La configuración de la instancia gana una clave, infrastructure.userManagement.internalPort,
que el chart fija en 8082; déjala en ese valor, porque el Service, el pod y la política de red del chart
usan ese puerto fijo. Todo lo que describen las secciones de la v0.25.1 y la
v0.25.0 sigue siendo lo que estás ejecutando, incluidas sus limitaciones conocidas.
Actualiza el clúster y después cada instancia. Pasa a dcctl install los ajustes con los que se instaló
el clúster, como --ha y --database-node-selector, además de la nueva --version:
dcctl install local --version v0.25.2
dcctl upgrade local devicechain --version v0.25.2 --dry-run
dcctl upgrade local devicechain --version v0.25.2
Si vienes de v0.25.0 o de v0.24.0, sigue las notas de la v0.25.1 con
--version v0.25.2: se aplican sin cambios, y también lo que dicen sobre las actualizaciones de la v0.25.0.
Los endpoints internos salen del puerto público
user-management servía en su puerto público dos endpoints pensados solo para los servicios de la propia
plataforma: /auth/service-token, que intercambia el secreto de servicio compartido por un token de
servicio de corta duración, y /auth/jwks, el conjunto de claves con el que cada servicio valida los
tokens. Lo único que los mantenía fuera de internet era un fragmento de configuración (snippet) de nginx en
el ingress de la API del chart. Por eso, una instalación que traía su propio controlador de ingress tenía
ambos accesibles desde fuera, protegidos por el secreto de servicio compartido, que se compara en tiempo
constante.
A partir de esta versión, user-management sirve ambos en un puerto interno aparte, el 8082, que el
chart publica solo en el Service interno del clúster. Ningún ingress, ruta ni balanceador de carga se
refiere a él, y el puerto público responde 404 a ambas rutas, haya lo que haya delante, así que un
controlador propio no necesita ninguna regla en el borde para ocultarlos. Ahora cada servicio obtiene el
conjunto de claves y emite su token en el puerto interno. Consulta
Endpoints que nunca salen del clúster.
- El chart ya no fija ningún snippet de configuración de nginx.
- El controlador de ingress que instala
dcctl installno cambia en esta versión y sigue aceptando snippets, porque las instancias aún no actualizadas dependen de ellos. Una versión posterior los desactiva, tras una comprobación dedcctl installque se niega a continuar mientras algún Ingress de la clase del controlador siga llevando una anotación*-snippet. - Los verificadores de tokens externos no se ven afectados: usan el
jwks_uride los metadatos del servidor de autorización,/oauth/jwks, que sigue siendo público.
Qué esperar
user-managementy sus pares deben actualizarse juntos. Un pod de una versión anterior pide el conjunto de claves y la emisión de tokens al puerto público, que ahora responde 404, y no sale de ello reintentando: sus emisiones fallan hasta que ese pod se sustituye por uno de esta versión.dcctl upgradesustituye los pods de todos los servicios, así que esto dura lo que dura el despliegue; no dejes ningún área atrás en una imagen anterior.- Un pod anterior que se reinicia después de que
dcctl upgradehaya escrito la nueva configuración no arranca. Los binarios anteriores decodifican la configuración de la instancia de forma estricta y rechazan la nueva claveinternalPort, así que ese pod entra en un bucle de reinicios hasta que se sustituye por uno de esta versión. - Si usas tu propio motor de políticas de red, permite que los pods del namespace de la instancia
lleguen al puerto
8082deuser-management, y nada más. La política de red propia del chart para ese puerto está desactivada por defecto, y las instalaciones condcctlla ejecutan desactivada. - Los paneles de Grafana que incluye el chart se abren con una tabla de las alertas activas de la instancia y enlazan a los demás paneles de la instancia, y un tercer panel, Instance overview, contiene por ahora solo esa tabla.
v0.25.1 — las imágenes de las bases de datos y del almacén de respaldos, reconstruidas por avisos de seguridad actuales
v0.25.1 es un parche de v0.25.0. No hay migración, y no cambia ninguna API, tema, permiso, valor del
chart ni clave de configuración. Mueve las tres imágenes de terceros sobre las que el clúster y cada
instancia ejecutan sus bases de datos y su almacén de respaldos a compilaciones que ya no llevan los avisos
de seguridad que se enumeran abajo, y corrige lo que dos servicios informan a Prometheus y los paneles de
Grafana que el chart incluye para ellos (consulta Las métricas y los paneles). Todo lo que describe la
sección de la v0.25.0 sigue siendo lo que estás ejecutando.
Siguen vigentes las limitaciones conocidas de la v0.25.0, incluida esta: con mqttFailClosed desactivado, el valor por defecto, también se pueden perder mensajes QoS 1 confirmados con carga sostenida y sin reinicio del broker, cuando event-sources se queda atrás y el stream de captura se llena. devicechain_<area>_jetstream_consumer_unread_skipped_total los cuenta y JetStreamDurableLostUnread alerta.
Actualiza el clúster y después cada instancia. Pasa a dcctl install los ajustes con los que se instaló
el clúster, como --ha y --database-node-selector, además de la nueva --version:
dcctl install local --version v0.25.1
dcctl upgrade local devicechain --version v0.25.1 --dry-run
dcctl upgrade local devicechain --version v0.25.1
Si vienes de v0.24.0, sigue las notas de la v0.25.0 con --version v0.25.1: se
aplican sin cambios, incluido ejecutar dcctl upgrade dos veces. Si vienes de v0.25.0, basta con un
dcctl upgrade si se ejecutaron las dos actualizaciones de la v0.25.0. Si solo se ejecutó la primera, el
inicio de sesión compartido del bróker sigue en su sitio, y esta actualización lo retira, con el reinicio
del bróker que eso conlleva; su --dry-run y su resumen final lo indican (consulta
Los inicios de sesión del bróker, en dos actualizaciones).
Qué se mueve
| Imagen | Ejecuta | De | A | Avisos que ya no lleva |
|---|---|---|---|---|
ghcr.io/devicechain-io/postgresql-timescaledb | el almacén de eventos de cada instancia | 17.10-ts2.28.3-r1 | 17.11-ts2.28.3-r1 | Perl 5.36.0-7+deb12u3: CVE-2026-13221, CVE-2026-42496, CVE-2026-8376 (críticos), CVE-2026-42497, CVE-2026-48962, CVE-2026-57432, CVE-2026-57433 (altos). PCRE2 10.42-1: CVE-2026-103111, CVE-2026-86145, CVE-2026-89157, CVE-2026-89161 (altos) |
ghcr.io/cloudnative-pg/postgresql | la base de datos relacional compartida del clúster (dc-rdb, en dc-system) | 17.10-standard-bookworm | 17.11-standard-bookworm | los mismos avisos de Perl y PCRE2 |
cgr.dev/chainguard/minio | el almacén de respaldos dentro del clúster, cuando los respaldos van a él | resumen sha256:32c504be… | resumen sha256:73297936… | CVE-2026-111497 (decodificador Brotli, alto), CVE-2026-111943 (crypto/x509 de Go, en el cliente mc incluido, alto) |
La imagen del almacén de eventos es una compilación propia de DeviceChain sobre la base PostgreSQL de CloudNativePG, así que se mueve con esa base. PostgreSQL pasa de 17.10 a 17.11, una versión menor: los ficheros de datos se conservan tal cual y no se vuelca ni se restaura nada. TimescaleDB sigue en 2.28.3. Analizada con Trivy en busca de avisos altos y críticos que tengan corrección, ninguna de las imágenes nuevas informa de ninguno.
Las métricas y los paneles
event-processingpone a cero sus indicadores exclusivos del líder cuando una réplica deja de serlo. Una réplica que había perdido la concesión de detección seguía exportando el retraso, la demora y los tamaños de estado de su último mandato. El panel y las alertasDetectConsumerBacklogHigh,DetectWatermarkLagHighyDetectTenantOverStateBudgettoman la lectura más alta entre réplicas, así que esa lectura congelada podía mostrar un retraso que ninguna réplica tenía e impedir que una alerta se resolviera. Una réplica en espera informa ahora cero para ellos. El recuento de reglas cargadas no cambia, porque todas las réplicas cargan las reglas.command-deliveryexporta sus contadores de lotes de comandos a cero desde el arranque, de modo que su panel muestra cero en lugar de "No data" antes del primer lote, y unincrease()sobre ellos ve el primero.- Se corrigen los dos paneles que incluye el chart: sus series coinciden con lo que exportan los servicios, los eventos poco frecuentes se muestran como recuentos, los gráficos que mezclaban unidades se separan y se añaden gráficos para el presupuesto de muestras retenidas.
Qué esperar
dcctl installreinicia una vez las instancias de la base de datos relacional, sobre la imagen nueva: con--ha, primero las réplicas en espera y después una conmutación a una de ellas, así que las escrituras se detienen solo durante la conmutación. Una base de datos relacional de una sola instancia no está disponible hasta que esa instancia se ha reiniciado, y las escrituras hechas mientras tanto se reintentan.dcctl installespera hasta que cada instancia ejecuta la imagen nueva.dcctl installreinicia una vez el pod del almacén de respaldos, cuando el clúster guarda sus respaldos dentro del clúster. Los respaldos y el registro de escritura anticipada guardados se conservan. Mientras el pod se reinicia, el archivado se detiene y las bases de datos guardan el registro de escritura anticipada localmente. Un clúster que envía sus respaldos a tu propio almacén de objetos con--backup-credentials-fileno ejecuta ningún almacén de respaldos, y ahí no cambia nada.dcctl upgradereinicia una vez el almacén de eventos de la instancia, sobre la imagen nueva, en el paso de infraestructura antes de mover los servicios: con--ha, primero las réplicas en espera y después una conmutación; sin--ha, la única instancia se reinicia, y event-management no puede guardar eventos hasta que vuelve. Esos eventos esperan en el flujo de ingesta y se reintentan; uno se abandona solo tras unos cuatro minutos de reintentos fallidos. La actualización espera hasta que cada instancia del almacén ejecuta la imagen nueva antes de mover los servicios. Los ajustes del bróker de mensajes no cambian, así que sus servidores no se reinician.- Los servicios pasan a las imágenes
v0.25.1pod a pod, como en cualquier actualización. Su código es el mismo que el dev0.25.0, salvo los dos cambios de métricas de arriba. - Si replicas imágenes en un registro propio, replica las tres referencias nuevas de arriba antes de
actualizar, y las imágenes de DeviceChain
v0.25.1como siempre. - Si fijaste
timescale_imagetú mismo en elterraform.tfvarsjunto al estado de infraestructura de una instancia, la actualización conserva tu valor, y el almacén de eventos se queda en la imagen que nombra. Ponlo enghcr.io/devicechain-io/postgresql-timescaledb:17.11-ts2.28.3-r1, o quita la línea, para moverlo. - Cambiar un ajuste de la base de datos en la misma ejecución se rechaza en una base de datos de más
de una instancia: el operador de la base de datos no acepta una imagen nueva y ajustes nuevos a la vez.
Limita
dcctl installa los ajustes que el clúster ya tiene (un--max-connectionsdistinto, por ejemplo, es un cambio así), y cambia el ajuste en una ejecución aparte.
v0.25.0 — cada área inicia sesión en el bróker con su propia identidad, y las versiones están firmadas
v0.25.0 es una actualización en su sitio desde v0.24.0: dcctl install para el clúster y después
dcctl upgrade para cada instancia, como se describe para la v0.17.0. Pasa a
dcctl install los ajustes con los que se instaló el clúster, como --ha y --database-node-selector,
además de la nueva --version.
A diferencia de la mayoría de las versiones, dcctl upgrade se ejecuta dos veces. La primera ejecución da
a cada área un inicio de sesión propio en el bróker de mensajes y mantiene a su lado el inicio de sesión
compartido; la segunda retira el inicio de sesión compartido (consulta
Los inicios de sesión del bróker, en dos actualizaciones). No se puede alcanzar en
su sitio desde la v0.22.0 ni versiones anteriores: actualiza primero pasando por la v0.23.0 y la
v0.24.0 (consulta Antes de actualizar). Sus tres migraciones añaden cinco tablas, una
columna y sus índices, y no reescriben ninguna fila existente (consulta
Durante la actualización). Desde ella se avanza, no se vuelve atrás (consulta
Volver atrás).
Los comandos, con la v en la versión y un ensayo primero:
dcctl install local --version v0.25.0
dcctl upgrade local devicechain --version v0.25.0 --dry-run
dcctl upgrade local devicechain --version v0.25.0
# when that has finished and every area is Ready, run it again to retire the shared broker login:
dcctl upgrade local devicechain --version v0.25.0
--version lleva la etiqueta con su v. En un clúster que no sea el local por defecto, pasa --kube-context
a dcctl install y a dcctl upgrade, y pasa --registry cuando las imágenes salgan de un registro distinto
del predeterminado. El --dry-run de cada ejecución indica cuál de las dos realizaría. Si la instancia se
inicializó sin custodia de la clave raíz, dcctl upgrade imprime una advertencia de custodia; es lo esperado
y no tiene relación con esta actualización. Un valor de --mqtt-body-credential indicado para la v0.24.0
se conserva en una actualización que omite la opción; la opción se eliminó en la v0.26.0 (consulta la v0.24.0).
Esta versión hace dos cosas en torno a la confianza. Dentro del clúster, ningún servicio comparte ya una credencial del bróker con otro: cada área inicia sesión en el bróker de mensajes con su propia identidad, limitada a lo que usa, y un único inicio de sesión de administración crea y modifica streams y buckets. Fuera de él, todas las imágenes y el chart están firmados, de modo que puedes comprobar que lo que ejecutas lo construyó el flujo de trabajo de versiones de DeviceChain. Además: el token de acceso de un dispositivo se almacena como un digest con clave, el agente de borde es un gateway con una identidad propia, los tenants pueden crear cuentas de servicio para sus integraciones, y las actualizaciones over-the-air se pueden desplegar en un grupo de dispositivos. Qué cambia para alguien:
- Ejecuta
dcctl upgradedos veces. La primera actualización mantiene el inicio de sesión compartidodc_service; la segunda lo elimina. Consulta Los inicios de sesión del bróker, en dos actualizaciones. - El token de acceso de un dispositivo ya no se puede leer de vuelta. Todo lo que leía
credentialIdde una credencialACCESS_TOKENy lo usaba como token recibe ahora una huella. Consulta Los tokens de acceso de los dispositivos se almacenan como digests. - Un agente de borde debe pasar a su identidad de gateway antes de actualizarse; el antiguo enlace ascendente directo de dispositivo ha desaparecido. Consulta El agente de borde es un gateway.
- Una conexión del SDK de C# que el bróker rechaza lanza ahora
MqttConnectRefusedExceptionen lugar de reintentarse como si la red estuviera caída. Consulta El SDK de C#. - Una instalación que ejecuta el chart sin
dcctlnecesita el espacio de nombres de la instancia y el Secret del administrador del bróker antes de su primera instalación, obrokerAdmin.enabled=false. Consulta Los inicios de sesión del bróker, en dos actualizaciones. - El bróker se reinicia una vez en cada una de las dos actualizaciones, un servidor a la vez con
--ha. Consulta Durante la actualización. - No hay vuelta atrás a la
v0.24.0. Consulta Volver atrás. - Actualiza pasando por la
v0.23.0y lav0.24.0si vienes de lav0.22.0o anterior. - Tres migraciones: dos tablas en
update-management, tres enuser-management, y una columna y un índice endevice-management. Consulta Durante la actualización. - Las versiones están firmadas. No hay nada que hacer; consulta La primera versión firmada.
- Una actualización revierte el ajuste que hayas hecho a mano, salvo que lo pases a
--values. Eso ya era así antes; esta versión añade la forma de conservarlo. Consulta El ajuste del operador se conserva.
Antes de actualizar
- Si vienes de la
v0.22.0o anterior, detente. Actualiza a lav0.23.0, después a lav0.24.0, esperando cada vez a que todos los pods ejecuten la versión nueva, y solo entonces a lav0.25.0. El formato de cable compacto que lav0.24.0convirtió en el predeterminado es ilegible para lav0.22.0y anteriores (consulta El formato de los eventos en el cable), y saltarse una versión menor no es una ruta probada (consulta Rutas de actualización admitidas). Lee también las notas de lav0.24.0. Una instancia construida por lav0.16.0o anterior sigue sin poder actualizarse; consulta Instancias construidas por la v0.16.0 y anteriores. - Averigua qué lee de vuelta el token de acceso de un dispositivo. Un script, una herramienta de
aprovisionamiento o una hoja de cálculo que obtenía el token de
deviceCredentialso dedeviceCredentialsByTokenrecibirá en su lugar una huella que empieza pordctk1$. Los tokens que están en los dispositivos siguen funcionando. Decide de dónde saldrá cada token que no registraste: fija un token nuevo en la credencial (consulta Los tokens de acceso de los dispositivos se almacenan como digests). - Si ejecutas el agente de borde, planifica su paso a gateway antes de actualizarlo. Crea un dispositivo
gateway con una credencial
MQTT_BASICpara cada agente, y asígnale los dispositivos que el sitio le presenta. No reinicies un agente en esta versión hasta que la plataforma, bróker incluido, se haya actualizado. Consulta El agente de borde es un gateway. - Si ejecutas el chart sin
dcctl, crea primero el espacio de nombres y el Secret del administrador, o indicabrokerAdmin.enabled=falsey crea tú mismo los streams y los buckets con la imagendc-broker-admin. Consulta Qué aplica una actualización a la infraestructura. Una instalación que trae su propio bróker puede imprimir los permisos que necesita cada inicio de sesión condcctl broker permissions. - Si replicas las imágenes en tu propio registro, añade
dc-broker-admin. El job previo a la actualización la ejecuta, y la actualización falla antes de que ruede ningún servicio si no se puede descargar. También figura en la lista de imágenes firmadas. - Si ajustaste la instancia a mano (número de réplicas, recursos, la configuración propia de un área),
ponlo en un archivo de valores y pásalo como
--valuesen la primera actualización. Una actualización reconstruye los ajustes de una instancia a partir de su declaración, así que todo lo fijado de otro modo se revierte. Consulta Ajustar una instancia. - Si un programa de dispositivo en C# o Unity se conecta al bróker MQTT de la plataforma, lee El SDK de C# antes de recompilarlo.
Durante la actualización
- Se ejecutan tres migraciones, una por cada primer arranque del servicio al que pertenece. Ninguna
reescribe una fila, y cada una puede ejecutarse de nuevo si se interrumpe.
device-managementañade la columna anulabledevices.gateway_id, que registra el gateway tras el que está un dispositivo (está vacía para todos los dispositivos existentes), y un índice parcial sobre(tenant_id, gateway_id). El índice se construye con unCREATE INDEXsimple, que mantiene un bloqueo contra las escrituras endevicesmientras se construye; cubre solo los dispositivos que tienen un gateway, así que está vacío en la primera ejecución.update-managementcreaupdate_rolloutsyupdate_rollout_targets, que contienen los despliegues en grupo. Ambas empiezan vacías.user-managementcreaiam_service_accounts,iam_service_account_roleseiam_service_account_secrets, que contienen las cuentas de servicio y los digests de sus secretos. Las tres empiezan vacías.
device-managementconvierte cada token de acceso almacenado en su digest al arrancar. Esto no es una migración: se ejecuta después de la cadena de migraciones en cada arranque, abarca todos los tenants y las filas eliminadas lógicamente, escribe cada fila solo si aún contiene el valor que leyó, y la segunda vez no encuentra nada que hacer. Un dispositivo conserva el token que tiene; la misma cadena autentica antes y después.- Mientras
device-managementse renueva, los dispositivos que se autentican con un token de acceso pueden no conectarse. Cuando un pod de esta versión ha convertido las filas, un pod de lav0.24.0que aún está en la renovación busca un token presentado por su texto en claro y no encuentra nada, así que durante el solapamiento rechaza las conexiones con token de acceso y las comprobaciones por evento. Los dispositivos reintentan y llegan a un pod de esta versión. Un token que un pod de la versión anterior escribe durante el solapamiento se convierte en el siguiente arranque de un pod de esta versión. Los dispositivos que se autentican conMQTT_BASICno se ven afectados. - El bróker se reinicia una vez en la primera actualización y otra en la segunda. La primera añade los
inicios de sesión al bróker; la segunda elimina el compartido. Con
--hacada uno se reinicia un servidor a la vez, cada uno Ready antes de que se detenga el siguiente; sin--hase reinicia el único servidor y el bróker no está disponible mientras tanto, normalmente alrededor de un minuto. Los dispositivos y los servicios se vuelven a conectar por sí solos. No reinicies a mano un servidor del bróker mientras se renueva. Consulta Qué aplica una actualización a la infraestructura. - Un job se ejecuta entre el bróker y los servicios. El chart ejecuta
<instance>-broker-admincomo hook pre-install y pre-upgrade de Helm. Crea o repara cada stream y cada bucket clave-valor, incluido activar las lecturas directas del streamresolved-eventsque ahora usan las reproducciones de event-processing. Si falla, la actualización falla antes de que ruede ningún servicio,dcctlimprime el log del job y los servicios de lav0.24.0siguen ejecutándose. El job dispone por defecto de 540 segundos (brokerAdmin.activeDeadlineSeconds) y de un reintento (brokerAdmin.backoffLimit). - Un pod de la versión anterior que se reinicia mientras se ejecuta la actualización no arranca.
dcctlescribe la nueva configuración de la instancia justo antes del job, y esta lleva una clave (areaLogins) que lav0.24.0no declara, así que un pod de lav0.24.0que se reinicia después rechaza la configuración. Los pods que siguen en ejecución no se ven afectados. Deja que la actualización termine en lugar de reiniciar pods a mano; los pods que los sustituyen ejecutan esta versión. - Cada área espera su inicio de sesión. Tras la primera actualización, un área se niega a arrancar si la instancia dice que existen inicios de sesión por área y falta su propio Secret, en lugar de recurrir al inicio de sesión compartido.
Volver atrás
Avanza. No vuelvas a la v0.24.0, ni con helm rollback ni de ningún otro modo. Si la actualización falla
a medias, corrige la causa y ejecuta dcctl upgrade otra vez con la misma --version. Volver atrás deja una
instancia que no funciona:
- Se rechaza a todo dispositivo con token de acceso. El token se almacena ahora como un digest, y la
v0.24.0busca un token presentado por su texto en claro. Una reversión no restaura el texto en claro, y este no se guarda en ningún sitio. - Puede que el inicio de sesión compartido del bróker ya no exista. Tras la segunda actualización el bróker
ya no tiene
dc_servicey la configuración de la instancia ya no lo nombra, así que un servicio de lav0.24.0no tiene con qué conectarse.dcctllo dice cuando retira el inicio de sesión: no se admite volver atrás a través de esta versión, vuelve a ejecutar eldcctl upgrademás reciente. - La configuración está escrita para esta versión.
dcctlescribe la configuración de la instancia en el Secretdci-<instance>-config, fuera de la release del chart, así quehelm rollbackrestaura las cargas de trabajo de la release anterior y deja la configuración tal como la escribió esta versión. Esta lleva la claveareaLogins, que lav0.24.0no declara; los servicios rechazan al arrancar una clave de configuración desconocida.
Las tablas nuevas y la columna nueva no estorbarían: la v0.24.0 lee la misma base de datos y las deja sin
usar.
Después de la actualización
- Ejecuta
dcctl upgradeuna segunda vez, cuando la primera haya terminado con todas las áreas Ready. Consulta Los inicios de sesión del bróker, en dos actualizaciones. - Comprueba las firmas de lo que instalaste, si quieres. Consulta La primera versión firmada.
- Mantén activados
metrics.enabledymetrics.alerts(ambos lo están por defecto) para instalar las tres alertas nuevas de eliminación de tenants:TenantPurgeStoreFailing,TenantPurgeStoreHoldingyTenantPurgeCoordinatorFailing. Consulta Eliminación de inquilinos. - Pasa cada agente de borde cuando la plataforma haya terminado. Consulta El agente de borde es un gateway.
- Fija un token nuevo en toda credencial de token de acceso que no registraste. Consulta Los tokens de acceso de los dispositivos se almacenan como digests.
Los inicios de sesión del bróker, en dos actualizaciones
Hasta ahora todos los servicios iniciaban sesión en el bróker de mensajes con un único inicio de sesión
compartido, de modo que cualquier pod podía presentar, y cualquier filtración de su configuración exponía, la
credencial de todos ellos. El mecanismo se describe en
Qué aplica una actualización a la infraestructura, donde se tratan los inicios de
sesión por área, el job de administración y dcctl broker reconcile; qué significa para la actualización:
-
La primera actualización es la fase 1 de 2. Crea un inicio de sesión para cada área que usa el bróker (
mcpyai-inferencenunca abren una conexión con el bróker y no reciben ninguno) y uno para la administración del bróker, cada uno en un Secret llamadodci-<instance>-nats-<area>que solo monta esa área. El inicio de sesión compartidodc_servicese mantiene, con los permisos que siempre tuvo, de modo que un pod que aún no se ha renovado conserva su conexión. Hasta la segunda actualización sigue estando en la configuración que lee cada pod, así que un pod aún puede presentarlo. El resumen final dice «This was phase 1 of 2: rundcctl upgradeonce more to retire it.» -
La segunda actualización lo retira. Solo lo hace cuando la instancia de la que parte ya ejecuta todas las áreas con su propio inicio de sesión. Lo comprueba así:
- la configuración en ejecución ya indica a las áreas que usen sus propios inicios de sesión;
- el Secret de cada inicio de sesión existía antes de esta ejecución, de modo que ninguno se está creando ahora;
- el bróker en ejecución ya tiene un inicio de sesión para cada área y para el administrador;
- la versión en ejecución incluye el job de administración del bróker;
- la última ejecución sobre la instancia terminó Ready; y
- esta ejecución aplica el bróker, así que
--skip-infrastructurenunca retira el inicio de sesión.
Cuando se cumple todo, el bróker y la configuración de la instancia dejan de llevar el inicio de sesión compartido, con un reinicio más del bróker, y los servicios se renuevan una vez más sobre la configuración modificada. El resumen final dice «The shared message broker login is retired.» Cuando algo no se cumple, el inicio de sesión se mantiene y el resumen dice «The shared message broker login was NOT retired» y nombra la causa; resuélvela y ejecuta
dcctl upgradeotra vez. -
No pases
--skip-infrastructurea ninguna de las dos ejecuciones. No aplica nada al bróker, así que ni añade los inicios de sesión ni retira el compartido. -
Una instancia nueva nunca tiene un inicio de sesión compartido.
dcctl bootstrapcrea solo los inicios de sesión por área. -
No se admite volver atrás a través de la segunda actualización. Consulta Volver atrás.
-
Los servicios comprueban, y el administrador cambia. Un servicio verifica cada stream y cada bucket que abre y se detiene con un error que nombra el stream y en qué difiere cuando falta uno o es incorrecto. Ejecuta
dcctl broker reconcile <instance>para dejarlo como estaba, lo que también recupera un stream o un bucket eliminado a mano. -
Dos comportamientos cambian con ello. La vida de los buckets de caché queda fijada en cinco minutos, porque los crea el job y ya no se lo pregunta a cada servicio; los ajustes de tiempo de vida de la caché de
device-managementlimitan ahora solo cuánto tiempo conserva una réplica una entrada en su propia memoria. Y un número de réplicas aumentado en la configuración de la instancia surte efecto cuando se ejecuta el job, en la siguiente actualización, y no en cada reinicio de pod. -
Las instalaciones solo con el chart necesitan el espacio de nombres y el Secret de administración en su sitio antes de la primera instalación, porque el job se ejecuta antes de que el chart cree nada. El Secret se llama
dci-<instance>-nats-broker-adminy contieneuserypassword.dcctl broker permissionsimprime los permisos para un bróker que ejecutas tú mismo. -
Restaurar desde una copia de seguridad recibe inicios de sesión nuevos. Consulta Recuperación ante desastres.
Consulta el modelo de seguridad para saber qué protegen y qué no protegen los inicios de sesión.
Los tokens de acceso de los dispositivos se almacenan como digests
El token de una credencial ACCESS_TOKEN es su id de credencial, y antes se almacenaba y se devolvía tal como
se enviaba, de modo que una filtración de la base de datos o de una copia de seguridad entregaba una
credencial que funcionaba para cada dispositivo con token. Ahora se almacena como un digest con clave del
mismo tipo que ya lo es la contraseña de MQTT_BASIC: un HMAC-SHA-256 sobre el tenant y el token, con una
clave derivada de la clave raíz de la instancia. La forma almacenada es dctk1$<key id>$<digest>.
- Los dispositivos existentes conservan sus tokens. Ningún dispositivo necesita reaprovisionarse.
- El token se muestra una sola vez, en la respuesta a la llamada que lo establece (crear, una actualización que lo rota, un reemplazo de dispositivo que genera uno) y en el aviso de la consola, y nunca más. Una lectura devuelve la huella, que identifica la credencial y no puede presentarse como el token.
- Para obtener un token utilizable de una credencial cuyo token no registraste, fija uno nuevo: Set new
token en la consola, o
updateDeviceCredentialsolo concredentialId. El token actual del dispositivo deja de abrir conexiones en cuanto lo haces. Consulta Contraseñas y tokens que se muestran una vez, y su rotación. deviceCredentials(criteria: {credentialId})acepta el token o la huella.- Cambiar el tipo de una credencial a
ACCESS_TOKENo desdeACCESS_TOKENdebe nombrarcredentialIden la misma solicitud, porque el valor almacenado significa un digest con un tipo y un nombre de usuario con el otro. Una solicitud que no lo hace se rechaza comoINVALID_VALUE. Un token de más de 256 bytes se rechaza comoLIMIT_EXCEEDED. - Los fragmentos de conexión de la consola muestran
<access-token>para una credencial de token de acceso, igual que ya mostraban un marcador para una contraseña. - Una clave raíz distinta vuelve ajenos todos los digests. Como ocurre con los digests de contraseña, una instancia restaurada junto a una clave raíz equivocada registra un error que indica cuántos digests almacenados no produjo su clave.
El agente de borde es un gateway
El agente de borde inicia sesión en la plataforma como un dispositivo propio, un gateway, y publica los eventos de cada dispositivo local en su propio espacio de nombres. La plataforma acepta un evento solo de un dispositivo asignado a ese gateway. Este es el único modo de enlace ascendente: el antiguo modo de dispositivo directo, en el que el agente reenviaba al bróker de la nube sin cambios, se ha eliminado. Consulta Identidad del gateway y el espacio de nombres del gateway.
- La configuración de un agente debe cambiar.
agentIddeja de ser una clave, y una que quede detiene el agente al arrancar, con un error que nombrauplink.gatewayTokencomo su sustituta.uplink.tenant,uplink.gatewayToken,uplink.username(con la forma{tenant}:{credentialId}, rechazada al cargar en caso contrario) yuplink.passwordEnvson obligatorias. - Crea el dispositivo gateway y asígnale sus dispositivos antes de que el agente vacíe su cola pendiente.
Los eventos guardados en el spool con el modo antiguo se reenvían en el espacio de nombres nuevo, y uno de un
dispositivo que aún no está asignado se rechaza. El spool y su durable se limitan a
uplink.tenanten su sitio; los eventos guardados de cualquier otro tenant no se reenvían y permanecen en el spool hasta que su búfer circular los desaloja. - Asigna dispositivos con
assignDeviceGateway, o congatewayTokenal crear uno, o desde la pestaña Gateway del dispositivo en la consola. Un dispositivo tiene como máximo un gateway, un gateway no puede estar a su vez tras otro gateway, y un gateway que aún tiene dispositivos no se puede eliminar. Requieredevice:writey surte efecto en el siguiente evento del dispositivo. - Un evento rechazado no pasa en silencio. La plataforma lo registra en el stream de eventos fallidos con
el motivo
NotGatewayChild, lo cuenta enresolve_not_gateway_child_totaly envía un aviso al gateway; el agente lo registra en el log, lo cuenta y conserva el evento enrefused-events.jsonlen su directorio de almacén. - Actualiza primero la plataforma. Un
event-sourcesde lav0.24.0que se ejecuta coninfrastructure.nats.mqttFailClosedactivado confirma los mensajes de gateway que no puede atribuir y los descarta, y el agente ve un éxito. Termina de actualizar todas las réplicas deevent-sourcesy dedevice-managementy el bróker antes de reiniciar ningún agente en esta versión. Un agente cuyo bróker no se ha actualizado no puede suscribirse a sus avisos y no informauplink_connected. Consulta la advertencia en Actualizaciones progresivas. - Los comandos a dispositivos tras un gateway aún no se enrutan. El agente reenvía solo eventos.
El SDK de C#
El SDK no reconocía una conexión rechazada. La biblioteca MQTT informa de un CONNACK que no es un éxito
lanzando una excepción, y el SDK lo trataba como un fallo de transporte corriente, de modo que el bucle de
reconexión de una sesión seguía reintentando una credencial que el bróker había rechazado como si la red
estuviera caída. Ahora lanza MqttConnectRefusedException para un CONNACK que juzgó al cliente (versión de
protocolo no admitida, identificador de cliente no válido, nombre de usuario o contraseña incorrectos, no
autorizado, vetado, método de autenticación incorrecto), y el bucle de reconexión de una sesión se detiene
ante ella y declara la sesión ciega. Un CONNACK de «server unavailable» o «server busy», y un socket que
falla a mitad de la conexión, se siguen reintentando. MqttConnectRefusedException gana un constructor que
recibe la excepción subyacente, lo que es una adición a la API pública; no se elimina nada.
Qué cambia para un programa de dispositivo: uno que dependía de un reintento indefinido tiene ahora que manejar el rechazo, por ejemplo tras revocarse o sustituirse su credencial, o tras fijarse de nuevo su token de acceso.
La primera versión firmada
Cada imagen de servicio, el operador, el agente de borde, el administrador del bróker y la consola, y el chart
de Helm, están firmados con cosign, sin clave, por digest. Cada imagen lleva además un SBOM SPDX firmado y una
procedencia de compilación SLSA, y el chart lleva procedencia. Una firma queda ligada al flujo de trabajo de
versiones y a la etiqueta, así que una de cualquier otro flujo de trabajo, repositorio o rama no se verifica
como una versión. La versión de GitHub no se publica hasta que hack/verify-release-signatures.sh <tag> ha
pasado contra lo que se subió.
- Para comprobar lo que descargaste, sigue Verificar las versiones; el script
necesita
cosign3 o posterior,jqy la CLI de GitHub, y ninguna cuenta ni clave nuestra. - Las versiones anteriores a la
v0.25.0no llevan firma, y verificar una falla con «no signatures found». - La imagen de la base de datos no está cubierta. La imagen operand que ejecuta el almacén de eventos la publica un flujo de trabajo aparte y no está firmada en esta versión.
- Los archivos de
dcctly del agente de borde llevan procedencia de compilación, como desde lav0.18.0.
No hay nada que hacer para una actualización. Consulta la política de seguridad para saber cómo informar de un problema.
Cuentas de servicio
Un administrador de tenant puede crear cuentas de servicio en Settings, junto a Members, para
scripts e integraciones que no deban depender del token de actualización de una persona. Una cuenta tiene
exactamente los roles que se le dan (sin rol base de visor), opcionalmente limitada a algunos clientes o
grupos, y obtiene un token de acceso corriente válido durante cinco minutos con la concesión OAuth
client_credentials. Un secreto se muestra una vez, se almacena como un digest con clave y caduca (365 días
por defecto, 730 como máximo); rotar uno deja funcionando al antiguo durante un solapamiento que eliges, 24
horas por defecto. Un tenant puede tener 200 cuentas, y una cuenta no puede administrar el tenant. Consulta
Cuentas de servicio. El cliente OAuth de un operador no puede usar esta
concesión, y las credenciales de una cuenta de servicio no autentican nada en las demás concesiones.
Despliegues en grupo de actualizaciones over-the-air
createUpdateRollout, startUpdateRollout, pauseUpdateRollout, resumeUpdateRollout y
abortUpdateRollout asignan un artefacto a los miembros de un grupo de dispositivos, con nunca más de
maxInFlight dispositivos (de 1 a 1.000) con una actualización sin terminar, y Updates → Rollouts en la
consola los muestra. Iniciar un despliegue congela los miembros del grupo; un grupo de más de 10.000
dispositivos se rechaza. Un dispositivo que las reglas de asignación rechazan se omite con el código de esa
regla y no ocupa ningún hueco. Un umbral de fallos opcional pausa el despliegue por sí solo, y reanudarlo
entonces exige un umbral mayor. Abortar cancela los dispositivos que aún no han empezado y deja terminar a los
que están en curso. Los despliegues necesitan artifact:write para modificarse y artifact:read para verse, y
un miembro limitado a una parte del tenant es rechazado. Consulta
Desplegar en un grupo. Las métricas nuevas son
update_rollout_dispatches_total, update_rollout_transitions_total y
update_rollout_step_failures_total.
Qué más cambió
Limitaciones conocidas
- Tras la primera actualización, todos los pods pueden leer aún el inicio de sesión compartido. Esa es la ventana entre las dos actualizaciones; ejecuta la segunda sin demora.
- Dos permisos del bróker son más amplios por diseño:
event-sourcesconserva derechos de actualización sobre los almacenes MQTT propios del bróker, yuser-managementpuede purgar los datos de un tenant eliminado en todos los streams, salvo en los consumidores en los queevent-sourcesmantiene su durabilidad de mensajes confirmados. - Los comandos de un gateway no se enrutan, un aviso a un gateway es de mejor esfuerzo, y el agente guarda una copia acotada (8.192 eventos y 16 MiB) de lo que reenvió para contrastarla con un aviso.
- Los despliegues no tienen oleadas ni etapa canario, ni programación, ni alerta para el proceso que impulsa los despliegues si se detiene.
- El SBOM se genera a partir de la variante
amd64de cada imagen. - Con
mqttFailCloseddesactivado, que es el valor por defecto, se pueden perder mensajes QoS 1 que el bróker ya confirmó mientras el stream de captura MQTT cambia de líder, con cualquier carga, y nada los cuenta (JetStreamCaptureLeaderChangedavisa de que hubo un cambio). También se pueden perder sin ningún cambio de líder, con carga sostenida: en una prueba de carga en una instalación por defecto,event-sourcesse quedó atrás leyendo el stream de captura, el stream se llenó hasta su límite y descartó sus mensajes sin leer más antiguos, y se perdieron 1.357.188 eventos confirmados, entre el 7 y el 13 % del tráfico MQTT.devicechain_<area>_jetstream_consumer_unread_skipped_totallos cuenta yJetStreamDurableLostUnreadalerta. Aún se investiga por quéevent-sourcesse quedó atrás. Un reinicio progresivo del bróker reinicia todos los servidores, también el líder, y esta actualización reinicia el bróker dos veces, así que cuenta con una breve ventana de pérdida en cada reinicio del bróker salvo que fail-closed esté activado. En un ensayo de esta actualización con cuatro dispositivos que enviaban 20 mensajes QoS 1 por segundo entre todos, se perdieron 11 de 11 262 mensajes confirmados, todos durante los reinicios del bróker; en un ensayo anterior no se perdió ninguno. Para cerrar la ventana, activainfrastructure.nats.mqttFailClosed.dcctlno tiene una opción para ello en esta versión y--valuesno lo acepta, así que un valor puesto a mano en una instancia que gestionadcctllo sobrescribe el siguientedcctl upgrade; una versión posterior añade--mqtt-fail-closedadcctl bootstrapydcctl upgrade, que registra la elección en la instancia (consulta MQTT con fail-closed). La contrapartida: mientras el almacén de mensajes del bróker no tiene líder, una publicación QoS 1 no se confirma, así que el dispositivo debe volver a enviarla, y la instancia sostiene menos tráfico que con el ajuste desactivado. En un clúster de pruebas no perdió nada mientras daba abasto, a 6 000 y 9 000 eventos por segundo con cambios de líder repetidos; a 12 000 por segundo se quedó atrás, dos servidores del bróker se quedaron sin memoria y se perdieron mensajes confirmados. Dimensiona la instalación para mantenerte por debajo de su techo. Consulta MQTT con fail-closed. - Heredadas de la
v0.24.0: el relleno de una métrica calculada omite el historial comprimido, y una caída del bróker con una gran cola pendiente no está cubierta pormqttFailClosed.
También en esta versión
dcctl bootstrapydcctl upgradeaceptan--values, un archivo YAML de ajuste (número de réplicas, recursos, la configuración propia de un área) que se registra en la instancia y se vuelve a aplicar en cada actualización posterior. Una clave que poseedcctl, como una imagen, una credencial o un endpoint, se rechaza por su nombre antes de cambiar nada.--reset-valueslo elimina, y--dry-runimprime qué cambiaría. Consulta Ajustar una instancia.dcctl broker reconcile <instance>ydcctl broker permissionsson nuevos; consulta más arriba.- El registro de auditoría de una entidad se guarda en la misma transacción que el cambio. Antes se escribía después de que el cambio se confirmara, así que un fallo al escribir la auditoría le decía al llamante que el cambio había fallado aunque se había guardado, y lo dejaba sin registrar. Ahora se guardan ambos o ninguno, lo que significa que un fallo al escribir la auditoría hace fallar el cambio. Los eventos de inicio de sesión y de autenticación siguen siendo de mejor esfuerzo.
- La eliminación de un tenant muestra qué la retiene.
tenant_purge_store_blocked{store,reason}cuenta las eliminaciones abiertas por sistema de almacenamiento, junto contenant_purge_store_rows_erased_total,tenant_purge_store_erase_duration_seconds,tenant_purge_completed_total,tenant_purge_failures_total,tenant_purge_duration_secondsytenant_purge_clean_duration_seconds, y tres alertas. Consulta Eliminación de inquilinos. - La eliminación de un tenant es más rápida en dos puntos. El borrado de clave-valor ejecuta 32 purgas a la vez en lugar de una, y el borrado de objetos de S3 se hace por lotes, de hasta 1.000 claves por solicitud. En una prueba de loopback de un solo nodo, borrar 63.000 claves pasó de 28,9 s a 3,1 s. Un lote en el que cualquier clave no se llega a borrar hace fallar ahora la pasada, que se repite hasta que no queda nada.
- Un escritor sigue una elección de líder hasta ponerse al día. Un publicador que enruta al líder de un stream calculaba antes el nuevo líder una sola vez, y conservaba el destino antiguo si esa pasada fallaba. Ahora reintenta con una espera creciente, durante 30 segundos como máximo. Esto afecta solo al rendimiento.
- Paneles. Un panel puede mostrar una ventana fija, elegida con Custom range o abierta desde un enlace
?from=&to=, en lugar del intervalo móvil (consulta Intervalo personalizado). Un widget nuevo de tabla de historial lista el historial almacenado de un dispositivo como filas de promedios por intervalo, y un widget que tiene algo que entregar tiene un botón de descarga para CSV o PNG. Un widget sin nada que dibujar dice ahora cuál de cinco motivos es: ningún dispositivo elegido, no informado por este dispositivo, sin datos en este intervalo, sin acceso, o una fuente fallida./dash?rotate=tokA,tokB&every=60recorre de dos a 24 paneles en una pantalla de pared, de 10 a 3.600 segundos cada uno (consulta Rotar entre varios paneles). Todo ello es aditivo: un panel guardado se lee y se renderiza como antes. - Documentos de versionado y de seguridad. Política de versionado y actualización
dice qué es estable desde la
v1.0.0, y el modelo de seguridad describe los límites de confianza y qué hace cumplir cada uno. La sección de actualizaciones progresivas ya no afirma que no haya tiempo de inactividad. - Una comprobación de compatibilidad se ejecuta en cada cambio. Cada esquema GraphQL servido, los comandos
y las opciones de
dcctl, el contrato de cable de dispositivo, la disposición de topics de dispositivo, la API pública del SDK de C# y las exportaciones de los paquetes npm se comparan con la última versión, y una ruptura debe declararse. Frente a lav0.24.0no se declara ninguna ruptura en esta versión. - El reproductor de demostración del showcase Sitepulse fija un token propio en la credencial de cada dispositivo, porque ya no podía leer uno.
v0.24.0 — métricas calculadas que puedes crear tú mismo, y una ruta de eventos que transporta más
v0.24.0 es una actualización en su sitio desde v0.23.0: dcctl install para el clúster y después
dcctl upgrade para cada instancia, como se describe para la v0.17.0. Pasa a
dcctl install los ajustes con los que se instaló el clúster, como --ha y --database-node-selector,
además de la nueva --version. No se puede alcanzar en su sitio desde la v0.22.0 ni versiones
anteriores: actualiza primero a la v0.23.0. Sus cuatro migraciones añaden dos tablas y dos índices
y no reescriben ninguna fila existente (consulta Durante la actualización). Desde ella
se avanza, no se vuelve atrás: la v0.23.0 no puede arrancar con la configuración que escribe esta
versión (consulta Volver atrás). Si vienes de
la v0.22.0 o anterior, lee también las notas de la v0.23.0; se aplican a cualquier
actualización que cruce esa versión.
Los comandos, con la v en la versión y un ensayo primero:
dcctl install local --version v0.24.0
dcctl upgrade local devicechain --version v0.24.0 --dry-run
dcctl upgrade local devicechain --version v0.24.0
--version lleva la etiqueta con su v. En un clúster que no sea el local por defecto, pasa
--kube-context a dcctl install y a dcctl upgrade, y pasa --registry cuando las imágenes salgan de
un registro distinto del predeterminado. Si algún dispositivo MQTT sigue enviando una credencial en el
cuerpo de sus eventos, añade --mqtt-body-credential=strip al último comando: consulta
Antes de actualizar.
dcctl upgrade --dry-run no imprime el valor de --mqtt-body-credential, así que confirma que surtió efecto
tras la actualización (consulta el procedimiento en
Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT). Si la
instancia se inicializó sin custodia de la clave raíz, dcctl upgrade imprime una advertencia de custodia; es lo
esperado y no tiene relación con esta actualización.
Esta versión convierte las métricas calculadas en algo que creas y rellenas tú mismo: un editor de fórmulas con comprobación, constantes por dispositivo, fórmulas que leen otras métricas calculadas, vistas previas y un relleno que calcula una métrica para las lecturas almacenadas antes de que existiera. Lo demás trata de una ruta de eventos que transporta más: los eventos se escriben por defecto en una forma más pequeña, las detecciones se publican en paralelo y los cambios de alarma se aplican varios a la vez. También cierra dos sitios donde un secreto estaba al alcance de todos los servicios de la plataforma: la credencial de un dispositivo en el cuerpo de un evento MQTT y el estado de inicio de sesión. Qué cambia para alguien:
- Los dispositivos deben dejar de enviar una credencial en el cuerpo de un evento publicado por el
bróker MQTT de la plataforma. Ese evento se rechaza ahora. Para que una flota siga informando mientras
se actualiza su firmware, actualiza con
--mqtt-body-credential=strip. Consulta Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT. IDeviceEventCarrierdel SDK de C# tiene un miembro abstracto nuevo,CarriesBodyCredential; un portador propio deja de compilar hasta que lo declara. Consulta la misma sección.- Todos vuelven a iniciar sesión una vez, y el bróker se reinicia dos veces. El estado de inicio de sesión pasa a una cuenta propia del bróker y no se traslada, y el callout de autenticación de dispositivos se cifra. Consulta Los inicios de sesión del bróker se acotan.
- Actualiza pasando por la
v0.23.0. Los eventos se escriben ahora por defecto en la formacompact, que lav0.22.0y anteriores no pueden leer. Consulta El formato de los eventos en el cable. - El bróker pasa a NATS 2.15.1 en el primero de esos reinicios. Consulta El bróker pasa a NATS 2.15.
- No hay vuelta atrás a la
v0.23.0. Avanza: unhelm rollbackdeja servicios que no pueden arrancar. Consulta Volver atrás. - Cuatro migraciones: una tabla para los trabajos de relleno en
event-management, una tabla para el registro de activaciones de perfil y un índice endevice-management, y un índice encommand-delivery. Consulta Durante la actualización. devicees un nombre reservado en las fórmulas de métricas calculadas. Consulta Métricas calculadas.- Cambia el id de un valor calculado para una lectura JSON que no envía su propia hora. Consulta Métricas calculadas.
- Se rechaza una medición numérica que sea NaN, infinita o demasiado grande. Consulta Mediciones.
- Se mueven algunos valores por defecto: el motor de detección publica 32 detecciones a la vez,
device-managementaplica los cambios de alarma en varios carriles, el endpoint MCP limita el tamaño de un lote y a cada llamante, y el tipo de máquina del grupo de servicios del módulo de referencia de GKE es otro. Consulta Valores por defecto que cambiaron.
Antes de actualizar
- Si vienes de la
v0.22.0o anterior, detente y actualiza primero a lav0.23.0. Lav0.22.0y las anteriores leen solo la forma de cablelegacy. Un pod de una de ellas descarta un mensajecompact, o lo aparta como fallido endevice-management, así que una actualización progresiva directa a lav0.24.0pierde los eventos escritos mientras conviven pods viejos y nuevos. Actualiza cada instancia a lav0.23.0, espera a que todos los pods la ejecuten y después actualiza a lav0.24.0. En una instalación con el chart (no condcctl) puedes en cambio indicarinfrastructure.messaging.wireFormat: legacydurante la actualización y quitarlo cuando todos los pods se hayan renovado.dcctlno tiene ninguna opción para indicarlo. - Si algún dispositivo MQTT envía una credencial en el cuerpo de sus eventos, actualiza con
--mqtt-body-credential=strip. CondeviceAuthMode: requiredson todos los dispositivos MQTT, porque lav0.23.0rechaza un evento MQTT que no lleva credencial en el cuerpo. Por eso el firmware no se puede actualizar primero: un dispositivo actualizado antes de la actualización ve rechazados sus eventos hasta que esta termina. Ejecutadcctl upgrade local devicechain --version v0.24.0 --mqtt-body-credential=stripy sigue los pasos de Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT. No indiquesdeviceAuthMode: optionalpara salvar el intervalo. Hace que la instancia acepte un evento HTTP sin credencial, solo con el token del dispositivo. - Si un
terraform.tfvarsjunto al estado de infraestructura de la instancia fijanats_chart_version, súbelo a2.15.1o elimínalo. Un chart de NATS anterior a2.15.0se rechaza al elaborar el plan. - No cambies la replicación del bróker (
streamReplicas,nats_cluster_replicas) en la misma actualización. Mientras los servidores se reinician, unos ejecutan2.14.4y otros2.15.1, y un cambio de réplicas o de ubicación iniciado en ese intervalo puede quedarse atascado. Hazlo antes o después. Consulta El bróker pasa a NATS 2.15. - Si una fórmula publicada de una métrica calculada lee como identificador simple una métrica medida
cuya clave es
device, reescríbela comodouble(m["device"])(o la conversión de su tipo) antes de actualizar. Tras la actualización esa fórmula ya no compila y no produce valor en ninguna lectura. Las métricas calculadas están desactivadas hasta que elcalculatedMetricsPerProfilede un nivel supera 0, así que esto solo afecta a los niveles en los que ya lo hayas subido. - Si instalaste tú mismo el módulo
nats, manténjetstream.limits.default_max_consumersen-1. NATS 2.15, si no, limita cada stream a 1.000 consumidores, y la suscripción MQTT QoS 1 o 2 número 1.001 se rechaza mientras su dispositivo sigue conectado.
Durante la actualización
-
Se ejecutan cuatro migraciones, en el primer arranque del servicio al que pertenece cada una. Ninguna escribe ni reescribe filas, y cada una se puede volver a ejecutar si se interrumpe.
event-managementcrea la tablacalculated_backfillsy sus índices.device-managementcreadevice_profile_activations, el registro de qué versión de un perfil pasó a estar activa y cuándo (empieza vacío: no se reconstruye nada de las activaciones anteriores a la actualización), y un índice sobredevices (tenant_id, device_type_id)que atiende las pestañas por tipo de dispositivo de la tabla de alarmas.command-deliverycreaidx_commands_device_time, que atiende las marcas de los gráficos que muestran los comandos de un dispositivo en su eje de tiempo.
Cada índice se construye con un
CREATE INDEXsimple, que mantiene un bloqueo contra escrituras en la tabla mientras se ejecuta; en una tabla con millones de filas, arranca ese servicio en un momento tranquilo. -
El bróker se reinicia, y en la primera actualización que añade el callout cifrado se reinicia dos veces. El primer reinicio lleva el paso a NATS 2.15.1 y la nueva cuenta de inicio de sesión; el segundo activa el cifrado del callout cuando los servicios ya se han renovado a un respondedor que puede leerlo (una instancia sin callout de autenticación de dispositivos no tiene nada que cifrar y se reinicia una vez). Con
--ha, de un servidor en otro, cada uno Ready antes de que se detenga el siguiente; sin--hael único servidor se reinicia y el bróker no está disponible durante aproximadamente un minuto cada vez. Consulta Los inicios de sesión del bróker se acotan. Los dispositivos se vuelven a conectar solos, y una sesión MQTT persistente conserva sus suscripciones y los mensajes QoS 1 retenidos para ella. Los dispositivos se vuelven a conectar sin perder mensajes solo con--ha. Enkindcon--ha(dos reinicios progresivos del bróker), la actualización tardó de 4 a 5 minutos en total: unos 90 segundos el primero, unos 40 segundos sin actividad y unos 80 segundos el segundo. No reinicies a mano un servidor del bróker mientras avanza. Consulta El bróker pasa a NATS 2.15. -
Los servicios empiezan a escribir eventos
compacta medida que se renuevan. Los pods de lav0.23.0leen ambas formas, así que una actualización progresiva entre las dos versiones es segura. -
Revocar la autoridad de un dispositivo durante la renovación puede fallar, o dejar una sesión abierta. Deshabilitar o eliminar un dispositivo, o cambiar una credencial, termina ahora también las sesiones MQTT abiertas del dispositivo pidiéndoselo a
event-sources, y solo responde un pod deevent-sourcesde esta versión. Mientras no haya ninguno en marcha, el cambio se guarda y la llamada devuelve un error («the change was saved, but the device's live broker sessions could not be confirmed ended ... repeat the operation»). Un cambio que atiende un pod dedevice-managementde la versión anterior se guarda y no termina ninguna sesión, como antes de la actualización. Repite esos cambios cuando termine la renovación; repetirlos es seguro y vuelve a preguntar. -
Un pod de la versión anterior que se reinicia durante la renovación no vuelve. Antes de que se muevan los servicios,
dcctlescribe la configuración de la instancia para esta versión, y lav0.23.0la rechaza al arrancar (consulta Volver atrás). Un pod de lav0.23.0desalojado, terminado por falta de memoria o que pierde su nodo en ese intervalo sigue caído hasta que la nueva versión lo sustituye, así que deja que la actualización termine en lugar de reiniciar pods a mano. -
Un inicio de sesión o una renovación de token que llegue a un pod de
user-managementde la versión anterior puede fallar durante unos segundos mientras se traslada el estado de inicio de sesión. Sale bien al reintentarlo. -
Un valor derivado almacenado por un pod de la versión anterior y otro almacenado por un pod de la nueva pueden llevar ids distintos para una lectura cuyo instante tiene dígitos por debajo del microsegundo. Consulta Métricas calculadas.
Volver atrás
Avanza. No vuelvas a la v0.23.0, ni con helm rollback ni de ninguna otra forma. Si la
actualización falla a medias, corrige la causa y vuelve a ejecutar dcctl upgrade con la misma
--version. Volver atrás deja una instancia que no funciona:
- Los servicios de la
v0.23.0no pueden arrancar.dcctlescribe la configuración de la instancia en el Secretdci-<instance>-config, fuera de la release del chart, así quehelm rollbackrestaura las cargas de trabajo de la release anterior y deja la configuración tal como la escribió esta versión. Esa configuración lleva claves que lav0.23.0no conoce, comoidentityAccount,calloutIssuerPublicycalloutXKeyPublic, y lav0.23.0rechaza al arrancar cualquier clave de su configuración que no conozca. Todos los servicios que arranca fallan, y la semilla de firma del callout ya ni siquiera está en esa configuración. - Los dispositivos no pueden conectarse. El bróker no forma parte de la release del chart, así que
sigue en NATS 2.15 y sigue cifrando su callout de autenticación de dispositivos. Las semillas del
callout están en un Secret que la
v0.23.0no lee, así que no hay ningún respondedor que pueda atender las peticiones del bróker, y todos los dispositivos se rechazan. - El bróker tampoco puede volver atrás. NATS solo admite volver de 2.15 a 2.14.7 o posterior, y la versión anterior ejecuta 2.14.4.
- No se restaura el estado de inicio de sesión. Los buckets de inicio de sesión de la versión anterior se eliminaron, así que todos tendrían que volver a iniciar sesión.
Las tablas y los índices nuevos no estorbarían: la v0.23.0 lee la misma base de datos y los deja sin
usar. Volver a la v0.22.0 o anterior exige indicar antes legacy y que se hayan vaciado de los
streams todos los mensajes compact (consulta El formato de los eventos en el cable).
Después de la actualización
- No hace falta nada. Todos los ajustes nuevos tienen un valor por defecto.
- El paso del bróker es irreversible. NATS solo admite volver de 2.15 a 2.14.7 o posterior, y la versión anterior ejecuta 2.14.4.
- Mantén
metrics.enabledymetrics.alertsactivados (lo están por defecto) para instalar la nueva alertaMqttGatewayStreamUnbounded. - Localiza los dispositivos que aún envían una credencial en el cuerpo.
devicechain_eventsources_total_msg_credential_in_mqtt_bodycuenta los eventos rechazados por origen y, constrip, los que se eliminaron. Actualiza el firmware o el SDK de cada uno y rota la credencial de todo dispositivo que se haya contado (consulta la sección siguiente).
Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT
Un dispositivo en el bróker MQTT de la plataforma se autentica al conectarse, mediante el callout de autenticación de dispositivos. El contrato publicado hacía además que repitiera su credencial en el cuerpo de cada evento, y el bróker escribía ese cuerpo en sus propios streams antes de que se ejecutara ningún código de la plataforma, de modo que una contraseña o un token de acceso en texto claro quedaba en un stream legible por todos los servicios de la plataforma, por cualquiera con acceso al volumen y por sus instantáneas. Ahora la credencial en el cuerpo se rechaza:
-
Se rechaza un evento publicado por el bróker MQTT de la plataforma cuyo cuerpo lleve
credentialType,credentialIdocredentialSecret, salvo que hayas indicadocapture.bodyCredential: strippara la actualización (más abajo). Se cuenta endevicechain_eventsources_total_msg_credential_in_mqtt_body, se aparta en el stream failed-decode con la credencial censurada y no se reenvía nunca. El bróker ya ha confirmado el mensaje, así que el rechazo lo ves tú y no el dispositivo: un dispositivo que sigue enviando el cuerpo antiguo se queda en silencio mientras cree que publica. -
Se acepta un evento sin credencial y se atribuye al dispositivo que se conectó. Con
deviceAuthMode: requiredse acepta para todos los tipos de evento. -
La ingesta HTTP y un bróker MQTT que conectas como origen no cambian. Siguen exigiendo la credencial en el cuerpo.
-
Trata como expuesto a un dispositivo que fue rechazado. El texto claro existió en el bróker durante los instantes previos a la confirmación del mensaje, en el almacén del gateway MQTT mientras había una suscripción interesada y en bloques de archivo sin recuperar hasta la compactación. Rota la credencial de todo dispositivo que se haya contado.
-
Actualiza con
strip, actualiza los SDK y el firmware y pasa después arefuse. Lav0.23.0rechaza un evento MQTT que no lleva credencial en el cuerpo, y esta versión rechaza uno que sí la lleva, así que una flota no puede actualizar su firmware antes de la actualización. El puente escapture.bodyCredential: strip, que acepta un evento del bróker MQTT de la plataforma con la credencial eliminada. En este orden:- Actualiza con
dcctl upgrade local devicechain --version v0.24.0 --mqtt-body-credential=strip. Los eventos siguen fluyendo y se cuenta cada uno que llevaba una credencial. El--dry-rundel comando no imprime el valor de este indicador; para confirmar que la actualización lo tomó, busca la advertencia de arranque deevent-sourcesque dice que el ajuste es transitorio, o comprueba quedevicechain_eventsources_capture_body_credential_stripvale1. En una instalación con el chart (no condcctl), indica en su lugarfunctionalAreas.event-sources.config.capture.bodyCredential: strip. - Despliega el SDK o el firmware que deja de enviar la credencial en el cuerpo.
- Vigila
devicechain_eventsources_total_msg_credential_in_mqtt_bodyhasta que deje de subir durante más tiempo que el intervalo de envío de tu dispositivo más lento. Recopila la lista de dispositivos sobre la marcha. Una advertencia en el registro deevent-sourcesindica el inquilino y el dispositivo de cada uno que sigue enviando una credencial (una vez por hora para cada dispositivo, en cada pod deevent-sources); copia esas parejas inquilino-dispositivo del registro durante esta fase, porque es el único lugar donde se nombran. - Ejecuta
dcctl upgrade local devicechain --version v0.24.0 --mqtt-body-credential=refuse. A partir de aquí el registro deevent-sourcesno nombra ningún dispositivo y la métrica no tiene etiqueta de dispositivo. El único registro por dispositivo que queda es el stream de decodificaciones fallidas, que conserva el nombre del dispositivo con la credencial censurada. - Rota la credencial de todo dispositivo de la lista que recopilaste en el paso 3 (y de los que el stream de decodificaciones fallidas nombre después del paso 4).
stripno elimina la exposición: el bróker guardó el cuerpo antes de que se aplicara cualquiera de los dos ajustes, así questripyrefusedejan el mismo texto claro en reposo, y el paso 5 hace falta con ambos.stripse aplica solo al bróker MQTT de la plataforma. Undcctl upgradeposterior sin la opción conserva el valor.stripera transitorio y se elimina en lav0.26.0: desde esa versión una credencial en el cuerpo se rechaza siempre, la opción--mqtt-body-credentialya no existe yevent-sourcesno arranca mientras siga indicadocapture.bodyCredential. Elimina la clave antes de actualizar a lav0.26.0.Mientras la actualización se despliega, un pod de
event-sourcesde esta versión puede quitar la credencial de un evento antes de quedevice-managementse haya actualizado. Undevice-managementde lav0.23.0rechaza ese evento, porque ya no lleva credencial, y lo deja para que se entregue de nuevo un minuto después, hasta cinco entregas en total; undevice-managementde esta versión lo acepta. Así que no se pierde nada sidevice-managementtermina de actualizarse en unos cuatro minutos desde el primer pod nuevo deevent-sources, como ocurre en una actualización normal. Un evento que siga rechazado en su quinta entrega queda apartado en el flujo de eventos fallidos como no autenticado, sin la credencial. - Actualiza con
-
Qué cambiar en un dispositivo. El SDK de C# (y el paquete de Unity, que se apoya en él) deja de enviar la credencial por MQTT en esta versión, y la sigue enviando por HTTP. El JSON Schema del sobre marca ahora los tres miembros como solo HTTP. Un
IDeviceEventCarrierpropio debe declarar el nuevo miembroCarriesBodyCredential(truepara un portador que va por HTTP,falsepara el MQTT de la plataforma); es un error de compilación, a propósito, en lugar de un valor por defecto. El firmware que escribe el cuerpo a mano debe quitar los tres miembros. El agente de borde reenvía los cuerpos sin cambios, y su enlace ascendente a un bróker de la plataforma que autentica dispositivos no es compatible en esta versión. -
Una sesión ya no sobrevive a su credencial. El token de la conexión caduca ahora con la credencial (lo que ocurra antes entre 12 horas y la caducidad de la propia credencial), y revocar una credencial, rotar su secreto, deshabilitar o eliminar un dispositivo o sustituirlo termina las sesiones MQTT abiertas del dispositivo. El dispositivo se vuelve a conectar y se autentica de nuevo con la credencial que presenta, que la base de datos rechaza si se revocó. Terminan todas las sesiones del dispositivo, así que revocar una de dos credenciales corta un momento la sesión de la otra. Si la plataforma no puede confirmar que las sesiones terminaron, el cambio se guarda igualmente y la llamada devuelve un error que lo indica; repítela.
-
Rota los tokens de los dispositivos de token de acceso cuyos mensajes se rechazaron o pasaron a mensajes fallidos. Los registros de failed-decode y de dead-letter conservaban el
credentialIdde un token de acceso, que en ese tipo de credencial es el propio token (en MQTT_BASIC es el nombre de inicio de sesión). Ahora se censuran, pero nada reescribe un registro escrito por una versión anterior: esos streams caducan a los 7 días, la tabla de dead-letters la limpia su barrido de retención y una copia de seguridad de la base de datos los conserva hasta que caduca. -
event-sourcesnecesita el inicio de sesión de la cuenta de sistema del bróker para arrancar siempre que el bróker ejecute el callout de autenticación de dispositivos (dcctl bootstraplo crea), y ese inicio de sesión queda limitado a listar y terminar conexiones.dcctl upgraderechaza una instancia que tiene el callout y no tiene inicio de sesión de sistema, en lugar de dejar aevent-sourcesen un bucle de fallos. -
El inicio de sesión de servicio compartido ya no puede publicar en el subject de eventos de un dispositivo. Quien lo tuviera podía antes falsificar un evento de cualquier dispositivo con una sola publicación. No es una frontera frente a quien posee el inicio de sesión, que sigue administrando los streams de los servicios.
Consulta Conexión de un dispositivo, Credenciales de dispositivo y el referencia del protocolo de dispositivo.
Los inicios de sesión del bróker se acotan
Dos secretos que estaban al alcance de todos los servicios están ahora al alcance de uno solo. El mecanismo y los reinicios se describen en Qué aplica una actualización a la infraestructura; qué cambia para alguien:
- El callout de autenticación de dispositivos se cifra. La contraseña de un dispositivo cruzaba el
bróker en claro hacia cualquier servicio que escuchara.
dcctl upgradecrea el Secretdci-<instance>-callout(la semilla de firma y una nueva semilla de cifrado), montado solo endevice-management. La configuración de la instancia conserva las mitades públicas. Una instalación solo con el chart debe crear ese Secret por su cuenta. - El estado de inicio de sesión pasa a una cuenta propia del bróker, y todos vuelven a iniciar sesión
una vez. Los tokens de actualización, los códigos de autorización OAuth, los registros de inicio de
sesión único y el limitador de inicios de sesión pasan a una cuenta
IDENTITYa la que solo puede entraruser-management, con la contraseña en el Secretdci-<instance>-identity. Las copias de la versión anterior se eliminan, no se trasladan, así que termina toda sesión anterior a la actualización: la gente inicia sesión de nuevo en la consola y en los paneles, y los clientes MCP y OAuth vuelven a autorizar. Un token de acceso ya emitido funciona hasta que caduca, 15 minutos por defecto. Una instalación solo con el chart debe añadir la cuenta a su propio bróker, o no cambia nada. - El bróker se reinicia dos veces en la primera actualización que hace ambas cosas, como se describe
más arriba. Los dispositivos se vuelven a conectar en segundos con
--hay en aproximadamente un minuto sin él. Si falla el segundo paso, los dispositivos siguen conectándose; ejecutadcctl upgradeotra vez para terminarlo. - La semilla de firma se traslada, no se sustituye. La semilla de firma del callout estaba en la
configuración de la instancia, y
dcctl upgradelleva esa misma semilla al nuevo Secret.dcctlmantiene la configuración fuera de los valores de Helm, así que su historial de releases no guarda ninguna copia. Una instalación con el chart que pasa la configuración en línea sigue teniendo la semilla en las releases de Helm guardadas antes de la actualización; elimina esos Secrets de release si eso te importa. - Una instancia restaurada recibe un inicio de sesión nuevo para el estado de inicio de sesión, y ese estado no se restaura desde una copia de seguridad.
- En el clúster, esos Secrets son la única copia de las semillas. La máquina que ejecutó
dcctl bootstraptambién las guarda en~/.devicechain/instances/<instance>/. No hay verbo de rotación, y editar cualquiera de los dos Secrets fuera dedcctlno está admitido. Quien pueda leer Secrets en el espacio de nombres de la instancia puede seguir leyéndolos.
El bróker pasa a NATS 2.15
El bróker de mensajería de la instancia pasa de NATS 2.14.4 a 2.15.1 (el chart oficial nats,
misma versión). dcctl upgrade lo aplica en su primera aplicación del bróker, la que también añade la
cuenta de inicio de sesión, así que el paso no cuesta un reinicio propio: con --ha sus servidores se
reinician de uno en uno, cada uno Ready antes de que se detenga el siguiente; sin --ha el único
servidor se reinicia y el bróker no está disponible durante aproximadamente un minuto. El segundo
reinicio, que activa el cifrado del callout, llega después de los servicios (consulta
Durante la actualización). Los
dispositivos se vuelven a conectar solos, y una sesión MQTT persistente conserva sus suscripciones y
los mensajes QoS 1 retenidos para ella mientras el dispositivo no estaba.
- No cambies la replicación del bróker en la misma actualización. Mientras los servidores se
reinician, unos ejecutan
2.14.4y otros2.15.1. NATS 2.15 cambió la forma en que un stream o un consumidor cambia su número de réplicas o su ubicación, y solo NATS2.14.7y posteriores entienden el nuevo mecanismo. Esta actualización parte de2.14.4, así que un cambio de réplicas o de ubicación iniciado mientras algún servidor todavía lo ejecuta puede quedarse atascado, no solo retrasado. Los streams se pueden leer y escribir durante todo el proceso, y crearlos o eliminarlos no se ve afectado. SubestreamReplicasonats_cluster_replicasantes o después de esta actualización, no durante. - No reinicies a mano un servidor del bróker mientras avanza la actualización. La nueva
configuración llega a todos los servidores a la vez, pero cada servidor pasa a
2.15.1solo cuando le toca. Hasta entonces sigue funcionando con la configuración con la que arrancó, y si se reinicia en ese intervalo (a mano, o porque falla su nodo) no puede arrancar con la nueva configuración y queda caído hasta que la actualización lo reemplaza. Con--haeso deja al clúster con un servidor menos durante el resto del proceso, y los streams replicados dejan de aceptar escrituras mientras el siguiente servidor se reinicia. - Se rechaza un chart de NATS anterior a
2.15.0. La configuración del bróker está escrita ahora para NATS 2.15 y un servidor 2.14 la rechaza al arrancar, así que unnats_chart_versioninferior a2.15.0hace fallar el plan en lugar de dejar el bróker en un bucle de reinicios. Si unterraform.tfvarsjunto al estado de infraestructura de la instancia fijanats_chart_version, súbelo a2.15.1o elimínalo antes de actualizar. Considera el paso a 2.15 como irreversible: NATS solo admite volver de 2.15 a 2.14.7 o posterior, y la versión anterior ejecuta 2.14.4. - Se levanta el límite de 1.000 consumidores que NATS 2.15 añade a cada stream. Cada
suscripción MQTT con QoS 1 o 2 es un consumidor en el stream de mensajes propio del bróker, así que
con el nuevo valor por defecto se rechazaría la suscripción número 1.001 de ese tipo en toda la
flota mientras su dispositivo seguía conectado, y ese dispositivo nunca recibiría un comando. Se
cuentan suscripciones, no dispositivos: un dispositivo con dos suscripciones QoS 1 usa dos. Si
instalas tú mismo el módulo
nats, manténjetstream.limits.default_max_consumersen-1.
Qué mejora:
- Las publicaciones QoS 1 de una misma conexión MQTT ya no se esperan unas a otras. El bróker almacena ahora hasta 1.024 mensajes QoS 1 de una conexión a la vez, en lugar de uno en uno. En un clúster de prueba de tres servidores, una conexión que enviaba 5.000 mensajes pasó de unos 1.100 a unos 20.000 confirmados por segundo.
- Recargar la configuración del bróker ya no detiene la entrega QoS 1 y 2 a los dispositivos ya conectados. Con TLS en el listener MQTT, que es el valor por defecto, cada recarga volvía a aplicar los ajustes MQTT y dejaba cada sesión conectada sin poder recibir mensajes QoS 1 o 2, comandos incluidos, hasta que se reconectaba. Una renovación de certificado podía provocar una.
- Correcciones en el inicio de sesión de dispositivos y los permisos, entre ellas cómo decide el bróker qué inicios de sesión omiten la comprobación de dispositivo, y un rechazo de inicio de sesión que ahora se informa como error de autenticación.
- El bróker local del agente de borde ya no rechaza la suscripción QoS 1 o 2 número 1.001 de un
sitio.
dc-edge-agentintegra NATS 2.15, y desdev0.20.0hastav0.23.0su listener MQTT local tenía el mismo límite de 1.000 consumidores: respondía a la suscripción QoS 1 o 2 número 1.001 de un sitio con un rechazo mientras el dispositivo seguía conectado. El límite se levanta también allí. Actualice el agente en cualquier sitio cuyos dispositivos mantengan entre todos más de 1.000 suscripciones de ese tipo en su listener.
Métricas calculadas
Las métricas calculadas siguen desactivadas hasta que el calculatedMetricsPerProfile de un nivel supera
0 (se introdujo en la v0.23.0). Novedades de esta versión, allí donde estén activadas:
- Creación desde la consola. La pestaña Métricas del perfil de dispositivo tiene un selector Tipo (Medida o Calculada) y un editor de Fórmula con comprobación. El borrador se compila con el mismo compilador que usan la puerta de publicación y el resolvedor, y muestra su coste frente al techo de 100. La guía de usuario le dedica un capítulo.
- Constantes numéricas por dispositivo.
device.calibrationodevice["ct-ratio"]leen un número de los metadatos del dispositivo. Solo cuenta un número JSON; una cadena, un booleano, null, un objeto o una lista está presente pero no es utilizable y nunca se convierte.devicees ahora un nombre reservado: una métrica medida con la clavedevicese lee comom["device"], con su conversión de tipo. Una fórmula publicada que leía esa métrica como identificador simple ya no compila: no produce valor en ninguna lectura, se cuenta comoeval_errorendevicechain_devicemanagement_calcmetric_skipped_totaly se informa en el registro dedevice-management. Un valor que el dispositivo envíe bajo la clave de esa métrica calculada se sigue descartando. - Encadenamiento. Una fórmula puede leer otra métrica calculada, hasta cuatro niveles. Un anillo
(
a -> b -> a) o una cadena de más de cuatro se rechaza al publicar, indicando la cadena. - Vistas previas.
previewRuleacepta las métricas del perfil en borrador y vuelve a derivar los valores calculados con ese borrador, y un panel Pruébalo con el historial reciente de la consola evalúa una fórmula en borrador sobre las lecturas almacenadas de un dispositivo. - Relleno. Un trabajo que calcula una métrica calculada para las lecturas almacenadas antes de que se publicara su versión y escribe los valores que faltan. Consulta Relleno del historial.
- Las métricas de dispositivos Sparkplug y LwM2M ahora se calculan. Un dispositivo que envía una
métrica por entrada (Sparkplug, LwM2M o un lote JSON) omitía toda fórmula de varias entradas como
missing_input, porque cada entrada era una lectura por separado. Ahora una lectura es cada medición de un mismo mensaje que lleva exactamente el mismo instante, de modo quepower = voltage * currentse calcula cuando ambas comparten instante. Sparkplug y LwM2M sellan al milisegundo, así que un nodo que sella cada métrica por separado (valores con unos milisegundos de diferencia), o que solo informa de lo que cambió, sigue sin obtener valor en una fórmula de varias entradas. Si una métrica aparece dos veces en un instante, la fórmula lee la primera. Las lecturas LwM2M de un mismo paquete SenML comparten ahora un único instante de recepción. La guía de usuario describe cómo se forma una lectura. - Dos muestras calculadas del mismo nombre en el mismo instante conservan una sola fila almacenada, la primera escrita.
- El id de un valor derivado sigue ahora a su instante en UTC con precisión de microsegundo. Las lecturas cuyo instante es exacto al microsegundo (todas las de Sparkplug y LwM2M, y las lecturas JSON que envían su propia hora con hasta seis decimales) conservan los mismos ids. Una lectura con dígitos por debajo del microsegundo recibe un id derivado nuevo, lo que incluye toda lectura JSON que no envía su propia hora, porque la plataforma le pone la hora de recepción con nanosegundos. Si esa misma lectura se almacena de nuevo tras la actualización, porque el almacenamiento de eventos la recibió de nuevo (aún no estaba confirmada cuando los pods se renovaron) o el dispositivo reenvió una lectura anterior, su valor derivado se almacena como una segunda fila. Las filas sin procesar no se ven afectadas y las filas antiguas no se reescriben.
- Un mensaje que no lleva ninguna de las entradas de una fórmula deja de contarse como omisión. Una
fórmula de batería registraba una omisión
missing_inputpor cada mensaje de temperatura de un dispositivo que envía ambas magnitudes en mensajes separados (unas 3.600 por hora con un mensaje por segundo). Ese mensaje simplemente ya no se evalúa, y un mensaje que lleva algunas de las entradas pero no todas sigue contando comomissing_input. Tras la actualización,devicechain_devicemanagement_calcmetric_skipped_totalconmissing_inputy las líneas de registro correspondientes bajan, así que un panel o una alerta basados en ello leerán menos. No cambia ningún valor almacenado. - Las fórmulas que leen una constante de dispositivo ahora se calculan con lecturas en vivo de
dispositivos que se autentican con una credencial (inicio de sesión MQTT o token de acceso, por
cualquier transporte). Se omitían como
missing_inputen cada una de esas lecturas, mientras que la vista previa de la consola, que toma las constantes de la petición, funcionaba. Una constante que edites llega a la siguiente lectura. - En la consola, la pestaña Versiones del perfil muestra, para la versión activa, si cada métrica
calculada está calculándose, no se está calculando o no tiene lecturas de entrada, en las últimas 24
horas o 7 días, contado a partir de las lecturas almacenadas; el relleno se deshabilita de antemano, con
el motivo, cuando la instancia no puede ejecutarlo (
calculatedMetricBackfillAvailability); ycalculatedMetricPlanmarca una métrica cuyo nombre también usa la versión activa de otro perfil (nameSharedWithOtherProfiles). - Un perfil de dispositivo registra qué versión pasó a estar activa y cuándo.
DeviceProfile.activationslista las publicaciones y los retrocesos, de la más reciente a la más antigua. El registro empieza en la actualización; un perfil publicado antes no tiene entrada hasta su próxima publicación o retroceso, y una entrada ausente significa desconocido, no inactivo.
Relleno del historial
Un relleno añade una métrica calculada al historial almacenado antes de que se publicara la versión que la define, de modo que los gráficos y las exportaciones del pasado también la muestren. Está disponible allí donde hay métricas calculadas y no necesita nada para activarse salvo una versión publicada de un perfil que tenga una métrica calculada.
- Iniciar y cancelar un relleno exige
device:write; leer y listar los trabajos exigeevent:read. Un llamante limitado a clientes es rechazado por las cuatro operaciones. La consola lo inicia desde la pestaña Versiones del perfil y lo ofrece una vez cuando publicas una versión que añade una métrica calculada. - Un trabajo tiene límites. Como máximo 90 días por trabajo, que terminen como muy tarde ahora, sobre una versión publicada de un perfil, para hasta 1.000 dispositivos nombrados o todos los del perfil. Un intervalo más antiguo de lo que permite la retención se rechaza en lugar de acortarse. Hay un trabajo activo (en cola o en ejecución) por tenant.
- Solo añade valores y es silencioso. Un valor almacenado nunca cambia. Un valor rellenado aparece en paneles, historial y exportaciones; no cambia los últimos valores de un dispositivo y las reglas de detección nunca lo ven.
- Una lectura que contiene una misma entrada dos veces con valores distintos se omite como
ambiguous, mientras que el cálculo en vivo lee la primera. El trabajo cuenta cada omisión por motivo. - El historial comprimido se omite en esta versión (el almacén de eventos comprime por defecto los fragmentos de más de 7 días), y el trabajo cuenta lo que omitió.
- Un trabajador por instancia ejecuta los trabajos, a un ritmo acotado.
calculatedBackfill.enableden la configuración deevent-managementtiene tres estados. Sin definir, el valor por defecto, el trabajador se ejecuta cuando el pool de conexiones tiene sitio para él junto a los escritores de persistencia y se queda apagado, con un aviso al arrancar que nombra los ajustes, cuando no lo tiene, de modo que una instancia afinada antes de esta versión arranca como lo hacía.truedetiene el servicio al arrancar si el pool no puede alojar al trabajador.falseapaga el trabajador, y entonces iniciar un relleno se rechaza como no disponible, con el motivo.calculatedBackfill.rowsPerSecondes 20000 por defecto, de 1 a 200000, y ese valor es provisional. Consulta Relleno de métricas calculadas, que también lista las métricas y el SQL que cancela un trabajo atascado, y Rellenar el historial en la guía de usuario.
Mediciones: se rechazan NaN, infinito y valores enormes
Una medición numérica que sea NaN, infinita o de 1.000.000.000.000 o más en magnitud se rechaza ahora al resolver el evento.
- Para una métrica declarada en el perfil, se rechaza todo el evento como no válido. Antes, un valor de 1e12 o más ya se perdía del historial (la columna lo rechazaba); ahora además se mantiene fuera del estado en vivo y de la evaluación de reglas, y NaN ya no se cuela por los valores Mín. y Máx. de una métrica.
- Para una clave no declarada, solo se descarta ese valor, con un aviso en el registro de
device-management. Antes, fallaba el almacenamiento de todo el evento. - Un valor NaN o infinito ya no hace que el almacenamiento de eventos reintente el mensaje durante unos cinco minutos (cinco entregas) y lo informe después como un fallo de un componente posterior.
Valores por defecto que cambiaron
| Ajuste | Antes | Ahora | Restaurar el comportamiento anterior |
|---|---|---|---|
infrastructure.messaging.wireFormat | legacy | compact | legacy (solo en instalación con el chart; consulta Antes de actualizar) |
event-processing derivedPublishing.maxInFlight (nuevo) | una detección cada vez | 32 | Indica 1. Sigue habiendo como máximo una detección pendiente por dispositivo, así que las detecciones de cada dispositivo llegan en orden. Volver a publicar sin duplicados se mantiene dentro de la ventana de duplicados de 30 minutos del stream de eventos derivados. |
device-management raiseAlarm.workers (nuevo, fijo, se lee al arrancar) | un cambio cada vez | max(1, min(8, pool - resolution.workers - 4)), es decir, 6 con el pool por defecto de 20 | Indica 1 para la ruta en línea anterior. Los cambios de una misma alarma se aplican siempre en orden. Un valor explícito se valida contra el pool de conexiones y nunca se ajusta. |
mcp maxBatchEntries, callsPerSecond, callsBurst (en functionalAreas.mcp.config) | sin límite | 16, 20 y 40 | Súbelos; callsBurst no puede ser menor que maxBatchEntries. |
event-sources capture.bodyCredential (nuevo, fijo, en functionalAreas.event-sources.config) | ninguno: se aceptaba una credencial en el cuerpo en el bróker MQTT de la plataforma | refuse | Eliminado en la v0.26.0: una credencial en el cuerpo se rechaza siempre. Consulta Los dispositivos deben dejar de enviar la credencial en el cuerpo por MQTT. |
services_machine_type del módulo de referencia de GKE (deploy/gke) | n2-custom-4-8192 | t2d-standard-4 | Indícalo explícitamente. Cambiar el tipo de máquina de un grupo existente recrea sus nodos. |
- Detección: las detecciones de distintos dispositivos se publican en paralelo, hasta 32 a la vez, en
lugar de esperar cada confirmación. En un clúster de pruebas de GKE con una carga de disparos intensa de unas
2.500 detecciones por segundo ofrecidas, una ventana de 32 publicó 2.441 detecciones por segundo frente a
528 con una ventana de 1, y el retraso de la marca de agua fue de 5,1 s en lugar de 139 s. El
presupuesto de bytes
derivedPublishing.maxBufferedBytescuenta ahora todas las cargas preparadas que aún no se han confirmado. Consulta la página del motor de detección. - Alarmas:
device-managementaplicaba cada cambio de raise-alarm en su bucle de lectura, unos cien por segundo en una base de datos local, por inactivo que estuviera el servicio. Ahora los aplica enraiseAlarm.workerscarriles, y los cambios de una alarma van al mismo carril. En una prueba local con 8 carriles fueron entre cuatro y siete veces más. El valor por defecto deja libres cuatro conexiones del pool junto a los resolvedores; ambos grupos comparten el pool de conexiones, así que dimensiónalos juntos. Consulta Qué tan rápido se aplican las alarmas. - MCP: un lote que supera el tope se rechaza entero (HTTP 400, petición no válida de JSON-RPC, no se
ejecuta nada), y un llamante que supera la tasa recibe HTTP 429 con
Retry-After. Un lote de N cuenta como N mensajes, y el llamante es el sujeto del token verificado (tenant y correo). Consulta los límites del servidor MCP. - GKE: en una instalación HA 3+3, los nodos de servicios T2D persistieron un 18 % más de eventos por
segundo (unos 17.200 frente a 14.500 y 14.700, con 18.000 ofrecidos por HTTP), y el p99 de la
confirmación MQTT QoS 1 a 9.000 eventos por segundo fue de 38 ms frente a 578 y 171 ms. La alternativa
n2d-custom-4-8192equivale a la forma N2 dentro del ruido y es aproximadamente un 13 % más barata por nodo.T2D_CPUSes una cuota propia, y no todas las zonas ofrecen T2D (us-east4-a,-by-csí). El grupo de bases de datos sigue siendon2-standard-4.
Confirmación MQTT con fallo cerrado
infrastructure.nats.mqttFailClosed lo acepta ahora la configuración (la v0.23.0 lo rechazaba) y
sigue desactivado por defecto: nada cambia a menos que lo actives. Con él activado, un PUBACK QoS 1
significa que la plataforma tiene el mensaje. El almacén de mensajes MQTT del propio bróker ($MQTT_msgs)
se declara acotado y con descarte de lo nuevo, de modo que un almacén lleno rechaza una publicación QoS 1
(el dispositivo no recibe PUBACK y la reenvía) en lugar de descartar una que ya había confirmado.
event-sources reenvía desde el almacén, y el almacén se traspasa entre pods de forma segura durante una
actualización progresiva. Un almacén casi lleno aparta a los dispositivos: device-management rechaza las
conexiones MQTT nuevas en cuanto llega al 80 % y hasta que baja del 60 %, lo que un dispositivo
ve como CONNACK con código 5 (no autorizado), así que el firmware debe seguir reintentando ante él. El
ajuste se rechaza en un bróker que sirve también a otra instancia.
Límites, descritos en las páginas de observabilidad y de la
matriz de transportes: QoS 0 nunca se almacena; un fallo del bróker con
una acumulación grande no está cubierto; los PUBACK son más lentos con él activado (p99 de 336 ms a 6.000
eventos por segundo en una prueba, frente a 35 ms con él desactivado); y el margen de memoria cerca de
10.000 eventos por segundo es escaso en ambos modos, así que sube nats_memory_limit si un servidor se
detiene por falta de memoria.
Los streams del gateway MQTT quedan acotados en una instalación nueva
En una instalación nueva de la v0.22.0 o la v0.23.0, los streams $MQTT_msgs, $MQTT_out y
$MQTT_qos2in del gateway MQTT los creaba el bróker sin límite de tamaño cuando se conectaba el primer
dispositivo MQTT, y seguían sin límite hasta que event-sources se reiniciaba. Un $MQTT_msgs sin límite
puede llenar el volumen del bróker. Ahora cada pod de event-sources comprueba estos streams cada 30
segundos y fija el techo, así que en una instancia existente en ejecución quedan acotados en cuanto
arrancan los pods nuevos. Una alerta nueva, MqttGatewayStreamUnbounded (aviso, 10 minutos), se dispara
cuando no se pudo fijar el techo, normalmente porque el bróker no tiene almacenamiento libre para
reservarlo. Métricas nuevas: devicechain_eventsources_mqtt_gateway_stream_unbounded{stream} y
devicechain_eventsources_mqtt_gateway_stream_bounded_late_total{stream}.
Qué más cambió
Limitaciones conocidas
- Heredada de la
v0.23.0: conmqttFailCloseddesactivado, un cambio de líder del stream de captura de MQTT con mucha carga puede perder eventos QoS 1 ya confirmados sin contarlos (JetStreamCaptureLeaderChangedavisa). El techo documentado de MQTT es de unos 6.000 eventos por segundo en tres nodos de 4 vCPU, limitado por el bróker. - Un fallo del bróker con una acumulación grande no lo cubre
mqttFailClosed. En una prueba de carga de 9.000 eventos QoS 1 por segundo, antes de acelerar el lector del almacén, dos de los tres servidores NATS se quedaron sin memoria y cerca de un tercio de los eventos confirmados no llegó nunca al almacén de eventos. No se ha establecido dónde se perdieron. El ajuste es opcional y está desactivado por defecto. - El relleno omite el historial comprimido, y su ritmo por defecto (
rowsPerSecond) no se ha medido en una instancia con carga.
También en esta versión
dcctl upgradecomprueba el montaje del almacén de objetos antes de registrar la versión nueva. Un almacén ReadWriteOnce que montaría un segundo pod se rechaza antes de registrar la versión, como ya hacía--enable-area. El mensaje «recorded binding» ya no nombra dos veces el contexto.- Una acción de regla
sendCommandpuede acotar cuánto espera su comando al dispositivo. ElexpiresAfteropcional admite una duración de1ma168h; sin él, el comando espera los 7 días por defecto como antes. Un valor fuera de rango, o que no se puede leer, se rechaza al guardar o publicar la regla, y una regla almacenada con un valor no válido se descarta (se cuenta con el motivoinvalid_action) en lugar de enviarse sin límite. - Paneles y widgets. La tabla de alarmas puede agrupar sus alarmas en pestañas por tipo de
dispositivo, cada una con su propio recuento y su mayor severidad; la tarjeta de estadística puede
mostrar una minigráfica de tendencia; una nueva tarjeta de recuento de flota cuenta los dispositivos de
un grupo, o los que requieren atención, y deja fuera los dispositivos cuyo perfil no declara la
medición; una tarjeta de estado del dispositivo muestra si un dispositivo está en línea, con cuándo se
vio por última vez, y un anillo de conexión divide un grupo en en línea, sin conexión y sin estado
todavía (ambos leen el estado de los dispositivos que conoce la plataforma y requieren permiso para
leer el estado de los dispositivos); el control deslizante de comandos tiene
un modo de pasos; un clic en un marcador del mapa selecciona el dispositivo, y un enlace puede abrir un
panel con un dispositivo enlazado; un desglose de severidad de alarmas muestra las alarmas activas por
severidad; el gráfico de series temporales puede marcar alarmas y comandos en su eje de tiempo, limitado
a las alarmas sobre la medición que dibuja con la opción
markAlarmsScope(un gráfico nuevo empieza limitado; un gráfico guardado sin la opción marca todas las alarmas del dispositivo), y dibujar una línea por dispositivo de un grupo congroupBy: device(5 líneas por defecto, 12 como máximo); el editor de widgets ofrece las métricas de un dispositivo y marca las calculadas; y Create dashboard en la pestaña Perfil de un tipo de dispositivo crea un borrador de panel a partir de lo que declara el perfil. Todo es aditivo: un panel guardado se lee y se dibuja como antes. Consulta la guía de usuario. - Consola: los formularios ya no guardan sobre la entidad equivocada. Tras cambiar de registro, inquilino, nivel, rol o dispositivo, un formulario podía conservar los datos de la entidad anterior y guardarlos sobre la nueva. Ahora se separan los datos que se muestran de los datos sobre los que se actúa, en todas las consultas de la consola.
- GraphQL. La mutación de relleno de posición
_emptydeevent-managementdesaparece, porque el servicio ya tiene una mutación real (iniciar y cancelar un relleno). Un cliente que llamara a_emptyrecibe un error de campo desconocido. - Panel de detección. Dos paneles de latencia (p50 y p99 de la escritura de salud de las reglas y de la confirmación de publicación derivada) se suman al panel de escritura de salud de las reglas.
- Una tarea que falla una y otra vez ya no llena el registro. La línea «Maintenance pass failed» de
una tarea periódica, como el tick de detección que se ejecuta cada segundo, se registra una vez al
empezar una racha de fallos, después como mucho una vez por minuto con un recuento de las líneas
retenidas, y una vez cuando la tarea se recupera. Cada origen Sparkplug lleva su propia racha, así que
un origen que falla no se esconde tras uno sano. Siete bucles que no registraban duración, resultado ni último éxito de sus pasadas
ahora lo hacen, en las series existentes
devicechain_<area>_<task>_passes_total. - El acceso a streams y buckets se declara por servicio. Cada servicio solo puede abrir los streams y buckets clave-valor que tiene declarados para leer o escribir, y rechaza la llamada, nombrando el stream y la solución, si pide otro. Un arranque del bróker abandonado por quien lo llamó (apagado) ya no gasta aproximadamente un minuto por stream reintentando.
- Salud de las reglas. Los contadores de disparos de la salud de las reglas se agrupan fuera del bucle
de detección (unos 2,6 ms ahorrados por detección publicada en PostgreSQL), y el panel de detección
gana un panel para
detect_rule_stat_write_failures_totaly la nuevadetect_rule_stat_admission_contended_total. - Propiedad de dispositivos. Las horas de los hechos de propiedad las da el reloj de la base de datos, y un dispositivo que vuelve a ponerse en cola una y otra vez conserva su lugar en la cola, así que ya no puede quedar relegado indefinidamente.
- Un consumidor duradero de fallo cerrado que se vuelve a crear empieza en la primera secuencia del
almacén, de modo que un consumidor eliminado no deja mensajes confirmados sin leer (solo con
mqttFailClosedactivado). La ventana de duplicados del stream de destino absorbe una repetición y, más allá de ella, se almacena de nuevo. - Usuarios de cliente. Un miembro limitado a algunos clientes vuelve a ver su lista de Actualizaciones, y la pestaña Usuarios del cliente, con más de 10.000 miembros, muestra los primeros 10.000 con un aviso en lugar de un error.
- Go 1.27.3. La cadena de herramientas pasa a Go 1.27.3, que incluye la corrección de un aviso de
crypto/x509. - Sustituir la clave raíz de la instancia significa recrear la instancia. No hay verbo de rotación; consulta Recuperación ante desastres.
- Compilar desde el código fuente. El SDK de C# se compila ahora con el SDK de .NET fijado en
global.json(8.0.425), así que una restauración bloqueada ya no se rompe cuando una imagen de runner cambia de parche. - Documentación. Un capítulo de la guía de usuario sobre métricas calculadas (en inglés, español y chino), y las opciones de custodia de la guía de inicio rápido, la extracción de la CA de MQTT y las pruebas locales con TLS.
Versiones anteriores
Cuando se publique una nueva versión menor, la versión detallada más antigua pasará a esta tabla; cada enlace de Detalles abre las notas completas de esa versión tal como estaban en su etiqueta.
| Versión | Resumen | Acción necesaria | Detalles |
|---|---|---|---|
| v1.1.0 | la ingesta cuesta menos por evento, y los dispositivos fuera del clúster se conectan por MQTT | Sí | Notas completas |
| v1.0.0 | la primera versión estable: una caída de la base de datos retiene eventos, y Traefik es el acceso por defecto | Sí | Notas completas |
| v0.23.0 | usuarios de cliente con acceso acotado, y una ingesta MQTT que pierde menos | Sí | Notas completas |
| v0.22.0 | paneles sobre una cuadrícula de celdas cuadradas, y una ruta de eventos que espera menos | Sí | Notas completas |
| v0.21.1 | un parche, nada que hacer | No | Notas completas |
| v0.21.0 | un dispositivo puede quedar excluido por completo, y las actualizaciones se firman | Sí | Notas completas |
| v0.20.0 | inicia sesión con tu propio proveedor de identidad; los widgets se distribuyen como paquetes | Sí | Notas completas |
| v0.19.0 | dimensionada a partir de lo medido a 6000 eventos por segundo; un stream lleno rechaza | Sí | Notas completas |
| v0.18.0 | lo que fallaba en silencio ahora lo dice, y la ingesta sigue el ritmo de su techo | Sí | Notas completas |
| v0.17.0 | las instancias dejan de ser dueñas del clúster en el que se ejecutan | Sí | Notas completas |
| v0.16.0 | los dispositivos deben nombrar el despacho que responden | Sí | Notas completas |
| v0.15.0 | las actualizaciones dejan de borrar lo que no envió | No | Notas completas |
| v0.14.0 | los paquetes contra los que compila | No | Notas completas |
| v0.13.0 | los límites de geocercas pasan a formar parte de su plan | No | Notas completas |
| v0.12.1 | un parche, nada que hacer | No | Notas completas |
| v0.12.0 | una actualización que cambia contratos | Sí | Notas completas |
| v0.11.0 | de nuevo una actualización normal | No | Notas completas |
Durabilidad de los datos
La capa de base de datos es intencionalmente independiente del ciclo de vida de la aplicación. Ambas bases de datos se aprovisionan como infraestructura separada con una protección contra destrucción, de modo que actualizar, reinstalar o desinstalar la aplicación nunca las toca. Ese es el caso habitual y es seguro.
La protección resguarda cada base de datos mientras está dentro de la configuración de infraestructura. No resguarda una que se haya sacado fuera de ella: un recurso eliminado de la configuración deja de estar cubierto por las reglas que esa configuración declara, y el plan de eliminación se ejecutará con éxito. Los clústeres de base de datos además son dueños de sus volúmenes, así que eliminar uno se lleva sus datos consigo en lugar de dejar un volumen desasociado.
No edites la base de datos para sacarla de la configuración de infraestructura como forma de reemplazarla.
Actualizar una instancia creada antes de que las bases de datos pasaran al operador es el
único caso en que esto aparece, y se rechaza en tiempo de planificación en lugar de dejarse
al azar. Vuelca primero ambas bases de datos y vuelve a ejecutar dcctl install con
--allow-legacy-db-removal para la base de datos relacional, y el arranque con él para el
almacén de eventos, lo que afirma que te has ocupado de los datos y no verifica nada.
Para una instancia local, recrearla es más simple y descarta los datos de forma
deliberada: destrúyela, recrea el clúster y después instala y arranca, como se describe en
Instancias creadas por la v0.16.0 y anteriores.
Esto es durabilidad de los volúmenes en ejecución; no es un sustituto de las copias de seguridad programadas y la recuperación a un punto en el tiempo, que se aprovisionan con la infraestructura de producción. Consulte Despliegue y operador para saber cómo se separan las capas de infraestructura y aplicación.