长期支持版本

    社区创新版本

      http接口

      概述

      rubik对外开放接口均为http接口,当前包括pod优先级设置/更新接口、rubik探活接口和rubik版本号查询接口。

      接口介绍

      设置、更新Pod优先级接口

      rubik提供了设置或更新pod优先级的功能,外部可通过调用该接口发送pod相关信息,rubik根据接收到的pod信息对其设置优先级从而达到资源隔离的目的。接口调用格式为:

      HTTP POST /run/rubik/rubik.sock
      {
          "Pods": {
              "podaaa": {
                  "CgroupPath": "kubepods/burstable/podaaa",
                  "QosLevel": 0
              },
              "podbbb": {
                  "CgroupPath": "kubepods/burstable/podbbb",
                  "QosLevel": -1
              }
          }
      }
      

      Pods 配置中为需要设置或更新优先级的 Pod 信息,每一个http请求至少需要指定配置1个 pod,每个 pod 必须指定CgroupPath 和 QosLevel,其含义如下:

      配置项配置值类型配置取值范围配置含义
      QosLevelint0、-1pod优先级,0表示其为在线业务,-1表示其为离线业务
      CgroupPathstring相对路径对应Pod的cgroup子路径(即其在cgroup子系统下的相对路径)

      接口调用示例如下:

      curl -v -H "Accept: application/json" -H "Content-type: application/json" -X POST --data '{"Pods": {"podaaa": {"CgroupPath": "kubepods/burstable/podaaa","QosLevel": 0},"podbbb": {"CgroupPath": "kubepods/burstable/podbbb","QosLevel": -1}}}' --unix-socket /run/rubik/rubik.sock http://localhost/
      

      探活接口

      rubik作为HTTP服务,提供探活接口用于帮助判断rubik是否处于运行状态。

      接口形式:HTTP/GET /ping

      接口调用示例如下:

      curl -XGET --unix-socket /run/rubik/rubik.sock http://localhost/ping
      

      若返回ok则代表rubik服务处于运行状态。

      版本信息查询接口

      rubik支持通过HTTP请求查询当前rubik的版本号。

      接口形式:HTTP/GET /version

      接口调用示例如下:

      curl -XGET --unix-socket /run/rubik/rubik.sock http://localhost/version
      {"Version":"0.0.1","Release":"1","Commit":"29910e6","BuildTime":"2021-05-12"}
      

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份