ReplicaSet

apiVersion: apps/v1

import "k8s.io/api/apps/v1"

ReplicaSet

ReplicaSet 确保指定数量的 Pod 副本在任何时间都正在运行。

• apiVersion: apps/v1

• kind: ReplicaSet

• metadata (ObjectMeta)

  如果 ReplicaSet 的 Labels 为空，它们会默认为与 ReplicaSet 管理的 Pod(s) 相同。标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec (ReplicaSetSpec)

  Spec 定义了 ReplicaSet 期望行为的规范。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

• status (ReplicaSetStatus)

  Status 是最近观察到的 ReplicaSet 状态。此数据可能存在一定时间窗口的延迟。由系统填充。只读。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

ReplicaSetSpec

ReplicaSetSpec 是 ReplicaSet 的规范。

• selector (LabelSelector)，必需

  Selector 是对 Pods 的标签查询，应与副本数量匹配。必须匹配的标签键和值才能由该副本集控制。它必须与 Pod 模板的标签匹配。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/labels/#label-selectors

• template (PodTemplateSpec)

  Template 是描述当检测到副本不足时将被创建的 Pod 的对象。更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/controllers/replicaset/#pod-template

• replicas (int32)

  Replicas 是期望的 Pod 数量。这是一个指针，用于区分显式指定为零和未指定。默认为 1。更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/controllers/replicaset

• minReadySeconds (int32)

  新创建的 Pod 在其任何容器没有崩溃的情况下，应保持就绪状态的最少秒数，以便被认为是可用的。默认为 0（Pod 在就绪后立即被认为是可用的）。

ReplicaSetStatus

ReplicaSetStatus 表示 ReplicaSet 的当前状态。

• replicas (int32)，必需

  Replicas 是最近观察到的非终止状态 Pod 的数量。更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/controllers/replicaset

• availableReplicas (int32)

  此副本集可用的非终止状态 Pod（就绪至少 minReadySeconds）的数量。

• readyReplicas (int32)

  此 ReplicaSet 目标中处于就绪状态（Ready Condition）的非终止状态 Pod 的数量。

• terminatingReplicas (int32)

  此副本集中正在终止的 Pod 的数量。正在终止的 Pod 具有非空的 .metadata.deletionTimestamp，并且尚未达到 Failed 或 Succeeded 的 .status.phase。

  这是一个 Alpha 字段。启用 DeploymentReplicaSetTerminatingReplicas 功能门控以使用此字段。

• fullyLabeledReplicas (int32)

  标签与副本集的 Pod 模板标签匹配的非终止状态 Pod 的数量。

• conditions ([]ReplicaSetCondition)

  Patch 策略：按键 type 合并

  Map：合并时将保留键 type 上的唯一值

  表示副本集当前状态的最新可用观察结果。

  ReplicaSetCondition 描述了副本集在某个时间点的状态。

  • conditions.status (string)，必需

    状况状态，可以是 True、False 或 Unknown。

  • conditions.type (string)，必需

    副本集状况类型。

  • conditions.lastTransitionTime (Time)

    状况上次从一个状态转换为另一个状态的时间。

    Time 是 time.Time 的包装器，支持正确地序列化为 YAML 和 JSON。提供了对 time 包中许多工厂方法的包装。

  • conditions.message (string)

    指示转换详细信息的人类可读消息。

  • conditions.reason (string)

    状况上次转换的原因。

• observedGeneration (int64)

  ObservedGeneration 反映最近观察到的 ReplicaSet 的世代。

ReplicaSetList

ReplicaSetList 是 ReplicaSet 的集合。

• apiVersion: apps/v1

• kind: ReplicaSetList

• metadata (ListMeta)

  标准列表元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

• items ([]ReplicaSet)，必需

  ReplicaSet 列表。更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/controllers/replicaset

操作

get 读取指定的 ReplicaSet

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

401: 未授权

get 读取指定的 ReplicaSet 的状态

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

401: 未授权

list 列出或监视 ReplicaSet 类型的对象

HTTP 请求

GET /apis/apps/v1/namespaces/{namespace}/replicasets

参数

• namespace (in path): string，必需

  命名空间

• allowWatchBookmarks (in query): boolean

  允许监视书签

• continue (in query): string

  继续标记

• fieldSelector (in query): string

  字段选择器

• labelSelector (in query): string

  标签选择器

• limit (in query): integer

  限制数量

• pretty (in query): string

  美化输出

• resourceVersion (in query): string

  资源版本

• resourceVersionMatch (in query): string

  资源版本匹配策略

• sendInitialEvents (in query): boolean

  发送初始事件

• timeoutSeconds (in query): integer

  超时秒数

• watch (in query): boolean

  监视

响应

200 (ReplicaSetList): OK

401: 未授权

list 列出或监视 ReplicaSet 类型的对象

HTTP 请求

GET /apis/apps/v1/replicasets

参数

• allowWatchBookmarks (in query): boolean

  允许监视书签

• continue (in query): string

  继续标记

• fieldSelector (in query): string

  字段选择器

• labelSelector (in query): string

  标签选择器

• limit (in query): integer

  限制数量

• pretty (in query): string

  美化输出

• resourceVersion (in query): string

  资源版本

• resourceVersionMatch (in query): string

  资源版本匹配策略

• sendInitialEvents (in query): boolean

  发送初始事件

• timeoutSeconds (in query): integer

  超时秒数

• watch (in query): boolean

  监视

响应

200 (ReplicaSetList): OK

401: 未授权

create 创建一个 ReplicaSet

HTTP 请求

POST /apis/apps/v1/namespaces/{namespace}/replicasets

参数

• namespace (in path): string，必需

  命名空间

• body: ReplicaSet，必需

• dryRun (in query): string

  空运行

• fieldManager (in query): string

  字段管理器

• fieldValidation (in query): string

  字段校验

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

201 (ReplicaSet): 已创建

202 (ReplicaSet): 已接受

401: 未授权

update 替换指定的 ReplicaSet

HTTP 请求

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• body: ReplicaSet，必需

• dryRun (in query): string

  空运行

• fieldManager (in query): string

  字段管理器

• fieldValidation (in query): string

  字段校验

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

201 (ReplicaSet): 已创建

401: 未授权

update 替换指定的 ReplicaSet 的状态

HTTP 请求

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• body: ReplicaSet，必需

• dryRun (in query): string

  空运行

• fieldManager (in query): string

  字段管理器

• fieldValidation (in query): string

  字段校验

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

201 (ReplicaSet): 已创建

401: 未授权

patch 部分更新指定的 ReplicaSet

HTTP 请求

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• body: Patch，必需

• dryRun (in query): string

  空运行

• fieldManager (in query): string

  字段管理器

• fieldValidation (in query): string

  字段校验

• force (in query): boolean

  强制

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

201 (ReplicaSet): 已创建

401: 未授权

patch 部分更新指定的 ReplicaSet 的状态

HTTP 请求

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• body: Patch，必需

• dryRun (in query): string

  空运行

• fieldManager (in query): string

  字段管理器

• fieldValidation (in query): string

  字段校验

• force (in query): boolean

  强制

• pretty (in query): string

  美化输出

响应

200 (ReplicaSet): OK

201 (ReplicaSet): 已创建

401: 未授权

delete 删除一个 ReplicaSet

HTTP 请求

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

参数

• name (in path): string，必需

  ReplicaSet 的名称

• namespace (in path): string，必需

  命名空间

• body: DeleteOptions

• dryRun (in query): string

  空运行

• gracePeriodSeconds (in query): integer

  优雅终止秒数

• ignoreStoreReadErrorWithClusterBreakingPotential (in query): boolean

  忽略可能导致集群损坏的存储读取错误

• pretty (in query): string

  美化输出

• propagationPolicy (in query): string

  传播策略

响应

200 (Status): OK

202 (Status): 已接受

401: 未授权

deletecollection 删除 ReplicaSet 的集合

HTTP 请求

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets

参数

• namespace (in path): string，必需

  命名空间

• body: DeleteOptions

• continue (in query): string

  继续标记

• dryRun (in query): string

  空运行

• fieldSelector (in query): string

  字段选择器

• gracePeriodSeconds (in query): integer

  优雅终止秒数

• ignoreStoreReadErrorWithClusterBreakingPotential (in query): boolean

  忽略可能导致集群损坏的存储读取错误

• labelSelector (in query): string

  标签选择器

• limit (in query): integer

  限制数量

• pretty (in query): string

  美化输出

• propagationPolicy (in query): string

  传播策略

• resourceVersion (in query): string

  资源版本

• resourceVersionMatch (in query): string

  资源版本匹配策略

• sendInitialEvents (in query): boolean

  发送初始事件

• timeoutSeconds (in query): integer

  超时秒数

响应

200 (Status): OK

401: 未授权