第 9 章 在 OpenShift Container Platform 上部署您的 Jboss EAP 应用程序

流程

1. 在 OpenShift Container Platform Web 控制台中导航至 Operators→ OperatorHub。
2. 向下滚动或在 Filter by keyword 框中输入 EAP，以查找 EAP 操作器。
3. 选择 JBoss EAP operator 并单击 Install。

4. 在 Create Operator Subscription 页面：

   1. 任选以下一项：

      • All namespaces on the cluster(default)，将 operator 安装至默认 openshift-operators 命名空间，以便供集群中的所有命名空间监视和使用。该选项并非始终可用。
      • 集群中的特定命名空间会将 Operator 安装到您选择的特定命名空间中。Operator 仅可在该单一命名空间中使用。
   2. 选择一个 Update Channel。
   3. 如前面所述，选择自动或手动批准策略。

5. 点 Subscribe 使 EAP Operator 可供此 OpenShift Container Platform 集群上的所选命名空间使用。

   1. 如果选择了手动批准策略，订阅的升级状态将保持在 Upgrading，直至您审核并批准了它的安装计划。批准 Install Plan 页面中的安装计划后，订阅升级状态将变为 Up to date。
   2. 如果您选择了一个自动批准策略，则升级状态会在不干预的情况下变为 Up to date。

6. 在订阅的升级状态变为 Up to date 后，选择 Operators Installed Operators 来验证 EAP ClusterServiceVersion(CSV)是否显示为 up，其 Status 会在相关命名空间中变为 InstallSucceeded。

   注意

   对于 All namespaces…​ 安装模式，openshift-operators 命名空间中显示的状态为 InstallSucceeded。在其他命名空间中，显示的状态是 Copied。如果 Status 字段没有更改为 InstallSucceeded，请检查 openshift-operators 项目（如果选择了 A specific namespace…​ 安装模式）中的 openshift-operators 项目中的 pod 的日志，这会在 Workloads Pods 页面中报告问题以便进一步排除故障。

流程

1. 查看 OperatorHub 中集群可用的 Operator 列表：

   $ oc get packagemanifests -n openshift-marketplace | grep eap
   NAME        CATALOG               AGE
   ...
   eap         Red Hat Operators     43d
   ...

   Copy to Clipboard Toggle word wrap

2. 创建一个 Subscription 对象 YAML 文件（例如，eap-operator-sub.yaml）来向 EAP operator 订阅命名空间。以下是 Subscription 对象 YAML 文件示例：

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: eap
     namespace: openshift-operators
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: eap 

   1

   
     source:  redhat-operators 

   2

   
     sourceNamespace: openshift-marketplace

   Copy to Clipboard Toggle word wrap

   1

   要订阅的 Operator 的名称。

   2

   EAP Operator 由 redhat-operators CatalogSource 提供。

   有关频道和批准策略的详情，请查看此流程的 Web 控制台 版本。

3. 从 YAML 文件创建 Subscription 对象：

   $ oc apply -f eap-operator-sub.yaml
   $ oc get csv -n openshift-operators
   NAME                  DISPLAY     VERSION   REPLACES   PHASE
   eap-operator.v1.0.0   JBoss EAP   1.0.0                Succeeded

   Copy to Clipboard Toggle word wrap

   EAP 操作器已经安装成功。此时，OLM 知道 EAP 操作器。Operator 的 ClusterServiceVersion(CSV)出现在目标命名空间中，由 EAP 操作器提供的 API 可用于创建。

流程

1. 打开 Web 浏览器并登录到 OperatorHub。
2. 选择您要用于 Java 应用程序的 Project 或命名空间。
3. 进入到 Installed Operator，再选择 JBoss EAP operator。
4. 在 Overview 选项卡上，单击 Create Instance 链接。

5. 指定应用程序镜像详情。

   应用镜像指定包含 Java 应用的 Docker 镜像。该镜像必须使用 JBoss EAP for OpenShift Source-to-Image (S2I)构建镜像来构建。如果 applicationImage 字段与 imagestreamtag 对应，对镜像的任何更改都会触发应用程序的自动升级。

   您可以为 OpenShift 应用程序镜像提供以下 JBoss EAP 参考：

   • 镜像的名称：mycomp/myapp
   • tag: mycomp/myapp:1.0
   • 摘要：mycomp/myapp:@sha256:0af38bc38be93116b6a1d86a9c78bd14cd527121970899d719baf78e5dc7bfd2
   • imagestreamtag: my-app:latest

6. 指定应用程序的大小。例如：

   spec:
     replicas:2

   Copy to Clipboard Toggle word wrap

7. 使用 env spec 配置应用程序环境。环境变量 可以直接来自值，如 POSTGRESQL_SERVICE_HOST 或来自 Secret 对象，如 POSTGRESQL_USER。例如：

   spec:
     env:
     - name: POSTGRESQL_SERVICE_HOST
       value: postgresql
     - name: POSTGRESQL_SERVICE_PORT
       value: '5432'
     - name: POSTGRESQL_DATABASE
       valueFrom:
         secretKeyRef:
           key: database-name
           name: postgresql
     - name: POSTGRESQL_USER
       valueFrom:
         secretKeyRef:
           key: database-user
           name: postgresql
     - name: POSTGRESQL_PASSWORD
       valueFrom:
         secretKeyRef:
           key: database-password
           name: postgresql

   Copy to Clipboard Toggle word wrap

8. 完成与应用程序部署相关的以下可选配置：

   • 指定服务器数据目录的存储要求。如需更多信息，请参阅为应用程序配置持久性存储。

   • 指定您在 WildFlyServerSpec 中创建的 Secret 名称，将其挂载为运行应用的 pod 中的卷。例如：

     spec:
       secrets:
         - my-secret

     Copy to Clipboard Toggle word wrap

     Secret 挂载到 /etc/secrets/<secret name& gt;，每个键/值存储为一个文件。文件的名称是键，内容是值。Secret 作为一个卷在 pod 中挂载。以下示例演示了可用于查找键值的命令：

     $ ls /etc/secrets/my-secret/
     my-key  my-password
     $ cat /etc/secrets/my-secret/my-key
     devuser
     $ cat /etc/secrets/my-secret/my-password
     my-very-secure-pasword

     Copy to Clipboard Toggle word wrap
     注意

     修改 Secret 对象可能会导致项目不一致。红帽建议创建一个与旧内容相同的新对象，而不是修改现有 Secret 对象。然后，您可以根据需要更新内容，并将 operator 自定义资源(CR)中的引用从 old 改为 new。这被视为一个新的 CR 更新，pod 被重新加载。

   • 指定您在 WildFlyServerSpec 中创建的 ConfigMap 名称，将其挂载为运行应用程序的 pod 中的卷。例如：

     spec:
       configMaps:
       - my-config

     Copy to Clipboard Toggle word wrap

     ConfigMap 挂载于 /etc/configmaps/<configmap name& gt;，每个键/值都存储为一个文件。文件的名称是键，内容是值。ConfigMap 作为一个卷在 pod 中挂载。查找键值：

     $ ls /etc/configmaps/my-config/
     key1 key2
     $ cat /etc/configmaps/my-config/key1
     value1
     $ cat /etc/configmaps/my-config/key2
     value2

     Copy to Clipboard Toggle word wrap
     注意

     修改 ConfigMap 可能会导致项目不一致。红帽建议创建一个与旧内容相同的新 ConfigMap，而不是修改现有 ConfigMap。然后，您可以根据需要更新内容，并将 operator 自定义资源(CR)中的引用从 old 改为 new。这被视为一个新的 CR 更新，pod 被重新加载。

   • 如果您选择拥有自己的独立 ConfigMap，请提供 ConfigMap 的名称以及 standalone.xml 文件的密钥：

       standaloneConfigMap:
         name: clusterbench-config-map
         key: standalone.xml

     Copy to Clipboard Toggle word wrap
     注意

     JBoss EAP 8.0 不支持从 standalone.xml 文件创建 ConfigMap。

   • 如果要在 OpenShift 中禁用默认的 HTTP 路由创建，请将 disableHTTPRoute 设置为 true ：

     spec:
       disableHTTPRoute: true

     Copy to Clipboard Toggle word wrap

流程

1. 在 OpenShift Container Platform Web 控制台中进入 Monitoring→ Metrics。
2. 在 Metrics 屏幕上，在文本框中键入应用程序的名称以选择您的应用程序。您的应用程序的指标会出现在屏幕上。

流程

1. 在 Operators→ Installed Operators 页面中，选择 JBoss EAP。
2. 在 Operator Details 页面的右侧，从 Actions 下拉菜单中选择 Uninstall Operator。
3. 如果要删除所有安装相关组件，则在看到 Remove Operator Subscription 窗口提示时，勾选 Also completely remove the Operator from the selected namespace 复选框。这会删除 CSV，并删除与 Operator 关联的 pod、部署、自定义资源定义(CRD)和自定义资源(CR)。
4. 单击 Remove。EAP 操作器将停止运行，并且不再接收更新。

流程

1. 在 currentCSV 字段中检查 EAP operator 订阅的当前版本：

   $ oc get subscription eap-operator -n openshift-operators -o yaml | grep currentCSV
     currentCSV: eap-operator.v1.0.0

   Copy to Clipboard Toggle word wrap

2. 删除 EAP Operator 的订阅：

   $ oc delete subscription eap-operator -n openshift-operators
   subscription.operators.coreos.com "eap-operator" deleted

   Copy to Clipboard Toggle word wrap

3. 使用上一步中的 currentCSV 值删除目标命名空间中 EAP Operator 的 CSV：

   $ oc delete clusterserviceversion eap-operator.v1.0.0 -n openshift-operators
   clusterserviceversion.operators.coreos.com "eap-operator.v1.0.0" deleted

   Copy to Clipboard Toggle word wrap

流程

1. 配置资源：

   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: eap-helloworld
   spec:
     applicationImage: 'eap-helloworld:latest'
     replicas: 1
     resources:
       limits:
         cpu: 500m
         memory: 2Gi
       requests:
         cpu: 100m
         memory: 1Gi

   Copy to Clipboard Toggle word wrap
   重要

   您必须为 pod 中的容器指定资源限值和请求，以便自动扩展按预期工作。

2. 创建 Horizontal pod 自动缩放器：

   oc autoscale wildflyserver/eap-helloworld --cpu-percent=50 --min=1 --max=10

   Copy to Clipboard Toggle word wrap