红帽全球峰会19.8. PackageManifest [packages.operators.coreos.com/v1]
- 描述
- PackageManifest 包含有关软件包的信息，这是单个软件包下对一个或多个频道的引用。
- 类型
-
对象
19.8.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| ||
|
|
| PackageManifestSpec 定义 PackageManifest 的所需状态 |
|
|
| PackageManifestStatus 代表 PackageManifest 的当前状态 |
19.8.1.1. .spec
- 描述
- PackageManifestSpec 定义 PackageManifest 的所需状态
- 类型
-
对象
19.8.1.2. .status
- 描述
- PackageManifestStatus 代表 PackageManifest 的当前状态
- 类型
-
对象 - 必填
-
catalogSource -
catalogSourceDisplayName -
catalogSourcePublisher -
catalogSourceNamespace -
packageName -
Channels -
defaultChannel
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| CatalogSource 是此软件包所属的 CatalogSource 的名称 |
|
|
| |
|
|
| CatalogSourceNamespace 是拥有 CatalogSource 的命名空间 |
|
|
| |
|
|
|
频道是软件包的声明频道，ala |
|
|
| PackageChannel 在软件包下定义一个频道，指向该软件包的版本。 |
|
|
| 如果指定，defaultChannel 是软件包的默认频道的名称。如果没有明确指定其他频道，则会安装默认频道。如果软件包只有一个频道，则该频道会隐式使用默认频道。 |
|
|
|
packageName 是整个软件包的名称，ala |
|
|
| AppLink 定义到应用程序的链接 |
19.8.1.3. .status.channels
- 描述
-
频道是软件包的声明频道，ala
stable或alpha。 - 类型
-
array
19.8.1.4. .status.channels[]
- 描述
- PackageChannel 在软件包下定义一个频道，指向该软件包的版本。
- 类型
-
对象 - 必填
-
name -
currentCSV
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| currentCSV 定义对当前用于频道的此软件包版本的 CSV 的引用。 |
|
|
| CSVDescription 定义 CSV 的描述 |
|
|
|
name 是频道的名称，如 |
19.8.1.5. .status.channels[].currentCSVDesc
- 描述
- CSVDescription 定义 CSV 的描述
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
| ||
|
| ||
|
|
| LongDescription 是 CSV 的描述 |
|
|
| displayName 是 CSV 的显示名称 |
|
|
| icon 是 CSV 的 base64 编码图标 |
|
|
| 图标定义 base64 编码图标和介质类型 |
|
| InstallMode 指定支持的安装类型 | |
|
|
| |
|
|
| |
|
|
| AppLink 定义到应用程序的链接 |
|
|
| |
|
|
| maintainer 定义了项目维护人员 |
|
|
| |
|
|
| 用于 Operator 安装的最低 Kubernetes 版本 |
|
| ||
|
|
| AppLink 定义到应用程序的链接 |
|
|
| 相关镜像列表 |
|
| version 是 CSV 的语义版本 |
19.8.1.6. .status.channels[].currentCSVDesc.icon
- 描述
- icon 是 CSV 的 base64 编码图标
- 类型
-
array
19.8.1.7. .status.channels[].currentCSVDesc.icon[]
- 描述
- 图标定义 base64 编码图标和介质类型
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
19.8.1.8. .status.channels[].currentCSVDesc.links
- 描述
- 类型
-
array
19.8.1.9. .status.channels[].currentCSVDesc.links[]
- 描述
- AppLink 定义到应用程序的链接
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
19.8.1.10. .status.channels[].currentCSVDesc.maintainers
- 描述
- 类型
-
array
- 描述
- maintainer 定义了项目维护人员
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
19.8.1.12. .status.channels[].currentCSVDesc.provider
- 描述
- AppLink 定义到应用程序的链接
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
19.8.1.13. .status.provider
- 描述
- AppLink 定义到应用程序的链接
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| |
|
|
|
19.8.2. API 端点
可用的 API 端点如下：
/apis/packages.operators.coreos.com/v1/packagemanifests-
GET: 列出 PackageManifest 类型的对象
-
/apis/packages.operators.coreos.com/v1/namespaces/{namespace}/packagemanifests-
GET: 列出 PackageManifest 类型的对象
-
/apis/packages.operators.coreos.com/v1/namespaces/{namespace}/packagemanifests/{name}-
GET：读取指定的 PackageManifest
-
/apis/packages.operators.coreos.com/v1/namespaces/{namespace}/packagemanifests/{name}/icon-
GET: 将 GET 请求连接到 PackageManifest 的图标
-
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| 如果 'true'，则输出被用户友善。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
|
|
| 观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET - 描述
- 列出 PackageManifest 类型的对象
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 对象名称和身份验证范围，如团队和项目 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| 如果 'true'，则输出被用户友善。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
|
|
| 观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET - 描述
- 列出 PackageManifest 类型的对象
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| PackageManifest 的名称 |
|
|
| 对象名称和身份验证范围，如团队和项目 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果 'true'，则输出被用户友善。 |
- HTTP 方法
-
GET - 描述
- 阅读指定的 PackageManifest
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| PackageManifest 的名称 |
|
|
| 对象名称和身份验证范围，如团队和项目 |
- HTTP 方法
-
GET - 描述
- 将 GET 请求连接到 PackageManifest 的图标
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}