×
描述

部署配置定义了 Pod 的模板,并管理部署新镜像或配置更改。单个部署配置通常类似于单个微服务。可以支持许多不同的部署模式,包括完全重启、可自定义的滚动更新和完全自定义的行为,以及部署前和部署后挂钩。每个单独的部署都表示为一个副本控制器。

当配置更改或镜像流中的标签更改时,将“触发”部署。可以禁用触发器以允许手动控制部署。“策略”决定如何执行部署,并且可以随时更改。当任何方式触发新的部署时,都会更新`latestVersion`字段。

兼容性级别 1:在主要版本中稳定至少 12 个月或 3 个次要版本(以较长者为准)。已弃用:改用部署或其他方法来声明式更新 Pod。

类型

对象

必需
  • spec

规格

属性 类型 描述

apiVersion

字符串

APIVersion 定义了对象的此表示形式的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind 是一个字符串值,表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。无法更新。使用驼峰式命名法。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta_v2

metadata 是标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

DeploymentConfigSpec 表示部署的期望状态。

status

对象

DeploymentConfigStatus 表示当前的部署状态。

.spec

描述

DeploymentConfigSpec 表示部署的期望状态。

类型

对象

属性 类型 描述

minReadySeconds

整数

MinReadySeconds 是新创建的 Pod 应在没有任何容器崩溃的情况下保持就绪的最小秒数,才能将其视为可用。默认为 0(Pod 一旦就绪即可视为可用)

paused

布尔值

Paused 表示部署配置已暂停,导致在模板更改或由其他触发器引起的模板更改时不会进行新的部署。

replicas

整数

Replicas 是所需副本的数量。

revisionHistoryLimit

整数

RevisionHistoryLimit 是要保留的旧 ReplicationControllers 的数量,以便进行回滚。此字段是指针,允许区分显式零和未指定。默认为 10。(这仅适用于通过新的组 API 资源创建的 DeploymentConfigs,而不适用于旧版资源。)

selector

对象(字符串)

Selector 是对应该匹配 Replicas 计数的 Pod 的标签查询。

strategy

对象

DeploymentStrategy 描述如何执行部署。

template

PodTemplateSpec

Template 是描述如果检测到不足的副本将创建的 Pod 的对象。

test

布尔值

Test 确保此部署配置将具有零个副本,除非在部署运行时。这允许将部署配置用作持续部署测试——根据镜像触发,运行部署,然后成功或失败。部署后挂钩和 After 操作可用于将成功的部署与操作集成。

triggers

数组

Triggers 确定对 DeploymentConfig 的更新如何导致新的部署。如果没有定义触发器,则新的部署只能作为对具有新 LatestVersion 的 DeploymentConfig 的显式客户端更新的结果而发生。如果为 null,则默认为具有配置更改触发器。

triggers[]

对象

DeploymentTriggerPolicy 描述导致新部署的单个触发器的策略。

.spec.strategy

描述

DeploymentStrategy 描述如何执行部署。

类型

对象

属性 类型 描述

activeDeadlineSeconds

整数

ActiveDeadlineSeconds 是此部署配置的部署程序 Pod 在节点上可能处于活动状态的持续时间(以秒为单位),在此之后系统会主动尝试终止它们。

annotations

对象(字符串)

注解是一组键值对,添加到自定义部署程序和生命周期前后钩子 Pod 中。

customParams

对象

CustomDeploymentStrategyParams 是自定义部署策略的输入。

labels

对象(字符串)

标签是一组键值对,添加到自定义部署程序和生命周期前后钩子 Pod 中。

recreateParams

对象

RecreateDeploymentStrategyParams 是重新创建部署策略的输入。

resources

资源需求

资源包含执行部署和任何钩子的资源需求。

rollingParams

对象

RollingDeploymentStrategyParams 是滚动部署策略的输入。

type

字符串

类型是部署策略的名称。

.spec.strategy.customParams

描述

CustomDeploymentStrategyParams 是自定义部署策略的输入。

类型

对象

属性 类型 描述

command

数组 (字符串)

命令是可选的,并覆盖容器镜像中的 CMD。

environment

数组 (EnvVar)

环境包含将提供给镜像容器的环境变量。

image

字符串

镜像指定可以执行部署的容器镜像。

.spec.strategy.recreateParams

描述

RecreateDeploymentStrategyParams 是重新创建部署策略的输入。

类型

对象

属性 类型 描述

mid

对象

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

post

对象

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

pre

对象

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

timeoutSeconds

整数

TimeoutSeconds 是在放弃之前等待更新的时间。如果值为 nil,将使用默认值。

.spec.strategy.recreateParams.mid

描述

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

类型

对象

必需
  • failurePolicy

属性 类型 描述

execNewPod

对象

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

failurePolicy

字符串

FailurePolicy 指定如果钩子失败该采取什么操作。

tagImages

数组

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

tagImages[]

对象

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

.spec.strategy.recreateParams.mid.execNewPod

描述

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

类型

对象

必需
  • command

  • containerName

属性 类型 描述

command

数组 (字符串)

命令是操作命令及其参数。

containerName

字符串

ContainerName 是部署 Pod 模板中容器的名称,其容器镜像将用于钩子 Pod 的容器。

env

数组 (EnvVar)

Env 是一组环境变量,用于提供给钩子 Pod 的容器。

volumes

数组 (字符串)

Volumes 是 Pod 模板中命名卷的列表,应将其复制到钩子 Pod。Pod规范中找不到的卷名将被忽略。空列表表示不会复制任何卷。

.spec.strategy.recreateParams.mid.tagImages

描述

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

类型

数组

.spec.strategy.recreateParams.mid.tagImages[]

描述

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

类型

对象

必需
  • containerName

  • to

属性 类型 描述

containerName

字符串

ContainerName 是部署配置中容器的名称,其镜像值将用作标签的源。如果只有一个容器,此值将默认为该容器的名称。

to

ObjectReference

To 是要将容器镜像设置到的目标 ImageStreamTag。

.spec.strategy.recreateParams.post

描述

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

类型

对象

必需
  • failurePolicy

属性 类型 描述

execNewPod

对象

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

failurePolicy

字符串

FailurePolicy 指定如果钩子失败该采取什么操作。

tagImages

数组

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

tagImages[]

对象

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

.spec.strategy.recreateParams.post.execNewPod

描述

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

类型

对象

必需
  • command

  • containerName

属性 类型 描述

command

数组 (字符串)

命令是操作命令及其参数。

containerName

字符串

ContainerName 是部署 Pod 模板中容器的名称,其容器镜像将用于钩子 Pod 的容器。

env

数组 (EnvVar)

Env 是一组环境变量,用于提供给钩子 Pod 的容器。

volumes

数组 (字符串)

Volumes 是 Pod 模板中命名卷的列表,应将其复制到钩子 Pod。Pod规范中找不到的卷名将被忽略。空列表表示不会复制任何卷。

.spec.strategy.recreateParams.post.tagImages

描述

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

类型

数组

.spec.strategy.recreateParams.post.tagImages[]

描述

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

类型

对象

必需
  • containerName

  • to

属性 类型 描述

containerName

字符串

ContainerName 是部署配置中容器的名称,其镜像值将用作标签的源。如果只有一个容器,此值将默认为该容器的名称。

to

ObjectReference

To 是要将容器镜像设置到的目标 ImageStreamTag。

.spec.strategy.recreateParams.pre

描述

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

类型

对象

必需
  • failurePolicy

属性 类型 描述

execNewPod

对象

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

failurePolicy

字符串

FailurePolicy 指定如果钩子失败该采取什么操作。

tagImages

数组

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

tagImages[]

对象

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

.spec.strategy.recreateParams.pre.execNewPod

描述

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

类型

对象

必需
  • command

  • containerName

属性 类型 描述

command

数组 (字符串)

命令是操作命令及其参数。

containerName

字符串

ContainerName 是部署 Pod 模板中容器的名称,其容器镜像将用于钩子 Pod 的容器。

env

数组 (EnvVar)

Env 是一组环境变量,用于提供给钩子 Pod 的容器。

volumes

数组 (字符串)

Volumes 是 Pod 模板中命名卷的列表,应将其复制到钩子 Pod。Pod规范中找不到的卷名将被忽略。空列表表示不会复制任何卷。

.spec.strategy.recreateParams.pre.tagImages

描述

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

类型

数组

.spec.strategy.recreateParams.pre.tagImages[]

描述

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

类型

对象

必需
  • containerName

  • to

属性 类型 描述

containerName

字符串

ContainerName 是部署配置中容器的名称,其镜像值将用作标签的源。如果只有一个容器,此值将默认为该容器的名称。

to

ObjectReference

To 是要将容器镜像设置到的目标 ImageStreamTag。

.spec.strategy.rollingParams

描述

RollingDeploymentStrategyParams 是滚动部署策略的输入。

类型

对象

属性 类型 描述

intervalSeconds

整数

IntervalSeconds 是更新后轮询部署状态之间等待的时间。如果值为 nil,将使用默认值。

maxSurge

IntOrString

MaxSurge 是可以在原始 Pod 数量之上调度的 Pod 最大数量。值可以是绝对数字(例如:5)或更新开始时总 Pod 百分比(例如:10%)。绝对数字是通过向上取整从百分比计算的。

如果 MaxUnavailable 为 0,则此值不能为 0。默认情况下,使用 25%。

示例:当此值设置为 30% 时,滚动更新开始时,新的 RC 可以立即按 30% 的比例向上扩展。一旦旧 Pod 被终止,新的 RC 就可以进一步向上扩展,确保在更新期间任何时间运行的 Pod 总数最多为原始 Pod 的 130%。

maxUnavailable

IntOrString

MaxUnavailable 是更新期间最多可以不可用的 Pod 数量。值可以是绝对数字(例如:5)或更新开始时总 Pod 百分比(例如:10%)。绝对数字是通过向下取整从百分比计算的。

如果 MaxSurge 为 0,则此值不能为 0。默认情况下,使用 25%。

示例:当此值设置为 30% 时,滚动更新开始时,旧的 RC 可以立即按 30% 的比例向下扩展。一旦新的 Pod 准备就绪,旧的 RC 就可以进一步向下扩展,然后向上扩展新的 RC,确保在更新期间始终至少有 70% 的原始 Pod 数量可用。

post

对象

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

pre

对象

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

timeoutSeconds

整数

TimeoutSeconds 是在放弃之前等待更新的时间。如果值为 nil,将使用默认值。

updatePeriodSeconds

整数

UpdatePeriodSeconds 是单个 Pod 更新之间等待的时间。如果值为 nil,将使用默认值。

.spec.strategy.rollingParams.post

描述

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

类型

对象

必需
  • failurePolicy

属性 类型 描述

execNewPod

对象

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

failurePolicy

字符串

FailurePolicy 指定如果钩子失败该采取什么操作。

tagImages

数组

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

tagImages[]

对象

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

.spec.strategy.rollingParams.post.execNewPod

描述

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

类型

对象

必需
  • command

  • containerName

属性 类型 描述

command

数组 (字符串)

命令是操作命令及其参数。

containerName

字符串

ContainerName 是部署 Pod 模板中容器的名称,其容器镜像将用于钩子 Pod 的容器。

env

数组 (EnvVar)

Env 是一组环境变量,用于提供给钩子 Pod 的容器。

volumes

数组 (字符串)

Volumes 是 Pod 模板中命名卷的列表,应将其复制到钩子 Pod。Pod规范中找不到的卷名将被忽略。空列表表示不会复制任何卷。

.spec.strategy.rollingParams.post.tagImages

描述

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

类型

数组

.spec.strategy.rollingParams.post.tagImages[]

描述

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

类型

对象

必需
  • containerName

  • to

属性 类型 描述

containerName

字符串

ContainerName 是部署配置中容器的名称,其镜像值将用作标签的源。如果只有一个容器,此值将默认为该容器的名称。

to

ObjectReference

To 是要将容器镜像设置到的目标 ImageStreamTag。

.spec.strategy.rollingParams.pre

描述

生命周期钩子定义特定的部署生命周期操作。任何时候只能指定一种类型的操作。

类型

对象

必需
  • failurePolicy

属性 类型 描述

execNewPod

对象

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

failurePolicy

字符串

FailurePolicy 指定如果钩子失败该采取什么操作。

tagImages

数组

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

tagImages[]

对象

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

.spec.strategy.rollingParams.pre.execNewPod

描述

ExecNewPodHook 是一种钩子实现,它根据指定的容器(假定它是部署模板的一部分)在新 Pod 中运行命令。

类型

对象

必需
  • command

  • containerName

属性 类型 描述

command

数组 (字符串)

命令是操作命令及其参数。

containerName

字符串

ContainerName 是部署 Pod 模板中容器的名称,其容器镜像将用于钩子 Pod 的容器。

env

数组 (EnvVar)

Env 是一组环境变量,用于提供给钩子 Pod 的容器。

volumes

数组 (字符串)

Volumes 是 Pod 模板中命名卷的列表,应将其复制到钩子 Pod。Pod规范中找不到的卷名将被忽略。空列表表示不会复制任何卷。

.spec.strategy.rollingParams.pre.tagImages

描述

TagImages 指示部署程序将容器下引用的当前镜像标记到镜像流标签上。

类型

数组

.spec.strategy.rollingParams.pre.tagImages[]

描述

TagImageHook 是将特定容器中的镜像标记到 ImageStreamTag 的请求。

类型

对象

必需
  • containerName

  • to

属性 类型 描述

containerName

字符串

ContainerName 是部署配置中容器的名称,其镜像值将用作标签的源。如果只有一个容器,此值将默认为该容器的名称。

to

ObjectReference

To 是要将容器镜像设置到的目标 ImageStreamTag。

.spec.triggers

描述

Triggers 确定对 DeploymentConfig 的更新如何导致新的部署。如果没有定义触发器,则新的部署只能作为对具有新 LatestVersion 的 DeploymentConfig 的显式客户端更新的结果而发生。如果为 null,则默认为具有配置更改触发器。

类型

数组

.spec.triggers[]

描述

DeploymentTriggerPolicy 描述导致新部署的单个触发器的策略。

类型

对象

属性 类型 描述

imageChangeParams

对象

DeploymentTriggerImageChangeParams 代表 ImageChange 触发器的参数。

type

字符串

触发器的类型

.spec.triggers[].imageChangeParams

描述

DeploymentTriggerImageChangeParams 代表 ImageChange 触发器的参数。

类型

对象

必需
  • from

属性 类型 描述

automatic

布尔值

自动意味着检测到新的标签值应该导致 Pod 模板内部的镜像更新。

containerNames

数组 (字符串)

ContainerNames 用于将标签更新限制到 Pod 中指定的一组容器名称。如果多个触发器指向相同的容器,则结果行为未定义。未来的 API 版本将使其成为验证错误。如果 ContainerNames 没有指向有效的容器,则将忽略触发器。未来的 API 版本将使其成为验证错误。

from

ObjectReference

From 是对要监视更改的镜像流标签的引用。From.Name 是唯一必需的子字段 - 如果 From.Namespace 为空,将使用当前部署触发器的命名空间。

lastTriggeredImage

字符串

LastTriggeredImage 是最后一次触发的镜像。

.status

描述

DeploymentConfigStatus 表示当前的部署状态。

类型

对象

必需
  • latestVersion

  • observedGeneration

  • replicas

  • updatedReplicas

  • availableReplicas

  • unavailableReplicas

属性 类型 描述

availableReplicas

整数

AvailableReplicas 是此部署配置的目标可用 Pod 的总数。

条件

数组

条件代表部署配置当前状态的最新可用观测值。

conditions[]

对象

DeploymentCondition 描述了部署配置在某一时刻的状态。

详细信息

对象

DeploymentDetails 捕获有关部署原因的信息。

latestVersion

整数

LatestVersion 用于确定与部署配置关联的当前部署是否不同步。

observedGeneration

整数

ObservedGeneration 是部署配置控制器观察到的最新代。

就绪副本

整数

此部署目标的就绪 Pod 的总数。

replicas

整数

Replicas 是此部署配置目标的 Pod 总数。

unavailableReplicas

整数

UnavailableReplicas 是此部署配置目标的不可用 Pod 的总数。

updatedReplicas

整数

UpdatedReplicas 是此部署配置目标的非终止 Pod 的总数,这些 Pod 具有所需的模板规范。

.status.conditions

描述

条件代表部署配置当前状态的最新可用观测值。

类型

数组

.status.conditions[]

描述

DeploymentCondition 描述了部署配置在某一时刻的状态。

类型

对象

必需
  • type

  • status

属性 类型 描述

上次转换时间

时间

条件从一种状态转换为另一种状态的最后时间。

上次更新时间

时间

此条件上次更新的时间。

消息

字符串

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

原因

字符串

条件上次转换的原因。

status

字符串

条件的状态,True、False、Unknown 之一。

type

字符串

部署条件的类型。

.status.details

描述

DeploymentDetails 捕获有关部署原因的信息。

类型

对象

必需
  • 原因

属性 类型 描述

原因

数组

原因是与创建新部署的所有原因关联的扩展数据。

causes[]

对象

DeploymentCause 捕获有关部署特定原因的信息。

消息

字符串

如果此部署是由用户手动触发的,则消息是用户指定的更改消息。

.status.details.causes

描述

原因是与创建新部署的所有原因关联的扩展数据。

类型

数组

.status.details.causes[]

描述

DeploymentCause 捕获有关部署特定原因的信息。

类型

对象

必需
  • type

属性 类型 描述

镜像触发器

对象

DeploymentCauseImageTrigger 代表有关源自镜像更改触发器的部署原因的详细信息。

type

字符串

导致创建新部署的触发器的类型。

.status.details.causes[].imageTrigger

描述

DeploymentCauseImageTrigger 代表有关源自镜像更改触发器的部署原因的详细信息。

类型

对象

必需
  • from

属性 类型 描述

from

ObjectReference

From 是对触发部署的已更改对象的引用。该字段可能包含 DockerImage、ImageStreamTag 或 ImageStreamImage 类型。

API 端点

提供以下 API 端点

  • /apis/apps.openshift.io/v1/deploymentconfigs

    • GET:列出或监视 DeploymentConfig 类型的对象。

  • /apis/apps.openshift.io/v1/watch/deploymentconfigs

    • GET:监视对 DeploymentConfig 列表的单个更改。已弃用:改用列表操作中的“watch”参数。

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs

    • DELETE:删除 DeploymentConfig 集合。

    • GET:列出或监视 DeploymentConfig 类型的对象。

    • POST:创建 DeploymentConfig。

  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs

    • GET:监视对 DeploymentConfig 列表的单个更改。已弃用:改用列表操作中的“watch”参数。

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}

    • DELETE:删除 DeploymentConfig。

    • GET:读取指定的 DeploymentConfig。

    • PATCH:部分更新指定的 DeploymentConfig。

    • PUT:替换指定的 DeploymentConfig。

  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}

    • GET:监视 DeploymentConfig 类型对象的更改。已弃用:改用列表操作中的“watch”参数,并使用“fieldSelector”参数将其过滤为单个项目。

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status

    • GET:读取指定的 DeploymentConfig 的状态。

    • PATCH:部分更新指定的 DeploymentConfig 的状态。

    • PUT:替换指定的 DeploymentConfig 的状态。

/apis/apps.openshift.io/v1/deploymentconfigs

HTTP 方法

GET

描述

列出或监视 DeploymentConfig 类型的对象

表 1. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfigList 模式

401 - 未授权

/apis/apps.openshift.io/v1/watch/deploymentconfigs

HTTP 方法

GET

描述

监视对 DeploymentConfig 列表的单个更改。已弃用:改用列表操作中的“watch”参数。

表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

WatchEvent 模式

401 - 未授权

/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs

HTTP 方法

DELETE

描述

删除 DeploymentConfig 集合

表 3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 4. HTTP 响应
HTTP 代码 响应体

200 - OK

Status_v2 模式

401 - 未授权

HTTP 方法

GET

描述

列出或监视 DeploymentConfig 类型的对象

表 5. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfigList 模式

401 - 未授权

HTTP 方法

POST

描述

创建 DeploymentConfig

表 6. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并且将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,则这将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表 7. 主体参数
参数 类型 描述

主体

DeploymentConfig 模式

表 8. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

201 - 已创建

DeploymentConfig 模式

202 - 已接受

DeploymentConfig 模式

401 - 未授权

/apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs

HTTP 方法

GET

描述

监视对 DeploymentConfig 列表的单个更改。已弃用:改用列表操作中的“watch”参数。

表 9. HTTP 响应
HTTP 代码 响应体

200 - OK

WatchEvent 模式

401 - 未授权

/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}

表 10. 全局路径参数
参数 类型 描述

名称

字符串

DeploymentConfig 的名称

HTTP 方法

DELETE

描述

删除 DeploymentConfig

表 11. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 12. HTTP 响应
HTTP 代码 响应体

200 - OK

Status_v2 模式

202 - 已接受

Status_v2 模式

401 - 未授权

HTTP 方法

GET

描述

读取指定的 DeploymentConfig

表 13. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 DeploymentConfig

表 14. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并且将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,则这将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表 15. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

201 - 已创建

DeploymentConfig 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 DeploymentConfig

表 16. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并且将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,则这将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表 17. 主体参数
参数 类型 描述

主体

DeploymentConfig 模式

表 18. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

201 - 已创建

DeploymentConfig 模式

401 - 未授权

/apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}

表 19. 全局路径参数
参数 类型 描述

名称

字符串

DeploymentConfig 的名称

HTTP 方法

GET

描述

监视 DeploymentConfig 类型对象的更改。已弃用:改用列表操作中的“watch”参数,并使用“fieldSelector”参数将其过滤为单个项目。

表 20. HTTP 响应
HTTP 代码 响应体

200 - OK

WatchEvent 模式

401 - 未授权

/apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status

表 21. 全局路径参数
参数 类型 描述

名称

字符串

DeploymentConfig 的名称

HTTP 方法

GET

描述

读取指定的 DeploymentConfig 的状态

表 22. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 DeploymentConfig 的状态

表 23. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并且将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,则这将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表 24. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

201 - 已创建

DeploymentConfig 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 DeploymentConfig 的状态

表 25. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并且将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:这将通过标准警告响应标头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict:如果从对象中删除任何未知字段,或者存在任何重复字段,则这将使用 BadRequest 错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表 26. 主体参数
参数 类型 描述

主体

DeploymentConfig 模式

表 27. HTTP 响应
HTTP 代码 响应体

200 - OK

DeploymentConfig 模式

201 - 已创建

DeploymentConfig 模式

401 - 未授权