Red Hat JBoss Web Server for OpenShift

流程

1. 按照红帽客户门户网站中的说明，使用 registry 服务帐户创建身份验证令牌。
2. 在令牌的 Token Information 页面中，点 OpenShift Secret 选项卡并下载包含令牌的 OpenShift secret 的 YAML 文件。

3. 使用您下载的 YAML 文件，为 OpenShift 项目创建身份验证令牌机密。

   例如：

   oc create -f 1234567_myserviceaccount-secret.yaml

   Copy to Clipboard Toggle word wrap

4. 要为 OpenShift 项目配置 secret，请输入以下命令：

   oc secrets link default 1234567-myserviceaccount-pull-secret --for=pull
   oc secrets link builder 1234567-myserviceaccount-pull-secret --for=pull

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，将 1234567-myserviceaccount 替换为您在上一步中创建的 secret 的名称。

流程

1. 使用您的客户门户网站凭证登录到 Red Hat Container Registry。如需更多信息，请参阅 Red Hat Container Registry 身份验证。

2. 根据您使用的 JDK 版本，执行以下步骤：

   • 如果使用 OpenJDK 8，输入以下命令：

     for resource in \
     jws57-openjdk8-tomcat9-ubi8-basic-s2i.json \
     jws57-openjdk8-tomcat9-ubi8-https-s2i.json \
     jws57-openjdk8-tomcat9-ubi8-image-stream.json
     do
     oc replace -n openshift --force -f \
     https://raw.githubusercontent.com/jboss-container-images/jboss-webserver-5-openshift-image/jws57el8-v5.7.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

     前面的命令导入 UBI8 JDK 8 镜像流、jboss-webserver57-openjdk8-tomcat9-openshift-ubi8 以及命令中指定的所有模板。

   • 如果使用 OpenJDK 11，输入以下命令：

     for resource in \
     jws57-openjdk11-tomcat9-ubi8-basic-s2i.json \
     jws57-openjdk11-tomcat9-ubi8-https-s2i.json \
     jws57-openjdk11-tomcat9-ubi8-image-stream.json
     do
     oc replace -n openshift --force -f \
     https://raw.githubusercontent.com/jboss-container-images/jboss-webserver-5-openshift-image/jws57el8-v5.7.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

     前面的命令导入 UBI8 JDK 11 镜像流、jboss-webserver57-openjdk11-tomcat9-openshift-ubi8 以及命令中指定的所有模板。

流程

1. 在本地文件系统中，为二进制构建创建一个源目录和一个 deployments 子目录。

   例如，要为 tomcat-websocket-chat 应用程序创建 /ocp 源目录和 /deployments 子目录，请输入以下命令：

   $ cd openshift-quickstarts/tomcat-websocket-chat/
   $ mkdir -p ocp/deployments

   Copy to Clipboard Toggle word wrap
   注意

   源目录可以包含未包含在 Maven 二进制文件中的应用程序所需的任何内容。如需更多信息，请参阅 JWS for OpenShift S2I 流程。

2. 将 .war、.ear 或 .jar 二进制文件复制到 deployments 子目录。

   例如，要复制 tomcat-websocket-chat 应用程序的 .war 文件，请输入以下命令：

   $ cp target/websocket-chat.war ocp/deployments/

   Copy to Clipboard Toggle word wrap
   注意

   在上例中，target/websocket-chat.war 是您要复制的二进制文件的路径。

   源目录的 deployments 子目录中的应用存档复制到 OpenShift 上构建的镜像的 $JWS_HOME/tomcat/webapps/ 目录中。要成功部署应用程序，您必须确保包含 Web 应用数据的目录层次结构是正确的。如需更多信息，请参阅 JWS for OpenShift S2I 流程。

3. 登录到 OpenShift 实例：

   $ oc login <url>

   Copy to Clipboard Toggle word wrap

4. 如果需要，创建一个新项目。

   例如：

   $ oc new-project jws-bin-demo

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，jws-bin-demo 是您要创建的项目名称。

5. 识别应用程序要使用的 JWS for OpenShift 镜像流：

   $ oc get is -n openshift | grep ^jboss-webserver | cut -f1 -d ' '

   Copy to Clipboard Toggle word wrap

   前面的命令会产生以下类型的输出：

   jboss-webserver57-openjdk8-tomcat9-openshift-ubi8

   Copy to Clipboard Toggle word wrap
   注意

   -n openshift 选项指定要使用的项目。oc get is -n openshift 命令从 openshift 项目中获取镜像流资源。

6. 创建新构建配置，并确保您指定镜像流和应用程序名称。

   例如，要为 tomcat-websocket-chat 应用程序创建新构建配置，请执行以下操作：

   $ oc new-build --binary=true \
    --image-stream=jboss-webserver57-openjdk8-tomcat9-openshift-ubi8:latest\*
    --name=jws-wsch-app

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，jws-wsch-app 是 JWS for OpenShift 应用的 JWS 的名称。

   前面的命令会产生以下类型的输出：

   --> Found image 8c3b85b (4 weeks old) in image stream "openshift/jboss-webserver57-tomcat9-openshift" under tag "latest" for "jboss-webserver57"
   
       JBoss Web Server 5.7
       --------------------
       Platform for building and running web applications on JBoss Web Server 5.7 - Tomcat v9
   
       Tags: builder, java, tomcat9
   
       * A source build using binary input will be created
         * The resulting image will be pushed to image stream "jws-wsch-app:latest"
         * A binary build was created, use 'start-build --from-dir' to trigger a new build
   
   --> Creating resources with label build=jws-wsch-app ...
       imagestream "jws-wsch-app" created
       buildconfig "jws-wsch-app" created
   --> Success

   Copy to Clipboard Toggle word wrap

7. 启动二进制构建。

   例如：

   $ oc start-build jws-wsch-app --from-dir=./ocp --follow

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，jws-wsch-app 是 JWS for OpenShift 应用的名称，ocp 是源目录的名称。

   前面的命令指示 OpenShift 使用您为 OpenShift 镜像构建的二进制输入创建的源目录。

   前面的命令会产生以下类型的输出：

   Uploading directory "ocp" as binary input for the build ...
   build "jws-wsch-app-1" started
   Receiving source from STDIN as archive ...
   
   Copying all deployments war artifacts from /home/jboss/source/deployments directory into `/opt/jws-5.7/tomcat/webapps` for later deployment...
   '/home/jboss/source/deployments/websocket-chat.war' -> '/opt/jws-5.7/tomcat/webapps/websocket-chat.war'
   
   Pushing image 172.30.202.111:5000/jws-bin-demo/jws-wsch-app:latest ...
   Pushed 0/7 layers, 7% complete
   Pushed 1/7 layers, 14% complete
   Pushed 2/7 layers, 29% complete
   Pushed 3/7 layers, 49% complete
   Pushed 4/7 layers, 62% complete
   Pushed 5/7 layers, 92% complete
   Pushed 6/7 layers, 100% complete
   Pushed 7/7 layers, 100% complete
   Push successful

   Copy to Clipboard Toggle word wrap

8. 根据镜像创建新 OpenShift 应用程序：

   例如：

   $ oc new-app jws-wsch-app

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，jws-wsch-app 是 JWS for OpenShift 应用的 JWS 的名称。

   前面的命令会产生以下类型的输出：

   --> Found image e5f3a6b (About a minute old) in image stream "jws-bin-demo/jws-wsch-app" under tag "latest" for "jws-wsch-app"
   
       JBoss Web Server 5.7
       --------------------
       Platform for building and running web applications on JBoss Web Server 5.7 - Tomcat v9
   
       Tags: builder, java, tomcat9
   
       * This image will be deployed in deployment config "jws-wsch-app"
       * Ports 8080/tcp, 8443/tcp, 8778/tcp will be load balanced by service "jws-wsch-app"
         * Other containers can access this service through the hostname "jws-wsch-app"
   
   --> Creating resources ...
       deploymentconfig "jws-wsch-app" created
       service "jws-wsch-app" created
   --> Success
       Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
        'oc expose svc/jws-wsch-app'
       Run 'oc status' to view your app.

   Copy to Clipboard Toggle word wrap

9. 公开该服务以使应用程序可以被用户访问：

   例如，要使 jws-wsch-app 应用程序可以被访问，请执行以下步骤：

   1. 检查要公开的服务名称：

      $ oc get svc -o name

      Copy to Clipboard Toggle word wrap

      前面的命令会产生以下类型的输出：

      service/jws-wsch-app

      Copy to Clipboard Toggle word wrap

   2. 公开服务：

      $ oc expose svc/jws-wsch-app

      Copy to Clipboard Toggle word wrap

      前面的命令会产生以下类型的输出：

      route "jws-wsch-app" exposed

      Copy to Clipboard Toggle word wrap

10. 检索公开路由的地址：

    oc get routes --no-headers -o custom-columns='host:spec.host' jws-wsch-app

    Copy to Clipboard Toggle word wrap

11. 打开 Web 浏览器，再输入 URL 以访问应用。

    例如，要访问示例 jws-wsch-app 应用程序，请输入以下 URL：

    \http://<address_of_exposed_route>/websocket-chat

    注意

    在前面的示例中，将 <address_of_exposed_route> 替换为您的部署的适当值。

流程

1. 登录到 OpenShift 实例：

   $ oc login <url>

   Copy to Clipboard Toggle word wrap

2. 根据需要创建新项目：

   $ oc new-project <project-name>

   Copy to Clipboard Toggle word wrap
   注意

   在前面的示例中，将 <project-name> 替换为您要创建的项目名称。

3. 识别应用程序要使用的 JWS for OpenShift 镜像流：

   $ oc get is -n openshift | grep ^jboss-webserver | cut -f1 -d ' '

   Copy to Clipboard Toggle word wrap

   前面的命令会产生以下类型的输出：

   jboss-webserver57-openjdk8-tomcat9-openshift-ubi8

   Copy to Clipboard Toggle word wrap
   注意

   -n openshift 选项指定要使用的项目。oc get is -n openshift 命令从 openshift 项目中获取镜像流资源。

4. 使用 Red Hat JBoss Web Server for OpenShift 镜像从源代码创建新 OpenShift 应用程序：

   $ oc new-app \
    <source_code_location>\
    --image-stream=jboss-webserver57-openjdk8-tomcat9-openshift-ubi8\
    --name=<openshift_application_name>

   Copy to Clipboard Toggle word wrap

   例如：

   $ oc new-app \
    \https://github.com/jboss-openshift/openshift-quickstarts.git#main \
    --image-stream=jboss-webserver57-openjdk8-tomcat9-openshift-ubi8\
    --context-dir='tomcat-websocket-chat' \
    --name=jws-wsch-app

   Copy to Clipboard Toggle word wrap

   前面的命令将源代码添加到镜像中，并编译源代码。前面的命令还会创建构建配置和服务。

5. 要公开应用程序，请执行以下步骤：

   1. 检查要公开的服务名称：

      $ oc get svc -o name

      Copy to Clipboard Toggle word wrap

      前面的命令会产生以下类型的输出：

      service/<openshift_application_name>

      Copy to Clipboard Toggle word wrap

   2. 公开服务：

      $ oc expose svc/<openshift_application_name>

      Copy to Clipboard Toggle word wrap

      前面的命令会产生以下类型的输出：

      route "<openshift_application_name>" exposed

      Copy to Clipboard Toggle word wrap

6. 检索公开路由的地址：

   oc get routes --no-headers -o custom-columns='host:spec.host' <openshift_application_name>

   Copy to Clipboard Toggle word wrap

7. 打开 Web 浏览器，并输入以下 URL 来访问应用程序：

   \http://<address_of_exposed_route>/<java_application_name>

   注意

   在前面的示例中，将 <address_of_exposed_route> 和 <java_application_name> 替换为部署的相应值。

流程

1. 启动 Docker 中的镜像：

   docker run --network host -i -t -p 8080:8080 ImageURL

   Copy to Clipboard Toggle word wrap

2. 查找 CONTAINER ID ：

    docker ps | grep <ImageName>

   Copy to Clipboard Toggle word wrap

3. 将库复制到 tomcat/lib/ 目录中：

   docker cp <yourLibrary> <CONTAINER ID>:/opt/jws-5.7/tomcat/lib/

   Copy to Clipboard Toggle word wrap

4. 将更改提交到新镜像：

   docker commit <CONTAINER ID> <NEW IMAGE NAME>

   Copy to Clipboard Toggle word wrap

5. 创建新镜像标签：

   docker tag <NEW IMAGE NAME>:latest <NEW IMAGE REGISTRY URL>:<TAG>

   Copy to Clipboard Toggle word wrap

6. 将镜像推送到 registry：

   docker push <NEW IMAGE REGISTRY URL>

   Copy to Clipboard Toggle word wrap