Le binaire installé : parc, cycle de vie, console série, gabarits

Tout ce guide décrit le binaire que votre `PATH` trouve, pas un autre. Si plusieurs fichiers portent ce nom sur la machine, c'est celui du PATH qui répond quand vous tapez anhywhere.

$ aw version
<version> (revision <revision>, built <date>)

$ aw version --revision
<revision>

$ sha256sum "$(command -v anhywhere)"
<empreinte>  anhywhere

Quatre drapeaux sont globaux : toutes les commandes les acceptent, et l'aide de chacune les rappelle en fin de liste.

chmod +x anhywhere-client
sha256sum -c anhywhere-client.sha256
mv anhywhere-client ~/.local/bin/anhywhere

run crée la machine, rattache les réseaux demandés et attend son démarrage. --name et --template sont exigés ; tout le reste a une valeur par défaut.

# créer une machine et attendre son démarrage
aw run --name site-vitrine --template ubuntu2404 --cpu 2 --mem 2048 --disk 10240

# rendre la main tout de suite, et suivre le démarrage depuis l'interface
aw run --name api-interne --template ubuntu2404 --no-wait

list n'accepte aucun drapeau en dehors de --help et rend un tableau ; info n'accepte que --id et rend un objet JSON.

$ aw list
ID     NAME          STATE    TEMPLATE     CPU  MEM   IP          NETWORKS
17005  site-vitrine  running  ubuntu2404   1    256   10.0.0.121  -
17004  api-interne   running  ubuntu2404   1    256   10.0.0.119  -

$ aw info site-vitrine
{
  "id": 17005,
  "name": "site-vitrine",
  "template": "ubuntu2404",
  "state": "running",
  "cpu": 1,
  "mem_mib": 256,
  "disk_mib": 2048,
  "ip_address": "10.0.0.121",
  "pending_restart": false
}

• •Un argument entièrement numérique est compris comme un identifiant : aw info 17005 rend le même objet que aw info site-vitrine.
• •Un nom inconnu donne un code de sortie 1, et un message dans la langue d'affichage du client : Error: API error (404): VM introuvable pour un client en français, Error: API error (404): vm not found pour un client en anglais.
• •Pour un script, utilisez info : il rend du JSON, que vous découpez sans dépendre de la mise en colonnes.
• •L'adresse IPv6 n'est pas dans list : passez par info si vous la cherchez.

start, stop et delete impriment une ligne par machine, avec le verdict de chacune. set ne modifie rien tant que le serveur n'a pas accepté la demande.

aw shell sert à deux choses très différentes. Par défaut il ouvre la console série de la machine, par WebSocket ; avec --ssh, il ouvre une session SSH. C'est le mode série qui sauve une machine sans réseau : il ne dépend ni du sshd ni de l'adresse IP.

$ echo "" | aw shell site-vitrine --serial
[  OK  ] Reached target Multi-User System.
[  OK  ] Reached target Graphical Interface.
… (la console rejoue le démarrage de la machine, puis rend la main)

La publication expose un port d'une machine sur l'hôte. publish create la crée, publish list montre les publications en cours, publish delete les retire.

$ aw publish create --help
  -H, --host-port int     Host port (auto-assigned if not specified)
  -n, --name string       Publish entry name (required)
      --protocol string   Protocol (tcp/udp) (default "tcp")
  -m, --vm string         VM name (required)
  -p, --vm-port int       VM port (required)

$ aw publish list
No publish entries found.

• •--host-port est facultatif : sans lui, le port de l'hôte est choisi automatiquement.
• •--protocol vaut tcp par défaut, et accepte udp.
• •--name, --vm et --vm-port sont exigés : la commande les réclame si l'un manque.
• •Relisez aw publish list après une création : c'est la liste des publications réellement en place.