Exécution à distance

actrun permet d’exécuter des graphs sans installation locale.

Démarrage rapide

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- <file-or-url> [options]

Comment ça fonctionne

Le script actrun.sh effectue les étapes suivantes :

1. Détecte votre plateforme — OS (Linux, macOS, Windows) et architecture (x64, arm64).
2. Récupère la dernière version — Interroge l’API Actionforge pour obtenir la dernière release stable.
3. Met en cache le binaire — Télécharge et extrait le binaire actrun dans ~/.cache/actrun/. Les exécutions suivantes sautent le téléchargement.
4. Exécute votre graph — Passe tous les arguments au binaire mis en cache.

Exécuter un graph local

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- my_graph.act

Exécuter un graph partagé

Les graphs partagés sont hébergés sur Actionforge et peuvent être exécutés directement par URL. Le format de l’URL est :

https://app.actionforge.dev/shared/<id>.act

curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- https://app.actionforge.dev/shared/divine-fog-f9cc9408.act

Quand une URL partagée est détectée, le script récupère le contenu du graph depuis l’API Actionforge et le passe à actrun comme fichier temporaire.

Note : Vous pouvez aussi passer des URLs de graphs partagés directement à actrun si vous l’avez installé localement :

actrun https://app.actionforge.dev/shared/divine-fog-f9cc9408.act

Passer des flags

Les arguments après le fichier graph (ou l’URL) sont passés directement au graph en tant qu’inputs.

# Passer des flags au graph
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- my_graph.act --my-flag=test --count=5

# Passer des flags actrun avant le fichier graph
curl -fsSL https://www.actionforge.dev/actrun.sh | bash -s -- --env-file=.env my_graph.act --my-flag=test

Note : La partie bash -s -- est requise. bash -s lit le script depuis stdin, et -- sépare les options propres à bash des arguments passés au script.

Plateformes supportées

OS	Architecture	Package Format
Linux	x64, arm64	.tar.gz
macOS	x64, arm64	.pkg
Windows (MINGW/MSYS/Cygwin)	x64, arm64	.zip

Mise en cache

Le binaire est mis en cache dans ~/.cache/actrun/<version>/actrun. Quand une nouvelle version est publiée, le script la télécharge automatiquement. Les versions précédentes ne sont pas supprimées.

Code source

Le script de bootstrap est disponible sur github.com/actionforge/actrun-cli/blob/main/actrun.sh .