Investigar 2
testing/ogcore-api/pipeline/head There was a failure building this commit Details

pull/102/head
Nicolas Arenas 2026-04-29 11:00:49 +02:00
parent 8569e73fea
commit a5a0f60c59
1 changed files with 305 additions and 0 deletions

View File

@ -0,0 +1,305 @@
# 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 NULL` o 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 `RemotePC` si no existe
- Se fija `reservedUntil = ahora + maxTime horas`
- Se limpian `urlLogin` y `urlLogout`
- Se persiste en BD
**5. Respuesta a UDS**
```json
{ "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:**
```python
# 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:
```json
{
"@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:**
```php
// 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:
```php
$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:
```json
{"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`:
```php
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:
```php
$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:
```php
$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`:
1. El command processor encontraba una traza LOGIN PENDING
2. Llamaba a `loginAction->__invoke`
3. `LoginAction` detectaba que el cliente no estaba en OG_LIVE, creaba **otra traza LOGIN PENDING** y devolvía 200
4. `executeLogin` marcaba la traza original como `SUCCESS`
5. 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`:
```sql
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:**
```php
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:**
```php
$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 |