- 资源:FleetPackage
- ResourceBundleSelector
- ResourceBundleTag
- CloudBuildRepository
- 目标
- Fleet
- LabelSelector
- VariantSelector
- FleetPackageInfo
- 州/省/直辖市/自治区
- FleetPackageError
- 状态
- 方法
资源:FleetPackage
Config Delivery API 中的 FleetPackage 资源。
FleetPackage 定义了一个软件包,通过该软件包,Kubernetes 配置可部署到一组 Kubernetes 集群。
| JSON 表示法 |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "resourceBundleSelector": { object ( |
| 字段 | |
|---|---|
name |
标识符。 |
createTime |
仅限输出。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
updateTime |
仅限输出。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
labels |
可选。标签是可由用户和 Config Delivery 设置和使用的属性。标签必须满足以下限制条件:
键和值还必须小于或等于 128 字节。 包含一系列 |
resourceBundleSelector |
必需。指定要部署的 Kubernetes 配置来源的信息。 |
target |
可选。用于选择要将 Kubernetes 配置部署到的目标集群的配置。 |
rolloutStrategy |
可选。用于将 Kubernetes 配置部署到集群的策略。 |
variantSelector |
必需。指定如何将 |
info |
仅限输出。包含 |
deletionPropagationPolicy |
可选。有关在删除 |
state |
可选。舰队软件包的预期状态。 |
ResourceBundleSelector
指定要部署的 Kubernetes 配置来源的信息。
| JSON 表示法 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "resourceBundle": { object ( |
| 字段 | |
|---|---|
来源可以是直接推送的 ResourceBundle 或包含 Kubernetes 配置的 CloudBuildRepository。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段: |
|
resourceBundle |
指定 |
cloudBuildRepository |
指定 |
| 互斥字段结束。 | |
ResourceBundleTag
ResourceBundleTag 包含用于引用 ResourceBundle 的版本的信息。
| JSON 表示法 |
|---|
{ "name": string, "tag": string } |
| 字段 | |
|---|---|
name |
必需。 |
tag |
必需。ResourceBundle 中某个版本发布内容的 Git 标记。该标记必须遵循语义化版本格式 vX.Y.Z。 |
CloudBuildRepository
CloudBuildRepository 包含有关从 CloudBuildRepository 提取 Kubernetes 配置的信息。
| JSON 表示法 |
|---|
{ "name": string, "path": string, "tag": string, "serviceAccount": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "variantsPattern": string // End of mutually exclusive fields. } |
| 字段 | |
|---|---|
name |
必需。Cloud Build 代码库的名称。格式为 projects/{p}/locations/{l}/connections/{c}/repositories/{r}。 |
path |
可选。代码库中包含 Kubernetes 配置的目录或文件的路径。如果未指定,则假定路径为代码库的顶级根目录。 |
tag |
必需。底层 Git 代码库的 Git 标记。Git 标记必须采用语义版本格式 |
serviceAccount |
必需。在 CloudBuild 触发器中使用的 Google 服务账号,用于提取和存储 Kubernetes 配置。 |
| 指定如何在代码库中查找变体的配置。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段: | |
variantsPattern |
可选。将用于在代码库中查找变体的 glob 模式。示例: |
| 互斥字段结束。 | |
目标
目标定义了定位 Kubernetes 集群集的不同方式。
| JSON 表示法 |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"fleet": {
object ( |
| 字段 | |
|---|---|
| 舰队软件包的目标。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段: | |
fleet |
用于定位 FleetPackage 发布目标的 GKE 舰队信息。 |
| 互斥字段结束。 | |
舰队
应在其中部署 FleetPackage 的舰队。
| JSON 表示法 |
|---|
{
"project": string,
"selector": {
object ( |
| 字段 | |
|---|---|
project |
必需。GKE 舰队的宿主项目。格式为 |
selector |
可选。选择器允许使用标签定位舰队成员的子集。 |
LabelSelector
标签选择器是针对一组资源的标签查询。空标签选择器会匹配所有对象。
| JSON 表示法 |
|---|
{ "matchLabels": { string: string, ... } } |
| 字段 | |
|---|---|
matchLabels |
可选。{key,value} 对的映射。每个 {key,value} 对都必须与现有标签键和值完全匹配,才能满足匹配条件。 包含一系列 |
VariantSelector
VariantSelector 包含用于在 ResourceBundle 中选择要部署到目标集群的变体的信息。
| JSON 表示法 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "variantNameTemplate": string // End of mutually exclusive fields. } |
| 字段 | |
|---|---|
| 选择变体的策略。以下是互斥字段的列表。在响应中,最多只能设置其中一个字段: | |
variantNameTemplate |
必需。variantNameTemplate 是一个模板,可以指包含集群成员元数据(如位置、名称和标签)的变量,用于生成目标集群的变体名称。变量语法与 unix shell 变量类似。 可用变量包括 如果要对所有集群部署一个特定的变体,例如“default”,则可以使用“default”(不含任何变量的字符串)作为 variantNameTemplate。 |
| 互斥字段结束。 | |
FleetPackageInfo
FleetPackageInfo 表示 FleetPackage 在所有目标集群中的状态。
| JSON 表示法 |
|---|
{ "activeRollout": string, "lastCompletedRollout": string, "state": enum ( |
| 字段 | |
|---|---|
activeRollout |
可选。正在进行的发布(如果有)。格式为 |
lastCompletedRollout |
可选。上次完成的发布(如有)。格式为 |
state |
可选。仅限输出。 |
errors[] |
可选。仅限输出。配置部署期间遇到的错误(如有)。 |
州
FleetPackage 状态的可能值。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED |
未指定状态。 |
ACTIVE |
FleetPackage 已启用。 |
SUSPENDED |
FleetPackage 已中止。 |
FAILED |
FleetPackage未能对账。 |
DELETING |
正在删除“FleetPackage”。 |
FleetPackageError
表示在发布配置期间遇到的错误的信息。
| JSON 表示法 |
|---|
{ "errorMessage": string } |
| 字段 | |
|---|---|
errorMessage |
可选。对错误的描述。 |
州
State 表示舰队软件包的预期状态。未指定的值等同于 ACTIVE。如果状态设置为 SUSPENDED,则正在进行的发布(如有)将继续,但不会安排新的发布。
| 枚举 | |
|---|---|
STATE_UNSPECIFIED |
未指定状态。 |
ACTIVE |
FleetPackage 旨在处于活跃状态。 |
SUSPENDED |
FleetPackage 旨在暂停。 |
方法 |
|
|---|---|
|
在给定的项目和位置中创建新 FleetPackage。 |
|
删除单个 FleetPackage。 |
|
获取单个 FleetPackage 的详细信息。 |
|
列出给定项目和位置中的 FleetPackage。 |
|
更新单个 FleetPackage 的参数。 |