mirror of
https://github.com/OpenRouterTeam/spawn.git
synced 2026-06-01 22:59:54 +00:00
fc34a640bd
Add Atlantic.Net Cloud as a new cloud provider with REST API support. Starting at $4-8/mo for budget VPS instances with SSH access. Implementation: - Created atlanticnet/lib/common.sh with HMAC-SHA256 API auth - Implemented 3 agent scripts: claude.sh, aider.sh, openclaw.sh - Updated manifest.json with cloud entry and 15 matrix entries - Added test coverage in test/record.sh and test/mock.sh - Created atlanticnet/README.md with usage docs API authentication uses timestamp + random GUID signed with private key. Defaults: G2.2GB plan, ubuntu-24.04_64bit image, USEAST2 location. Agent: cloud-scout-1 Co-authored-by: B (Discovery Team) <6723574+louisgv@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
336 lines
10 KiB
Bash
336 lines
10 KiB
Bash
#!/bin/bash
|
|
set -eo pipefail
|
|
# Common bash functions for Atlantic.Net Cloud spawn scripts
|
|
|
|
# ============================================================
|
|
# Provider-agnostic functions
|
|
# ============================================================
|
|
|
|
# Source shared provider-agnostic functions (local or remote fallback)
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd)"
|
|
if [[ -n "$SCRIPT_DIR" && -f "$SCRIPT_DIR/../../shared/common.sh" ]]; then
|
|
source "$SCRIPT_DIR/../../shared/common.sh"
|
|
else
|
|
eval "$(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/shared/common.sh)"
|
|
fi
|
|
|
|
# Note: Provider-agnostic functions (logging, OAuth, browser, nc_listen) are now in shared/common.sh
|
|
|
|
# ============================================================
|
|
# Atlantic.Net Cloud specific functions
|
|
# ============================================================
|
|
|
|
readonly ATLANTICNET_API_BASE="https://cloudapi.atlantic.net"
|
|
readonly ATLANTICNET_API_VERSION="2010-12-30"
|
|
|
|
# Generate HMAC-SHA256 signature for Atlantic.Net API
|
|
# Args: timestamp rndguid
|
|
atlanticnet_sign() {
|
|
local timestamp="$1"
|
|
local rndguid="$2"
|
|
local private_key="${ATLANTICNET_API_PRIVATE_KEY}"
|
|
|
|
local string_to_sign="${timestamp}${rndguid}"
|
|
printf '%s' "$string_to_sign" | openssl dgst -sha256 -hmac "$private_key" -binary | base64 -w 0
|
|
}
|
|
|
|
# Generate random GUID for request deduplication
|
|
atlanticnet_generate_guid() {
|
|
python3 -c "import uuid; print(str(uuid.uuid4()))"
|
|
}
|
|
|
|
# URL encode a string
|
|
url_encode() {
|
|
python3 -c "import sys, urllib.parse; print(urllib.parse.quote(sys.argv[1], safe=''))" "$1"
|
|
}
|
|
|
|
# Centralized API wrapper for Atlantic.Net Cloud API
|
|
# Args: action [param1 value1 param2 value2 ...]
|
|
atlanticnet_api() {
|
|
local action="$1"; shift
|
|
|
|
check_python_available || return 1
|
|
|
|
local timestamp
|
|
timestamp=$(date +%s)
|
|
local rndguid
|
|
rndguid=$(atlanticnet_generate_guid)
|
|
local signature
|
|
signature=$(atlanticnet_sign "$timestamp" "$rndguid")
|
|
local encoded_signature
|
|
encoded_signature=$(url_encode "$signature")
|
|
|
|
# Build query string
|
|
local query="Action=$action"
|
|
query="${query}&Format=json"
|
|
query="${query}&Version=${ATLANTICNET_API_VERSION}"
|
|
query="${query}&ACSAccessKeyId=${ATLANTICNET_API_KEY}"
|
|
query="${query}&Timestamp=${timestamp}"
|
|
query="${query}&Rndguid=${rndguid}"
|
|
query="${query}&Signature=${encoded_signature}"
|
|
|
|
# Add optional parameters
|
|
while [[ $# -gt 0 ]]; do
|
|
local param="$1"; shift
|
|
local value="$1"; shift
|
|
local encoded_value
|
|
encoded_value=$(url_encode "$value")
|
|
query="${query}&${param}=${encoded_value}"
|
|
done
|
|
|
|
# Make API request
|
|
curl -fsSL "${ATLANTICNET_API_BASE}/?${query}"
|
|
}
|
|
|
|
# Test API credentials
|
|
test_atlanticnet_credentials() {
|
|
local response
|
|
response=$(atlanticnet_api describe-plan planname G2.2GB 2>&1) || {
|
|
log_error "Failed to connect to Atlantic.Net API"
|
|
return 1
|
|
}
|
|
|
|
if echo "$response" | grep -qi '"error"'; then
|
|
log_error "API Error: Invalid credentials"
|
|
log_error ""
|
|
log_error "How to fix:"
|
|
log_error " 1. Verify your API credentials at: https://cloud.atlantic.net/ → API Info"
|
|
log_error " 2. Ensure both API Key and API Private Key are correct"
|
|
log_error " 3. Check that your API access is enabled"
|
|
return 1
|
|
fi
|
|
return 0
|
|
}
|
|
|
|
# Ensure Atlantic.Net API credentials are available
|
|
ensure_atlanticnet_credentials() {
|
|
local config_file="$HOME/.config/spawn/atlanticnet.json"
|
|
|
|
# Try environment variables first
|
|
if [[ -n "${ATLANTICNET_API_KEY:-}" && -n "${ATLANTICNET_API_PRIVATE_KEY:-}" ]]; then
|
|
if test_atlanticnet_credentials; then
|
|
return 0
|
|
fi
|
|
log_warn "Environment variables set but authentication failed"
|
|
fi
|
|
|
|
# Try config file
|
|
if [[ -f "$config_file" ]]; then
|
|
log_step "Loading Atlantic.Net credentials from $config_file"
|
|
ATLANTICNET_API_KEY=$(python3 -c "import json,sys; print(json.load(open(sys.argv[1])).get('api_key',''))" "$config_file")
|
|
ATLANTICNET_API_PRIVATE_KEY=$(python3 -c "import json,sys; print(json.load(open(sys.argv[1])).get('api_private_key',''))" "$config_file")
|
|
export ATLANTICNET_API_KEY ATLANTICNET_API_PRIVATE_KEY
|
|
|
|
if [[ -n "${ATLANTICNET_API_KEY}" && -n "${ATLANTICNET_API_PRIVATE_KEY}" ]]; then
|
|
if test_atlanticnet_credentials; then
|
|
return 0
|
|
fi
|
|
log_warn "Saved credentials are invalid"
|
|
fi
|
|
fi
|
|
|
|
# Prompt for credentials
|
|
log_info ""
|
|
log_info "Atlantic.Net Cloud API credentials required"
|
|
log_info ""
|
|
log_info "Get your credentials at: https://cloud.atlantic.net/ → API Info"
|
|
log_info ""
|
|
|
|
ATLANTICNET_API_KEY=$(safe_read "API Access Key ID: ")
|
|
ATLANTICNET_API_PRIVATE_KEY=$(safe_read "API Private Key: ")
|
|
export ATLANTICNET_API_KEY ATLANTICNET_API_PRIVATE_KEY
|
|
|
|
log_step "Testing credentials..."
|
|
if ! test_atlanticnet_credentials; then
|
|
log_error "Invalid credentials"
|
|
return 1
|
|
fi
|
|
|
|
log_info "Credentials valid!"
|
|
|
|
# Save to config file
|
|
mkdir -p "$(dirname "$config_file")"
|
|
python3 -c "import json,sys; json.dump({'api_key': sys.argv[1], 'api_private_key': sys.argv[2]}, open(sys.argv[3], 'w'), indent=2)" \
|
|
"$ATLANTICNET_API_KEY" "$ATLANTICNET_API_PRIVATE_KEY" "$config_file"
|
|
chmod 600 "$config_file"
|
|
log_info "Credentials saved to $config_file"
|
|
|
|
return 0
|
|
}
|
|
|
|
# Check if SSH key is registered with Atlantic.Net
|
|
# Args: fingerprint
|
|
atlanticnet_check_ssh_key() {
|
|
local fingerprint="$1"
|
|
local response
|
|
response=$(atlanticnet_api list-sshkeys)
|
|
|
|
if echo "$response" | grep -q "$fingerprint"; then
|
|
return 0
|
|
fi
|
|
return 1
|
|
}
|
|
|
|
# Register SSH key with Atlantic.Net
|
|
# Args: key_name pub_path
|
|
atlanticnet_register_ssh_key() {
|
|
local key_name="$1"
|
|
local pub_path="$2"
|
|
local pub_key
|
|
pub_key=$(cat "$pub_path")
|
|
|
|
log_step "Registering SSH key with Atlantic.Net..."
|
|
local response
|
|
response=$(atlanticnet_api add-sshkey ssh_key_name "$key_name" ssh_key "$pub_key")
|
|
|
|
if echo "$response" | grep -qi '"error"'; then
|
|
log_error "Failed to register SSH key"
|
|
log_error "Response: $response"
|
|
return 1
|
|
fi
|
|
|
|
log_info "SSH key registered"
|
|
return 0
|
|
}
|
|
|
|
# Ensure SSH key exists locally and is registered with Atlantic.Net
|
|
ensure_ssh_key() {
|
|
ensure_ssh_key_with_provider atlanticnet_check_ssh_key atlanticnet_register_ssh_key "Atlantic.Net"
|
|
}
|
|
|
|
# Get server name from env var or prompt
|
|
get_server_name() {
|
|
get_validated_server_name "ATLANTICNET_SERVER_NAME" "Enter server name: "
|
|
}
|
|
|
|
# Get plan name from env var or use default
|
|
get_plan_name() {
|
|
local default="${1:-G2.2GB}"
|
|
if [[ -n "${ATLANTICNET_PLAN:-}" ]]; then
|
|
echo "$ATLANTICNET_PLAN"
|
|
else
|
|
echo "$default"
|
|
fi
|
|
}
|
|
|
|
# Get image ID from env var or use default
|
|
get_image_id() {
|
|
local default="${1:-ubuntu-24.04_64bit}"
|
|
if [[ -n "${ATLANTICNET_IMAGE:-}" ]]; then
|
|
echo "$ATLANTICNET_IMAGE"
|
|
else
|
|
echo "$default"
|
|
fi
|
|
}
|
|
|
|
# Get location from env var or use default
|
|
get_location() {
|
|
local default="${1:-USEAST2}"
|
|
if [[ -n "${ATLANTICNET_LOCATION:-}" ]]; then
|
|
echo "$ATLANTICNET_LOCATION"
|
|
else
|
|
echo "$default"
|
|
fi
|
|
}
|
|
|
|
# Create Atlantic.Net Cloud Server
|
|
# Args: server_name
|
|
create_server() {
|
|
local name="$1"
|
|
local plan_name
|
|
plan_name=$(get_plan_name)
|
|
local image_id
|
|
image_id=$(get_image_id)
|
|
local location
|
|
location=$(get_location)
|
|
|
|
log_step "Creating Atlantic.Net Cloud Server '$name'..."
|
|
log_step " Plan: $plan_name"
|
|
log_step " Image: $image_id"
|
|
log_step " Location: $location"
|
|
|
|
# Get SSH key name (use the spawn key)
|
|
local ssh_key_name="spawn-$(hostname)-ed25519"
|
|
|
|
local response
|
|
response=$(atlanticnet_api run-instance \
|
|
server_name "$name" \
|
|
planname "$plan_name" \
|
|
imageid "$image_id" \
|
|
vm_location "$location" \
|
|
ServerQty 1 \
|
|
key_id "$ssh_key_name")
|
|
|
|
if echo "$response" | grep -qi '"error"'; then
|
|
log_error "Failed to create server"
|
|
log_error "Response: $response"
|
|
return 1
|
|
fi
|
|
|
|
# Extract instance ID and IP
|
|
local instance_id
|
|
instance_id=$(echo "$response" | python3 -c "import json,sys; data=json.load(sys.stdin); print(data.get('run-instanceresponse',{}).get('instancesSet',{}).get('item',{}).get('instanceid',''))")
|
|
|
|
local ip_address
|
|
ip_address=$(echo "$response" | python3 -c "import json,sys; data=json.load(sys.stdin); print(data.get('run-instanceresponse',{}).get('instancesSet',{}).get('item',{}).get('ip_address',''))")
|
|
|
|
if [[ -z "$instance_id" || -z "$ip_address" ]]; then
|
|
log_error "Failed to parse server details from response"
|
|
return 1
|
|
fi
|
|
|
|
# Export for use by agent scripts
|
|
ATLANTICNET_SERVER_ID="$instance_id"
|
|
ATLANTICNET_SERVER_IP="$ip_address"
|
|
export ATLANTICNET_SERVER_ID ATLANTICNET_SERVER_IP
|
|
|
|
log_info "Server created: ID=$ATLANTICNET_SERVER_ID, IP=$ATLANTICNET_SERVER_IP"
|
|
}
|
|
|
|
# SSH operations — delegates to shared helpers (SSH_USER defaults to root)
|
|
verify_server_connectivity() { ssh_verify_connectivity "$@"; }
|
|
run_server() { ssh_run_server "$@"; }
|
|
upload_file() { ssh_upload_file "$@"; }
|
|
interactive_session() { ssh_interactive_session "$@"; }
|
|
|
|
# Delete Atlantic.Net Cloud Server
|
|
# Args: instance_id
|
|
destroy_server() {
|
|
local instance_id="$1"
|
|
|
|
log_step "Destroying server $instance_id..."
|
|
atlanticnet_api terminate-instance instanceid "$instance_id"
|
|
log_info "Server $instance_id destroyed"
|
|
}
|
|
|
|
# Get available plans
|
|
get_available_plans() {
|
|
local response
|
|
response=$(atlanticnet_api describe-plan)
|
|
echo "$response" | python3 -c "
|
|
import json, sys
|
|
data = json.load(sys.stdin)
|
|
plans = data.get('describe-planresponse', {}).get('plans', {}).get('item', [])
|
|
if isinstance(plans, dict):
|
|
plans = [plans]
|
|
for plan in plans:
|
|
name = plan.get('planname', '')
|
|
ram = plan.get('ram', '')
|
|
cpu = plan.get('processor', '')
|
|
disk = plan.get('disk_size', '')
|
|
bandwidth = plan.get('bandwidth', '')
|
|
price = plan.get('price', '')
|
|
print(f'{name}|{cpu} CPU|{ram} RAM|{disk} disk|{bandwidth} bandwidth|\${price}/mo')
|
|
"
|
|
}
|
|
|
|
# Get available locations
|
|
get_available_locations() {
|
|
cat << 'EOF'
|
|
USEAST1|Ashburn, VA|USA
|
|
USEAST2|Orlando, FL|USA
|
|
USCENTRAL1|Dallas, TX|USA
|
|
USWEST1|San Francisco, CA|USA
|
|
CAEAST1|Toronto, ON|Canada
|
|
EOF
|
|
}
|