5.6.10. 了解您的 API 服务

与 CRD 一样，您的 Operator 可使用两类 APIService：拥有的和必需的。

当 CSV 拥有 API 服务时，它将负责描述为其提供支持的扩展 api-server 的部署及其提供的组/version/kind（GVK）。

API 服务由它提供的 group/version 唯一标识，并可以多次列出，以表示期望提供的不同类型。

表 5.12. 拥有的 API 服务字段

字段	描述	必需/可选
`Group`	API 服务提供的组，如 `database.example.com`。	必填
`Version`	API 服务的版本，如 `v1alpha1`。	必填
`Kind`	API 服务应提供的类型。	必填
`名称`	提供的 API 服务的复数名称。	必填
`DeploymentName`	由您的 CSV 定义的部署名称，对应您的 API 服务（对于拥有的 API 服务是必需的）。在 CSV 待定阶段，OLM Operator 会在您的 CSV `InstallStrategy` 中搜索具有匹配名称的 `Deployment` spec，如果未找到，则不会将 CSV 转换至安装就绪阶段。	必填
`DisplayName`	API 服务名称的人类可读版本，如 `MongoDB Standalone`。	必填
`描述`	有关 Operator 如何使用此 API 服务的简短描述，或有关 API 服务提供的功能描述。	必填
`资源`	您的 API 服务拥有一类或多类 Kubernetes 对象。它们将在 resources 部分列出，用于告知用户他们可能需要排除故障的对象或如何连接至应用程序，如公开数据库的服务或 Ingress 规则。建议仅列出对人重要的对象，而不必列出您编排的所有对象。例如，不要列出存储用户不会修改的内部状态的配置映射。	选填
`SpecDescriptors`、`StatusDescriptors` 和 `ActionDescriptors`	与拥有的 CRD 基本相同。	选填

Operator Lifecycle Manager (OLM) 负责为每个唯一拥有的 API 服务创建或替换服务及 API 服务资源：

每当安装拥有的 API 服务时，OLM 均会处理服务密钥/证书对的生成。服务证书有一个通用名称（CN），其中包含生成的 Service 资源的主机名，并由嵌入在对应 API 服务资源中的 CA 捆绑包的私钥签名。

该证书作为类型 kubernetes.io/tls secret 存储在部署命名空间中，名为 apiservice-cert 的卷会自动附加至 CSV 中与 API 服务描述的 DeploymentName 字段匹配的 volumes 部分中。

如果尚不存在，则具有匹配名称的卷挂载也会附加至该部署的所有容器中。这样用户便可使用预期名称来定义卷挂载，以适应任何自定义路径要求。所生成的卷挂载的默认路径为 /apiserver.local.config/certificates，具有相同路径的任何现有卷挂载都会被替换。

Select Your Language