Investigar 2
testing/ogcore-api/pipeline/head There was a failure building this commit
Details
testing/ogcore-api/pipeline/head There was a failure building this commit
Details
parent
8569e73fea
commit
a5a0f60c59
|
|
@ -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 |
|
||||
Loading…
Reference in New Issue