Interacting with Fireactions via CLI
Fireactions provides a CLI for interacting with the server.
$ fireactions --help
BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure Firecracker based virtual machines.
Usage:
fireactions [command]
Main application commands:
runner Starts the virtual machine runner. This command should be run inside the virtual machine.
server Start the server
Pool management commands:
resume Resume a paused pool, enabling it to scale up again
pause Pause a pool, preventing it from scaling up
scale Scale a pool to specified number of replicas
show Retrieve a specific pool by name
list List all pools
Additional Commands:
reload Reload the server with the latest configuration (no downtime)
Flags:
-e, --endpoint string Endpoint to use for communicating with the Fireactions API. (default "http://127.0.0.1:8080")
-u, --username string Username to use for authenticating with the Fireactions API.
-p, --password string Password to use for authenticating with the Fireactions API.
-h, --help help for fireactions
-v, --version version for fireactions
Use "fireactions [command] --help" for more information about a command.
Authentication
If the Fireactions server is configured with basic authentication, user must include the username and password using the --username
and --password
flags.
Commands
runner
Starts the virtual machine runner. This command should be run inside the virtual machine.
server
Starts the server.
resume <NAME>
Resume a paused pool, enabling it to scale up again.
pause <NAME>
Pause a pool, preventing it from scaling up.
scale <NAME> [--replicas=<REPLICAS>]
Scale a pool to specified number of replicas.
show <NAME>
Retrieve a specific pool by name.
list
List all pools.
reload
Reload the server with the latest configuration (no downtime).