将 Cryostat 2.4 迁移到 Cryostat 3.0


Red Hat build of Cryostat 3

Red Hat Customer Content Services

摘要

Red Hat build of Cryostat 是 OpenShift Container Platform 上的红帽产品。Migrating Cryostat 2.4 to Cryostat 3.0 指南提供了如何将 Cryostat 2.4 应用程序升级到 Cryostat 3.0 的信息。

前言

Red Hat build of Cryostat 是 JDK Flight Recorder (JFR)的容器原生虚拟化,可用于安全监控在 OpenShift Container Platform 集群上运行的工作负载的 Java 虚拟机(JVM)性能。您可以使用 Cryostat 3.0 使用 Web 控制台或 HTTP API 启动、停止、检索、存档、导入和导出容器化应用中的 JVM 的 JFR 数据。

根据您的用例,您可以使用 Cryostat 提供的内置工具直接存储和分析 Red Hat OpenShift 集群上的记录,或者您可以将记录导出到外部监控应用程序,以对记录数据进行更深入分析。

重要

Red Hat build of Cryostat 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。

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

使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中有问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息

第 1 章 Cryostat 迁移概述

在 Red Hat OpenShift 中作为集群管理员,您可以从 Cryostat 2.4 升级到 Cryostat 3.0。本指南涵盖了 Cryostat 3.0 发行版本中提供的新更新、已弃用和不支持的功能,以及任何所需的应用程序和 Operator 配置更新以保持一致的行为。

在开始 迁移过程 前,请完成以下步骤:

1.1. 主 Cryostat Operator 更改

Red Hat build of Cryostat 3.0 包括对 Cryostat Operator 的安装模式以及提供的 API 类型进行主要更新。

安装模式更改
Expand
Red Hat build of Cryostat 版本安装模式

2.4 及更早版本

  • All namespaces on the cluster (default)
  • 集群中的特定命名空间

3.0

  • All namespaces on the cluster (default)

在 Red Hat OpenShift 中,Cryostat Operator 现在可以在集群范围(集群中的所有命名空间)中安装,而不是安装到集群命名空间的子集。集群范围的安装是 Operator Lifecycle Manager 的首选模式,每个命名空间安装都是已弃用的功能。

图 1.1. Cryostat 3.0 中的安装模式

Cryostat 3.0 中的安装模式
提供的 API 更改
Expand
Red Hat build of Cryostat 版本提供的 API

2.4 及更早版本

  • ClusterCryostat
  • Cryostat

3.0

  • Cryostat

ClusterCryostatCryostat API 现在被统一为 singular Cryostat API。您可以使用 Cryostat API 及其可选的 Target Namespaces 字段来创建与包含应用程序的命名空间或命名空间组对应的一个或多个 Cryostat 实例。

图 1.2. 在 Cryostat 3.0 中提供了 API

在 Cryostat 3.0 中提供了 API

1.2. 应用程序配置更改

对于使用 Cryostat 代理部署的应用程序,可以使用更新的 0.4.0 版本代理,并使用 Red Hat build of Cryostat 3.0。有关 Cryostat 代理的最新可用构建版本的详情,请参考 Red Hat Maven 存储库

除了升级代理外,一些代理配置属性也更改了:

Expand
代理配置属性Cryostat 2.4 值Cryostat 3.0 值详情

CRYOSTAT_AGENT_BASEURI

http://cryostat.mynamespace.mycluster.svc:8181

http://cryostat.mynamespace.mycluster.svc:4180

服务端口已从 8181 改为 4180。

CRYOSTAT_AGENT_AUTHORIZATION

bearer Base64 令牌

bearer raw (plain-text)令牌

bearer 令牌不再需要经过 Base64 编码。

有关代理配置更改和其他新功能及改进的更多信息,请参阅 Red Hat build of Cryostat 3.0 的发行注记

注意

对于使用远程 JMX 连接的应用程序,红帽构建的 Cryostat 不包括任何配置更改。

1.3. 迁移建议

迁移前,请考虑备份任何 Cryostat 数据,以确保在升级后可以恢复自定义。

这个数据包括:

  • 自定义配置集模板
  • 自定义仪表板布局
  • 活跃和归档的记录
  • 自定义自动化规则

如果以前的 SSL 证书和存储的凭证配置,请确保在迁移过程中可用。

第 2 章 Cryostat 迁移过程

迁移到 Cryostat 3.0 的过程包括以下任务:

2.1. 熟悉您当前的 Cryostat 安装和配置实例

如果将 Update 批准策略 被设置为 Automatic,则 Cryostat Operator 通常会自动更新。但是,因为 Cryostat 3.0 引入了对安装模式的更改并提供 API,如 Major Cryostat Operator 所述,您可能需要执行手动操作来确保 Cryostat 正确更新。

要确定是否需要手动干预,请查看以下步骤来熟悉您当前的 Cryostat 安装和配置实例。

流程

  1. 作为管理员,在 Red Hat OpenShift Web 控制台的主导航中,单击下拉菜单并选择 Administrator
  2. 在导航菜单中点 Operators &gt ; Installed Operators
  3. 搜索已安装的 Red Hat build of Cryostat Operator。
  4. 要检查 Cryostat 的安装模式,请注意 Managed Namespaces 列中的值。这个值可以是 All Namespaces 或用户定义的命名空间。

    图 2.1. Cryostat 中的受管命名空间详情

    Cryostat 中的受管命名空间详情
  5. Name 列中,点 Red Hat build of Cryostat
  6. Operator 详情面板中Subscription 选项卡。
  7. Subscription details 面板中,要检查 Cryostat 的更新批准策略,请注意 Update approval 区域中的值。这个值可以是 ManualAutomatic

    图 2.2. 更新 Cryostat 中的批准详情

    更新 Cryostat 中的批准详情
  8. 检查您配置的实例:

    1. Cluster Cryostat 选项卡。这将显示已创建的 ClusterCryostat 实例的列表。如果没有实例,则页面 diplays No operands found
    2. Cryostat 选项卡。这将显示已创建的 Cryostat 实例列表。如果没有实例,则页面 diplays No operands found

确定安装模式和配置实例的组合后,您可以通过完成与部署匹配的 Cryostat 安装中的相应步骤来升级 Cryostat

2.2. 升级 Cryostat 安装

根据 Cryostat 安装和实例组合,您必须遵循升级 Cryostat 的步骤而有所不同,具体取决于以下场景与您现有的 Cryostat 安装匹配:

注意

在这种情况下,如果 Update approval 策略被设置为 Automatic,则不需要升级步骤。

在这种情况下,如果 Update approval 策略被设置为 Manual,请完成以下步骤。

流程

  1. 作为管理员,在 Red Hat OpenShift Web 控制台的主导航中,单击下拉菜单并选择 Administrator
  2. 在导航菜单中点 Operators &gt ; Installed Operators
  3. 搜索已安装的 Red Hat build of Cryostat Operator。
  4. 检查 Cryostat Operator 的版本和状态。

    Cryostat 版本为 2.4,Status 列应当显示 Upgrade available

  5. 单击 Upgrade available
  6. Preview InstallPlan,然后点 Approve

现在,您已成功升级到 Cryostat 3.0。

注意

为确保缓存的会话被重置,在打开 Cryostat Web 应用程序时可能需要硬浏览器刷新。

在这种情况下,请完成以下步骤:

流程

  1. 作为管理员,在 Red Hat OpenShift Web 控制台的主导航中,单击下拉菜单并选择 Administrator
  2. 在导航菜单中点 Operators &gt ; Installed Operators
  3. 搜索已安装的 Red Hat build of Cryostat Operator。
  4. 检查 Cryostat Operator 的版本和状态。

    1. 如果 Cryostat 的 Update 批准策略Automatic,则 Cryostat 版本已升级到 3.0。继续 第 5 步
    2. 如果 Cryostat 的 Update Approval Strategy 为 Manual,则 Cryostat 版本为 2.4,Status 列应当显示 Upgrade available

      1. 单击 Upgrade available
      2. Preview InstallPlan,然后点 Approve
  5. Once Cryostat 3.0 is installed,进入到 Administration > CustomResourceDefinitions
  6. 搜索并点 ClusterCryostat CRD (自定义资源定义)。
  7. 实例 选项卡。
  8. 对于需要迁移的每个 ClusterCryostat 实例,请复制 YAML 配置:

    1. 单击 ClusterCryostat 实例的名称。然后点击 YAML 选项卡,然后点击面板右下角的 Download
    2. 对需要迁移的每个实例重复第 8a 步。
  9. 返回到 ClusterCryostat Instances 选项卡。
  10. 点右侧的 ellipsis 图标删除每个 ClusterCryostat 实例。这包括您在第 8 步中 下载的实例。
  11. 进入到 Installed Operators > Red Hat build of Cryostat > Cryostat 标签页。
  12. 对于第 8 步中的每个 ClusterCryostat 实例:

    1. Create Cryostat
    2. 使用 YAML 视图来修改 ClusterCryostat 配置。

      例如:

      旧 YAML 设置:

      apiVersion: operator.cryostat.io/v1beta1
      kind: ClusterCryostat
      metadata:
        name: cryostat-sample
      spec:
        enableCertManager: true
        installNamespace: cryostat
        targetNamespaces:
        - openshift-operators
      Copy to Clipboard Toggle word wrap

      新的 YAML 设置:

      apiVersion: operator.cryostat.io/v1beta2
      kind: Cryostat
      metadata:
        name: cryostat-sample
        namespace: openshift-operators
      spec:
        enableCertManager: true
        targetNamespaces:
        - openshift-operators
      Copy to Clipboard Toggle word wrap
    3. Create

现在,您已成功迁移了 Cryostat 实例。有关更新部署的应用程序的更多信息,请参阅更新部署的应用程序

有关迁移 ClusterCryostat 实例的详情,请参阅升级将 Cryostat 安装到 "All Namespaces" 和 "ClusterCryostat" 实例的安装

注意

Cryostat 实例不需要修改或删除。

在这种情况下,无论 Update approval 策略是 AutomaticManual,Cryostat Operator 的升级路径将失败,并显示以下错误:

Error: OwnNamespace InstallModeType 不支持,无法配置为监视自己的命名空间

继续操作前,请查看 迁移建议 中的信息。

在这种情况下,请完成以下流程中的步骤。

流程

  1. 作为管理员,在 Red Hat OpenShift Web 控制台的主导航中,单击下拉菜单并选择 Administrator
  2. 在导航菜单中点 Operators &gt ; Installed Operators

    注意

    确保您已选择安装了 Cryostat 的正确项目(命名空间)。

  3. 搜索安装的 Red Hat build of Cryostat 版本 2.4 Operator。
  4. 从 Operators > Installed Operators 卸载 Red Hat build of Cryostat。

    1. 如果 Update 批准策略Manual,Installed Operators 表中只显示 Cryostat 2.4。点右侧的 ellipsis 图标并选择 Uninstall Operator
    2. 如果 Update Approval Strategy 是 Automatic,则 Installed Operators 表中都会显示 Cryostat 2.4 和 3.0。

      1. 对于 Cryostat 2.4,点 ellipsis 图标并选择 Delete ClusterServiceVersion
      2. 对于 Cryostat 3.0,点 ellipsis 图标并选择 Uninstall Operator
  5. 进入 Operators > OperatorHub 并搜索 Cryostat。
  6. Red Hat build of Cryostat 标题并将 版本 3.0 安装到 openshift-operators 命名空间中。openshift-operators 是 Operator 安装的默认命名空间,安装到 "All Namespaces"。

现在,您已成功迁移到 Cryostat 3.0 Operator。有关更新部署的应用程序的更多信息,请参阅更新部署的应用程序

注意

为确保缓存的会话被重置,在打开 Cryostat Web 应用程序时可能需要硬浏览器刷新。

在这种情况下,无论 Update approval 策略是 AutomaticManual,Cryostat Operator 的升级路径将失败,并显示以下错误:

Error: OwnNamespace InstallModeType 不支持,无法配置为监视自己的命名空间

继续操作前,请查看 迁移建议 中的信息。

在这种情况下,请完成以下流程中的步骤。

流程

  1. 作为管理员,在 Red Hat OpenShift Web 控制台的主导航中,单击下拉菜单并选择 Administrator
  2. 在导航菜单中点 Operators &gt ; Installed Operators

    注意

    确保您已选择安装了 Cryostat 的正确项目(命名空间)。

  3. 搜索安装的 Red Hat build of Cryostat 版本 2.4 Operator。
  4. Cluster Cryostat 选项卡。

    1. 要导出需要迁移的实例,请点此实例名称。然后点击 YAML 选项卡,然后点击面板右下角的 Download
    2. 对需要迁移的每个实例重复第 4a 步。
    3. 导出实例后,若要删除这些实例,请从面板右上角的 Actions 下拉菜单中选择 Delete ClusterCryostat
  5. 从 Operators > Installed Operators 卸载 Red Hat build of Cryostat。

    1. 如果 Update 批准策略Manual,Installed Operators 表中只显示 Cryostat 2.4。点右侧的 ellipsis 图标并选择 Uninstall Operator
    2. 如果 Update Approval Strategy 是 Automatic,则 Installed Operators 表中都会显示 Cryostat 2.4 和 3.0。

      1. 对于 Cryostat 2.4,点 ellipsis 图标并选择 Delete ClusterServiceVersion
      2. 对于 Cryostat 3.0,点 ellipsis 图标并选择 Uninstall Operator
  6. 进入 Operators > OperatorHub 并搜索 Cryostat。
  7. Red Hat build of Cryostat 标题并将 版本 3.0 安装到 openshift-operators 命名空间中。openshift-operators 是 Operator 安装的默认命名空间,安装到 "All Namespaces"。
  8. 对于您在第 4 步中 导出的每个 ClusterCryostat 实例:

    1. Create Cryostat
    2. 使用 第 4 步中的 YAML,使用 YAML 视图来修改 ClusterCryostat 配置。

      例如:

      旧 YAML 设置:

      apiVersion: operator.cryostat.io/v1beta1
      kind: ClusterCryostat
      metadata:
        name: cryostat-sample
      spec:
        enableCertManager: true
        installNamespace: cryostat
        targetNamespaces:
        - openshift-operators
      Copy to Clipboard Toggle word wrap

      新的 YAML 设置:

      apiVersion: operator.cryostat.io/v1beta2
      kind: Cryostat
      metadata:
        name: cryostat-sample
        namespace: openshift-operators
      spec:
        enableCertManager: true
        targetNamespaces:
        - openshift-operators (or Target Namespace)
      Copy to Clipboard Toggle word wrap
    3. Create

现在,您已成功迁移到 Cryostat 3.0 Operator。有关更新部署的应用程序的更多信息,请参阅更新部署的应用程序

有关迁移 ClusterCryostat 实例的详情,请参阅升级将 Cryostat 安装到目标命名空间的安装,并且之前创建了 ClusterCryostat 实例

注意

Cryostat 实例不需要修改或删除。

2.3. 更新您部署的应用程序

有关在 Cryostat 3.0 中配置 Java 应用程序的更多信息,请参阅配置 Java 应用程序

2.4. 恢复以前的配置

对于之前自定义的 Cryostat 配置,如事件模板、仪表板布局、JFR 记录和自动规则,请查看以下指南来恢复这些自定义:

事件模板
如需更多信息,请参阅使用自定义事件模板 中的第 7 步。
仪表板布局
如需更多信息 ,请参阅恢复仪表板布局
JFR 记录
如需更多信息,请参阅将 JFR 记录上传到 Cryostat 归档位置
自动化规则
如需更多信息,请参阅 在 JSON 中上传自动化规则

更新于 2024-07-02

法律通告

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