isard_

Els teus escriptoris d'IsardVDI, des del terminal. Entra amb el compte de la Generalitat i crea, arrenca, obre i programa els mateixos escriptoris virtuals que et dona el portal web.

Instal·la
Primers passos
Un escriptori amb scripts
Documentació

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

$ isard login
$ isard list
$ isard view windows

Què és

IsardVDI és la plataforma d'escriptoris virtuals de la xarxa educativa de la Generalitat. El portal web és una manera d'entrar-hi; isard és l'altra. Inicia la sessió exactament com ho fa el portal —amb el compte del centre, a través de l'inici de sessió de Microsoft— i la desa, de manera que, a partir de la primera vegada, cada ordre és una sola crida HTTPS.

Escriptoris

create, start, stop, delete i view, que n'obre un amb remote-viewer per SPICE i, si no hi és, primer instal·la el visor.

SSH i la VPN

isard ssh passa pel bastió d'IsardVDI amb la teva pròpia clau. isard vpn up t'uneix a la xarxa dels escriptoris per WireGuard, per a tots els ports i no només dos.

Programable

exec, push, pull, job: la sortida estàndard és la de l'escriptori, el codi de sortida també, i no pregunta res. Un escriptori es converteix en una màquina de proves que un script pot governar.

Plantilles

isard build perfil.yaml porta una ISO de Fedora o d'Ubuntu fins a una plantilla acabada i configurada: tot menys les pantalles del mateix instal·lador, que fas al visor.

Un sol binari

Sense entorn d'execució ni gestor de paquets. Un sol executable per plataforma, d'uns 12 MB, verificat per SHA-256 abans que l'instal·lador el posi al seu lloc.

Les credencials són teves

Cap ordre no accepta la contrasenya com a opció. Surt de GENCAT_USERNAME / GENCAT_PASSWORD, d'un .env o d'una pregunta, mai de l'historial de l'intèrpret.

Instal·lació

Una sola línia. L'instal·lador baixa el manifest de la versió, descarrega el binari de la teva plataforma, en comprova l'SHA-256 i el posa al teu PATH.

macOS i 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 baixa't el binari tu mateix. Les versions de Linux són estàtiques, i per tant funcionen a qualsevol distribució.

Plataforma	Fitxer	Mida	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

Les mateixes dades, per a scripts: /api/version. Defineix ISARD_INSTALL per triar on va el binari, o ISARD_NO_MODIFY_PATH=1 per no tocar els fitxers d'inici de l'intèrpret.

També és a PyPI, amb la biblioteca de Python: uv tool install isard (només l'ordre) o pip install isard (import isard).

Primers passos

Inicia la sessió una vegada. La sessió es desa a ~/.config/isard/ i es renova sola quan caduca: amb la contrasenya de l'entorn o d'un .env si n'hi ha, i si no, preguntant-te-la.

$ isard login                     # el teu compte @edu.gencat.cat
$ isard list --hardware           # els teus escriptoris, amb vCPU i memòria
$ isard template list
$ isard create lab -t "Ubuntu Server 24.04_isardvdi_v1"
$ isard start lab
$ isard view lab                  # la pantalla de l'escriptori, per SPICE
$ isard ssh lab
$ isard stop lab

Els noms es comparen amb tolerància: isard view win troba «Windows 11» si no n'hi ha cap altre de semblant. El recorregut complet, amb l'aspecte de cada pas, és a la pàgina de la línia d'ordres.

Un escriptori amb scripts

Quan una prova necessita una màquina que el portàtil no és —Windows, x86_64, virtualització imbricada—, un escriptori pot ser aquesta màquina. Aquestes ordres no pregunten mai res, només escriuen a la sortida estàndard la de l'escriptori i acaben amb el seu codi de sortida.

$ isard up windows                # activa la clau SSH, arrenca, espera sshd
$ isard exec windows -- 'Get-Date'
$ isard push windows ./project --mirror   # només el que ha canviat
$ isard job windows gate.ps1 -r 'C:\work\result.json' -o result.json
$ isard pull windows 'C:\work\out.txt' -
$ isard stop windows --wait

Després de la primera crida, la ruta fins a l'escriptori queda desada: un exec és una sola connexió SSH —uns dos segons a Windows— i no toca l'API per a res.