#发版日志

#兼容性和支持矩阵

下表展示了 Alauda DevOps Connectors operator 与 ACP 版本之间的兼容性和支持矩阵。

#v1.6.1

#功能与增强

• 安全更新：更新基础镜像、依赖项，修复安全漏洞。

#修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v1.6.0

#功能与增强

更多 Connectors

• 支持通过 GitLab Connector 集成 GitLab Server。详情请参见：
  • GitLab Connector 快速开始
• 支持通过 NPM Connector 集成 NPM Registries。详情请参见：
  • NPM Connector 快速开始
• 支持通过 Harbor Connector 集成 Harbor Registries。详情请参见：
  • Harbor Connector 快速开始

Pipeline 集成的 ResourceInterface

• 提供开箱即用的 GitCodeRepository、OCIArtifact 和 MavenArtifact 资源定义，实现通过统一的 UI 界面将外部资源（Git 仓库、OCI 工件、Maven 工件）无缝集成到 TektonCD pipeline 中。详情请参见：
  • ResourceInterface
  • Pipeline Integration
• 支持 Pipeline 集成中 ResourceInterface 的动态表单。详情请参见 ResourceInterface 动态表单。

UI 增强

• 新增通过平台 UI 创建和管理 Connector 和 ConnectorClass 资源的支持，简化了连接器配置。

Connector API 增强

• 当 ConnectorClass 提供 Proxy Service 功能时，支持通过 Connector API 访问工具的原生 API。系统现支持两种访问工具资源的方式：通过 Proxy Service 使用工具原生 API，或使用为 ConnectorClass 提供的自定义 API。详情请参见 Connector API。

ConnectorClass 自定义灵活性

• 支持在使用内置 HTTP 反向代理时，通过 Rego 规则从客户端请求中提取令牌。结合现有通过 Rego 规则向后端请求注入认证凭证的能力，您现在可以扩展内置反向代理的功能，以支持非标准 HTTP 认证机制的工具。
  • 令牌提取配置请参见 基于 Rego 的自定义认证。
  • 认证注入配置请参见 使用内置反向代理时向后端请求注入认证凭证。
• 支持在 spec.auth.types[].generator.rego 中使用请求变量向后端请求注入认证凭证。详情请参见 Rego 中可用变量。

OCI Connector 正向代理

• OCI Connector 支持使用正向代理进行镜像操作。详情请参见 OCI Connector 正向代理。

CSI Driver 内置配置

• Connectors CSI Driver 提供始终挂载到 Pod 中的内置配置文件。详情请参见 内置配置。

其他增强

• 新增文档说明每个连接器所需的凭证权限。详情请参见 凭证权限需求。

#破坏性变更

• 移除 spec.auth.types[].generator.rego 中的 input.xxx 变量，改用 input.data.xxx。

#修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v1.4.0

#功能与增强

• 支持通过 Maven Connector 和 PyPI Connector 集成 Maven 和 PyPI Registries。详情请参见：
  • Maven Connector 快速开始
  • PyPI Connector 快速开始
• 安全更新：更新基础镜像、依赖项，修复安全漏洞。

#破坏性变更

无破坏性变更。

#修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v1.2.1

#功能与增强

• 支持通过 Kubernetes Connector 集成 Kubernetes 集群，并支持在 k8s 工作负载或 tektoncd pipeline 中使用 Kubernetes Connector。详情请参见：
  • Kubernetes Connector 快速开始
  • 理解 Kubernetes Connector
  • 在 tektoncd pipeline 中使用 Kubernetes Connector
• 安全更新：更新基础镜像、依赖项，修复安全漏洞。

#破坏性变更

无破坏性变更。

#修复的问题

• 在此更新之前，如果 ACP 打开了 project-ns-prefix 功能开关， 在业务集群ACP 项目下的 NS Pod 中挂载项目级别的Connector会提示权限错误，此次更新之后，修复了该问题。ACP 打开 project-ns-prefix 功能开关的情况下，在业务集群ACP 项目下的 NS Pod 中，可以正常挂载项目级别的Connector。

#已知问题

此次发版无相关问题。

#v1.1.0

#功能与增强

• 支持在 k8s 中拉取镜像时使用 OCI Connector。详情请参见：使用 OCI Connector 以无密方式部署工作负载
• 安全更新：更新基础镜像、依赖项，修复安全漏洞。

#破坏性变更

#OCI ConnectorClass resolver-type 变更

OCI connector 镜像地址格式已更新，以提供更好的命名空间隔离和资源管理。

旧格式：c-connector.connector-ns.svc.cluster.local

新格式：connector.connector-ns.svc.cluster.local/namespaces/<connector-ns>/connectors/<connector-name>

影响场景：

• 在 K8S Job 中使用 OCI Connector 构建镜像：镜像地址由 c-harbor.default.svc.cluster.local/test/demo:v1 变更为 harbor.default.svc.cluster.local/namespaces/oci-connector-demo/connectors/oci-connector/test/demo:v1
• 在 Tekton Pipeline 中使用 OCI Connector 构建镜像：镜像地址由 c-harbor.default.svc.cluster.local/test/demo:v1 变更为 harbor.default.svc.cluster.local/namespaces/oci-connector-demo/connectors/oci-connector/test/demo:v1

升级说明：现有使用 OCI connector 的工作负载需更新镜像地址格式以适配新的命名规范。

#Services "c-xxx" 已存在

升级到 v1.1.0 后，v1.0.8 创建的 Connectors 可能会遇到错误：services "c-xxx" already exist

该问题是由于与 Connector 代理关联的 Service 标签发生变化，导致无法匹配旧的 Service。

解决方案：删除冲突名称的 Service 资源，Connector 状态将自动恢复。

#修复的问题

• 在此更新之前，在 kubernetes 1.31 之前部署 Connectors 组件后，由于 kubernetes Server-side apply 存在bug（https://github.com/kubernetes/kubernetes/issues/124605）， 会不断的更新资源的 resourceVersion，可能导致集群的稳定性下降。此次更新之后，connectors-operator 绕过了该问题，在 kubernetes 1.31 之前版本部署，仅有 resourceVersion 变更时不会触发 reconcile。
• 在此更新之前，如果 Connectors 组件部署到 非 connectors-system 命名空间下，创建的 OCI Connector 的认证状态会一直处于失败状态。 此次更新之后， 修复了该问题。 OCI Connector 的认证状态不会受到组件部署命名空间的影响，能够准确反馈凭据的有效性。
• 在此更新之前，部署完 Connectors 组件之后，组件状态正常，在 Pod 中使用 connectors-csi driver 时，会偶发提示 “driver name connectors-csi not found in list of registered csi driver”， 导致 Pod 无法启动。 此次更新之后，修复了该问题。部署完成之后，组件状态正常的情况下，Pod 中可正常使用 connectors-csi driver，不会遇到该偶发问题

#已知问题

此次发版无相关问题。

#v1.0.8

#功能与增强

• 安全更新：更新基础镜像、依赖项，修复安全漏洞。

#修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v1.0.4

#功能与增强

#Alauda DevOps Connectors v1.0（Alpha）

Connectors 提供了一种安全高效的方式连接外部服务和工具，并提供了无侵入式的集成方式。平台团队可以轻松且安全地创建连接器，同时保护访问凭证。

开箱即用支持：

• git 仓库
• oci 注册表

Connectors 还通过 API 和自定义连接器实现提供了自定义连接器的扩展能力。

#修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。