Red Hat Developer Hub 发行注记
Red Hat Developer Hub 1.6 发行注记
摘要
前言 复制链接链接已复制到粘贴板!
Red Hat Developer Hub (Developer Hub) 1.6 现已正式发布。Developer Hub 是完全支持的企业级产品化版本,上游 Backstage v1.36.1。您可以从 红帽客户门户网站 或 生态系统 目录访问并下载 Red Hat Developer Hub 应用程序。
第 1 章 新功能 复制链接链接已复制到粘贴板!
本节重点介绍 Red Hat Developer Hub 1.6 中的新功能。
1.1. OpenTelemetry 指标支持添加到 Keycloak 后端插件中 复制链接链接已复制到粘贴板!
在这个版本中,Keycloak 后端插件支持 OpenTelemetry 指标,它监控获取操作并诊断潜在的问题。
可用的计数器包括:
-
backend_keycloak_fetch_task_failure_count_total: Counts fetch task failures where no data was due an error. -
backend_keycloak_fetch_data_batch_failure_count_total: Counts partial data batch failures.即使某些批处理失败,插件也会继续获取 others。
这些计数器包括 taskInstanceId 标签,它唯一标识每个调度的 fetch 任务,并允许您将失败追踪回单个任务执行。
配置示例:
backend_keycloak_fetch_data_batch_failure_count_total{taskInstanceId="df040f82-2e80-44bd-83b0-06a984ca05ba"} 1
您可以使用任何 OpenTelemetry 兼容的后端导出指标,如 Prometheus。
1.2. 增强的会话持续时间控制和刷新令牌 Cookie 策略 复制链接链接已复制到粘贴板!
在这个版本中,在支持的身份验证提供程序中引入了一个新的可配置字段 sessionDuration。这样,管理员可以指定自定义用户会话持续时间,从而更好地控制会话超时并强制退出。另外,刷新令牌 Cookie 的默认最长期限已减少到 400 天,以便与现代 Web 浏览器策略保持一致。
如需更多信息,请参阅 Red Hat Developer Hub 中的身份验证。
1.3. 支持设置页面中的自定义版本信息 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 现在支持在设置页面中扩展或替换版本信息。此功能允许客户和合作伙伴将设置页面中的版本信息替换为自己的版本。
1.4. 更新了审核员服务 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 1.6 对 RBAC 和 Bulk Import 插件引入了改进,允许用户使用 Backstage 的新审核员服务。主要特性包括:
- 审计日志格式更新:
审计日志格式已更新,以匹配新的 Auditor 服务惯例。审计字段和事件标识符已更新。根据旧格式过滤查询可能无法正常工作。
- 后端插件 API 集成:
审计日志现在由 @backstage/backend-plugin-api 软件包支持。
- 审计事件分组:
Bulk Import backend 插件和 RBAC 后端插件为各种操作发出审计事件,事件按 eventId. 分组。
1.5. 将 Create 重命名为 Self-service 复制链接链接已复制到粘贴板!
术语 Create 已跨关键 UI 区域重命名为 Self-service,以更好地与通过 Backstage scaffolder 提供的自助服务功能保持一致,从而提高了用户的清晰性。
这个更改适用于以下区域:
- 侧边栏导航
- 全局标头
- 目录页面
- Scaffolder 页面
1.6. 增强的 Extensions 目录中的插件可见性 复制链接链接已复制到粘贴板!
在这个版本中,扩展目录直接在 Red Hat Developer Hub 中显示包含插件的默认配置。此功能有助于管理员在启用插件前更好地了解可用的插件及其配置选项。虽然插件配置现在可见,但管理员仍然需要将这些配置手动复制到其 Helm Charts 或 Operator 自定义资源中以安装或配置插件。
1.7. 使用自动 baseUrl 配置简化 OpenShift 支持的 Operator 部署 复制链接链接已复制到粘贴板!
在以前的版本中,使用 Operator 部署 Developer Hub 需要在自定义 app-config ConfigMap 中手动配置 baseUrl 设置。
在这个版本中,Operator 可以根据 OpenShift 集群入口域和 Backstage 自定义资源中的自定义 Route 设置自动计算默认应用程序 URL。然后,它会将它填充为 app-config ConfigMap 中为 Developer Hub 实例生成的默认 baseUrl。此功能特定于 OpenShift。Operator 在默认的 app-config ConfigMap 中填写以下字段: app.baseUrl,backend.baseUrl, 和 backend.cors.origin。因此,这消除了为 OpenShift 上大多数由 Operator 支持的部署设置这些值的需求,但您仍可在自定义 app-config ConfigMap 中覆盖这些设置。
1.8. 新的侧边栏项目可见性配置 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 现在支持一个干净且灵活的方法,使用侧边栏菜单中新启用的密钥隐藏侧边栏项目。如果设置为 false,则指定的侧边栏项将不再显示在 UI 中,同时保持完全向后兼容现有配置。
配置示例:
dynamicPlugins:
frontend:
default.main-menu-items:
menuItems:
default.home:
title: Home
icon: home
enabled: false
default.list:
title: References
icon: bookmarks
default.my-group:
parent: default.list
default.learning-path:
parent: default.list
title: ''
default.homepage:
title: HomePage 123
icon: home
enabled: false
default.create:
title: Create
icon: add
parent: default.homepage
现在,您还可以切换徽标、搜索、设置和管理等核心侧边栏元素的可见性,如下所示:
app:
sidebar:
search: false # hides sidebar search
logo: false # hides sidebar logo
settings: false # hides settings item
administration: false # hides administration item
1.9. Developer Hub 社区插件更新至 Backstage 1.36 复制链接链接已复制到粘贴板!
Developer Hub 社区插件已更新至 Backstage 版本 1.36。
1.10. 在 RBAC 插件中添加了新的 RBAC 条件规则 IS_OWNER 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 引入了一个新的 RBAC 条件规则 IS_OWNER,它允许管理员为角色分配所有权并控制对 RBAC 插件的访问。此功能增强通过允许对角色、权限策略和条件策略进行基于所有权的过滤来实现更精细的访问控制。
此增强从 policy.entity.create 权限中删除资源类型,防止将条件规则应用到权限。您可以更新使用带有操作 create 的资源类型 policy-entity 的所有权限策略(如 role:default/some_role, policy-entity, create, allow to role:default/some_role, policy.entity.create, create, allow)以防止降级。
1.11. 支持 Microsoft Azure Kubernetes Service 中的高可用性 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 现在支持 Microsoft Azure Kubernetes Service (AKS)中的高可用性设置。此功能增强允许部署超过单个副本,确保应用程序保持运行,即使出现故障或中断也是如此。
如需更多信息,请参阅 Red Hat Developer Hub 中配置高可用性。
Red Hat Developer Hub 现在支持 @backstage/plugin-scaffolder-backend-module-github 插件,在软件模板中启用 GitHub Actions。通过此集成,您可以安全地创建和管理存储库,打开拉取请求,触发 GitHub Actions 工作流,等等都直接从软件模板中。此插件允许用户轻松自动执行 GitHub 交互和工作流。
1.13. 默认 OIDC 注册解析器更新 复制链接链接已复制到粘贴板!
在这个版本中,OIDC 符号的默认解析器被设置为 oidcSubClaimMatchingKeycloakUserId 来增强安全性。现在,这个解析器也可以在登录解析器设置下作为可配置的选项提供。
1.14. Kubernetes builder 操作的新动态插件 复制链接链接已复制到粘贴板!
在这个版本中,Developer Hub 引入了 @backstage-community/plugin-scaffolder-backend-module-kubernetes 插件,为 Kubernetes 启用 Backstage 模板操作。目前,它包含 create-namespace 操作。这个动态插件默认是禁用的。
如需更多信息,请参阅 Red Hat Developer Hub 中的 Kubernetes 自定义操作。
第 2 章 可能会造成问题的更改 复制链接链接已复制到粘贴板!
本节列出了 Red Hat Developer Hub 1.6 中的破坏更改。
2.1. 特定于拓扑的权限 topology.view.read 已被删除 复制链接链接已复制到粘贴板!
在以前的版本中,Topology 插件使用 topology.view.read 权限来控制访问。用户无法使用 RBAC UI 配置 Topology 权限。在这个版本中,用户可以使用 RBAC UI 配置 Kubernetes 插件权限,这现在管理对 Topology 插件的访问。现在,您可以使用 Kubernetes 插件权限 kubernetes.clusters.read、kubernetes.resources.read 和 kubernetes.proxy 用于 Topology 插件,因为删除了特定于 Topology 的权限 topology.view.read。
如果您使用 CSV 权限文件,请更新以下行:
旧 Topology 权限定义
p, role:default/topology-viewer, topology.view.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow
新的 Topology 权限定义
p, role:default/topology-viewer, kubernetes.clusters.read, read, allow
p, role:default/topology-viewer, kubernetes.resources.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow
其他资源
2.2. 迁移到核心审核员服务 复制链接链接已复制到粘贴板!
审核员格式(包括审计字段和事件名称以及 ID)已更新,以匹配上游 Backstage 审计员服务定义的新审核员服务惯例。根据旧格式过滤查询可能无法按预期工作。
其他资源
2.3. Red Hat Developer Hub 引入了 Backstage 审计日志服务 复制链接链接已复制到粘贴板!
Red Hat Developer Hub 1.6 引入了 Backstage Audit Log Service,它替换了自定义审计日志记录系统。这是对生成和消耗审计事件的方式有重大的结构化和行为更改。
此转换中引入的主要更改包括:
- 现在,审计日志记录被委派给 Backstage 插件。Backstage 中的每个插件都负责实施和发出自己的审计事件。
- 审计事件名称、结构和内容可能会因插件而异。审计事件使用标准化上游机制包括在每个插件内,它会自动捕获参与者详情和插件上下文。
-
新的 Event Structure 和 Naming: 审计事件名称现在遵循 Backstage 的约定(例如,小写、kebab-case 名称),并包含结构化元数据,如
actionType。旧的 Developer Hub 事件名称(例如,ScaffolderTaskCreation、CatalogEntityDeletion)不再使用。 - 增强的日志上下文 :每个审计事件都包含插件上下文,从而更轻松地过滤特定功能区域的日志。您可以根据与该插件关联的事件 ID 或元数据进行过滤。
其他资源
2.4. 特定于 Tekton 的权限 tekton.view.read 已被删除 复制链接链接已复制到粘贴板!
在以前的版本中,Tekton 插件使用 tekton.view.read 权限来控制访问。用户无法使用 RBAC UI 配置 Tekton 权限。在这个版本中,用户可以使用 RBAC UI 配置 Kubernetes 插件权限,这现在管理对 Tekton 插件的访问。现在,您可以使用 Kubernetes 插件权限 kubernetes.clusters.read,kubernetes.resources.read 和 kubernetes.proxy 用于 Tekton 插件,因为删除了特定于 Tekton 的权限 tekton.view.read。
如果您使用 CSV 权限文件,请更新以下行:
旧的 Tekton 权限定义
p, role:default/tekton-viewer, tekton.view.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow
新的 Tekton 权限定义
p, role:default/tekton-viewer, kubernetes.clusters.read, read, allow
p, role:default/tekton-viewer, kubernetes.resources.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow
其他资源
第 3 章 弃用的功能 复制链接链接已复制到粘贴板!
本节列出了 Red Hat Developer Hub 1.6 中的已弃用的功能。
3.1. 弃用带有 import (…)的动态导入 复制链接链接已复制到粘贴板!
使用带有 import (…) 的动态导入功能已被弃用,不再被支持。Backstage CLI 支持 Node.js 代码中的原生 ESM,提供对导入的 ESM 软件包的访问权限。因此,在使用 ESM 或 CommonJS 软件包时,您必须使用 require (…) 作为 typeof import (…)。
其他资源
第 4 章 开发者预览 复制链接链接已复制到粘贴板!
本节列出了 Red Hat Developer Hub 1.6 中的开发人员预览功能。
Developer Preview(开发人员预览)功能不被红帽支持,其功能可能并不完善且不是生产环境就绪。不要将开发人员预览功能用于生产环境或业务关键型工作负载。开发人员预览功能在红帽产品产品中包括早期对功能的访问。客户可以使用这些功能在开发过程中测试并提供反馈。开发人员预览功能可能没有任何文档,可以随时更改或删除,并且已获得有限的测试。红帽可能会提供在没有关联 SLA 的情况下提交对开发人员预览功能的反馈。
有关红帽开发人员预览功能的支持范围的更多信息,请参阅 开发人员预览支持范围。
4.1. Red Hat Developer Hub Local 复制链接链接已复制到粘贴板!
Red Hat Developer Hub Local (RHDH Local)现在作为开发者预览功能提供,提供轻量级、自包含的 RHDH 版本,允许开发人员和平台工程师在模板上工作、试用插件、验证软件目录和执行其他任务,而无需在 Kubernetes 集群上安装 Developer Hub。
有关安装 RHDH 本地的更多信息,请参阅 Red Hat Developer Hub Local on Github。
其他资源
- 如需更多信息,请参阅博客文章,本地使用 Ease 运行 Red Hat Developer Hub
其他资源
第 5 章 修复的问题 复制链接链接已复制到粘贴板!
本节列出了 Red Hat Developer Hub 1.6 中修复的问题。
5.1. 修复了 1.6.2 中的问题 复制链接链接已复制到粘贴板!
5.1.1. 修复了安装时 helm chart 的错误描述 复制链接链接已复制到粘贴板!
在以前的版本中,在安装 1.6.1 Helm Chart 时,会使用上游 readme 文本而不是红帽文本。
这在 1.6.2 中解决
其他资源
5.2. 修复了 1.6.1 的问题 复制链接链接已复制到粘贴板!
5.2.1. 修复了显示 客户机 而不是带有 OIDC 身份验证的用户名称的问题 复制链接链接已复制到粘贴板!
在以前的版本中,全局标头中的 Profile 下拉菜单 显示 客户机,而不是在使用 OIDC 身份验证登录时用户的显示名称。
在这个版本中,Profile 下拉菜单 可以正确地显示用户的名称,首先检查 spec.profile.displayName,然后是 metadata.title,最后返回到 Settings 页面中显示的名称(如果都不可用)。
其他资源
5.2.2. ArgoCD 插件权限和 Quay 插件权限不会在 RBAC 前端 UI 中显示 复制链接链接已复制到粘贴板!
在以前的版本中,只与前端插件关联的权限不会出现在 RBAC 前端 UI 中,因为它们需要后端插件来公开权限框架已知的端点。
在这个版本中,您可以使用 CSV 文件或直接调用 RBAC 后端插件的 REST API 来应用这些权限。受影响的插件包括 ArgoCD (argocd.view.read)和 Quay (quay.view.read)。
其他资源
5.2.3. 修复了 1.6.0 Helm Chart 发行版本中的错误品牌 复制链接链接已复制到粘贴板!
在以前的版本中,在释放 1.6.0 Helm Chart 时,会使用上游品牌而不是红帽品牌。
这在 1.6.1 中解决
其他资源
5.3. 修复了 1.6.0 中的问题 复制链接链接已复制到粘贴板!
5.3.1. 为非 OpenShift 平台更新了 air-gapped 安装指南 复制链接链接已复制到粘贴板!
在以前的版本中,Red Hat Developer Hub 文档不会在支持的 Kubernetes 平台上完全和部分 air-gapped 环境中使用 Helm Chart 来突出显示 Developer Hub 安装。
在这个版本中,文档提供了镜像所需的容器镜像、更新 Helm 值和安装 chart 的说明,而无需依赖互联网访问。
其他资源
5.3.2. 为长菜单标题标签启用行换 复制链接链接已复制到粘贴板!
在以前的版本中,在侧边栏菜单中关闭带有长文本的菜单项,如 Platform Engineer Services。在这个版本中,长期菜单标题标签启用了行换行,防止修剪并确保完全文本可见性。
其他资源
5.3.3. app-config.yaml 中的动态 favicon 配置不会在登录页面中显示 复制链接链接已复制到粘贴板!
在此次更新之前,app-config 配置 app.branding.iconLogo 没有作为浏览器中的 favicon 应用。
这个问题已被解决,app-config 配置 app.branding.iconLogo 现在可以正确地设置浏览器中的 favicon。
其他资源
5.3.4. 浮动操作按钮(FAB)位于 Developer Hub 上的 'Bottom-Left' 插槽中 复制链接链接已复制到粘贴板!
在以前的版本中,当插槽设置为"bottom-left"时,FAB (FAB)会出现在导航栏上。这种放置模糊访问导航元素,这可能会妨碍用户交互。
在这个版本中,对 FAB 的位置进行了调整,以便呈现到"bottom-left' 插槽位置的导航中。因此,用户可以在不模糊的情况下访问导航选项。
其他资源
5.3.5. 手动添加的分辨率覆盖解决方案,由 -suppress-native-package添加 复制链接链接已复制到粘贴板!
在以前的版本中,export-dynamic-plugin 命令没有覆盖手动添加分辨率,这可能会导致导出的动态插件中的软件包依赖项不正确。
在这个版本中,软件包 export-dynamic-plugin 覆盖手动添加的解析,确保返回阶段依赖项被处理,并且禁止从导出的动态插件中阻止原生依赖项。
其他资源
在以前的版本中,OpenShift Container Platform Web 控制台中的 Developer Hub Operator 详情页面包含一些无法在红帽网络外访问的页面的链接。在这个版本中,Operator 安装信息页面中的链接已被修复。
其他资源
第 6 章 修复了安全问题 复制链接链接已复制到粘贴板!
您可以查看 Red Hat Developer Hub 1.6 中由红帽 安全更新 中修复的安全问题。
对于 1.6.3,请参阅 红帽程序错误修复公告 RHBA-2025:11475。
有关 1.6.2,请参阅 红帽安全公告 RHSA-2025:9966。
对于 1.6.0 和 1.6.1,请参阅 红帽安全公告 RHSA-2025:7626。