Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

Red Hat Developer Hub 1.1 发行注记

Red Hat Developer Hub 1.1

Red Hat Customer Content Services

摘要

Red Hat Developer Hub 是一个用于构建开发人员门户的开发人员平台。本文档包含 Red Hat Developer Hub 1.1 发行注记。

前言
复制链接

Red Hat Developer Hub (Developer Hub) 1.1 现已正式发布。Developer Hub 是上游 Backstage v1.23.4 完全支持的企业级产品化版本。您可以从 客户门户网站 访问并下载 Red Hat Developer Hub。

Red Hat Developer Hub 支持
复制链接

如果您在执行本文档所述的某个流程时遇到问题，请访问红帽客户门户。您可以使用红帽客户门户网站进行以下目的：

第 1 章 关于此版本
复制链接

本发行注记提供了 Red Hat Developer Hub 1.1 中已实现的功能的高级信息，并记录了本发行版中的已知问题。

本发行版本中的一些功能可能作为技术预览提供，提供对即将推出的产品功能的访问，使客户能够测试功能并在开发过程中提供反馈。

有关红帽技术预览功能支持范围的更多信息，请参阅 技术预览支持范围。

Red Hat Developer Hub 的优点包括：

  • 提高开发人员生产率 ：通过消除常见的组织挑战、实现无缝协作以及为创建、开发和部署应用程序提供明确的指导，提高开发人员的工作效率。
  • 统一自助服务仪表板：通过统一仪表板 （如 Git、CI/CD、SAST/DAST、Supply Chain、OpenShift/Kubernetes 集群、JIRA、监控、API、文档等）提供给开发团队，由 150 个插件促进。所有由平台工程团队策展的，与公司的最佳实践一致。
  • 通过软件模板进行最佳实践 ：通过编码通用任务（如创建新应用、运行 Ansible 作业以及为 Git 中生产部署建立 CI/CD 管道）来自动化组织最佳实践。
  • 可扩展技术文档 ：代码和文档驻留在同一存储库中，消除了对专有文档系统的依赖性。
  • 有效地加入新开发人员 ：新开发人员在短时间内迅速适应和提高生产力。
  • 强大的企业级基于角色的访问控制(RBAC) ：让管理员创建角色、将用户或组分配到角色，以及实施强大的安全策略以增强访问控制。

1.1. 支持的平台
复制链接

  • OpenShift Container Platform 4.12, 4.13, 4.14, 4.15
  • Red Hat OpenShift Service on AWS (ROSA)
  • Azure Red Hat OpenShift (ARO)
  • Amazon Elastic Kubernetes Service (EKS)
  • Microsoft Azure Kubernetes Service (AKS)
  • [技术预览] Google Kubernetes Engine (GKE)

1.2. 支持的构架
复制链接

容器可用于以下 CPU 架构：

  • AMD64 和 Intel 64 (x86_64)

1.3. 升级 Red Hat Developer Hub Helm Chart
复制链接

您可以使用以下方法升级到 Red Hat Developer Hub 的新版本：

  • OpenShift web 控制台

    1. 在 Developer 视角中，点 Helm 打开 Helm Releases 选项卡。
    2. 点 Helm release 条目旁边的三个点，然后选择 Upgrade。
    3. 在 Upgrade Helm Release 页面中，从 chart 版本 下拉列表中选择您要升级到的 Developer Hub 版本。

    4. 单击 Upgrade。

      注意

      在旧版本中的资源被删除并启动 Developer Hub pod 的较新版本时，您必须等待。

    5. 关闭所有打开的 Developer Hub 网页，然后再次登录以验证升级是否成功。

  • OpenShift CLI

    1. 以集群管理员身份登录 OpenShift 集群，并切换到 devhub 项目。 

      oc login -u <user> -p <password> https://api.<HOSTNAME>:6443
oc project devhub
      Copy to Clipboard Toggle word wrap

    2. 对于 Developer Hub helm chart 的新版本，请运行以下命令： 

      helm upgrade -i rhdh -f new-values.yml \
  openshift-helm-charts/redhat-developer-hub --version 1.1.4
      Copy to Clipboard Toggle word wrap
      注意

      您还可以通过在工作站上创建一个 new-values.yml 文件，其值覆盖安装图表中的属性或添加新属性，来为 Chart 提供额外的值。

第 2 章 新功能
复制链接

本节重点介绍 Red Hat Developer Hub 1.1 中的新功能。

2.1. Red Hat Developer Hub Operator 现已正式发布(GA)
复制链接

您可以使用 Red Hat Developer Hub Operator 在 OpenShift Container Platform 集群上安装 Developer Hub。如需更多信息，请参阅管理指南中的 使用 Operator 安装 Red Hat Developer Hub 部分。

2.2. 产品化版本的变化
复制链接

Red Hat Developer Hub 产品化版本现在基于上游 Backstage 项目 v1.23.4。

现在，您可以使用 Developer Hub 为各个用户或组分配特定的角色和权限。使用 Developer Hub Web 界面，您可以执行以下操作：

  • 创建角色
  • 编辑角色和相关权限
  • 删除角色

如需更多信息， 请参阅管理指南中的 Red Hat Developer Hub 中的基于角色的访问控制部分。

2.4. 将 Red Hat Developer Hub 迁移到新的后端系统
复制链接

Red Hat Developer Hub 1.1 现在迁移到 Backstage 新的后端系统。在这个版本中，您可能会注意到 Developer Hub 应用程序中的以下功能相关的更改：

2.4.1. 新的 Scaffolder 身份客户端
复制链接

身份客户端正常工作稍有不同，由新后端系统 Scaffolder 插件和上一版本中使用的后端系统稍有不同。

新的后端系统的 Scaffolder 插件使用身份服务，该服务引入了影响错误处理的差别。例如，当在请求中遇到无效的授权标头时，Developer Hub 会将错误记录到控制台，而不是丢弃它。

2.4.2. 启用所有 GitLab 操作
复制链接

Red Hat Developer Hub 1.1 默认启用所有 GitLab 操作。

2.5. 支持 Elastic Kubernetes 服务(EKS)
复制链接

现在，您可以在 EKS 集群中安装和使用 Red Hat Developer Hub。

如需更多信息，请参阅管理指南中的 Red Hat Developer Hub 与 Amazon Web Services 集成 部分。

2.6. 支持 Azure Kubernetes 服务(AKS)
复制链接

现在，您可以在 AKS 集群中安装和使用 Red Hat Developer Hub。

如需更多信息，请参阅管理指南中的 Red Hat Developer Hub 与 Azure Kubernetes Services 集成 部分。

2.7. 支持使用 Web 界面查看已安装的插件
复制链接

现在，您可以使用 Developer Hub Web 界面查看已安装的插件表。此功能使用 dynamic-plugins-info frontend 组件，它生成 Red Hat Developer Hub 中当前安装的插件表。您可以将客户端侧排序、过滤和分页应用到 plugins 表。

如需更多信息， 请参阅管理指南中的查看已安装的插件 部分。

2.8. Red Hat Developer Hub 1.1 中支持的插件
复制链接

要获得支持的动态插件的完整列表，请参阅管理指南中的 Red Hat Developer Hub 中包含的动态插件 部分。

第 3 章 可能会造成问题的更改
复制链接

本节列出了 Red Hat Developer Hub 1.1 的破坏更改：

3.1. GitHub 机构目录供应商中的配置更改
复制链接

新后端系统的 GitHub 机构目录模块切换到新的 GithubMultiOrgEntityProvider 供应商，它允许从多个 GitHub 机构获取数据。这个新供应商会更改默认插件配置设置。您必须升级 @backstage/plugin-catalog-backend-module-github-org 插件，并使用以下方法重新配置它： 

kind: ConfigMap
apiVersion: v1
metadata:
  name: app-config-rhdh
data:
  app-config-rhdh.yaml: |
    ...
    catalog:
      providers:
        githubOrg:
          id: production
          githubUrl: "${GITHUB_URL}"
          orgs: [ "${GITHUB_ORG}" ]
1 

    ...
Copy to Clipboard Toggle word wrap
1
将 ${GITHUB_ORG} 替换为您要从中隐藏用户的 GitHub 组织。

如需更多信息，请参阅 Getting started 指南中的 Red Hat Developer Hub 中启用 GitHub 机构成员发现 部分。

第 4 章 技术预览
复制链接

本节列出了 Red Hat Developer Hub 1.1 中技术预览的功能。

重要

这些功能仅用于技术预览。红帽产品服务级别协议（SLA）不支持技术预览功能，且其功能可能并不完善，因此红帽不建议在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能的更多信息，请参阅 技术预览功能范围。

4.1. Red Hat Developer Hub 中的插件
复制链接

Red Hat Developer Hub 包含各种动态插件。红帽完全支持某些插件，而其他插件则是社区支持的项目。有些插件会被默认启用，其他插件需要配置，因此默认禁用。

有关如何启用、禁用或配置动态插件的更多信息，请参阅管理指南中的 安装动态插件 部分。

要获得支持的动态插件的完整列表，请参阅管理指南中的 Red Hat Developer Hub 中包含的动态插件 部分。

第 5 章 已知问题
复制链接

5.1. Red Hat Developer Hub 1.1.2 中已知的问题
复制链接

部署失败并显示错误：迁移表已锁定

当您将 Developer Hub 更新至最新的 1.1.z Helm Chart 时，如果集群中有一个或多个已存在的 Developer Hub 实例，现有的 Helm chart 或数据库可能会与新部署不兼容。

因此，当部署新的 Developer Hub 实例时，即使您使用不同的命名空间，部署可能会失败，并显示以下错误消息： MigrationLocked: Migration 表已被锁定。

临时解决方案： 保存现有的 ConfigMap 和 Helm Chart 配置，然后在部署最新的 1.1.z Helm Chart 前删除任何已存在的 Red Hat Developer Hub 部署。

在 Openshift Developer Console 上 Helm Chart 升级发行版本失败

如果您使用 Helm CLI 手动安装 Developer Hub，则 OpenShift Developer 控制台中的 helm chart 发行版本升级会失败。

临时解决方案 ：您可以使用 Helm CLI 升级。如果您仍然希望使用控制台升级，则临时解决方案是从下拉列表中选择 Helm Chart 版本，并选择要升级到的 Developer Hub 版本。在执行此临时解决方案前，请确保您的 values.yaml 配置文件保存到其他位置。

使用持久缓存进行 Developer Hub 升级路径的问题
如果您使用 Red Hat Developer Hub 配置了缓存，并计划升级到其新版本，请确保已删除该缓存。升级后将重新创建新的缓存。
为新后端系统重新设计了 事件 插件

新的后端系统不完全支持 Events 插件，因此如果未完全中断，则其有用性会大大减少。

对新后端系统的 事件 插件支持的完整重新设计正在进行中，但插件仍无法集成到此 Red Hat Developer Hub 发行版本中。这个限制会临时防止第三方完全使用插件或模块中的事件，以作为 Red Hat Developer Hub 的动态插件。

RBAC 插件的问题

在新的后端系统中，无法自动获取所有动态安装插件的 ID。这意味着支持 RBAC 的动态插件的权限不会自动显示在 RBAC UI 中。

临时解决方案 ：您可以手动在 Developer Hub 应用程序配置文件中添加支持 RBAC 的动态插件 ID 列表。

OpenShift Container Platform 4.15.3 部署的问题
在 OpenShift Container Platform 4.15.2 或更早版本上部署 Developer Hub 实例，以避免在 OpenShift Container Platform 4.15.3 部署中报告已知问题。如需更多信息，请参阅 OCPBUGS-31080。

第 6 章 修复的问题
复制链接

6.1.1. Red Hat Developer Hub 1.1.1 中的安全修复
复制链接

这个版本应用了多个安全修复，包括：

无法使用自定义 sidecar 容器

在早期版本的 Developer Hub 中，您无法通过覆盖 Developer Hub 镜像来使用 sidecar 容器。

在 Red Hat Developer Hub 1.1.2 中，CR Resource spec.rawRuntimeConfig 字段中定义的 sidecar 容器镜像不会被 RELATED_IMAGE_* 环境变量或 spec.application.image 字段覆盖。

对 Kubernetes 中的非公共镜像的支持

在早期版本的 Developer Hub 中，在使用 Operator 安装 Red Hat Developer Hub 时，无法为 PostgreSQL pod 配置镜像 pull secret。

因此，对于本地 PostgreSQL 数据库，这个问题会阻止用户在非 OpenShift Container Platform 集群中使用非公共镜像，如 Amazon Elastic Kubernetes Service (EKS)或 Microsoft Azure Kubernetes Service (AKS)。

在 Red Hat Developer Hub 1.1.2 中，您可以在 spec.application.imagePullSecrets 中为 Developer Hub 和 PostgreSQL pod 配置镜像 pull secret。

无法使用 Helm CLI 安装 Red Hat Developer Hub 1.1.1

在 Developer Hub 1.1.0 发行版本后，OpenShift Helm chart 被重命名为，为 secret 创建与 Developer Hub 1.1.0 命名规则不兼容。

因此，在 Developer Hub 1.1.1 中，如果由 Helm CLI 安装，容器无法启动。

Developer Hub 1.1.1 中引入的这个回归问题已在 Developer Hub 1.1.2 中解决。

Operator pod 可能会遇到内存不足错误

在部署和服务等大量对象的集群中，Developer Hub operator pod 可能会失败，并显示 OOMKilled 状态，因为内存分配不足。

在 Developer Hub 1.1.2 中，这个问题已通过为 pod 分配 1Gi 内存来解决。

ArgoCD 插件从 2.6.2 降级到 2.4.1
当使用 ArgoCD 后端插件时，EntityArgoCDHistoryCard 无法正常工作。这个问题已通过将 ArgoCD 插件版本恢复到 2.4.1 来解决。如需更多信息，请参阅 https://github.com/RoadieHQ/roadie-backstage-plugins/issues/1238
Helm Chart 部署问题

在 Red Hat Developer Hub 1.1.0 中，由于无法在 config.openshift.io API 组中获取资源 "ingresses"，没有集群管理员权限的用户无法在托管的 OpenShift Container Platform 实例中部署 Red Hat Developer Hub 1.1.0 Helm Chart。这个问题已通过不自动查询用于 clusterRouterBase 的域的 OpenShift Container Platform 集群入口来解决，因为普通用户无法访问此资源，只有集群管理员。

因此，当使用 1.1.1 Helm Chart 安装 Red Hat Developer Hub 时，您需要设置 clusterRouterBase 值。如需了解更多详细信息，请参阅 Red Hat Developer Hub 指南中的使用 Helm Chart 安装 Red Hat Developer Hub 部分。

RBAC 后端清理
在 Developer Hub 1.1.0 中，当您从应用程序中删除所有管理用户时，仍然存在管理元数据和策略。这个问题已在 Developer Hub 1.1.1 中解决，以便正确删除用户数据。如需更多信息，请参阅 https://github.com/janus-idp/backstage-plugins/pull/1314。
Tekton UI 的改进
Roxctl 镜像检查有时没有包含预期格式的响应，并导致 UI 中断。这个问题已在 Red Hat Developer Hub 1.1.1 中解决。如需更多信息，请参阅 https://issues.redhat.com/browse/RHTAPBUGS-1175 和 https://github.com/janus-idp/backstage-plugins/issues/1355。
Toplogy 视图中的路由显示不正确的映射
在 Red Hat Developer Hub 1.1.1 中，将检查添加到服务和路由中，以便在资源间获取资源时与工作负载相同的命名空间匹配。如需更多信息，请参阅 https://issues.redhat.com/browse/RHTAPBUGS-1166 和 https://github.com/janus-idp/backstage-plugins/pull/1389。
注销 OAuth2 代理(OIDC)的问题
在 Developer Hub 1.1.0 中，对于使用带有 Keycloak 的 OAuth2 代理的用户有一个注销问题。要解决这个问题，在 1.1.1 中提供 auth-backend-module-oidc-provider 的 fork 版本，它允许使用 Keycloak 切换到 OIDC 供应商。如需更多信息，请参阅 https://issues.redhat.com/browse/RHDHBUGS-11 和 https://github.com/janus-idp/backstage-showcase/pull/1072。
Red Hat Developer Hub 1.1.1 中的插件更改
Expand
plugin1.1.0 中的版本1.1.1 中的版本

@roadiehq/backstage-plugin-argo-cd

2.6.2

2.4.1

@janus-idp/backstage-plugin-keycloak-backend

1.8.5

1.8.6

@janus-idp/backstage-plugin-topology

1.18.7

1.18.8

@janus-idp/backstage-plugin-ocm-backend

3.5.6

3.5.7

@janus-idp/backstage-plugin-quay

1.5.9

1.5.10

@janus-idp/backstage-plugin-rbac

1.15.3

1.15.5

@janus-idp/backstage-plugin-tekton

3.5.10

3.5.12

修复了无法动态加载多个上游后端插件的问题
在此版本之前，当转换为动态插件时，无法动态加载上游或第三方后端插件的整个类别。受影响的插件是使用 resolvePackagePath （） backstage API 方法的。此问题会影响大多数使用数据库服务并提供迁移脚本的后端插件。此发行版本删除了动态插件功能的重要限制。
Atlassian Auth 供应商中的配置不正确
在此版本之前，授权 URL 被构建为 ${baseUrl}/oauth/authorize，它与 Atlassian 预期路径不匹配，从而导致身份验证错误。现在，用户会被定向到授权 URL，以获取成功身份验证的授权代码。
RBAC：CSV 仓库会在服务器重启时模拟数据库
在此次更新之前，policy.csv 文件 用于将权限加载到 Developer Hub 中。可能存在重叠权限的实例，权限可以重新加载到数据库中。
验证不适用于 Create Role API
在此次更新之前，Create Role API 中的验证过程无效，允许创建无效的角色。这会导致在尝试更新或删除这些角色时输入错误。
RBAC 后端插件：策略更改需要服务器重启
在此版本之前，手动操作 policy.csv 文件会导致行为不一致，从而导致操作的权限或角色在 RBAC 插件中无法正确应用。
不支持监控 Red Hat Developer Hub 插件
在此发行版本中，管理员不提供监控 Red Hat Developer Hub 插件的支持。在这个版本中，管理员可以生成 Developer Hub 插件及其版本列表来监控目的。

法律通告
复制链接

Copyright © 2024 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返回顶部