Fugoku CLI

The Fugoku CLI is a command-line tool for managing your infrastructure from the terminal.

Coming Soon

The CLI is currently under development. In the meantime, use the REST API to manage your infrastructure programmatically.

Overview

The Fugoku CLI provides a fast, scriptable way to manage your infrastructure from the terminal. It wraps the Fugoku API and provides convenient commands for common operations.

Installation

Installation instructions will be available when the CLI is released.

Authentication

The CLI will support API key authentication via environment variable (FUGOKU_API_TOKEN) or interactive login.

Commands

The following commands are planned for the CLI:

Compute

fugoku instances list — List virtual machine instances
fugoku create instance — Create a virtual machine instance
fugoku instances delete — Delete an instance
fugoku instances start — Start an instance
fugoku instances stop — Stop an instance
fugoku instances reboot — Reboot an instance
fugoku instances rebuild — Reinstall OS on an instance
fugoku instances upgrade — Change instance plan
fugoku instances stats — View instance metrics
fugoku instances get — Get instance details
fugoku servers list — List bare metal servers
fugoku create server — Create a bare metal server
fugoku servers delete — Delete a server
fugoku servers start — Start a server
fugoku servers stop — Stop a server
fugoku servers reboot — Reboot a server
fugoku servers rebuild — Reinstall OS on a server
fugoku servers upgrade — Change server plan
fugoku servers stats — View server metrics (including hardware health)
fugoku servers get — Get server details (including hardware health)

Storage

fugoku volumes list — List volumes
fugoku volumes create — Create a volume
fugoku volumes attach — Attach a volume to a server
fugoku volumes detach — Detach a volume

Networking

fugoku networks list — List private networks
fugoku networks create — Create a network
fugoku eips list — List elastic IPs
fugoku eips create — Reserve a new elastic IP
fugoku eips assign — Assign an elastic IP to an instance or load balancer
fugoku eips move — Move an elastic IP to a different target
fugoku eips delete — Release an elastic IP

SSH Keys

fugoku ssh-keys list — List SSH keys
fugoku ssh-keys add — Add an SSH key
fugoku ssh-keys delete — Delete an SSH key
fugoku ssh <instance> — SSH into an instance

Backups

fugoku snapshots enable — Enable automatic snapshots for an instance or volume
fugoku snapshots create — Create a snapshot
fugoku snapshots restore — Restore a snapshot
fugoku snapshots copy — Copy a snapshot to another region
fugoku snapshots list — List snapshots
fugoku snapshots delete — Delete a snapshot

Alerts

fugoku alerts create — Create a monitoring alert
fugoku alerts list — List alerts
fugoku alerts delete — Delete an alert

Other

fugoku plans list — List available plans
fugoku regions list — List available regions
fugoku images list — List available images

Using the API Today

While the CLI is not yet available, you can use the REST API directly:

# List servers
curl https://api.fugoku.com/v1/instances \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

# Create an instance
curl -X POST https://api.fugoku.com/v1/instances \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "instances",
      "attributes": {
        "name": "web-1",
        "site": "lagos-1",
        "plan": "g-vm-2-4-80",
        "operating_system": "ubuntu-22.04",
        "billing": "hourly"
      }
    }
  }'

See the API Reference for full documentation.

CLI Tool