aio fn — Function Management

# Deploy a function (most common command)
aio fn deploy my-func
 
# Invoke the function
aio fn invoke my-func --data '{"name": "World"}'

# Deployment
aio fn deploy <name>         # Deploy function (creates if needed)
 
# CRUD Operations
aio fn list                  # List functions
aio fn get <name>            # Get function details
aio fn create <name>         # Create function (metadata only)
aio fn update <name>         # Update function metadata
aio fn delete <name>         # Delete function
 
# Execute Operations
aio fn invoke <name>         # Invoke function
 
# Version Management
aio fn versions <name>       # List versions
aio fn rollback <name>       # Rollback to previous version
 
# Alias Management
aio fn alias list <name>     # List aliases
aio fn alias set <fn> <alias> <ver>  # Set alias
aio fn alias delete <fn> <alias>     # Delete alias
 
# Runtime Info
aio fn runtimes              # List supported runtimes
 
# Observability
aio fn logs <name>           # View logs

aio fn deploy <name> [options]

# Deploy current directory
aio fn deploy my-function
 
# Specify code path
aio fn deploy my-function --code ./src
 
# With runtime and handler
aio fn deploy my-function --runtime python --handler app.handler
 
# With environment variables
aio fn deploy my-function --env "API_KEY=xxx" --env "DEBUG=true"
 
# Deploy without setting latest alias
aio fn deploy my-function --publish=false
 
# Dry run (validate only)
aio fn deploy my-function --dry-run

⠋ Packaging code...
⠋ Uploading (1.2 MB)...
⠋ Creating version...

✓ Function 'my-function' deployed
  TRN:      trn:aionixfn:default:function/my-function
  Version:  v3
  Runtime:  python
  Size:     1.2 MB
  Alias:    latest → v3

aio fn list [--limit N] [--offset N]

NAME              VERSION    STATUS     RUNTIME      UPDATED
────────────────────────────────────────────────────────────────
my-function       v3         ● active   python       2 hours ago
hello-world       v1         ● active   nodejs       5 days ago

Showing 2 of 2 functions

aio fn get <name> [--version VER]

┌─────────────────────────────────────────────────────┐
│ Function: my-function                               │
├─────────────────────────────────────────────────────┤
│ TRN          │ trn:aionixfn:default:function/my-fn  │
│ Status       │ active                               │
│ Runtime      │ python                               │
│ Handler      │ handler.main                         │
│ Memory       │ 128 MB                               │
│ Timeout      │ 30s                                  │
│ Created      │ 2025-01-15 10:30:00                  │
│ Updated      │ 2025-01-20 14:22:10                  │
├─────────────────────────────────────────────────────┤
│ Versions: 3  │ Latest: v3                           │
│ Aliases:  2  │ prod → v3, staging → v2              │
└─────────────────────────────────────────────────────┘

aio fn invoke <name> [options]

# Basic invoke (uses latest alias)
aio fn invoke my-function
 
# With input data
aio fn invoke my-function --data '{"name": "Alice"}'
 
# From file
aio fn invoke my-function --file input.json
 
# Invoke specific version
aio fn invoke my-function --version v2
 
# Invoke via alias
aio fn invoke my-function --alias prod
 
# Async invocation
aio fn invoke my-function --async

✓ Function invoked
  Status: success
  Duration: 120ms

Output:
{
  "message": "Hello, Alice!"
}

aio fn delete <name> [--force] [--keep-logs]

aio fn versions <name> [--limit N]

Versions for: my-function

VERSION    STATUS      CREATED              SIZE
────────────────────────────────────────────────────
v3         ● active    2025-01-20 14:22     1.2 MB
v2         ○ retired   2025-01-15 10:30     1.1 MB
v1         ○ retired   2025-01-10 09:00     1.0 MB

aio fn rollback <name> [--version VER] [--yes]

# Rollback to previous version
aio fn rollback my-function
 
# Rollback to specific version
aio fn rollback my-function --version v2 --yes

aio fn alias list <name>

Aliases for: my-function

ALIAS      VERSION    UPDATED
─────────────────────────────────────
latest     v3         2 hours ago
prod       v3         1 day ago
staging    v2         3 days ago

aio fn alias set <function> <alias> <version> [--traffic "v2:90,v3:10"]

# Set alias
aio fn alias set my-func prod v3
 
# Canary deployment (traffic split)
aio fn alias set my-func prod v3 --traffic "v2:90,v3:10"

aio fn alias delete <function> <alias> [--force]

aio fn runtimes

RUNTIME        STATUS     DEFAULT    NOTES
─────────────────────────────────────────────────────────────
python3.11     stable     ✓          Default Python
python3.12     stable     -          Latest features
nodejs20       stable     ✓          Active LTS
nodejs22       preview    -          Current
deno1          stable     ✓          Latest 1.x

Aliases:
  python  → python3.11
  nodejs  → nodejs20
  deno    → deno1

aio fn logs <name> [options]

def main(event):
    name = event.get("name", "World")
    return {"message": f"Hello, {name}!"}

export async function main(event) {
    const name = event.name || "World";
    return { message: `Hello, ${name}!` };
}

{
  "name": "Alice",
  "data": { "key": "value" },
  "context": {
    "executionId": "exec-abc123",
    "functionName": "my-func",
    "versionId": "v3",
    "invokedAt": "2024-12-03T12:00:00Z"
  }
}

# 1. Deploy function
aio fn deploy my-processor --code ./src --runtime python
 
# 2. Test invoke
aio fn invoke my-processor --data '{"items": [1, 2, 3]}'
 
# 3. Check versions
aio fn versions my-processor
 
# 4. Create production alias
aio fn alias set my-processor prod v1
 
# 5. Deploy new version
aio fn deploy my-processor --code ./src
# Output: Version: v2, Alias: latest → v2
 
# 6. Gradual rollout (canary)
aio fn alias set my-processor prod v2 --traffic "v1:90,v2:10"
 
# 7. Full rollout
aio fn alias set my-processor prod v2
 
# 8. Check logs
aio fn logs my-processor --since 1h
 
# 9. Rollback if needed
aio fn rollback my-processor --version v1 --yes