使用 Red Hat build of Cryostat Operator 配置 Cryostat

流程

1. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。
   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

2. 在 Create Cryostat 面板上，要配置 enableCertManager 属性，请选择以下选项之一：

   1. 如果要使用 Form 视图：

      1. 点 Form view 单选按钮。

      2. 将 Enable cert-manager Integration 开关设置为 false，然后在 Name 字段中输入值。

         图 1.1. 将 Enable cert-manager Integration 开关切换为 false

         

         View larger image

         

   2. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 在 YAML 文件的 spec: 键集合中，将 enableCertManager 属性更改为 false。

         在 YAML 文件中配置的 spec: 键示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           enableCertManager: false
         --

         Copy to Clipboard Toggle word wrap

3. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
4. 如果要完成创建此 Cryostat 实例，请点击 Create。

验证

1. 从 Operator 详情页面的 Cryostat 选项卡中选择您的 Cryostat 实例。
2. 进入 Cryostat Conditions 表。

3. 验证 TLSSetupComplete 条件是否已设置为 true，并且此条件的 Reason 列是否已设置为 CertManagerDisabled。这表示您已将 enableCertManager 属性设置为 false。

   图 1.2. 将 TLSSetupComplete 条件设置为 true 的示例

   

   View larger image

   

流程

1. 要下载默认事件模板，请导航到 Cryostat web 控制台，再从 Events 菜单点击 Downloads。

   注意

   事件模板采用 XML 格式，文件名扩展名为 .jfc。

2. 可选： 如果您希望自定义事件模板，请使用文本编辑器或 XML 编辑器编辑下载的默认事件模板，来配置模板以满足您的需要。
3. 通过在 CLI 中输入 oc login 命令登录到您的 Red Hat OpenShift Web 控制台。

4. 通过在 CLI 中输入以下命令，从事件模板创建 ConfigMap 资源。您必须在要部署 Cryostat 应用程序的路径中发出该命令。您可以使用此资源存储运行 Cryostat 实例的集群中的事件模板文件。

   使用 CLI 创建 ConfigMap 资源示例

   $ oc create configmap <template_name> --from-file=<path_to_custom_event_template>

   Copy to Clipboard Toggle word wrap

5. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。
   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

6. 在 Create Cryostat 面板中，要将 XML 格式的事件模板上传到资源中，请选择以下选项之一：

   1. 如果要使用 Form 视图：

      1. 点 Form view 单选按钮。
      2. 导航到 Cryostat 实例的 Event Templates 部分。
      3. 在 Event Templates 菜单中点 Add Event Template。在 Red Hat OpenShift 控制台中打开 Event Templates 部分。

      4. 从 Config Map Name 下拉列表中选择包含事件模板的 ConfigMap 资源。

         图 1.3. Cryostat 实例的事件模板选项

         

         View larger image

         
      5. 在 Filename 字段中，输入 ConfigMap 中包含的 .jfc 文件的名称。

   2. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 为 eventTemplates 属性指定任何自定义事件模板。此属性将 Red Hat build of Cryostat Operator 指向您的 ConfigMap，以便 Red Hat build of Cryostat Operator 可以读取事件模板。

         为 eventTemplates 属性指定自定义事件模板示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           eventTemplates:
           - configMapName: custom-template1
             filename: my-template1.jfc
           - configMapName: custom-template2
             filename: my-template2.jfc
         --

         Copy to Clipboard Toggle word wrap

         重要

         您必须从 configMapName 下拉列表中选择与 Cryostat 或 Cluster Cryostat 实例关联的 ConfigMap 名称。另外，您必须在 filename 字段中指定与 ConfigMap 关联的密钥。

7. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
8. 如果要完成创建此 Cryostat 实例，请点击 Create。

验证

1. 在 Cryostat web 控制台中，点菜单中的 Events。如果 web 控制台中打开 Authentication Required 窗口，请输入您的凭证并点 Save。

2. 在 Event Templates 选项卡下，检查您的自定义事件模板是否显示在可用事件模板列表中。

   图 1.4. Event Templates 选项卡下列出的自定义事件模板示例

   

   View larger image

   

流程

1. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。
   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

2. 在 Create Cryostat 面板上，要配置 TLS 证书，请选择以下选项之一：

   1. 如果要使用 Form 视图：

      1. 点 Form view 单选按钮。
      2. 在 Name 字段中，为您要创建的 Cryostat 实例指定一个名称。

      3. 展开 Trusted TLS Certificates 选项，然后单击 Add Trusted TLS Certificates。在 Red Hat OpenShift Web 控制台中显示选项列表。

         图 1.5. Trusted TLS 证书选项

         

         View larger image

         

      4. 从 Secret Name 列表中选择 TLS secret。Certificate Key 字段是可选的。

         注意

         您可以通过单击 Remove Trusted TLS Certificates 来删除 TLS 证书。

   2. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 在 trustedCertSecrets 数组的 secretName 属性中指定您的 secret （位于 Cryostat 应用程序相同的命名空间中）。

         在 trustedCertSecrets 数组中指定 secret 的示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
         --

         Copy to Clipboard Toggle word wrap

      3. 可选： 将 certificateKey 属性值改为应用程序的 X.509 证书文件名。如果您不更改值，则 certificateKey 属性默认为 tls.crt。

         更改 certificateKey 属性值的示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           trustedCertSecrets:
           - secretName: my-tls-secret
             certificateKey: ca.crt
         --

         Copy to Clipboard Toggle word wrap

3. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
4. 如果要完成创建此 Cryostat 实例，请点击 Create。

验证

1. 通过在 CLI 中运行以下命令，确定您的所有应用程序 pod 是否与 Cryostat pod 位于同一个 OpenShift 集群命名空间中：

   $ oc get pods

   Copy to Clipboard Toggle word wrap
2. 登录到 Cryostat 实例的 Web 控制台。
3. 在 Cryostat 实例的 Dashboard 菜单中，从 Target 列表中选择一个目标 JVM。

4. 在 Cryostat web 控制台的导航菜单中，选择 Recordings。在 Authentication Required 对话框窗口中，输入您的 secret 凭证，然后选择 Save 为目标 JVM 提供凭证。

   注意

   如果所选目标为 JMX 连接启用了密码身份验证，则当提示连接时，必须为目标 JVM 提供 JMX 凭证。

   Cryostat 通过经过身份验证的 JMX 连接连接到您的应用程序。现在，您可以使用 Recordings 和 Events 功能来监控应用程序的 JFR 数据。

流程

1. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。
   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

2. 在 Create Cryostat 面板中，要更改 Cryostat 应用程序的存储设置，请选择以下选项之一：

   1. 如果要使用 Form 视图：

      1. 点 Form view 单选按钮。
      2. 导航到 Storage Options 部分，并在 Name 字段中输入值。
      3. 展开 Storage Options，再单击 Empty Dir。在 Red Hat OpenShift Web 控制台中打开了扩展的选项选择。

      4. 将 Enabled 开关设置为 true。

         图 1.6. 示例显示 Empty Dir 交换机设为 true

         

         View larger image

         

   2. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 在 YAML 文件的 spec: 键集合中，添加 storageOptions 定义，并将 emptyDir 属性设置为 true。

         将 emptyDir 属性设置为 true的示例

         --
         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           storageOptions:
             emptyDir:
               enabled: true
               medium: "Memory"
               sizeLimit: 1Gi
         --

         Copy to Clipboard Toggle word wrap

      3. 可选： 为 medium 和 sizeLimit 属性设置值。
3. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
4. 如果要完成创建此 Cryostat 实例，请点击 Create。

流程

1. 如果要开始创建 Cryostat 实例，请执行以下步骤：

   1. 在 Red Hat OpenShift web 控制台中，点 Operators > Installed Operators。
   2. 从可用 Operator 列表中，选择 Red Hat build of Cryostat。
   3. 在 Operator 详情页中，点 Details 选项卡。

   4. 在 Provided APIs 部分中，选择 Cryostat，然后单击 Create instance。

      注意

      Red Hat build of Cryostat Operator 不会为 Report sidecar pod 创建服务帐户。相反，这些 pod 在自己的命名空间中使用默认服务帐户。

2. 在 Create Cryostat 面板中，要配置安全上下文，请选择以下选项之一：

   1. 如果要使用 YAML 视图：

      1. 点 YAML 视图 单选按钮。

      2. 在 spec: 元素中，编辑 securityOptions 和 reportOptions 属性，以满足您的安全要求。

         安全上下文配置示例

         apiVersion: operator.cryostat.io/v1beta2
         kind: Cryostat
         metadata:
           name: cryostat-sample
         spec:
           securityOptions:
             podSecurityContext:
               runAsNonRoot: true
               seccompProfile:
                 type: RuntimeDefault
             coreSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
               runAsUser: 1001
             dataSourceSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
             grafanaSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
           reportOptions:
             replicas: 1
             podSecurityContext:
               runAsNonRoot: true
               seccompProfile:
                 type: RuntimeDefault
             reportsSecurityContext:
               allowPrivilegeEscalation: false
               capabilities:
                 drop:
                   - ALL
               runAsUser: 1001

         Copy to Clipboard Toggle word wrap

   2. 如果要使用 Form 视图：

      1. 点 *Form view" 单选按钮。

      2. 展开 Advanced configuration 以在 Red Hat OpenShift Web 控制台中打开附加选项。

         图 2.1. 高级配置菜单选项

         

         View larger image

         
      3. 展开 Core Security Context。从可用选项列表中，定义安全上下文的设置。

      4. 逐一扩展以下安全上下文，并根据情况定义设置：

         • 身份验证代理安全上下文
         • 数据源安全上下文
         • 数据库安全上下文
         • Grafana 安全上下文
         • Pod 安全上下文
         • 存储安全上下文

      5. 可选： 如果您使用 Report Generator 服务，您也可以为此服务配置安全上下文。在这种情况下，展开 Report Options > Advanced Configuration > Security Options。然后，根据情况扩展和定义 报告安全上下文 和 Pod 安全上下文设置。

         图 2.2. 报告生成器安全上下文

         

         View larger image

         
3. 如果要为这个 Cryostat 实例配置自定义资源(CR)中的其他属性，请参阅本文档的其它部分来了解有关这些属性的更多信息。
4. 如果要完成创建此 Cryostat 实例，请点击 Create。