Red Hat JBoss Web Server for OpenShift

프로세스

1. Red Hat 고객 포털의 지침에 따라 레지스트리 서비스 계정을 사용하여 인증 토큰을 생성합니다.
2. 토큰의 토큰 정보 페이지에서 OpenShift Secret 탭을 클릭하고 토큰의 OpenShift 시크릿이 포함된 YAML 파일을 다운로드합니다.

3. 다운로드한 YAML 파일을 사용하여 OpenShift 프로젝트에 대한 인증 토큰 시크릿을 생성합니다.

   예를 들면 다음과 같습니다.

   oc create -f 1234567_myserviceaccount-secret.yaml

   Copy to Clipboard Toggle word wrap

4. OpenShift 프로젝트의 시크릿을 구성하려면 다음 명령을 입력합니다.

   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 를 이전 단계에서 생성한 시크릿 이름으로 교체합니다.

프로세스

1. 고객 포털 인증 정보를 사용하여 Red Hat Container Registry에 로그인합니다. 자세한 내용은 Red Hat Container Registry Authentication 을 참조하십시오.

2. 사용 중인 JDK 버전에 따라 다음 단계 중 하나를 수행합니다.

   • OpenJDK 17

     OpenJDK 17을 사용하는 경우 다음 명령을 입력합니다.

     for resource in \
     jws61-openjdk17-tomcat10-ubi8-basic-s2i.json \
     jws61-openjdk17-tomcat10-ubi8-https-s2i.json \
     jws61-openjdk17-tomcat10-ubi8-image-stream.json
     do
     oc replace -n openshift --force -f \
     https://raw.githubusercontent.com/jboss-container-images/jboss-webserver-6-openshift-image/jws61el8-v6.1.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

     이전 명령은 UBI8 JDK 17 이미지 스트림, jboss-webserver61-openjdk17-tomcat10-openshift-ubi8 및 명령에 지정된 모든 템플릿을 가져옵니다.

   • OpenJDK 21

     OpenJDK 21을 사용하는 경우 다음 명령을 입력합니다.

     for resource in \
     jws61-openjdk21-tomcat10-ubi8-basic-s2i.json \
     jws61-openjdk21-tomcat10-ubi8-https-s2i.json \
     jws61-openjdk21-tomcat10-ubi8-image-stream.json
     do
     oc replace -n openshift --force -f \
     https://raw.githubusercontent.com/jboss-container-images/jboss-webserver-6-openshift-image/jws61el8-v6.1.0/templates/${resource}
     done

     Copy to Clipboard Toggle word wrap

     이전 명령은 UBI8 JDK 21 이미지 스트림, jboss-webserver61-openjdk21-tomcat10-openshift-ubi8 및 명령에 지정된 모든 템플릿을 가져옵니다.

프로세스

1. 로컬 파일 시스템에서 바이너리 빌드용 소스 디렉터리와 배포 하위 디렉터리를 생성합니다.

   예를 들어 tomcat-websocket-chat 애플리케이션에 대한 /ocp 소스 디렉터리 및 /deployments 하위 디렉터리를 생성하려면 다음 명령을 입력합니다.

   $ cd tomcat-websocket-chat-quickstart/tomcat-websocket-chat/
   $ mkdir -p ocp/deployments

   Copy to Clipboard Toggle word wrap
   참고

   소스 디렉터리는 Maven 바이너리에 포함되지 않은 애플리케이션에 필요한 모든 콘텐츠를 포함할 수 있습니다. 자세한 내용은 JWS for OpenShift S2I process 를 참조하십시오.

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 는 복사할 바이너리 파일의 경로입니다.

   소스 디렉터리의 배포 하위 디렉터리에 있는 애플리케이션 아카이브는 OpenShift에 빌드되는 이미지의 $JWS_HOME/tomcat/webapps/ 디렉터리에 복사됩니다. 애플리케이션이 성공적으로 배포될 수 있도록 하려면 웹 애플리케이션 데이터가 포함된 디렉터리 계층 구조가 올바르게 구성되어 있는지 확인해야 합니다. 자세한 내용은 JWS for OpenShift S2I process 를 참조하십시오.

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. 애플리케이션에 사용할 OpenShift 이미지 스트림의 JWS를 식별합니다.

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

   Copy to Clipboard Toggle word wrap

   이전 명령은 다음 유형의 출력을 생성합니다.

   jboss-webserver61-openjdk17-tomcat10-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-webserver61-openjdk17-tomcat10-openshift-ubi8:latest \
    --name=jws-wsch-app

   Copy to Clipboard Toggle word wrap
   참고

   이전 예에서 jws-wsch-app 은 OpenShift용 JWS의 이름입니다.

   이전 명령은 다음 유형의 출력을 생성합니다.

   --> Found image 8c3b85b (4 weeks old) in image stream "openshift/jboss-webserver61-tomcat10-openshift" under tag "latest" for "jboss-webserver61"
   
       JBoss Web Server 6.1
       --------------------
       Platform for building and running web applications on JBoss Web Server 6.1 - Tomcat v10
   
       Tags: builder, java, tomcat10
   
       * 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 은 OpenShift 애플리케이션의 JWS 이름이며 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-6.1/tomcat/webapps` for later deployment...
   '/home/jboss/source/deployments/websocket-chat.war' -> '/opt/jws-6.1/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 은 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 6.1
       --------------------
       Platform for building and running web applications on JBoss Web Server 6.1 - Tomcat v10
   
       Tags: builder, java, tomcat10
   
       * 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. 웹 브라우저를 열고 URL을 입력하여 애플리케이션에 액세스합니다.

    예를 들어 예제 jws-wsch-app 애플리케이션에 액세스하려면 다음 URL을 입력합니다.

    http://<address_of_exposed_route>/websocket-chat

    참고

    이전 예에서 < address_of_exposed_route&gt;를 배포에 적절한 값으로 바꿉니다.

프로세스

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& gt;을 생성할 프로젝트의 이름으로 바꿉니다.

3. 애플리케이션에 사용할 OpenShift 이미지 스트림의 JWS를 식별합니다.

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

   Copy to Clipboard Toggle word wrap

   이전 명령은 다음 유형의 출력을 생성합니다.

   jboss-webserver61-openjdk17-tomcat10-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-webserver61-openjdk17-tomcat10-openshift-ubi8:latest \
    --name=<openshift_application_name>

   Copy to Clipboard Toggle word wrap

   예를 들면 다음과 같습니다.

   $ oc new-app \
    https://github.com/web-servers/tomcat-websocket-chat-quickstart.git#main \
    --image-stream=jboss-webserver61-openjdk17-tomcat10-openshift-ubi8:latest \
    --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. 웹 브라우저를 열고 다음 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-6.1/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. 이미지를 레지스트리로 푸시합니다.

   docker push <NEW IMAGE REGISTRY URL>

   Copy to Clipboard Toggle word wrap