Red Hat Developer Hub 发行注记


Red Hat Developer Hub 1.6

Red Hat Developer Hub 1.6 发行注记

Red Hat Customer Content Services

摘要

Red Hat Developer Hub (Developer Hub) 1.6 现已正式发布。Developer Hub 是完全支持的企业级产品化版本,上游 Backstage 1.36.1。本文档包含 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 中的新功能。

在这个版本中,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

在这个版本中,在支持的身份验证提供程序中引入了一个新的可配置字段 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 自定义资源中以安装或配置插件。

在以前的版本中,使用 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。

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)以防止降级。

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 中的破坏更改。

在以前的版本中,Topology 插件使用 topology.view.read 权限来控制访问。用户无法使用 RBAC UI 配置 Topology 权限。在这个版本中,用户可以使用 RBAC UI 配置 Kubernetes 插件权限,这现在管理对 Topology 插件的访问。现在,您可以使用 Kubernetes 插件权限 kubernetes.clusters.readkubernetes.resources.readkubernetes.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 审计员服务定义的新审核员服务惯例。根据旧格式过滤查询可能无法按预期工作。

其他资源

Red Hat Developer Hub 1.6 引入了 Backstage Audit Log Service,它替换了自定义审计日志记录系统。这是对生成和消耗审计事件的方式有重大的结构化和行为更改。

此转换中引入的主要更改包括:

  • 现在,审计日志记录被委派给 Backstage 插件。Backstage 中的每个插件都负责实施和发出自己的审计事件。
  • 审计事件名称、结构和内容可能会因插件而异。审计事件使用标准化上游机制包括在每个插件内,它会自动捕获参与者详情和插件上下文。
  • 新的 Event Structure 和 Naming: 审计事件名称现在遵循 Backstage 的约定(例如,小写、kebab-case 名称),并包含结构化元数据,如 actionType。旧的 Developer Hub 事件名称(例如,ScaffolderTaskCreationCatalogEntityDeletion)不再使用。
  • 增强的日志上下文 :每个审计事件都包含插件上下文,从而更轻松地过滤特定功能区域的日志。您可以根据与该插件关联的事件 ID 或元数据进行过滤。

其他资源

在以前的版本中,Tekton 插件使用 tekton.view.read 权限来控制访问。用户无法使用 RBAC UI 配置 Tekton 权限。在这个版本中,用户可以使用 RBAC UI 配置 Kubernetes 插件权限,这现在管理对 Tekton 插件的访问。现在,您可以使用 Kubernetes 插件权限 kubernetes.clusters.read,kubernetes.resources.readkubernetes.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

其他资源

其他资源

第 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 的问题

在以前的版本中,全局标头中的 Profile 下拉菜单 显示 客户机,而不是在使用 OIDC 身份验证登录时用户的显示名称。

在这个版本中,Profile 下拉菜单 可以正确地显示用户的名称,首先检查 spec.profile.displayName,然后是 metadata.title,最后返回到 Settings 页面中显示的名称(如果都不可用)。

其他资源

在以前的版本中,只与前端插件关联的权限不会出现在 RBAC 前端 UI 中,因为它们需要后端插件来公开权限框架已知的端点。

在这个版本中,您可以使用 CSV 文件或直接调用 RBAC 后端插件的 REST API 来应用这些权限。受影响的插件包括 ArgoCD (argocd.view.read)和 Quay (quay.view.read)。

其他资源

在以前的版本中,在释放 1.6.0 Helm Chart 时,会使用上游品牌而不是红帽品牌。

这在 1.6.1 中解决

其他资源

5.3. 修复了 1.6.0 中的问题

在以前的版本中,Red Hat Developer Hub 文档不会在支持的 Kubernetes 平台上完全和部分 air-gapped 环境中使用 Helm Chart 来突出显示 Developer Hub 安装。

在这个版本中,文档提供了镜像所需的容器镜像、更新 Helm 值和安装 chart 的说明,而无需依赖互联网访问。

其他资源

5.3.2. 为长菜单标题标签启用行换

在以前的版本中,在侧边栏菜单中关闭带有长文本的菜单项,如 Platform Engineer Services。在这个版本中,长期菜单标题标签启用了行换行,防止修剪并确保完全文本可见性。

其他资源

在此次更新之前,app-config 配置 app.branding.iconLogo 没有作为浏览器中的 favicon 应用。

这个问题已被解决,app-config 配置 app.branding.iconLogo 现在可以正确地设置浏览器中的 favicon。

其他资源

在以前的版本中,当插槽设置为"bottom-left"时,FAB (FAB)会出现在导航栏上。这种放置模糊访问导航元素,这可能会妨碍用户交互。

在这个版本中,对 FAB 的位置进行了调整,以便呈现到"bottom-left' 插槽位置的导航中。因此,用户可以在不模糊的情况下访问导航选项。

其他资源

在以前的版本中,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

法律通告

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部