#使用 Connections

Connections 可让你在项目级别存储可复用的外部模型源和数据服务访问设置。

有关从 S3、PVC 或 OCI 源进行模型部署的直接 YAML 示例，请参见 Model Storage。

注意： 对于基于 OCI 的模型部署，模型部署表单中仅提供 ACCESS_TYPE 包含 Pull 的连接。

#前提条件

• 你有权访问目标项目命名空间。
• 已存在合适的连接类型。
• 你拥有要使用的外部存储或 registry 的凭据和终端节点信息。

#创建连接

1. 在 User View 中，打开目标项目。
2. 点击 Connections。
3. 点击 Create connection。
4. 选择一个连接类型。
5. 输入该连接的 Kubernetes 资源名称。
6. 可选：输入显示名称。
7. 完成所选连接类型定义的字段。
8. 点击 Create。

#内置字段集

• URI：在 URI 字段中提供完整 URI。
• OCI-compliant registry：提供 ACCESS_TYPE，上传或粘贴 .dockerconfigjson，并输入 OCI_HOST。
• S3-compatible object storage：提供 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_S3_ENDPOINT，并可选地提供 AWS_DEFAULT_REGION 和 AWS_S3_BUCKET。

#验证

• 新建项会出现在 Connections 页面上。
• 表格会显示连接名称、连接类型、兼容性标签和创建者。

注意： 连接资源名称和所选连接类型在创建后无法更改。

#更新连接

1. 在 Connections 页面上，打开目标连接的操作菜单。
2. 点击 Edit。
3. 更新显示名称或连接字段。
4. 点击 Save。

在你更新凭据或终端节点后，请重新部署或重启依赖的工作负载，以便它们获取最新值。

#删除连接

1. 在 Connections 页面上，打开目标连接的操作菜单。
2. 点击 Delete。
3. 确认该操作。

删除连接只会移除项目 Secret。任何仍依赖该 Secret 的工作负载都必须单独更新。

#管理连接类型

连接类型按集群范围进行管理，并存储在 kube-public 命名空间中。

#连接类型包含的内容

• 基本元数据：名称、显示名称、类别和启用状态
• 按顺序排列的分区标题和字段
• 可选的默认值和只读设置
• 用于 URI、OCI 或 S3 模型服务的兼容性标记

#内置模板

连接类型编辑器可追加以下预定义字段集：

• URI
• OCI compliant registry
• S3 compatible object storage

#支持的字段类型

注意： 当前 UI 中的 File 类型字段支持粘贴内容或上传最大 1 MiB 的文件。

#创建连接类型

1. 打开目标集群，转到 Settings > Connection types。
2. 点击 Create connection type。
3. 输入连接类型名称。平台会自动为其添加 ct- 前缀。
4. 可选：输入显示名称。
5. 选择一个或多个类别。
6. 根据需要设置 Enabled。
7. 添加分区标题和字段，或应用内置的模型服务兼容模板。
8. 点击 Create。

#复制、编辑、启用和删除

• 当你希望基于现有连接类型创建新的连接类型时，请使用 Duplicate。
• 自定义连接类型可以被编辑或删除。
• 预装连接类型可以复制，但当前 UI 不允许直接编辑或删除它们。
• 列表页提供 Enabled 开关，用于将连接类型标记为启用或禁用。

注意： 编辑连接类型不会重写之前创建的现有连接 Secret。

#在模型部署中使用连接

当你创建或更新推理服务时，可以将 Model location 设置为 Connection。

1. 打开推理服务创建或更新表单。
2. 将 Model location 设置为 Connection。
3. 选择该连接。
4. 根据连接类型完成模型路径字段：
   • URI：不需要额外路径；平台会从连接中读取完整 URI。
   • OCI：输入 oci://<OCI_HOST>/ 下的相对路径，例如 my-model:latest。
   • S3：输入 s3://<AWS_S3_BUCKET>/ 下的对象路径，例如 llm/qwen2.5。

#运行时行为

• 对于 OCI 连接，连接 Secret 会作为 imagePullSecret 挂载到工作负载。
• 对于 S3 连接，平台会创建一个专用的 ServiceAccount，并引用该连接 Secret。
• 推理服务元数据会将所选连接名称存储在 aml-model-source-connection 注解中。

#资源模型

当前实现对连接使用项目 Secret，对连接类型使用集群级别的 ConfigMap。

#连接 Secret 示例

apiVersion: v1
kind: Secret
metadata:
  name: minio-models
  namespace: demo-project
  labels:
    cpaas.io/dashboard: "true"
  annotations:
    cpaas.io/display-name: MinIO models
    cpaas.io/connection-type-ref: ct-s3-storage
    cpaas.io/connection-type-protocol: s3
    serving.kserve.io/s3-endpoint: minio.minio.svc:9000
    serving.kserve.io/s3-region: us-east-1
type: Opaque
stringData:
  AWS_ACCESS_KEY_ID: <access-key>
  AWS_SECRET_ACCESS_KEY: <secret-key>
  AWS_S3_ENDPOINT: http://minio.minio.svc:9000
  AWS_DEFAULT_REGION: us-east-1
  AWS_S3_BUCKET: models

#连接类型 ConfigMap 示例

apiVersion: v1
kind: ConfigMap
metadata:
  name: ct-uri-repository
  namespace: kube-public
  labels:
    cpaas.io/dashboard: "true"
    cpaas.io/connection-type: "true"
  annotations:
    cpaas.io/display_name: URI repository
    cpaas.io/disabled: "false"
data:
  category: '["URI"]'
  fields: >-
    [
      {
        "type": "section",
        "name": "URI",
        "description": "Fields required for URI model serving."
      },
      {
        "type": "uri",
        "name": "URI",
        "envVar": "URI",
        "required": true,
        "properties": {
          "defaultReadOnly": false
        }
      }
    ]

注意： 与最近的 OpenShift AI 文档相比，当前 Alauda AI 前端仍通过 cpaas.io/connection-type-ref 将连接绑定到其模板，并且还会将模型服务兼容性写入 cpaas.io/connection-type-protocol。