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 \
     jws56-openjdk8-tomcat9-ubi8-basic-s2i.json \
     jws56-openjdk8-tomcat9-ubi8-https-s2i.json \
     jws56-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/jws56el8-v5.6.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

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

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

     for resource in \
     jws56-openjdk11-tomcat9-ubi8-basic-s2i.json \
     jws56-openjdk11-tomcat9-ubi8-https-s2i.json \
     jws56-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/jws56el8-v5.6.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

     前面的命令导入 UBI8 JDK 11 镜像流、jboss-webserver56-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-webserver56-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-webserver56-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-webserver56-tomcat9-openshift" under tag "latest" for "jboss-webserver56"
   
       JBoss Web Server 5.6
       --------------------
       Platform for building and running web applications on JBoss Web Server 5.6 - 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.6/tomcat/webapps` for later deployment...
   '/home/jboss/source/deployments/websocket-chat.war' -> '/opt/jws-5.6/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.6
       --------------------
       Platform for building and running web applications on JBoss Web Server 5.6 - 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-webserver56-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-webserver56-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-webserver56-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.6/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

流程

1. 在项目命名空间中，使用 oc import-image 命令创建镜像流，以导入镜像的标签和其他信息。

   例如：

   oc import-image <my-image>-imagestream:latest \
   --from=quay.io/$user/<my-image>:latest \
   --confirm

   Copy to Clipboard Toggle word wrap

   在上例中，将每个出现的 &lt ;my-image > 替换为您要导入的镜像的名称。

   以上命令通过为 quay.io/$user/<my-image> 镜像导入信息来创建一个名为 <my-image>-imagestream 的镜像流。有关镜像流的格式和管理的更多信息，请参阅管理镜像流。

2. 为您希望在镜像流被更新时 JWS Operator 进行部署的 Web 应用程序创建 WebServer kind 的自定义资源。您可以使用 YAML 文件格式定义自定义资源。

   例如：

   apiVersion: web.servers.org/v1alpha1
   kind: WebServer
   metadata:
     name: <my-image>
   spec:
     # Add fields here
     applicationName: my-app
     useSessionClustering: true
     replicas: 2
     webImageStream:
       imageStreamNamespace: <project-name>
       imageStreamName: <my-image>-imagestream

   Copy to Clipboard Toggle word wrap

3. 使用 oc tag 命令触发对镜像流的更新。

   例如：

   oc tag quay.io/$user/<my-image> <my-image>-imagestream:latest --scheduled

   Copy to Clipboard Toggle word wrap

   上述命令会导致 OpenShift Container Platform 定期更新指定的镜像流标签。这个周期是集群范围的设置，默认设置为 15 分钟。

流程

1. 准备您的镜像并将其推送到要显示镜像的位置（例如 quay.io/ <USERNAME> /tomcat-demo:latest）。

2. 要为 自定义资源 web 服务器创建 YAML 文件，请执行以下步骤：

   1. 创建名为 的文件，如 webserver _cr.yaml。

   2. 以以下格式输入详情：

      apiVersion: web.servers.org/v1alpha1
      kind: WebServer
      metadata:
          name: example-image-webserver
      spec:
          # Add fields here
          applicationName: jws-app
          replicas: 2
      webImage:
         applicationImage: quay.io/<USERNAME>/tomcat-demo:latest

      Copy to Clipboard Toggle word wrap

3. 要部署 Web 应用程序，请执行以下步骤：

   1. 进入您在其中创建 Web 应用的目录。

   2. 输入以下命令：

      $ oc apply -f webservers_cr.yaml

      Copy to Clipboard Toggle word wrap

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

      webserver/example-image-webserver created

      Copy to Clipboard Toggle word wrap
      注意

      Operator 会自动创建一个路由。

4. 验证 Operator 创建的路由：

   $ oc get routes

   Copy to Clipboard Toggle word wrap

5. 可选：删除您在上一步中创建的 webserver ：

   $ oc delete webserver example-image-webserver

   Copy to Clipboard Toggle word wrap
   注意

   或者，您可以通过删除 YAML 文件来删除 webserver。例如：

   oc delete -f webservers_cr.yaml