科莫多技能

通过科莫多核心API管理服务器、Docker容器、堆栈、构建和流程。

先决条件

设置环境变量：

• KOMODO_ADDRESS- 科莫多核心URL（例如，https://komodo.example.com）
• KOMODO_API_KEY- API密钥（以K-开头）
• KOMODO_API_SECRET- API密钥（以S-开头）

快速参考

# Set env (or source from credentials file)
export KOMODO_ADDRESS="https://komodo.weird.cyou"
export KOMODO_API_KEY="K-..."
export KOMODO_API_SECRET="S-..."

# List resources
python scripts/komodo.py servers
python scripts/komodo.py deployments
python scripts/komodo.py stacks
python scripts/komodo.py builds
python scripts/komodo.py procedures
python scripts/komodo.py repos

# Server operations
python scripts/komodo.py server <name>
python scripts/komodo.py server-stats <name>

# Deployment operations
python scripts/komodo.py deployment <name>
python scripts/komodo.py deploy <name>
python scripts/komodo.py start <name>
python scripts/komodo.py stop <name>
python scripts/komodo.py restart <name>
python scripts/komodo.py logs <name> [lines]

# Stack operations
python scripts/komodo.py stack <name>
python scripts/komodo.py deploy-stack <name>
python scripts/komodo.py start-stack <name>
python scripts/komodo.py stop-stack <name>
python scripts/komodo.py restart-stack <name>
python scripts/komodo.py create-stack <name> <server> <compose.yml> [env_file]
python scripts/komodo.py delete-stack <name>
python scripts/komodo.py stack-logs <name> [service]

# Build operations
python scripts/komodo.py build <name>
python scripts/komodo.py run-build <name>

# Procedure operations
python scripts/komodo.py procedure <name>
python scripts/komodo.py run-procedure <name>

状态指示器

• 🟢 运行中/正常
• 🔴 已停止
• ⚪ 未部署
• 🟡 不健康
• 🔄 重启中
• 🔨 构建中
• ⏳ 等待中

直接调用API

对于命令行工具未涵盖的操作，请使用curl：

# Read operation
curl -X POST "$KOMODO_ADDRESS/read/ListServers" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KOMODO_API_KEY" \
  -H "X-Api-Secret: $KOMODO_API_SECRET" \
  -d '{}'

# Execute operation
curl -X POST "$KOMODO_ADDRESS/execute/Deploy" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KOMODO_API_KEY" \
  -H "X-Api-Secret: $KOMODO_API_SECRET" \
  -d '{"deployment": "my-deployment"}'

API参考

读取端点：ListServers,ListDeployments,ListStacks,ListBuilds,ListProcedures,ListRepos,GetSystemStats,GetLog

执行端点：Deploy,StartDeployment,StopDeployment,RestartDeployment,部署堆栈,启动堆栈,停止堆栈,重启堆栈,运行构建,运行流程

完整 API 文档：https://komo.do/docs