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.optersoft.com/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.optersoft.com/install.sh | sh

Windows (PowerShell)

> irm https://isard.optersoft.com/install.ps1 | iex

isard 0.4.8 — 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.3 MB	e1a94532e50ed0d1164c1913e8c04a08da61288933f7fa1ef28edfbe121c4aa2
macOS · Intel	isard-darwin-x86_64	12.0 MB	af2598d97bd2d79fb398ff912a9e0b8142cf4e393128629708f7cf41e3ba319f
Linux · x86_64 (static)	isard-linux-x86_64	12.5 MB	fc2d78c93ff55509537ce7accbd1275a5a4e66f90b46d9c7cda819d0c50971b1
Linux · arm64 (static)	isard-linux-aarch64	11.1 MB	d96189c4b86609ae485c4479713b80431cb0d73bb475161d1612a79293b07b6f
Windows · x86_64	isard-windows-x86_64.exe	13.1 MB	5287cb17eefa70e0a50111974bc7cb3289aa66afba2b771c376b53302cf0c407

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.