Sitios

Un sitio es una instalación de Arkvory: la principal, un espejo en otra ubicación, una instalación que importa versiones de otra. En Sitios, una instalación, el controlador, muestra cada sitio que gestiona: si responde, su versión, sus copias de HA y pasarelas de lectura, sus espejos y cuánto van retrasados, y su cola de descargas. Solo los administradores globales ven la página.

Estado del clúster

La página empieza con Estado del clúster: qué necesita atención en los sitios y qué sitio alimenta a cuál. El controlador lo construye con las últimas lecturas de los sitios, como mucho una vez cada 5 segundos, y se incluye a sí mismo como «este sitio».

Alertas

Cada alerta nombra el sitio y el problema. Primero van las más graves: Crítico, luego Advertencia, luego Nota. Si nada necesita atención, la lista lo dice.

Alerta	Gravedad	Cuándo	Qué hacer
Inaccesible	Crítico	Sin respuesta durante 2 minutos. Una lectura fallida no es una alerta	Revise el sitio y la red
Certificado, revocado, rechazado, no válido	Crítico	De inmediato, con el estado del mismo nombre	Empareje de nuevo o actualice ambas instalaciones
Desactualizado	Advertencia	El sitio respondía, pero no se ha leído durante tres periodos de lectura (90 segundos) más lo que tarda una ronda de lecturas: las lecturas en segundo plano del controlador están atascadas	Revise el proceso de la API del controlador
Sin escritura	Crítico	Un proceso de escritura rechaza escrituras sin estar drenando	Revise su base de datos y su disco
Copias	Crítico	A un sitio de HA le faltan copias de sus datos; las escrituras se pausan hasta que vuelvan	Recupere el nodo que falta, consulte Clúster de alta disponibilidad
Copia única	Advertencia	Faltan copias, pero un operador aceptó una sola copia hasta una hora	Recupere el nodo que falta antes de esa hora
Fallo del espejo	Advertencia	La última sincronización de un espejo falló. Volver a leer un origen restaurado no cuenta	Lea el código de error del espejo
Espejo retrasado	Advertencia	Un espejo va ARKVORY_FLEET_LAG_ALERT cambios (1000 por defecto) o más por detrás de su origen	Revise el origen, la red y el espejo
Actualización fallida	Advertencia	El actualizador del sitio informa de un fallo	Abra Actualizaciones en los ajustes del sitio
Otra versión	Nota	El sitio ejecuta otra versión que el controlador	Actualice los sitios a la misma versión

Las alertas usan solo lecturas recientes: un sitio que no responde genera su propia alerta, no alertas sobre lo que informó por última vez. Una ronda de lecturas tarda hasta 15 segundos por cada ocho sitios, porque el controlador lee como máximo ocho a la vez y espera hasta 15 segundos a cada uno; la alerta de desactualizado suma ese tiempo, para que muchos sitios inaccesibles no hagan parecer atascados a los sanos. Prometheus alerta con el mismo ARKVORY_FLEET_LAG_ALERT, consulte Monitorización.

Enlaces

Vínculos muestra qué sitio alimenta a cuál. Cada espejo e importación es una flecha del sitio de origen al sitio que tiene el espejo.

• Un origen en cuya dirección no responde ningún sitio gestionado se dibuja con su dirección y un borde discontinuo. Si ese origen es el propio controlador, defina ARKVORY_SITE_URL, consulte Configuración.
• Un enlace con fallos es una línea discontinua roja.
• El número de un enlace indica cuántos cambios va retrasado el espejo respecto a su origen.
• Mientras un sitio no responde, sus enlaces y su retraso se quedan como los informó por última vez, marcados como último estado conocido: discontinuos en el mapa y con la indicación Último estado conocido: el sitio no responde en la tabla.

Debajo del mapa, una tabla muestra los mismos datos: Origen, Sitio, Repositorio, Repositorio del origen y Retraso.

Los administradores globales del controlador obtienen las mismas alertas y enlaces con GET /api/v1/fleet/overview, o desde el SDK con client.fleet.overview(). Para Prometheus, el controlador exporta el estado de sus sitios y el número de alertas: consulte Monitorización.

Cómo funciona

• El controlador guarda una lista de sitios. Lee cada sitio cada 30 segundos por HTTPS y conserva la última respuesta, así que un sitio que deja de responder sigue mostrando su último estado conocido.
• Al emparejarse, el sitio da al sitio de control una clave propia, la clave de flota. Solo alcanza lo que el sitio de control necesita: el estado del sitio, las descripciones de su catálogo y los cambios indicados: la cola de descargas, las solicitudes de actualización y los cambios de espejos y HA para el agente del sitio. No puede descargar bytes de archivos, escribir en repositorios ni leer o cambiar cuentas y claves.
• El controlador guarda las claves de flota selladas con una clave de su directorio de datos (fleet.key). La base de datos y sus copias de seguridad por sí solas no las revelan. Tras una restauración, empareje los sitios de nuevo.
• Cada sitio muestra qué controladores lo gestionan y puede revocarlos en cualquier momento.

Emparejar un sitio

1. En el sitio: abra Sitios y, en Este sitio, seleccione Crear un código de emparejamiento. El sitio muestra un código válido diez minutos y, con HTTPS integrado, la huella de su certificado.
2. En el controlador: abra Sitios, introduzca la dirección del sitio en Emparejar un sitio y seleccione Comprobar. El controlador se conecta y muestra la huella del certificado que recibió.
3. Compare las dos huellas. Deben ser iguales. Si difieren, la dirección es incorrecta o algo se interpone entre las instalaciones: no empareje.
4. Introduzca el código y seleccione Emparejar. El sitio aparece en la lista con su estado.

Un código sirve una vez. Un código usado o caducado se rechaza: cree uno nuevo.

La dirección es la dirección HTTPS de la API del sitio, por ejemplo https://branch.example:8443. HTTP simple solo se acepta en el mismo equipo (127.0.0.1). Si TLS termina en un proxy delante del sitio, el sitio no puede mostrar el certificado del proxy: compare con la huella SHA-256 que su navegador muestra para la dirección del sitio.

A partir de ahí, el controlador confía exactamente en ese certificado. Cuando el sitio recibe un certificado nuevo, muestra Certificado cambiado: quite el sitio y empareje de nuevo.

Estados

Estado	Significado	Qué hacer
Funciona	El sitio respondió a la última lectura	Nada
Aún no leído	El sitio aún no se ha leído	Espere la siguiente lectura o seleccione Leer ahora
Inaccesible	Sin respuesta: el sitio está detenido o la red caída	Revise el sitio y la red. El último estado conocido sigue visible
Certificado cambiado	El sitio presenta otro certificado que el confirmado	Si el certificado se renovó, quite el sitio y empareje de nuevo
Acceso revocado	El administrador del sitio revocó este controlador	Empareje de nuevo con un código nuevo
Respuesta inesperada	El sitio respondió de una forma que esta versión no entiende	Actualice ambas instalaciones a la misma versión
Rechazado	El sitio rechazó la solicitud	Empareje de nuevo con un código nuevo

Qué muestra la lista

• Versión: la versión del sitio y su rol, escritura o pasarela de lectura.
• HA y pasarelas: en un clúster HA, las copias completas y cuántas necesita una escritura; las pasarelas de lectura que mantienen su puesto.
• Espejos: los espejos e importaciones del sitio; cuántos cambios lleva de retraso el más atrasado respecto a su origen, o cuántos están detenidos.
• Cola de descargas: descargas en curso y descargas que esperan en la cola.
• Última respuesta: cuándo respondió el sitio por última vez.

Leer todos ahora lee todos los sitios ahora en lugar de esperar a la siguiente ronda. Quitar olvida un sitio aquí; revoque también el controlador en el sitio, porque hasta entonces su clave sigue válida allí.

Contenido de un sitio

Contenido en la fila de un sitio abre bajo la lista sus repositorios, artefactos y archivos. Elija un repositorio; Buscar busca artefactos por nombre o etiqueta y muestra los archivos cuya ruta empieza por lo escrito. Mostrar más lee la página siguiente.

El sitio de control lo lee en el sitio con su clave de flota y muestra la respuesta tal como la dio el sitio. Solo viajan descripciones: nombres, tamaños, etiquetas, etapas, rutas y revisiones. Para descargar un archivo, use el propio sitio.

Ajustes de un sitio

Ajustes en la fila de un sitio abre sus ajustes bajo la lista; Ajustes de este sitio abre la misma tarjeta para este sitio. La tarjeta tiene tres partes:

• Cola de descargas: cuántas descargas van a la vez, plazas reservadas para personas, la estrategia, los pesos de las clases y los demás valores de la cola de Control de tráfico. Un campo vacío mantiene el valor del entorno del sitio, mostrado en gris. Guardar ajustes de la cola aplica los valores al instante, sin reiniciar: las nuevas decisiones los siguen y las descargas activas conservan su lugar. Volver a los valores por defecto vuelve al entorno.
• Actualizaciones: la versión instalada y la última, la instalación automática y la hora de mantenimiento, Comprobar ahora e Instalar actualización. El actualizador del sitio toma una solicitud en menos de un minuto; hasta entonces la tarjeta la muestra como aceptada.
• Espejos y clúster: los espejos e importaciones del sitio con Reemplazar clave y Desconectar, Conectar un espejo o una importación con la clave de origen y, en un clúster HA, Conmutar a un nodo con copia completa (el nombre del nodo se escribe dos veces) y la decisión de una sola copia. El agente del sitio aplica cada solicitud en menos de un minuto con las comprobaciones y la reversión de arkvory configure y cluster-*; Solicitudes al agente muestra cómo terminó cada una. La clave de origen llega al agente una vez, en un archivo propio, y no vuelve a mostrarse. El agente es el actualizador del sitio: conéctelo con updates-connect.

Cada cambio lleva la revisión de la que parte. Si alguien cambió los ajustes mientras tanto, el sitio rechaza el cambio y la tarjeta muestra los valores actuales: revíselos y guarde de nuevo. El sitio registra quién cambió su cola: la clave del sitio de control y el nombre de su administrador.

Desde el sitio de control un espejo o una importación solo se conecta como repositorio nuevo, y el certificado de la autoridad de un origen se configura en el propio sitio (arkvory configure --mirror-ca-file): aquello en lo que confía un sitio nunca cambia en remoto. La lista de solicitudes muestra con un código cómo terminó cada cambio; las palabras del agente quedan en su registro en el sitio. Si un cambio se interrumpió a medias, el agente no toma otro hasta que un administrador del sitio lo revise y ejecute allí arkvory changes-reset --root <raíz>.

Quién gestiona este sitio

En Este sitio, cada sitio enumera los controladores que lo gestionan: nombre, quién los emparejó, cuándo y su última solicitud. Revocar rechaza la clave del controlador de inmediato.

Configuración

Variable	Predeterminado	Significado
ARKVORY_SITE_NAME	el nombre del host	Cómo se llama esta instalación en otros sitios
ARKVORY_FLEET_KEY_FILE	fleet.key en el directorio de datos	La clave que sella las claves de los sitios gestionados; se crea en el primer inicio del proceso de escritura
ARKVORY_SITE_URL	sin definir	La dirección https://host[:port] con la que otros sitios llegan a esta instalación. Con ella, los espejos cuyo origen es esta instalación enlazan con ella en Vínculos. Un valor no válido detiene el inicio
ARKVORY_FLEET_LAG_ALERT	1000	Cambios de retraso respecto a su origen a partir de los cuales un espejo de un sitio gestionado genera una alerta; número entero, 1 o más

Límites

• Las pruebas de aislamiento y añadir o retirar nodos del clúster siguen siendo comandos locales en los nodos. Las pasarelas de lectura mantienen la cola de descargas de su entorno.
• Un controlador gestiona hasta 256 sitios y lee como mucho ocho a la vez.
• El controlador tiene una clave de cada sitio que gestiona: proteja a sus administradores globales y su directorio de datos con el mismo cuidado que los propios sitios.