isard_

Tus escritorios de IsardVDI, desde el terminal. Entra con tu cuenta de la Generalitat y crea, arranca, abre y programa los mismos escritorios virtuales que te da el portal web.

Instala
Primeros pasos
Un escritorio con scripts
Documentación

# macOS / Linux
$ curl -fsSL https://isard.xtec.dev/install.sh | sh

$ isard login
$ isard list
$ isard view windows

Qué es

IsardVDI es la plataforma de escritorios virtuales de la red educativa de la Generalitat. El portal web es una forma de entrar; isard es la otra. Inicia sesión exactamente como lo hace el portal —con la cuenta de tu centro, a través del inicio de sesión de Microsoft— y la guarda, así que a partir de la primera vez cada comando es una sola llamada HTTPS.

Escritorios

create, start, stop, delete y view, que abre uno con remote-viewer por SPICE y, si falta, instala antes el visor.

SSH y la VPN

isard ssh pasa por el bastión de IsardVDI con tu propia clave. isard vpn up te une a la red de los escritorios por WireGuard, para todos los puertos y no solo dos.

Programable

exec, push, pull, job: la salida estándar es la del escritorio, el código de salida también, y nunca pregunta nada. Un escritorio se convierte en una máquina de pruebas que un script puede manejar.

Plantillas

isard build perfil.yaml lleva una ISO de Fedora o de Ubuntu hasta una plantilla terminada y configurada: todo menos las pantallas del propio instalador, que haces en el visor.

Un solo binario

Sin entorno de ejecución ni gestor de paquetes. Un solo ejecutable por plataforma, de unos 12 MB, verificado por SHA-256 antes de que el instalador lo ponga en su sitio.

Tus credenciales son tuyas

Ningún comando acepta la contraseña como opción. Sale de GENCAT_USERNAME / GENCAT_PASSWORD, de un .env o de una pregunta, nunca del historial del shell.

Instalación

Una sola línea. El instalador obtiene el manifiesto de la versión, descarga el binario de tu plataforma, comprueba su SHA-256 y lo pone en tu PATH.

macOS y Linux

$ curl -fsSL https://isard.xtec.dev/install.sh | sh

Windows (PowerShell)

> irm https://isard.xtec.dev/install.ps1 | iex

isard 0.4.1 — o descarga el binario tú mismo. Las versiones de Linux son estáticas, así que funcionan en cualquier distribución.

Plataforma	Archivo	Tamaño	SHA-256
macOS · Apple silicon	isard-darwin-aarch64	11.1 MB	170d36ebf22c1782893533405f99f9008cd18aef245bb66aea1cfcc2b5f8a737
macOS · Intel	isard-darwin-x86_64	11.8 MB	6b6c3bd4d7d72483980e166654f7abb37cabe89e7550203b65da5127f6373a96
Linux · x86_64 (static)	isard-linux-x86_64	12.2 MB	16f08fb2fe8f022221bf006c5b02b0d8bc762c06f6cccbae021189cf71c7b0eb
Linux · arm64 (static)	isard-linux-aarch64	10.9 MB	2db67e9d88c29cfdccf61b8df7822b53e3617a30c3f2b9567ef97f2cd6d7cd6a
Windows · x86_64	isard-windows-x86_64.exe	13.0 MB	4f5a1ee237cfe220de8972585bff40fed80de3f4db45193b02463886f75c6c9d

Los mismos datos, para scripts: /api/version. Define ISARD_INSTALL para elegir dónde va el binario, o ISARD_NO_MODIFY_PATH=1 para no tocar los archivos de inicio del shell.

También está en PyPI, con la biblioteca de Python: uv tool install isard (solo el comando) o pip install isard (import isard).

Primeros pasos

Inicia sesión una vez. La sesión se guarda en ~/.config/isard/ y se renueva sola cuando caduca: con la contraseña del entorno o de un .env si lo hay, y si no, preguntándotela.

$ isard login                     # tu cuenta @edu.gencat.cat
$ isard list --hardware           # tus escritorios, con vCPU y memoria
$ isard template list
$ isard create lab -t "Ubuntu Server 24.04_isardvdi_v1"
$ isard start lab
$ isard view lab                  # la pantalla del escritorio, por SPICE
$ isard ssh lab
$ isard stop lab

Los nombres se comparan con tolerancia: isard view win encuentra «Windows 11» si no hay otro parecido. El recorrido completo, con el aspecto de cada paso, está en la página de la línea de comandos.

Un escritorio con scripts

Cuando una prueba necesita una máquina que el portátil no es —Windows, x86_64, virtualización anidada—, un escritorio puede ser esa máquina. Estos comandos nunca preguntan, solo escriben en la salida estándar la del escritorio y terminan con su código de salida.

$ isard up windows                # activa la clave SSH, arranca, espera a sshd
$ isard exec windows -- 'Get-Date'
$ isard push windows ./project --mirror   # solo lo que ha cambiado
$ isard job windows gate.ps1 -r 'C:\work\result.json' -o result.json
$ isard pull windows 'C:\work\out.txt' -
$ isard stop windows --wait

Tras la primera llamada, la ruta hasta el escritorio queda guardada: un exec es una sola conexión SSH —unos dos segundos en Windows— y no toca la API para nada.