SuperAPI AI 工具集

bk-cli-paas

通用与其它

查看项目

更新于 10-16 08:45

技能介绍

用途:通过 bk-cli paas 调用蓝鲸 PaaS 应用、模块、部署、日志、进程、环境变量和增强服务相关接口,并支持创建云原生应用或模块、触发多模块部署。

开始前必须先用 Read 工具读取 ../bk-cli-shared/SKILL.md,共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 与通用请求规则;本 skill 只补充 paas 命令的语义与输入约定。这些接口要求应用认证 + 用户认证 + 接口资源权限。应用 ID 用 PaaS 应用 app_code,部分接口按上游参数名使用 code;模块未指定时通常为 default;环境参数为 env 或 environment,常见 stag、prod,写操作默认先用 stag。

主要能力:get_minimal_app_list、get_app_info、list_app_modules、get_repo_branches、get_deployments_list、streams_history_events、list_processes、module_env_released_info、module_env_released_state、search_standard_log_with_post、create_module、get_deployment_result、deploy_with_module、create_cloud_native_app、list_config_vars、get_config_var、set_config_var_value、list_module_services、bind_service、get_service_instance_by_module、unbind_service。

用法:部署前用 get_minimal_app_list 定位应用、get_app_info 确认类型、list_app_modules 确认模块、get_repo_branches 取 name/type/revision 填入 deploy_with_module 的 --body;部署后用 get_deployments_list 找任务、streams_history_events 看日志。复杂请求体通过共享 --body '<json>' 传入,可运行 bk-cli paas <action> -h --body-schema 查看结构。

限制:streams_history_events 有频控,约每用户 60 秒 10 次,不要 tight loop;纯镜像应用没有仓库,相关错误应改走镜像部署路径;从未发布过时上游可能返回 APP_NOT_RELEASED;敏感变量值可能被掩码;解绑等写操作真实执行前建议先加 --dry-run。