12 KiB
Integración RemotePC: UDS ↔ ogcore — Flujo y bugs corregidos
Flujo de reserva de host
Visión general
UDS actúa como broker de escritorios remotos. Cuando un usuario solicita una sesión, UDS llama a ogcore para reservar una máquina física, arrancarla en el SO correcto y notificar el login/logout.
Endpoints implicados
| Método | Ruta | Descripción |
|---|---|---|
POST |
/opengnsys/rest/ous/{ouid}/images/{imageId}/reserve |
Reserva un cliente disponible |
POST |
/opengnsys/rest/ous/{ouid}/labs/{labId}/clients/{clientId}/events |
Registra URLs de callback login/logout |
POST |
/opengnsys/rest/ous/{ouid}/labs/{labId}/clients/{clientId}/session |
Define el tiempo máximo de sesión |
DELETE |
/opengnsys/rest/ous/{ouid}/labs/{labId}/clients/{clientId}/unreserve |
Libera la reserva y apaga el cliente |
Flujo detallado: POST /reserve
UDS → POST /reserve {labid, maxtime}
1. Selección del cliente (ClientRepository::findBestAvailableClientForImage)
La query busca el primer cliente que cumpla todos estos criterios:
- Pertenece a una OU bajo el path del centro (
ouid) - El laboratorio tiene
remotePc = true - Tiene una partición con la imagen solicitada donde
iir.remotePc = true - No está en mantenimiento
- No tiene reserva activa (
reservedUntil IS NULLo ya expiró) - Si se pasó
labId, filtra además por laboratorio - Ordena por
reservedUntil ASC(prioriza el liberado hace más tiempo) - Si no hay cliente disponible → HTTP 404
2. Búsqueda de la partición
Se itera sobre las particiones del cliente para encontrar la que contiene la imagen solicitada.
3. Arranque del cliente (startClient) — máximo 2s por llamada HTTP
Hay tres ramas según el estado actual del cliente:
| Estado del cliente | Acción |
|---|---|
OG_LIVE |
Envía IniciarSesion directamente al agente (https://{ip}:8000/opengnsys/IniciarSesion) con disco y partición. Si falla, crea traza LOGIN pendiente. |
OFF / TURNING_OFF / DISCONNECTED / null |
Envía Wake-on-LAN al ogrepository (http://{repo}:8006/ogrepository/v1/wol). Crea traza LOGIN pendiente para cuando arranque en OGLive. |
| Cualquier otro (Windows, Linux…) | Envía Reiniciar al agente (https://{ip}:8000/opengnsys/Reiniciar). Crea traza LOGIN pendiente. |
4. Registro de la reserva
- Se crea la entidad
RemotePCsi no existe - Se fija
reservedUntil = ahora + maxTime horas - Se limpian
urlLoginyurlLogout - Se persiste en BD
5. Respuesta a UDS
{ "id": 3, "name": "PC-01", "ip": "172.16.53.196", "mac": "00:1B:...", "lab": {"id": 2}, "ou": {"id": 1} }
Flujo posterior al reserve
UDS → POST /events { urlLogin, urlLogout }
ogcore guarda las URLs de callback en RemotePC
Máquina arranca en OGLive
ogagent OGLive → POST /ogAdmClient/InclusionCliente
ogcore: status = OG_LIVE
Command processor (cron cada minuto)
Encuentra traza LOGIN PENDING
Cliente en OG_LIVE → llama LoginAction → envía IniciarSesion
Máquina arranca Windows/Linux
ogagent Windows/Linux → POST /ogagent/started
ogcore: status = WINDOWS (o LINUX)
Usuario hace login en el SO
ogagent → POST /ogagent/loggedin
ogcore llama urlLogin de UDS ← UDS sabe que la sesión está lista
UDS → POST /session { deadLine: N }
ogcore encola: popup-10, popup-5, poweroff en AgentQueue
Usuario hace logout
ogagent → POST /ogagent/loggedout
ogcore llama urlLogout de UDS
UDS → DELETE /unreserve
ogcore: limpia reserva, borra AgentQueue y trazas LOGIN PENDING, envía Apagar
Bugs identificados y corregidos
Bug 1 — ogagent: POST con body vacío devuelve 500 antes de ejecutar el handler
Fichero: ogagent/src/opengnsys/httpserver.py
Problema: do_POST intentaba parsear el body como JSON siempre. Cuando ogcore enviaba Reiniciar o Apagar sin body (Content-Length: 0), json.loads("") lanzaba JSONDecodeError. El método llamaba a sendJsonError(500) pero sin return, de modo que continuaba ejecutando notifyMessage y enviaba un segundo response 200. El cliente (ogcore) recibía el primero: el 500.
Síntoma visible en logs del agente Windows:
(do_POST) length: 0, content >><<
(log_message) HTTP "POST /opengnsys/Reiniciar HTTP/1.1" 500 - ← enviado primero
(process_Reiniciar) Received reboot operation
(log_message) HTTP "POST /opengnsys/Reiniciar HTTP/1.1" 200 - ← ignorado por ogcore
Fix:
# antes
length = int(self.headers.get('content-length'))
content = self.rfile.read(length).decode('utf-8')
post_params = json.loads(content)
except Exception as e:
self.sendJsonError(500, exceptionToMessage(e))
# sin return → continuaba ejecutando notifyMessage
# después
length = int(self.headers.get('content-length', 0))
if length > 0:
content = self.rfile.read(length).decode('utf-8')
logger.debug('length: {0}, content >>{1}<<'.format(length, content))
post_params = json.loads(content)
else:
logger.debug('length: 0, content >><<')
except Exception as e:
self.sendJsonError(500, exceptionToMessage(e))
return # ← impide llamar a notifyMessage tras el error
Bug 2 — ogcore: excepciones HTTP 5xx no capturadas en startClient / sendIniciarSesion
Fichero: src/Controller/UDS/RemotePcController.php
Problema: Los bloques try/catch solo capturaban TransportExceptionInterface (errores de red). Cuando el agente devolvía HTTP 500, Symfony lanzaba ServerExceptionInterface (subclase de HttpExceptionInterface), que no era capturada. La excepción escalaba hasta el handler global de Symfony, que devolvía un error Hydra 500 a UDS:
{
"@type": "hydra:Error",
"hydra:description": "HTTP/1.0 500 Internal Server Error returned for \"https://172.16.53.196:8000/opengnsys/Reiniciar\"."
}
UDS interpretaba la reserva como fallida y llamaba a unreserve → Apagar.
Fix:
// antes
} catch (TransportExceptionInterface $e) {
// después
} catch (TransportExceptionInterface | HttpExceptionInterface $e) {
Aplicado en startClient y sendIniciarSesion.
Bug 3 — ogcore: sin timeout en llamadas HTTP al agente → UDS recibe read timeout
Fichero: src/Controller/UDS/RemotePcController.php
Problema: Las llamadas HTTP a IniciarSesion, Reiniciar, WoL y Apagar no tenían timeout. Para NativeHttpClient (modo síncrono), request() bloqueaba hasta recibir respuesta o agotar el socket timeout del sistema. Se observó que Apagar bloqueó 35 segundos:
21:38:47 Request: "POST .../Apagar"
21:39:23 WARNING: poweroff failed ← 35 segundos después
UDS tiene un read timeout de 10 segundos, por lo que siempre agotaba el tiempo de espera. Esto provocaba que UDS llamase a unreserve inmediatamente después de un reserve aparentemente exitoso.
Referencia: El código antiguo (opengnsys/admin/WebConsole/includes/restfunctions.php) usaba multiRequest() con CURLOPT_TIMEOUT_MS => 500.
Fix: Añadir timeout: 2.0 y ->getStatusCode() en todas las llamadas. El getStatusCode() es necesario para forzar la resolución de la respuesta en clientes async (CurlHttpClient), ya que sin él el timeout nunca se aplica:
$this->httpClient->request('POST', 'https://' . $client->getIp() . ':8000/opengnsys/IniciarSesion', [
'verify_host' => false,
'timeout' => 2.0,
'json' => [...],
'headers' => ['Authorization' => $client->getToken()],
])->getStatusCode();
Aplicado en: sendIniciarSesion, startClient (Reiniciar y WoL) y sendPowerOff.
Bug 4 — ogcore: executeLogin no encontraba la partición (mismatch de formato)
Fichero: src/Command/ExecutePendingTracesCommand.php
Problema: RemotePcController::startClient creaba las trazas LOGIN con {dsk: N, par: N} (números de disco/partición). ExecutePendingTracesCommand::executeLogin esperaba {partition: UUID}. El mismatch causaba el error:
{"error": "Partition not found in trace input", "input": {"dsk": 1, "par": 1}}
La traza fallaba e IniciarSesion nunca se enviaba cuando la máquina llegaba a OGLive.
Fix: Soportar ambos formatos en executeLogin:
if (isset($input['partition'])) {
$partition = $repo->findOneBy(['uuid' => $input['partition']]);
} elseif (isset($input['dsk']) && isset($input['par'])) {
$partition = $repo->findOneBy([
'client' => $client,
'diskNumber' => $input['dsk'],
'partitionNumber' => $input['par'],
]);
} else {
throw new \Exception("Partition not found in trace input");
}
Bug 5 — ogcore: LoginAction creaba trazas de retry con input vacío
Fichero: src/Controller/OgAgent/LoginAction.php
Problema: Cuando el cliente no estaba en OG_LIVE o IniciarSesion fallaba, LoginAction creaba nuevas trazas PENDING con input [] vacío:
$this->createService->__invoke($client, CommandTypes::LOGIN, TraceStatus::PENDING, null, []);
Estas trazas eran recogidas por el command processor y fallaban con "Partition not found in trace input" (Bug 4).
Fix: Propagar la información de partición a las trazas de retry:
$partitionInput = [
'dsk' => $partition->getDiskNumber(),
'par' => $partition->getPartitionNumber(),
];
$this->createService->__invoke($client, CommandTypes::LOGIN, TraceStatus::PENDING, null, $partitionInput);
Bug 6 — ogcore: bucle infinito de trazas LOGIN cuando el cliente está apagado
Ficheros: src/Command/ExecutePendingTracesCommand.php y src/Controller/UDS/RemotePcController.php
Problema: Cuando el cliente estaba en estado off o windows:
- El command processor encontraba una traza LOGIN PENDING
- Llamaba a
loginAction->__invoke LoginActiondetectaba que el cliente no estaba en OG_LIVE, creaba otra traza LOGIN PENDING y devolvía 200executeLoginmarcaba la traza original comoSUCCESS- La nueva traza era recogida el siguiente minuto → vuelta al paso 2
Adicionalmente, al hacer unreserve las trazas LOGIN PENDING del cliente no se eliminaban. El código antiguo sí borraba los comandos pendientes de la tabla acciones:
DELETE FROM acciones
WHERE idordenador = '$clntid'
AND descriaccion = 'RemotePC Session';
El nuevo ogcore no tenía equivalente, por lo que las trazas LOGIN sobrevivían al unreserve y seguían ejecutándose.
Síntoma observable: la máquina entraba en bucle continuo de reinicios.
Fix A — executeLogin espera a que el cliente esté en OG_LIVE:
if ($client->getStatus() !== ClientStatus::OG_LIVE) {
$this->logger->info('Login trace deferred: client not in OGLive', [
'client' => $client->getUuid(),
'status' => $client->getStatus(),
]);
return false; // la traza queda PENDING hasta que el cliente esté en OGLive
}
Fix B — unreserve elimina las trazas LOGIN pendientes:
$this->entityManager->createQuery(
'DELETE FROM App\Entity\Trace t
WHERE t.client = :client
AND t.command = :command
AND t.status = :status'
)
->setParameter('client', $client)
->setParameter('command', CommandTypes::LOGIN)
->setParameter('status', TraceStatus::PENDING)
->execute();
Resumen de ficheros modificados
| Repositorio | Fichero | Bugs corregidos |
|---|---|---|
ogagent |
src/opengnsys/httpserver.py |
#1 |
ogcore |
src/Controller/UDS/RemotePcController.php |
#2, #3, #6B |
ogcore |
src/Controller/OgAgent/LoginAction.php |
#5 |
ogcore |
src/Command/ExecutePendingTracesCommand.php |
#4, #6A |