差异化更新集群的状态
请求信息
请求行
PATCH /apis/platform.tkestack.io/v1/clusters/{name}/status
差异化更新指定的集群的状态。
请求行参数
| 名称 | 类型 | 是否必填项 | 描述 |
|---|---|---|---|
| name | string | 是 | 集群的名称。 |
请求参数
| 名称 | 类型 | 是否必填项 | 描述 |
|---|---|---|---|
| dryRun | string | 否 | 当该参数出现时,表示不应该持久化修改。一个无效的或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:All,将处理所有的试运行阶段。 |
| fieldManager | string | 否 | fieldManager 是与进行这些更改的角色或实体相关联的名称。 该值必须少于或少于 128 个字符,并且只能包含可打印的字符。 |
| force | boolean | 否 | Force 将“强制”应用请求。 这意味着用户将重新获取其他人拥有的冲突字段。 对于未应用的 PATCH 请求,必须取消设置强制标志。 |
| pretty | string | 否 | 如果为 true,则会将返回结果输出成适合打印的格式。 |
请求体
Content-Type
application/json-patch+json,
application/merge-patch+json,
application/strategic-merge-patch+json,
application/apply-patch+yaml
请求体示例
Patch 方法,为了给 Kubernetes Patch 请求体一个具体的名称和类型。
{
"addresses": [
{
"host": "192.168.16.53",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.54",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.55",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.52",
"path": "",
"port": 6443,
"type": "Advertise"
}
],
"clusterCIDR": "10.199.0.0/16",
"conditions": [
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsureCopyFiles"
},
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePreClusterInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePreInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:14:42Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePrepareNode"
},
{
"lastProbeTime": "2021-09-12T05:14:42Z",
"lastTransitionTime": "2021-09-12T05:14:42Z",
"status": "True",
"type": "EnsureClusterComplete"
},
{
"lastProbeTime": "2021-09-12T05:15:27Z",
"lastTransitionTime": "2021-09-12T05:14:42Z",
"status": "True",
"type": "EnsureContainerRuntime"
},
{
"lastProbeTime": "2021-09-12T05:16:13Z",
"lastTransitionTime": "2021-09-12T05:15:27Z",
"status": "True",
"type": "EnsureKubeNode"
},
{
"lastProbeTime": "2021-09-12T05:16:13Z",
"lastTransitionTime": "2021-09-12T05:16:13Z",
"status": "True",
"type": "EnsureNodeHostname"
},
{
"lastProbeTime": "2021-09-12T05:17:09Z",
"lastTransitionTime": "2021-09-12T05:16:13Z",
"status": "True",
"type": "EnsureInitMaster"
},
{
"lastProbeTime": "2021-09-12T05:17:11Z",
"lastTransitionTime": "2021-09-12T05:17:09Z",
"status": "True",
"type": "EnsureStoreCredential"
},
{
"lastProbeTime": "2021-09-12T05:17:12Z",
"lastTransitionTime": "2021-09-12T05:17:11Z",
"status": "True",
"type": "EnsureKubeconfig"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:17:12Z",
"status": "True",
"type": "EnsureJoin"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureCreateClusterMark"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureCleanupScript"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"message": "Skip current condition",
"reason": "Skip",
"status": "True",
"type": "EnsureCNI"
},
{
"lastProbeTime": "2021-09-12T05:20:27Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureUpdateCISConfiguration"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:27Z",
"status": "True",
"type": "EnsureRenewCertsService"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsurePostInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsurePostClusterInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsureCleanupCluster"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsureWaitClusterModuleReady"
},
{
"lastProbeTime": "2021-10-12T03:41:07Z",
"lastTransitionTime": "2021-09-12T05:23:51Z",
"status": "True",
"type": "HealthCheck"
}
],
"dnsIP": "10.96.0.10",
"nodeCIDRMaskSize": 24,
"phase": "Running",
"resource": {},
"serviceCIDR": "10.96.0.0/12",
"version": "1.21.2"
}返回信息
Content-Type
application/json,
application/yaml,
application/vnd.kubernetes.protobuf
状态码: 200
OK
返回体示例
Kubernetes 集群。
{
"addresses": [
{
"host": "192.168.16.53",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.54",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.55",
"path": "",
"port": 6443,
"type": "Real"
},
{
"host": "192.168.16.52",
"path": "",
"port": 6443,
"type": "Advertise"
}
],
"clusterCIDR": "10.199.0.0/16",
"conditions": [
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsureCopyFiles"
},
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePreClusterInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:14:34Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePreInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:14:42Z",
"lastTransitionTime": "2021-09-12T05:14:34Z",
"status": "True",
"type": "EnsurePrepareNode"
},
{
"lastProbeTime": "2021-09-12T05:14:42Z",
"lastTransitionTime": "2021-09-12T05:14:42Z",
"status": "True",
"type": "EnsureClusterComplete"
},
{
"lastProbeTime": "2021-09-12T05:15:27Z",
"lastTransitionTime": "2021-09-12T05:14:42Z",
"status": "True",
"type": "EnsureContainerRuntime"
},
{
"lastProbeTime": "2021-09-12T05:16:13Z",
"lastTransitionTime": "2021-09-12T05:15:27Z",
"status": "True",
"type": "EnsureKubeNode"
},
{
"lastProbeTime": "2021-09-12T05:16:13Z",
"lastTransitionTime": "2021-09-12T05:16:13Z",
"status": "True",
"type": "EnsureNodeHostname"
},
{
"lastProbeTime": "2021-09-12T05:17:09Z",
"lastTransitionTime": "2021-09-12T05:16:13Z",
"status": "True",
"type": "EnsureInitMaster"
},
{
"lastProbeTime": "2021-09-12T05:17:11Z",
"lastTransitionTime": "2021-09-12T05:17:09Z",
"status": "True",
"type": "EnsureStoreCredential"
},
{
"lastProbeTime": "2021-09-12T05:17:12Z",
"lastTransitionTime": "2021-09-12T05:17:11Z",
"status": "True",
"type": "EnsureKubeconfig"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:17:12Z",
"status": "True",
"type": "EnsureJoin"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureCreateClusterMark"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureCleanupScript"
},
{
"lastProbeTime": "2021-09-12T05:19:58Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"message": "Skip current condition",
"reason": "Skip",
"status": "True",
"type": "EnsureCNI"
},
{
"lastProbeTime": "2021-09-12T05:20:27Z",
"lastTransitionTime": "2021-09-12T05:19:58Z",
"status": "True",
"type": "EnsureUpdateCISConfiguration"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:27Z",
"status": "True",
"type": "EnsureRenewCertsService"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsurePostInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsurePostClusterInstallHook"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsureCleanupCluster"
},
{
"lastProbeTime": "2021-09-12T05:20:29Z",
"lastTransitionTime": "2021-09-12T05:20:29Z",
"status": "True",
"type": "EnsureWaitClusterModuleReady"
},
{
"lastProbeTime": "2021-10-12T03:41:07Z",
"lastTransitionTime": "2021-09-12T05:23:51Z",
"status": "True",
"type": "HealthCheck"
}
],
"dnsIP": "10.96.0.10",
"nodeCIDRMaskSize": 24,
"phase": "Running",
"resource": {},
"serviceCIDR": "10.96.0.0/12",
"version": "1.21.2"
}返回体说明
| 名称 | 类型 | 描述 |
|---|---|---|
| apiVersion | string | 查看公共参数 |
| kind | string | 查看公共参数 |
| metadata | object | 查看公共参数 |
| spec | object |
集群的描述。
字段路径:spec |
| spec.apiServerExtraArgs | object |
api server的扩展参数。
字段路径:spec.apiServerExtraArgs |
| spec.clusterCIDR | string |
容器网络的子网地址(CIDR 格式),例如:10.1.0.0/16,该地址应与节点子网不同。集群创建时的 Pod 可使用该网段内的 IP。
字段路径:spec.clusterCIDR |
| spec.clusterCredentialRef | object |
LocalObjectReference 包含了足够多的从相同的命名空间中下载参考对象的信息。
字段路径:spec.clusterCredentialRef |
| clusterCredentialRef.name | string |
引用对象的名称。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
字段路径:spec.clusterCredentialRef.name |
| spec.controllerManagerExtraArgs | object |
Controller Manager 额外的配置参数。
字段路径:spec.controllerManagerExtraArgs |
| spec.displayName | string |
集群的显示名称。
字段路径:spec.displayName |
| spec.dnsDomain | string |
DNSDomain 是被 k8s Service 使用的 DNS 域名。默认为 "cluster.local"。
字段路径:spec.dnsDomain |
| spec.dockerExtraArgs | object |
Docker 额外的配置参数,将写入 /etc/sysconfig/docker,建议不要修改。通过 daemon.json 文件配置 Docker,必须以键、值的方式进行配置。
字段路径:spec.dockerExtraArgs |
| spec.etcd | object |
Etcd 包含了描述 Etcd 配置的元素。
字段路径:spec.etcd |
| etcd.external | object |
ExternalEtcd 描述外部 etcd 集群。Kubeadm 不知道证书文件的位置,必须提供它们。
字段路径:spec.etcd.external |
| external.caFile | string |
CAFile 是一个 SSL 证书颁发机构文件,用于保护 etcd 通信。使用 TLS 连接时必须。
字段路径:spec.etcd.external.caFile |
| external.certFile | string |
CertFile 是用于保障 etcd 通信安全的 SSL 证书文件。使用 TLS 连接时必须。
字段路径:spec.etcd.external.certFile |
| external.endpoints | array |
ETCD 成员的端点。ExternalEtcd 所必需的。
字段路径:spec.etcd.external.endpoints |
| external.endpoints[] | string |
字段路径:spec.etcd.external.endpoints[] |
| external.keyFile | string |
KeyFile 是一个 SSL 密钥文件,用于保护 etcd 通信。使用 TLS 连接时必须。
字段路径:spec.etcd.external.keyFile |
| etcd.local | object |
LocalEtcd 描述了 kubeadm 应该在本地运行 etcd 集群。
字段路径:spec.etcd.local |
| local.dataDir | string |
DataDir 是 etcd 存放数据的目录。默认为“/var/lib/etcd”。
字段路径:spec.etcd.local.dataDir |
| local.extraArgs | object |
ExtraArgs 是在内部运行一个静态 Pod 时提供给 etcd 二进制文件的额外参数。
字段路径:spec.etcd.local.extraArgs |
| local.peerCertSANs | array |
PeerCertSANs 为 etcd 对等签名证书设置额外的主题替代名称。
字段路径:spec.etcd.local.peerCertSANs |
| local.peerCertSANs[] | string |
字段路径:spec.etcd.local.peerCertSANs[] |
| local.serverCertSANs | array |
ServerCertSANs 为 etcd 服务器签名证书设置额外的域名。
字段路径:spec.etcd.local.serverCertSANs |
| local.serverCertSANs[] | string |
字段路径:spec.etcd.local.serverCertSANs[] |
| spec.features | object |
ClusterFeature 记录了集群启用的特性。
字段路径:spec.features |
| features.authzWebhookAddr | object |
字段路径:spec.features.authzWebhookAddr |
| authzWebhookAddr.builtin | object |
字段路径:spec.features.authzWebhookAddr.builtin |
| authzWebhookAddr.external | object |
字段路径:spec.features.authzWebhookAddr.external |
| external.ip | string |
ExternalAuthzWebhookAddr 的 IP。
字段路径:spec.features.authzWebhookAddr.external.ip |
| external.port | integer (int32) |
ExternalAuthzWebhookAddr 的端口。
字段路径:spec.features.authzWebhookAddr.external.port |
| features.csiOperator | object |
字段路径:spec.features.csiOperator |
| csiOperator.version | string |
版本号。
字段路径:spec.features.csiOperator.version |
| features.enableMasterSchedule | boolean |
是否允许将应用调度到控制节点上。
字段路径:spec.features.enableMasterSchedule |
| features.enableMetricsServer | boolean |
是否启用 metrics 服务。
字段路径:spec.features.enableMetricsServer |
| features.files | array |
部署节点时额外复制的文件。
字段路径:spec.features.files |
| features.files[] | object |
字段路径:spec.features.files[] |
| files[].dst | string |
目标文件,只支持常规文件。
字段路径:spec.features.files[].dst |
| files[].src | string |
源文件,仅支持常规文件。
字段路径:spec.features.files[].src |
| features.gpuType | string |
GPU 类型。
字段路径:spec.features.gpuType |
| features.ha | object |
字段路径:spec.features.ha |
| ha.thirdParty | object |
字段路径:spec.features.ha.thirdParty |
| thirdParty.vip | string |
第三方 HA(Highly Available) 的虚拟 IP。
字段路径:spec.features.ha.thirdParty.vip |
| thirdParty.vport | integer (int32) |
第三方 HA(Highly Available) 的虚拟端口。
字段路径:spec.features.ha.thirdParty.vport |
| ha.tke | object |
字段路径:spec.features.ha.tke |
| tke.vip | string |
自建 HA(Highly Available) 的虚拟 IP。
字段路径:spec.features.ha.tke.vip |
| tke.vrid | integer (int32) |
自建 HA(Highly Available) 的 VRID。
字段路径:spec.features.ha.tke.vrid |
| features.hooks | object |
Hook。
字段路径:spec.features.hooks |
| features.internalLB | boolean |
内部负载均衡的开关。
字段路径:spec.features.internalLB |
| features.ipv6DualStack | boolean |
是否启用 IPV4/IPV6 双栈。
字段路径:spec.features.ipv6DualStack |
| features.ipvs | boolean |
Ipvs 开关。
字段路径:spec.features.ipvs |
| features.publicLB | boolean |
公共负载均衡开关。
字段路径:spec.features.publicLB |
| features.skipConditions | array |
SkipConditions 是一系列需要被跳过的状态。
字段路径:spec.features.skipConditions |
| features.skipConditions[] | string |
字段路径:spec.features.skipConditions[] |
| features.upgrade | object |
字段路径:spec.features.upgrade |
| upgrade.mode | string |
升级模式,默认值为 Auto。
字段路径:spec.features.upgrade.mode |
| upgrade.strategy | object |
用于控制升级过程的策略。
字段路径:spec.features.upgrade.strategy |
| strategy.drainNodeBeforeUpgrade | boolean |
升级前是否逐出节点上的 Pod。如果你的 Pod 不能接受被逐出当前节点,这个值应该是 false。
字段路径:spec.features.upgrade.strategy.drainNodeBeforeUpgrade |
| strategy.maxUnready | string (int-or-string) |
IntOrString 是一种可以保存 int32 或 string 的类型。当在 JSON 或 YAML 编组和解组中使用时,它会生成或使用内部类型。例如,这允许您拥有一个可以接受名称或数字的 JSON 字段。
字段路径:spec.features.upgrade.strategy.maxUnready |
| spec.finalizers | array |
终结器是一个内部的值列表,必须为空才能从存储中永久删除对象。
字段路径:spec.finalizers |
| spec.finalizers[] | string |
字段路径:spec.finalizers[] |
| spec.hostnameAsNodename | boolean |
如果为 true,将使用节点的 hostname 作为节点名称;如果为 false,将会使用节点 IP 作为节点名称。
字段路径:spec.hostnameAsNodename |
| spec.kubeletExtraArgs | object |
Kubelet 额外的配置参数。
字段路径:spec.kubeletExtraArgs |
| spec.machines | array |
集群节点,代表集群中的控制节点。
字段路径:spec.machines |
| spec.machines[] | object |
ClusterMachine 是集群的 master 节点定义。
字段路径:spec.machines[] |
| machines[].displayName | string |
显示名称。
字段路径:spec.machines[].displayName |
| machines[].ip | string |
字段路径:spec.machines[].ip |
| machines[].ipv6 | string |
IPV6 地址。
字段路径:spec.machines[].ipv6 |
| machines[].labels | object |
字段路径:spec.machines[].labels |
| machines[].networkDevice | string |
网络设备(网卡)名称。
字段路径:spec.machines[].networkDevice |
| machines[].passPhrase | string (byte) |
字段路径:spec.machines[].passPhrase |
| machines[].password | string (byte) |
字段路径:spec.machines[].password |
| machines[].port | integer (int32) |
字段路径:spec.machines[].port |
| machines[].privateKey | string (byte) |
字段路径:spec.machines[].privateKey |
| machines[].proxy | object |
通过 SSH 服务访问节点的代理。
字段路径:spec.machines[].proxy |
| proxy.address | string |
代理服务器的地址,例如:192.168.1.1:1080。
字段路径:spec.machines[].proxy.address |
| proxy.password | string (byte) |
访问代理服务器的密码。
字段路径:spec.machines[].proxy.password |
| proxy.type | string |
代理的类型。
字段路径:spec.machines[].proxy.type |
| proxy.username | string |
访问代理服务器的用户名。
字段路径:spec.machines[].proxy.username |
| machines[].publicIP | string |
节点的公网 IP。
字段路径:spec.machines[].publicIP |
| machines[].role | string |
节点的类型,控制节点(master)/计算节点(node)。
字段路径:spec.machines[].role |
| machines[].taints | array |
可选,节点的污点。
字段路径:spec.machines[].taints |
| machines[].taints[] | object |
污点是节点的一个属性,如果节点设置了污点后,底层的 Kubernetes 是不会将 Pod 调度到这个节点上的。
字段路径:spec.machines[].taints[] |
| taints[].effect | string |
必须。Pod 上污点的 effect,可选如下三种:
NoSchedule:表示不允许调度,已调度的资源不受影响。
PreferNoSchedule:表示尽量不调度。
NoExecute:表示不允许调度,已调度的资源将在 tolerationSeconds 后删除。
字段路径:spec.machines[].taints[].effect |
| taints[].key | string |
必须。应用到节点的污点的键。
字段路径:spec.machines[].taints[].key |
| taints[].timeAdded | string (date-time) |
Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径:spec.machines[].taints[].timeAdded |
| taints[].value | string |
与污点的键对应的污点的值。
字段路径:spec.machines[].taints[].value |
| machines[].username | string |
字段路径:spec.machines[].username |
| spec.networkArgs | object |
网络相关的参数。
字段路径:spec.networkArgs |
| spec.networkDevice | string |
网卡设备。
字段路径:spec.networkDevice |
| spec.networkType | string |
网络模式。
字段路径:spec.networkType |
| spec.properties | object |
ClusterProperty 记录了集群的属性信息。
字段路径:spec.properties |
| properties.maxClusterServiceNum | integer (int32) |
集群最多支持的 Kubernetes Service 个数。
字段路径:spec.properties.maxClusterServiceNum |
| properties.maxNodePodNum | integer (int32) |
节点上允许调度的最大 Pod 数。
字段路径:spec.properties.maxNodePodNum |
| properties.oversoldRatio | object |
集群的超售比。
字段路径:spec.properties.oversoldRatio |
| spec.publicAlternativeNames | array |
签发到证书中的 APIServer 访问地址,只能填写 IP 或域名,最多 253 个字符。
字段路径:spec.publicAlternativeNames |
| spec.publicAlternativeNames[] | string |
字段路径:spec.publicAlternativeNames[] |
| spec.scalingMachines | array |
ScalingMachines 是一组我们想要从集群中添加/删除的机器。
字段路径:spec.scalingMachines |
| spec.scalingMachines[] | object |
ClusterMachine 是集群的 master 节点定义。
字段路径:spec.scalingMachines[] |
| scalingMachines[].displayName | string |
显示名称。
字段路径:spec.scalingMachines[].displayName |
| scalingMachines[].ip | string |
字段路径:spec.scalingMachines[].ip |
| scalingMachines[].ipv6 | string |
IPV6 地址。
字段路径:spec.scalingMachines[].ipv6 |
| scalingMachines[].labels | object |
字段路径:spec.scalingMachines[].labels |
| scalingMachines[].networkDevice | string |
网络设备(网卡)名称。
字段路径:spec.scalingMachines[].networkDevice |
| scalingMachines[].passPhrase | string (byte) |
字段路径:spec.scalingMachines[].passPhrase |
| scalingMachines[].password | string (byte) |
字段路径:spec.scalingMachines[].password |
| scalingMachines[].port | integer (int32) |
字段路径:spec.scalingMachines[].port |
| scalingMachines[].privateKey | string (byte) |
字段路径:spec.scalingMachines[].privateKey |
| scalingMachines[].proxy | object |
通过 SSH 服务访问节点的代理。
字段路径:spec.scalingMachines[].proxy |
| proxy.address | string |
代理服务器的地址,例如:192.168.1.1:1080。
字段路径:spec.scalingMachines[].proxy.address |
| proxy.password | string (byte) |
访问代理服务器的密码。
字段路径:spec.scalingMachines[].proxy.password |
| proxy.type | string |
代理的类型。
字段路径:spec.scalingMachines[].proxy.type |
| proxy.username | string |
访问代理服务器的用户名。
字段路径:spec.scalingMachines[].proxy.username |
| scalingMachines[].publicIP | string |
节点的公网 IP。
字段路径:spec.scalingMachines[].publicIP |
| scalingMachines[].role | string |
节点的类型,控制节点(master)/计算节点(node)。
字段路径:spec.scalingMachines[].role |
| scalingMachines[].taints | array |
可选,节点的污点。
字段路径:spec.scalingMachines[].taints |
| scalingMachines[].taints[] | object |
污点是节点的一个属性,如果节点设置了污点后,底层的 Kubernetes 是不会将 Pod 调度到这个节点上的。
字段路径:spec.scalingMachines[].taints[] |
| taints[].effect | string |
必须。Pod 上污点的 effect,可选如下三种:
NoSchedule:表示不允许调度,已调度的资源不受影响。
PreferNoSchedule:表示尽量不调度。
NoExecute:表示不允许调度,已调度的资源将在 tolerationSeconds 后删除。
字段路径:spec.scalingMachines[].taints[].effect |
| taints[].key | string |
必须。应用到节点的污点的键。
字段路径:spec.scalingMachines[].taints[].key |
| taints[].timeAdded | string (date-time) |
Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径:spec.scalingMachines[].taints[].timeAdded |
| taints[].value | string |
与污点的键对应的污点的值。
字段路径:spec.scalingMachines[].taints[].value |
| scalingMachines[].username | string |
字段路径:spec.scalingMachines[].username |
| spec.schedulerExtraArgs | object |
Scheduler 额外的配置参数。
字段路径:spec.schedulerExtraArgs |
| spec.serviceCIDR | string |
Kubernetes Service 的网络地址范围(CIDR 格式),例如:10.96.0.0/12,不可与 Cluster CIDR 的网段重叠。与 MaxClusterServiceNum 互斥。
字段路径:spec.serviceCIDR |
| spec.tenantID | string |
租户 ID。
字段路径:spec.tenantID |
| spec.type | string |
集群类型,自建或接入。
字段路径:spec.type |
| spec.version | string |
集群的版本。
字段路径:spec.version |
| status | object |
ClusterStatus 代表集群状态的信息。
字段路径:status |
| status.addresses | array |
可到达集群的地址列表。
字段路径:status.addresses |
| status.addresses[] | object |
ClusterAddress 包含了集群地址的信息。
字段路径:status.addresses[] |
| addresses[].host | string |
集群地址。
字段路径:status.addresses[].host |
| addresses[].path | string |
集群地址的 IP 地址或域名。
字段路径:status.addresses[].path |
| addresses[].port | integer (int32) |
集群地址端口号。
字段路径:status.addresses[].port |
| addresses[].type | string |
集群地址的类型,包括 Public、ExternalIP、InternalIP。
字段路径:status.addresses[].type |
| status.clusterCIDR | string |
ClusterCIDR 是容器网络的子网地址(CIDR 格式),例如:10.1.0.0/16,该地址应与节点子网不同。集群创建时的 Pod 可使用该网段内的 IP。
字段路径:status.clusterCIDR |
| status.components | array |
集群组件。
字段路径:status.components |
| status.components[] | object |
ClusterComponent 记录了集群 master 节点的每个组件的副本数量。
字段路径:status.components[] |
| components[].replicas | object |
ClusterComponentReplicas 记录了集群 master 节点上每个组件的每个状态的副本数量。
字段路径:status.components[].replicas |
| replicas.available | integer (int32) |
集群组件副本是否可用。
字段路径:status.components[].replicas.available |
| replicas.current | integer (int32) |
当前副本数。
字段路径:status.components[].replicas.current |
| replicas.desired | integer (int32) |
期望的副本数。
字段路径:status.components[].replicas.desired |
| replicas.updated | integer (int32) |
已更新的副本数。
字段路径:status.components[].replicas.updated |
| components[].type | string |
集群组件的类型。
字段路径:status.components[].type |
| status.conditions | array |
集群的执行进度。
字段路径:status.conditions |
| status.conditions[] | object |
ClusterCondition 包括该集群当前条件的详细信息。
字段路径:status.conditions[] |
| conditions[].lastProbeTime | string (date-time) |
Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径:status.conditions[].lastProbeTime |
| conditions[].lastTransitionTime | string (date-time) |
Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径:status.conditions[].lastTransitionTime |
| conditions[].message | string |
状态转换的详细可读信息。
字段路径:status.conditions[].message |
| conditions[].reason | string |
最后一次状态转换的原因。
字段路径:status.conditions[].reason |
| conditions[].status | string |
条件的状态,可以是 True、False、Unknown。
字段路径:status.conditions[].status |
| conditions[].type | string |
条件的类型。
字段路径:status.conditions[].type |
| status.dnsIP | string |
域名的 IP。
字段路径:status.dnsIP |
| status.locked | boolean |
集群的锁定状态。
字段路径:status.locked |
| status.message | string |
指示集群为什么在当前条件的可读详细信息。
字段路径:status.message |
| status.nodeCIDRMaskSize | integer (int32) |
节点的 CIDR 掩码大小。
字段路径:status.nodeCIDRMaskSize |
| status.nodeCIDRMaskSizeIPv4 | integer (int32) |
节点的 IPV4 的 CIDR 掩码大小。
字段路径:status.nodeCIDRMaskSizeIPv4 |
| status.nodeCIDRMaskSizeIPv6 | integer (int32) |
节点的 IPV6 的 CIDR 掩码大小。
字段路径:status.nodeCIDRMaskSizeIPv6 |
| status.phase | string |
集群的执行进度阶段。
字段路径:status.phase |
| status.reason | string |
指示集群为什么在当前状态的简短 CamelCase 信息。
字段路径:status.reason |
| status.registryIPs | array |
镜像仓库 IP。
字段路径:status.registryIPs |
| status.registryIPs[] | string |
字段路径:status.registryIPs[] |
| status.resource | object |
ClusterResource 记录了集群的当前可用的最大资源配额信息。
字段路径:status.resource |
| resource.allocatable | object |
Allocatable 表示可用于调度的集群资源。默认与 Capacity 相同。
字段路径:status.resource.allocatable |
| resource.allocated | object |
Allocated 表示已分配的集群资源。
字段路径:status.resource.allocated |
| resource.capacity | object |
Capacity 表示集群的资源总量。
字段路径:status.resource.capacity |
| status.secondaryClusterCIDR | string |
secondaryClusterCIDR,用于双栈 IPV4/IPV6。
字段路径:status.secondaryClusterCIDR |
| status.secondaryServiceCIDR | string |
secondaryServiceCIDR,用于双栈 IPV4/IPV6。
字段路径:status.secondaryServiceCIDR |
| status.serviceCIDR | string |
Kubernetes Service 的网络地址范围(CIDR 格式),例如:10.96.0.0/12,不可与 Cluster CIDR 的网段重叠。与 MaxClusterServiceNum 互斥。
字段路径:status.serviceCIDR |
| status.version | string |
集群版本。
字段路径:status.version |