适用于 OpenShift 的 JBoss EAP 在线版入门

1. OpenJDK 镜像和架构

1. 使用 oc login 命令登录 您的 OpenShift 实例。

2. 在 OpenShift 中创建新项目：

   项目允许一组用户组织和管理与其他组不同的内容。您可以使用以下命令在 OpenShift 中创建项目：

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

   例如，对于 kitchensink quickstart，使用以下命令创建名为 eap-demo 的新项目：

   $ oc new-project eap-demo

   Copy to Clipboard Toggle word wrap

3. 可选 ：创建密钥存储和 secret。

   注意

   如果您使用 OpenShift 项目中支持 HTTPS 的功能，则需要创建密钥存储和机密。例如，如果您使用 eap74-https-s2i 模板，则必须创建密钥存储和 secret。

   这个 toolschen sink quickstart 的工作流演示不使用 HTTPS 模板，因此不需要密钥存储和 secret。

   1. 创建密钥存储.

      警告

      以下命令将生成自签名证书，但对于生产环境，红帽建议您使用从认证认证机构(CA)购买的 SSL 证书进行 SSL 加密连接(HTTPS)。

      您可以使用 Java keytool 命令生成密钥存储：

      $ keytool -genkey -keyalg RSA -alias <alias_name> -keystore <keystore_filename.jks> -validity 360 -keysize 2048

      Copy to Clipboard Toggle word wrap

      例如，对于 kitchensink quickstart，使用以下命令生成密钥存储：

      $ keytool -genkey -keyalg RSA -alias eapdemo-selfsigned -keystore keystore.jks -validity 360 -keysize 2048

      Copy to Clipboard Toggle word wrap

   2. 从密钥存储创建机密。

      使用以下命令，从前面创建的密钥存储创建机密。

      $ oc create secret generic <secret_name> --from-file=<keystore_filename.jks>

      Copy to Clipboard Toggle word wrap

      例如，对于 Kitchensink quickstart，使用以下命令来创建 secret：

      $ oc create secret generic eap7-app-secret --from-file=keystore.jks

      Copy to Clipboard Toggle word wrap

流程

1. 创建一个新的 OpenShift 应用，它将 JBoss EAP 用于 OpenShift 镜像和您的 Java 应用的源代码。您可以将其中一个提供的 JBoss EAP 用于 OpenShift 模板，以进行 S2I 构建。您也可以选择调配修剪的服务器。

   例如，若要使用 JDK 8 构建器镜像部署 kitchensink 快速启动，请输入以下命令在 eap-demo 项目中使用 eap74-basic -s2i 模板（在 eap-demo 项目中创建 的 eap chensink 源代码）。这个快速入门不支持修剪功能。

   oc new-app --template=eap74-basic-s2i \ 

   1

   
    -p IMAGE_STREAM_NAMESPACE=eap-demo \ 

   2

   
    -p EAP_IMAGE_NAME=jboss-eap74-openjdk8-openshift:7.4.0 \ 

   3

   
    -p EAP_RUNTIME_IMAGE_NAME=jboss-eap74-openjdk8-runtime-openshift:7.4.0 \ 

   4

   
    -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts \ 

   5

   
    -p SOURCE_REPOSITORY_REF=7.4.x \ 

   6

   
    -p CONTEXT_DIR=kitchensink 

   7

   Copy to Clipboard Toggle word wrap

   1

   要使用的模板。

   2

   最新的镜像流和模板导入到项目命名空间中，因此您必须指定要查找镜像流的命名空间。这通常是项目的名称。

   3

   JDK8 的 EAP 构建器镜像流的名称。

   4

   JDK8 的 EAP 运行时镜像流的名称。

   5

   包含应用源代码的存储库的 URL。

   6

   用于源代码的 Git 存储库引用。这可以是 Git 分支或标签引用。

   7

   要构建的源存储库中的目录。

   再举一个例子，若要使用 JDK 11 运行时镜像部署 helloworld-html5 快速启动并修剪 JBoss EAP 以仅包含 jaxrs-server 层，请输入以下命令：命令使用 eap- demo 项目中的 eap74-basic-s2i 模板，该模板在为应用部署 准备 OpenShift 中创建， 在 GitHub 上使用 helloworld-html5 源代码。

   oc new-app --template=eap74-basic-s2i \ 

   1

   
    -p IMAGE_STREAM_NAMESPACE=eap-demo \ 

   2

   
    -p EAP_IMAGE_NAME=jboss-eap74-openjdk11-openshift:7.4.0 \ 

   3

   
    -p EAP_RUNTIME_IMAGE_NAME=jboss-eap74-openjdk11-runtime-openshift:7.4.0 \ 

   4

   
    -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts \ 

   5

   
    -p SOURCE_REPOSITORY_REF=7.4.x \ 

   6

   
    -p GALLEON_PROVISION_LAYERS=jaxrs-server \ 

   7

   
    -p CONTEXT_DIR=helloworld-html5 

   8

   Copy to Clipboard Toggle word wrap

   1

   要使用的模板。

   2

   最新的镜像流和模板导入到项目命名空间中，因此您必须指定要查找镜像流的命名空间。这通常是项目的名称。

   3

   JDK11 的 EAP 构建器镜像流的名称。

   4

   JDK11 的 EAP 运行时镜像流的名称。

   5

   包含应用源代码的存储库的 URL。

   6

   用于源代码的 Git 存储库引用。这可以是 Git 分支或标签引用。

   7

   调配仅包含 jaxrs-server 层的修剪服务器。

   8

   要构建的源存储库中的目录。

   注意

   在创建新的 OpenShift 应用时，您可能还想配置环境变量。

   例如，如果您使用 eap74-https-s2i 等 HTTPS 模板，您必须指定所需的 HTTPS 环境变量 HTTPS _NAME、HTTPS_ PASSWORD 和 HTTPS_ KEYSTORE，才能匹配您的密钥存储详细信息。

   注意

   如果模板使用 AMQ，则必须包含带有适当值的 AMQ_IMAGE_NAME 参数。

   如果模板使用 SSO，您必须包含带有适当值的 SSO_IMAGE_NAME 参数。

2. 检索构建配置的名称：

   $ oc get bc -o name

   Copy to Clipboard Toggle word wrap

3. 使用上一步中的构建配置名称来查看构建的 Maven 进度。

   $ oc logs -f buildconfig/BUILD_CONFIG_NAME

   Copy to Clipboard Toggle word wrap

   例如，对于 kitchensink quickstart，以下命令显示 Maven 构建的进度：

   $ oc logs -f buildconfig/eap-app

   Copy to Clipboard Toggle word wrap

1. 使用以下命令获取应用的服务名称：

   $ oc get service

   Copy to Clipboard Toggle word wrap

2. 将主服务作为路由公开，以便您可以从 OpenShift 外部访问您的应用。例如，对于 Kitchensink quickstart，使用以下命令来公开所需的服务和端口：

   $ oc expose service/eap-app --port=8080

   Copy to Clipboard Toggle word wrap
   注意

   如果您使用模板来创建应用，则路由可能已存在。如果存在，请继续下一步。

3. 获取路由的 URL。

   $ oc get route

   Copy to Clipboard Toggle word wrap

4. 使用 URL 访问 Web 浏览器中的应用。URL 是上一命令输出中 HOST/PORT 字段的值。

   如果您的应用不使用 JBoss EAP 根上下文，请将应用的上下文附加到 URL。例如，对于 kitchensink quickstart，URL 可以是 http://HOST_PORT_VALUE/kitchensink/。

5. 此外，您还可以通过运行以下命令来扩展应用实例：这会将副本数量增加到 3。

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   Copy to Clipboard Toggle word wrap

   例如，对于 Kitchensink quickstart，使用以下命令来扩展应用：

   $ oc scale deploymentconfig eap-app --replicas=3

   Copy to Clipboard Toggle word wrap

流程

1. 在主导航中，点下拉菜单并选择 Developer。

2. 在导航菜单中点 Add。

   此时会打开 Add 页面。

3. 在 Add 页面中，点 Helm Chart。
4. 在 Helm Charts 目录中，搜索 JBoss EAP 7.4。

5. 点 JBoss EAP 7.4 Helm Chart 标题。

   侧面板显示有关 JBoss EAP 7 Helm Chart 的信息。

6. 点 Install Helm Chart。

   一些表单部分会被默认折叠。点 & gt; 扩展并查看其内容。

   注意

   这些部分不需要更新才能继续。

   在 build.uri 字段中指定有关您要构建和部署的 Jakarta EE 应用程序的详细信息。

   build:
     uri: https://github.com/jboss-eap-up-and-running/eap7-getting-started

   Copy to Clipboard Toggle word wrap
   注意

   如果要构建不同的应用程序，您必须更改此 uri 字段以指向该应用的 Git 存储库。

7. 点 Install 使用 Helm Chart 创建 JBoss EAP 7 应用程序。

流程

1. 在导航菜单中点 Helm。

2. 点 eap74 Helm release。

   Helm Release 详情页面 将打开。它显示与您安装 Helm 发行版本相关的所有信息。

3. 单击 Resources 选项卡。它列出了此 Helm 发行版本创建的所有资源。

流程

1. 在导航菜单中点 Topology。

   在 Topology 视图中，eap74 部署在右下角显示一个代码图标。

   此图标代表相关代码的 Git 存储库，或者安装了适当的运算符，它将在 IDE 中打开相关的代码。

2. 如果显示的图标是 CodeReady Workspaces 或 Eclipse Che，请点击它在 IDE 中启动关联的代码。否则，点它导航到关联的 Git 存储库。

流程

1. 在导航菜单中点 Topology。

2. 在 Topology 视图中，点 D eap74 图标。

   此时会打开一个侧面板，其中包含有关应用程序的详细信息。

3. 在侧面面板中，点 Resources 选项卡。Builds 部分显示与应用程序构建相关的所有详细信息。

流程

1. 在导航菜单中点 Topology。

2. 在 Topology 视图中，点 D eap74。

   此时会打开一个侧面板，其中包含有关应用程序的详细信息。

3. 在 Details 选项卡中，将鼠标悬停在 pod 上，以在工具提示中查看 pod 状态。

   • pod 数量显示在 pod 圆圈中。

   • pod circle 的颜色表示 pod status: Light blue = Pending, Blue = Not Ready, Dark blue = Running。

     注意

     在 Topology 视图中，D eap74 部署图标的 dark outer circle 也表示 pod 状态。

1. 如果源代码存储库中存在 pom.xml 文件，S2I 构建器镜像将启动 Maven 构建流程。Maven 构建使用 $MAVEN_ARGS 的内容。

   如果源代码存储库中不存在 pom.xml 文件，S2I 构建器镜像将启动二进制类型构建。

   要添加自定义 Maven 参数或选项，请使用 $MAVEN_ARGS_APPEND。$MAVEN_ARGS_APPEND 变量将选项附加到 $MAVEN_ARGS。

   默认情况下，OpenShift 配置文件使用 Maven 软件包 目标，其中包括用于跳过测试的系统属性(-DskipTests)和启用红帽 GA 存储库(-Dcom.redhat.xpaas.repo)。

   Maven 构建成功的结果复制到 OpenShift 镜像 JBoss EAP 中的 EAP_HOME/standalone/deployments/ 目录中。这包括 $ARTIFACT_DIR 环境变量指定的源存储库中的所有 JAR、WAR 和 EAR 文件。ARTIFACT_DIR 的默认值是 Maven 目标目录。

   注意

   要在 JBoss EAP 上的代理后面将 Maven 用于 OpenShift 镜像，请设置 $HTTP_PROXY_HOST 和 $HTTP_PROXY_PORT 环境变量。另外，您还可以设置 $HTTP_PROXY_USERNAME、$HTTP_PROXY_PASSWORD 和 $HTTP_PROXY_NONPROXYHOSTS 变量。

2. 模块 源存储库目录中的所有文件复制到 JBoss EAP for OpenShift 镜像的 EAP_HOME/modules/ 目录中。
3. configuration 源存储库目录中的所有文件复制到 JBoss EAP for OpenShift 镜像中的 EAP_HOME/standalone/configuration/ 目录中。如果要使用自定义 JBoss EAP 配置文件，请将文件命名为 standalone-openshift.xml。

流程

1. 使用 Galleon Maven 插件构建自定义层。

   如需更多信息 ，请参阅准备 Maven 项目。

2. 将自定义层部署到可访问的 Maven 存储库。

3. 您可以使用自定义 Galleon 功能包环境变量在 S2I 镜像构建过程中自定义 Galleon 功能包和层。

   有关自定义 Galleon 功能包和层的更多信息，请参阅在 S2I 构建期间使用自定义 Galleon 功能包。

4. 可选： 创建一个自定义调配文件来引用用户定义的层并支持的 JBoss EAP 层并将其存储在应用程序目录中。

   有关创建自定义配置文件的更多信息，请参阅为 JBoss EAP 自定义调配文件。

5. 运行 S2I 流程以在 OpenShift 中调配 JBoss EAP 服务器。

   如需更多信息，请参阅在 S2I 构建过程中使用自定义 Galleon 功能包。

1. 获取遇到问题的 pod 的名称。

   您可以看到容器集名称，以及每个容器集通过以下命令重启的次数。

   $ oc get pods

   Copy to Clipboard Toggle word wrap

2. 若要诊断容器集重新启动的原因，您可以检查上一容器集的 JBoss EAP 日志或 OpenShift 事件。

   1. 要查看上述 pod 的 JBoss EAP 日志，请使用以下命令：

      oc logs --previous POD_NAME

      Copy to Clipboard Toggle word wrap

   2. 若要查看 OpenShift 事件，可使用以下命令：

      $ oc get events

      Copy to Clipboard Toggle word wrap
3. 如果容器集因为资源问题而重启，您可以尝试修改 OpenShift 容器集配置，以增加其资源请求和限值。如需有关配置 pod 计算资源的更多信息，请参阅 OpenShift 文档。

1. 首先，打开一个连接至正在运行的容器集的远程 shell 会话。

   $ oc rsh POD_NAME

   Copy to Clipboard Toggle word wrap

2. 在远程 shell 会话中运行以下命令来启动 JBoss EAP 管理 CLI：

   $ /opt/eap/bin/jboss-cli.sh

   Copy to Clipboard Toggle word wrap

流程

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

4. 在 Create Operator Subscription 页面：

   1. 任选以下一项：

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

5. 单击 Subscribe，使 EAP 操作器可供 OpenShift Container Platform 集群上的所选命名空间使用。

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

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

   注意

   对于 All namespaces…​ 安装模式，openshift-operators 命名空间中显示的状态为 InstallSucceeded。在其他命名空间中，显示的状态为 Copied。

7. 如果 Status 字段没有更改为 InstallSucceeded，请检查 openshift-operators 项目（如果选择了其他相关命名空间）中的 pod 的日志，这会在 Workloads → Pods 页面中报告问题以便进一步排除故障。

流程

1. 查看 OperatorHub 中集群可用的操作器列表：

   $ 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

   要订阅的操作器的名称。

   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. 在 OpenShift 中导入 EAP 映像。如需更多信息，请参阅 导入 JBoss EAP XP 的 OpenShift 镜像流和模板。
2. 配置镜像流以接收关于应用镜像流更改和触发新构建的更新。如需更多信息，请参阅配置定期导入 imagestreamtag。

3. 创建 eap-s2i-build 模板，以使用 EAP S2I 镜像构建应用映像：

   $ oc replace --force -f https://raw.githubusercontent.com/jboss-container-images/jboss-eap-openshift-templates/master/eap-s2i-build.yaml

   Copy to Clipboard Toggle word wrap

   此 eap-s2i-build 模板会创建两个构建配置和两个镜像流，对应于中间构建构件和最终应用镜像。

4. 使用参数处理 eap-s2i-build 模板，以创建最终应用镜像的资源。以下示例创建了应用程序镜像 my-app ：

   $ oc process eap-s2i-build \
     -p APPLICATION_IMAGE=my-app \ 

   1

   
     \
     -p EAP_IMAGE=jboss-eap-xp1-openjdk11-openshift:1.0 \ 

   2

   
     -p EAP_RUNTIME_IMAGE=jboss-eap-xp1-openjdk11-runtime-openshift:1.0 \ 

   3

   
     -p EAP_IMAGESTREAM_NAMESPACE=$(oc project -q) \ 

   4

   
     \
     -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts.git \ 

   5

   
     -p SOURCE_REPOSITORY_REF=xp-1.0.x \ 

   6

   
     -p CONTEXT_DIR=microprofile-config | oc create -f - 

   7

   Copy to Clipboard Toggle word wrap

   1

   应用程序镜像流的名称。应用镜像带有 latest 标签。

   2

   EAP 构建器镜像的 imagestreamtag。

   3

   EAP 运行时镜像的 imagestreamtag。

   4

   安装 Red Hat Middleware 镜像的镜像流的命名空间。如果省略，则使用 openshift 命名空间。只有在 openshift 以外的命名空间中安装了镜像流时，才修改此项。

   5

   应用的 Git 源 URL。

   6

   Git 分支或标签引用

   7

   包含要构建的应用的 Git 存储库中的路径。

5. 使用 EAP 操作器准备应用镜像以进行部署。

   1. 配置 WildFlyServer 资源：

      $ cat > my-app.yaml<<EOF
      
      apiVersion: wildfly.org/v1alpha1
      kind: WildFlyServer
      metadata:
        name: my-app
      spec:
       applicationImage: 'my-app:latest'
       replicas: 1
      EOF

      Copy to Clipboard Toggle word wrap

   2. 应用这些设置，并让 EAP 操作器创建一个新的 WildFlyServer 资源来引用此应用程序镜像：

      $ oc apply -f my-app.yaml

      Copy to Clipboard Toggle word wrap

   3. 使用以下命令查看 WildFlyServer 资源：

      $ oc get wfly my-app

      Copy to Clipboard Toggle word wrap

      其他资源

      • 有关导入应用程序镜像流的更多信息，请参阅 导入 JBoss EAP XP 的最新 OpenShift 镜像流和模板。
      • 如需有关定期导入镜像流的更多信息，请参阅配置定期导入 imagestreamtag。

流程

1. 打开 Web 浏览器并登录到 OperatorHub。
2. 选择您要用于 Java 应用程序的项目或命名空间。
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
   • 标签：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>，每个键/值都保存为一个文件。文件的名称是键，内容是值。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)中的引用从旧改为 new。这被视为一个新的 CR 更新，pod 会被重新载入。

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

     spec:
       configMaps:
       - my-config

     Copy to Clipboard Toggle word wrap

     ConfigMap 挂载于 /etc/configmaps/<configmap name>，每个键/值都存储为一个文件。文件的名称是键，内容是值。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，而不是修改现有的 ConfigMap。然后，您可以根据需要更新内容，并将 operator 自定义资源(CR)中的引用从旧改为 new。这被视为一个新的 CR 更新，pod 会被重新载入。

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

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

     Copy to Clipboard Toggle word wrap
     注意

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

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

     spec:
       disableHTTPRoute: true

     Copy to Clipboard Toggle word wrap

流程

1. 从构建 EAP 应用镜像的位置中删除 eap74-sso-s2i 模板创建的 DeploymentConfig 文件。

2. 在 EAP 操作器的 WildFlyServer 资源的 env 字段中，配置 所有环境变量和机密。

   配置示例

   $ cat > my-app.yaml<<EOF
   
   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: my-app
   spec:
     applicationImage: 'my-app:latest'
     replicas: 1
   
     env:
     - name: SSO_URL
       value: https://secure-sso-sso-app-demo.openshift32.example.com/auth
     - name: SSO_REALM
       value: eap-demo
     - name: SSO_PUBLIC_KEY
       value: realm-public-key
     - name: SSO_USERNAME
       value: mySsoUser
     - name: SSO_PASSWORD
       value: 6fedmL3P
     - name: SSO_SAML_KEYSTORE
       value: /etc/secret/sso-app-secret/keystore.jks
     - name: SSO_SAML_KEYSTORE_PASSWORD
       value: mykeystorepass
     - name: SSO_SAML_CERTIFICATE_NAME
       value: jboss
     - name: SSO_BEARER_ONLY
       value: true
     - name: SSO_CLIENT
       value: module-name
     - name: SSO_ENABLE_CORS
       value: true
     - name: SSO_SECRET
       value: KZ1QyIq4
     - name: SSO_DISABLE_SSL_CERTIFICATE_VALIDATION
       value: true
     - name: SSO_SAML_KEYSTORE_SECRET
       value: sso-app-secret
     - name: HTTPS_SECRET
       value: eap-ssl-secret
     - name: SSO_TRUSTSTORE_SECRET
       value: sso-app-secret
   EOF

   Copy to Clipboard Toggle word wrap

   注意
   • 确保所有环境变量和 secret 都与镜像配置匹配。
   • 参数的值 SSO_URL 因 OpenShift 集群的用户而异。
   • EAP 操作器将机密挂载到 /etc/secret 目录中，而 eap74-sso 模板会将机密挂载到 /etc 目录中。
3. 保存 EAP 操作器的 WildFlyServer 资源配置。

流程

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