用途:使用 kestractl 完成 Kestra 环境的日常运维,包括流程的列出、查看、校验与部署,触发执行并查看状态,管理命名空间及命名空间文件(nsfiles),以及配置或切换 Kestra CLI 上下文。
主要能力与命令:流程方面可用 kestractl flows list/get/validate/deploy;执行方面可用 kestractl executions run --wait 与 executions get;命名空间用 kestractl namespaces list;命名空间文件用 kestractl nsfiles list/get/upload/delete。配置示例:kestractl config add dev http://localhost:8080 main --token DEV_TOKEN、kestractl config use dev、kestractl config show。
配置优先级:命令行标志(--host、--tenant、--token、--output)高于环境变量(KESTRACTL_HOST、KESTRACTL_TENANT、KESTRACTL_TOKEN、KESTRACTL_OUTPUT),再高于配置文件 ~/.kestractl/config.yaml,最后是内置默认值。
使用方式:先确认目标上下文,先做只读发现,部署前先校验,执行时显式传参,必要时用 --wait 验证结果,最后输出简洁运维报告。
限制与注意:写操作(部署、上传、删除)前需确认生产上下文;优先先 validate 再 deploy;自动化建议用 --output json;共享日志中避免 --verbose 以防泄露凭据;破坏性 nsfiles 操作需确认路径范围并谨慎使用 --force。Kestra 1.3 到 2.0 迁移应改用 migrate-kestra-2 技能,未安装时可用 npx skills add kestra-io/agent-skills@migrate-kestra-2 安装后委派。