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

Windows (PowerShell)

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

isard 0.4.8 — 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.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

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.