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 Bearer token authentication via environment variable or interactive login.

Commands

The following commands are planned for the CLI:

Compute

fugoku servers list — List servers (bare metal and virtual machines)
fugoku servers create — Create a new server
fugoku servers get — Get server details
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 upgrade — Change server plan

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 floating-ips list — List elastic IPs
fugoku floating-ips create — Create 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

Backups

fugoku backups list — List backups
fugoku backups create — Create a backup
fugoku backups restore — Restore a backup
fugoku backups delete — Delete a backup

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/servers \
  -H "Authorization: Bearer $FUGOKU_API_TOKEN"

# Create a server
curl -X POST https://api.fugoku.com/v1/servers \
  -H "Authorization: Bearer $FUGOKU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "servers",
      "attributes": {
        "name": "web-1",
        "site": "lagos-1",
        "plan": "vm-standard",
        "operating_system": "ubuntu-22.04",
        "billing": "hourly",
        "role": "VirtualMachine"
      }
    }
  }'

See the API Reference for full documentation.

CLI Tool