主页
产品
Red Hat JBoss Enterprise Application Platform
7.4
使用 JBoss EAP XP 4.0.0
8.14. 为多个可引导 JAR 实例启用 Web 会话数据存储

8.14. 为多个可引导 JAR 实例启用 Web 会话数据存储

您可以将 web-clustering 应用程序构建并打包为可引导 JAR。

先决条件

您已检查了最新的 Maven 插件版本，如 MAVEN_PLUGIN_VERSION.X.GA.Final-redhat-00001，其中 MAVEN_PLUGIN_VERSION 是主版本，X 是 microversion。请参阅 /ga/org/wildfly/plugins/wildfly-jar-maven-plugin 的索引。
您已检查了最新的 Galleon 功能软件包版本，如 4.0.X.GA-redhat-BUILD_NUMBER，其中 X 是 JBoss EAP XP 的微版本，BUILD_NUMBER 是 Galleon 功能软件包的构建号。X 和 BUILD_NUMBER 可以在 JBoss EAP XP 4.0.0 产品生命周期中演进。请参阅 /ga/org/jboss/eap/wildfly-galleon-pack 的索引。

您已创建了 Maven 项目，设置父依赖项，并添加了用于创建 Web 集群应用程序的依赖项。请参阅创建可引导 JAR Maven 项目。

重要

在设置 Maven 项目时，您必须在 Maven archetype 配置中指定值。例如：

mvn archetype:generate \
-DgroupId=com.example.webclustering \
-DartifactId=web-clustering \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DarchetypeArtifactId=maven-archetype-webapp \
-DinteractiveMode=false
cd web-clustering

$ mvn archetype:generate \
-DgroupId=com.example.webclustering \
-DartifactId=web-clustering \
-DarchetypeGroupId=org.apache.maven.archetypes \
-DarchetypeArtifactId=maven-archetype-webapp \
-DinteractiveMode=false
cd web-clustering

Copy to Clipboard

Toggle word wrap

注意

流程中显示的示例指定以下属性：

${bootable.jar.maven.plugin.version} 用于 Maven 插件版本。
${jboss.xp.galleon.feature.pack.version} 用于 Galleon 功能软件包版本。

您必须在项目中设置这些属性。例如：

<properties>
    <bootable.jar.maven.plugin.version>6.1.2.Final-redhat-00001</bootable.jar.maven.plugin.version>
    <jboss.xp.galleon.feature.pack.version>4.0.0.GA-redhat-00002</jboss.xp.galleon.feature.pack.version>
</properties>

<properties>
    <bootable.jar.maven.plugin.version>6.1.2.Final-redhat-00001</bootable.jar.maven.plugin.version>
    <jboss.xp.galleon.feature.pack.version>4.0.0.GA-redhat-00002</jboss.xp.galleon.feature.pack.version>
</properties>

Copy to Clipboard

Toggle word wrap

流程

在 pom.xml 文件的 <build > 元素中添加以下内容。您必须指定任何 Maven 插件的最新版本，以及 org.jboss.eap:wildfly-galleon-pack Galleon 功能软件包的最新版本。例如：

<plugins>
    <plugin>
        <groupId>org.wildfly.plugins</groupId>
        <artifactId>wildfly-jar-maven-plugin</artifactId>
        <version>${bootable.jar.maven.plugin.version}</version>
        <configuration>
            <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location>
            <layers>
                <layer>datasources-web-server</layer>
                <layer>web-clustering</layer>
            </layers>
        </configuration>
        <executions>
            <execution>
                <goals>
                    <goal>package</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
</plugins>

<plugins>
    <plugin>
        <groupId>org.wildfly.plugins</groupId>
        <artifactId>wildfly-jar-maven-plugin</artifactId>
        <version>${bootable.jar.maven.plugin.version}</version>
        <configuration>
            <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location>
            <layers>
                <layer>datasources-web-server</layer>
                <layer>web-clustering</layer>
            </layers>
        </configuration>
        <executions>
            <execution>
                <goals>
                    <goal>package</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
</plugins>

Copy to Clipboard

Toggle word wrap

注意

这个示例使用 web-clustering Galleon 层启用 Web 会话共享。

使用以下配置更新 src/main/webapp/WEB-INF 目录中的 web.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="4.0"
         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee  http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd">
    <distributable/>
</web-app>

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="4.0"
         xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee  http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd">
    <distributable/>
</web-app>

Copy to Clipboard

Toggle word wrap

& lt;distributable /> 标签表示此 servlet 可以在多个服务器间分布。

创建用于存储 Java 文件的目录：
```
mkdir -p APPLICATION_ROOT
/src/main/java/com/example/webclustering/
```
```
$ mkdir -p APPLICATION_ROOT
/src/main/java/com/example/webclustering/
```
Copy to Clipboard Toggle word wrap
其中 APPLICATION_ROOT 是包含应用的 pom.xml 配置文件的目录。

创建包含以下内容的 Java 文件 MyServlet.java，并将该文件保存到 APPLICATION_ROOT/src/main/java/com/example/webclustering/ 目录中。

package com.example.webclustering;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet(urlPatterns = {"/clustering"})
public class MyServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws IOException {
        response.setContentType("text/html;charset=UTF-8");
        long t;
        User user = (User) request.getSession().getAttribute("user");
        if (user == null) {
            t = System.currentTimeMillis();
            user = new User(t);
            request.getSession().setAttribute("user", user);
        }
        try (PrintWriter out = response.getWriter()) {
            out.println("<!DOCTYPE html>");
            out.println("<html>");
            out.println("<head>");
            out.println("<title>Web clustering demo</title>");
            out.println("</head>");
            out.println("<body>");
            out.println("<h1>Session id " + request.getSession().getId() + "</h1>");
            out.println("<h1>User Created " + user.getCreated() + "</h1>");
            out.println("<h1>Host Name " + System.getenv("HOSTNAME") + "</h1>");
            out.println("</body>");
            out.println("</html>");
        }
    }
}

package com.example.webclustering;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet(urlPatterns = {"/clustering"})
public class MyServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws IOException {
        response.setContentType("text/html;charset=UTF-8");
        long t;
        User user = (User) request.getSession().getAttribute("user");
        if (user == null) {
            t = System.currentTimeMillis();
            user = new User(t);
            request.getSession().setAttribute("user", user);
        }
        try (PrintWriter out = response.getWriter()) {
            out.println("<!DOCTYPE html>");
            out.println("<html>");
            out.println("<head>");
            out.println("<title>Web clustering demo</title>");
            out.println("</head>");
            out.println("<body>");
            out.println("<h1>Session id " + request.getSession().getId() + "</h1>");
            out.println("<h1>User Created " + user.getCreated() + "</h1>");
            out.println("<h1>Host Name " + System.getenv("HOSTNAME") + "</h1>");
            out.println("</body>");
            out.println("</html>");
        }
    }
}

Copy to Clipboard

Toggle word wrap

MyServlet.java 中的内容定义客户端向其发送 HTTP 请求的端点。

创建包含以下内容的 Java 文件 User.java，并将文件保存到 APPLICATION_ROOT/src/main/java/com/example/webclustering/ 目录中。

package com.example.webclustering;

import java.io.Serializable;

public class User implements Serializable {
    private final long created;

    User(long created) {
        this.created = created;
    }
    public long getCreated() {
        return created;
    }
}

package com.example.webclustering;

import java.io.Serializable;

public class User implements Serializable {
    private final long created;

    User(long created) {
        this.created = created;
    }
    public long getCreated() {
        return created;
    }
}

Copy to Clipboard

Toggle word wrap

打包应用程序：
```
mvn package
```
```
$ mvn package
```
Copy to Clipboard Toggle word wrap
可选：要在 JBoss EAP 裸机平台上运行应用程序，请按照在 JBoss EAP 裸机平台上使用可引导 JAR 中所述的步骤进行，但有以下区别：
1. 在 JBoss EAP 裸机平台上，您可以使用 java -jar 命令运行多个可引导 JAR 实例，如下例所示：
  $ java -jar target/web-clustering-bootable.jar -Djboss.node.name=node1 $ java -jar target/web-clustering-bootable.jar -Djboss.node.name=node2 -Djboss.socket.binding.port-offset=10
  Copy to Clipboard Toggle word wrap
2. 验证：您可以访问节点 1 实例中的应用程序： http://127.0.0.1:8080/clustering。记录用户会话 ID 和用户创建时间。
  终止此实例后，您可以访问节点 2 实例： http://127.0.0.1:8090/clustering。用户必须与会话 ID 和节点 1 实例的用户创建时间匹配。
可选：要在 JBoss EAP OpenShift 平台上运行应用程序，请按照在 JBoss EAP OpenShift 平台上使用可引导 JAR 中所述的步骤，但完成以下步骤：
1. 在插件配置中添加 <cloud /> 元素。例如：
  <plugins> <plugin> ...  <configuration > ... <cloud/> </configuration> </plugin> </plugins>
  Copy to Clipboard Toggle word wrap
2. 重建应用程序：
  $ mvn clean package
  Copy to Clipboard Toggle word wrap
3. 使用 oc login 命令登录到您的 OpenShift 实例。
4. 在 OpenShift 中创建一个新项目。例如：
  $ oc new-project bootable-jar-project
  Copy to Clipboard Toggle word wrap
5. 若要在 JBoss EAP OpenShift 平台上运行 web-clustering 应用，必须为 Pod 在其中运行的服务帐户授予授权访问权限。然后，服务帐户可以访问 Kubernetes REST API。以下示例显示了为服务帐户授予授权访问权限：
  $ oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default
  Copy to Clipboard Toggle word wrap
6. 输入以下 oc 命令来创建应用程序镜像：
  $ mkdir target/openshift && cp target/web-clustering-bootable.jar target/openshift
  1
  $ oc import-image ubi8/openjdk-11 --from=registry.redhat.io/ubi8/openjdk-11 --confirm
  2
  $ oc new-build --strategy source --binary --image-stream openjdk-11 --name web-clustering
  3
  $ oc start-build web-clustering --from-dir target/openshift
  4
  Copy to Clipboard Toggle word wrap
  1
  创建 target/openshift 子目录。打包的应用程序被复制到 openshift 子目录。
  2
  将最新的 OpenJDK 11 镜像流标签和镜像信息导入到 OpenShift 项目中。
  3
  根据 web-clustering 目录和 OpenJDK 11 镜像流创建构建配置。
  4
  使用 target/openshift 子目录作为二进制输入来构建应用程序。
7. 部署应用程序：
  $ oc new-app web-clustering -e KUBERNETES_NAMESPACE=$(oc project -q) $ oc expose svc/web-clustering
  Copy to Clipboard Toggle word wrap
  重要
  您必须使用 KUBERNETES_NAMESPACE 环境变量查看当前 OpenShift 命名空间中的其他 pod；否则，服务器会尝试从 default 命名空间检索 pod。
8. 获取路由的 URL。
  $ oc get route web-clustering --template='{{ .spec.host }}'
  Copy to Clipboard Toggle word wrap
9. 使用上一命令返回的 URL，访问 Web 浏览器中的应用。例如：
  http://ROUTE_NAME/clustering
  Copy to Clipboard Toggle word wrap
  记录用户会话 ID 和用户创建时间。
10. 将应用程序扩展到两个 pod：
  $ oc scale --replicas=2 deployments web-clustering
  Copy to Clipboard Toggle word wrap
11. 发出以下命令来查看可用的 OpenShift pod 列表，并检查 pod 构建状态：
  $ oc get pods
  Copy to Clipboard Toggle word wrap
12. 使用 oc delete pod web-clustering-POD_NAME命令终止 最旧的 pod，其中 POD_NAME 是最旧的 pod 的名称。
13. 再次访问应用程序：
  http://ROUTE_NAME/clustering
  Copy to Clipboard Toggle word wrap
  预期的结果：会话 ID 和新 pod 生成的创建时间与终止的 pod 的创建时间匹配。这表示启用了 Web 会话数据存储。

8.14. 为多个可引导 JAR 实例启用 Web 会话数据存储

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links