OpenShift 기반 Fuse 가이드

절차

1. 관리자로 OpenShift Server에 로그인합니다.

   oc login -u system:admin

2. 이미지 스트림을 설치하려는 OpenShift 프로젝트에 로그인합니다. OpenShift 이미지 스트림에서 Fuse 프로젝트를 사용하는 것이 좋습니다.

   oc project openshift

3. Red Hat Customer Portal 계정 또는 Red Hat Developer Program 계정 자격 증명을 사용하여 docker-registry 시크릿을 생성합니다. & lt;pull_secret_name >을 생성하려는 보안 이름으로 바꿉니다.

   oc create secret docker-registry <pull_secret_name> \
     --docker-server=registry.redhat.io \
     --docker-username=CUSTOMER_PORTAL_USERNAME \
     --docker-password=CUSTOMER_PORTAL_PASSWORD \
     --docker-email=EMAIL_ADDRESS

   참고

   이미지 스트림이 있고 registry.redhat.io를 사용하는 모든 네임스페이스에 docker-registry 시크릿을 생성해야 합니다.

4. Pod의 이미지를 가져오는 데 시크릿을 사용하려면 서비스 계정에 보안을 추가합니다. 서비스 계정 이름은 서비스 계정 Pod에서 사용하는 이름과 일치해야 합니다. 다음 예제에서는 default 서비스 계정을 사용합니다.

   oc secrets link default <pull_secret_name> --for=pull

5. 빌드 이미지를 푸시하고 가져오는 데 시크릿을 사용하려면 Pod 내부에서 보안을 마운트할 수 있어야 합니다. 시크릿을 마운트하려면 다음 명령을 사용합니다.

   oc secrets link builder <pull_secret_name>

절차

1. OpenShift 4 Server를 시작합니다.

2. 관리자로 OpenShift 서버에 로그인합니다.

   oc login -u system:admin

3. docker-registry 시크릿을 생성한 프로젝트를 사용하고 있는지 확인합니다.

   oc project openshift

4. Samples Operator의 현재 구성을 확인합니다.

   oc get configs.samples.operator.openshift.io -n openshift-cluster-samples-operator -o yaml

5. 추가된 fuse 템플릿 및 이미지 스트림을 무시하도록 Samples Operator를 구성합니다.

   oc edit configs.samples.operator.openshift.io -n openshift-cluster-samples-operator

6. Fuse 이미지 스트림 Skipped Imagestreams 섹션을 추가하고 Fuse 및 Spring Boot 2 템플릿을 Skipped Templates 섹션에 추가합니다.

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fis-java-openshift
     - fis-karaf-openshift
     - fuse7-console
     - fuse7-eap-openshift
     - fuse7-java-openshift
     - fuse7-karaf-openshift
     - jboss-fuse70-console
     - jboss-fuse70-eap-openshift
     - jboss-fuse70-java-openshift
     - jboss-fuse70-karaf-openshift
     - fuse-apicurito-generator
     - apicurito-ui
     skippedTemplates:
     - s2i-fuse76-eap-camel-amq
     - s2i-fuse76-eap-camel-cdi
     - s2i-fuse76-eap-camel-cxf-jaxrs
     - s2i-fuse76-eap-camel-cxf-jaxws
     - s2i-fuse76-eap-camel-jpa
     - s2i-fuse76-karaf-camel-amq
     - s2i-fuse76-karaf-camel-log
     - s2i-fuse76-karaf-camel-rest-sql
     - s2i-fuse76-karaf-cxf-rest
     - s2i-fuse76-spring-boot-camel
     - s2i-fuse76-spring-boot-camel-amq
     - s2i-fuse76-spring-boot-camel-config
     - s2i-fuse76-spring-boot-camel-drools
     - s2i-fuse76-spring-boot-camel-infinispan
     - s2i-fuse76-spring-boot-camel-rest-sql
     - s2i-fuse76-spring-boot-camel-rest-3scale
     - s2i-fuse76-spring-boot-camel-xa
     - s2i-fuse76-spring-boot-camel-xml
     - s2i-fuse76-spring-boot-cxf-jaxrs
     - s2i-fuse76-spring-boot-2-camel-amq
     - s2i-fuse76-spring-boot-2-camel-config
     - s2i-fuse76-spring-boot-2-camel-drools
     - s2i-fuse76-spring-boot-2-camel-infinispan
     - s2i-fuse76-spring-boot-2-camel-rest-3scale
     - s2i-fuse76-spring-boot-2-camel-rest-sql
     - s2i-fuse76-spring-boot-2-camel
     - s2i-fuse76-spring-boot-2-camel-xa
     - s2i-fuse76-spring-boot-2-camel-xml
     - s2i-fuse76-spring-boot-2-cxf-jaxrs
     - s2i-fuse76-spring-boot-2-cxf-jaxws
     - s2i-fuse76-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse76-spring-boot-2-cxf-jaxws-xml

7. OpenShift 이미지 스트림에 Fuse를 설치합니다.

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

   참고

   Error from server(AlreadyExists): imagestreams.image.openshift.io <imagestreamname >이라는 메시지와 함께 오류가 표시되면 다음 명령을 사용하여 기존 이미지 스트림을 최신 상태로 교체합니다.

   oc replace --force -n openshift -f ${BASEURL}/fis-image-streams.json

8. OpenShift 빠른 시작 템플릿에 Fuse를 설치합니다.

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-rest-3scale-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/quickstarts/${template}
    done

9. Spring Boot 2 빠른 시작 템플릿을 설치합니다.

   for template in spring-boot-2-camel-amq-template.json \
    spring-boot-2-camel-config-template.json \
    spring-boot-2-camel-drools-template.json \
    spring-boot-2-camel-infinispan-template.json \
    spring-boot-2-camel-rest-3scale-template.json \
    spring-boot-2-camel-rest-sql-template.json \
    spring-boot-2-camel-template.json \
    spring-boot-2-camel-xa-template.json \
    spring-boot-2-camel-xml-template.json \
    spring-boot-2-cxf-jaxrs-template.json \
    spring-boot-2-cxf-jaxws-template.json \
    spring-boot-2-cxf-jaxrs-xml-template.json \
    spring-boot-2-cxf-jaxws-xml-template.json ;
    do oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-760039-redhat-00001/quickstarts/${template}
    done

10. (선택 사항) OpenShift 템플릿에 설치된 Fuse를 확인합니다.

    oc get template -n openshift

절차

1. OpenShift Server를 시작합니다.

2. 관리자로 OpenShift 서버에 로그인합니다.

   oc login -u system:admin

3. docker-registry 시크릿을 생성한 프로젝트를 사용하고 있는지 확인합니다.

   oc project openshift

4. OpenShift 이미지 스트림에 Fuse를 설치합니다.

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003
   
   oc create -n openshift -f ${BASEURL}/fis-image-streams.json

5. 빠른 시작 템플릿을 설치합니다.

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-rest-3scale-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/quickstarts/${template}
    done

6. Spring Boot 2 빠른 시작 템플릿을 설치합니다.

   for template in spring-boot-2-camel-amq-template.json \
    spring-boot-2-camel-config-template.json \
    spring-boot-2-camel-drools-template.json \
    spring-boot-2-camel-infinispan-template.json \
    spring-boot-2-camel-rest-3scale-template.json \
    spring-boot-2-camel-rest-sql-template.json \
    spring-boot-2-camel-template.json \
    spring-boot-2-camel-xa-template.json \
    spring-boot-2-camel-xml-template.json \
    spring-boot-2-cxf-jaxrs-template.json \
    spring-boot-2-cxf-jaxws-template.json \
    spring-boot-2-cxf-jaxrs-xml-template.json \
    spring-boot-2-cxf-jaxws-xml-template.json ;
    do oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-760039-redhat-00001/quickstarts/${template}
    done

7. Fuse Console용 템플릿을 설치합니다.

   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/fis-console-cluster-template.json
   oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003/fis-console-namespace-template.json

   참고

   Fuse Console 배포에 대한 자세한 내용은 OpenShift에 Fuse Console 설정을 참조하십시오.

8. Apicurito 템플릿을 설치합니다.

   oc create -n openshift -f ${BASEURL}/fuse-apicurito.yml

9. (선택 사항) OpenShift 이미지 및 템플릿에서 설치된 Fuse를 확인합니다.

   oc get template -n openshift

절차

1. OpenShift 프로젝트에서 Fuse를 빌드하고 배포할 수 있도록 다음과 같이 OpenShift Server에 로그인합니다.

   oc login -u developer -p developer https://OPENSHIFT_IP_ADDR:8443

   여기서 OPENSHIFT_IP_ADDR 은 이 IP 주소가 항상 동일하지 않기 때문에 OpenShift 서버의 IP 주소 자리 표시자입니다.

   참고

   developer 사용자(개발 암호 포함)는 CDK를 통해 가상 OpenShift Server에서 자동으로 생성되는 표준 계정입니다. 원격 서버에 액세스하는 경우 OpenShift 관리자가 제공한 URL 및 인증 정보를 사용합니다.

2. test 라는 새 프로젝트 네임스페이스를 생성합니다(아직 존재하지 않는다고 가정).

   oc new-project test

   test 프로젝트 네임스페이스가 이미 있는 경우 해당 네임스페이스로 전환합니다.

   oc project test

3. OpenShift 이미지 스트림에 Fuse를 설치합니다.

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003
   
   oc create -n test -f ${BASEURL}/fis-image-streams.json

   명령 출력에는 OpenShift 프로젝트의 Fuse에서 사용할 수 있는 Fuse 이미지 스트림이 표시됩니다.

4. 빠른 시작 템플릿을 설치합니다.

   for template in eap-camel-amq-template.json \
    eap-camel-cdi-template.json \
    eap-camel-cxf-jaxrs-template.json \
    eap-camel-cxf-jaxws-template.json \
    eap-camel-jpa-template.json \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json \
    spring-boot-camel-amq-template.json \
    spring-boot-camel-config-template.json \
    spring-boot-camel-drools-template.json \
    spring-boot-camel-infinispan-template.json \
    spring-boot-camel-rest-sql-template.json \
    spring-boot-camel-rest-3scale-template.json \
    spring-boot-camel-template.json \
    spring-boot-camel-xa-template.json \
    spring-boot-camel-xml-template.json \
    spring-boot-cxf-jaxrs-template.json \
    spring-boot-cxf-jaxws-template.json ;
    do
    oc create -n test -f \
    ${BASEURL}/quickstarts/${template}
    done

5. Spring Boot 2 빠른 시작 템플릿을 설치합니다.

   for template in spring-boot-2-camel-amq-template.json \
    spring-boot-2-camel-config-template.json \
    spring-boot-2-camel-drools-template.json \
    spring-boot-2-camel-infinispan-template.json \
    spring-boot-2-camel-rest-3scale-template.json \
    spring-boot-2-camel-template.json \
    spring-boot-2-camel-xa-template.json \
    spring-boot-2-camel-xml-template.json \
    spring-boot-2-cxf-jaxrs-template.json \
    spring-boot-2-cxf-jaxws-template.json \
    spring-boot-2-cxf-jaxrs-xml-template.json \
    spring-boot-2-cxf-jaxws-xml-template.json ;
    do oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-760039-redhat-00001/quickstarts/${template}
    done

6. Fuse Console용 템플릿을 설치합니다.

   oc create -n test -f ${BASEURL}/fis-console-cluster-template.json
   oc create -n test -f ${BASEURL}/fis-console-namespace-template.json

   참고

   Fuse Console 배포에 대한 자세한 내용은 OpenShift에 Fuse Console 설정을 참조하십시오.

7. (선택 사항) OpenShift 이미지 및 템플릿에서 설치된 Fuse를 확인합니다.

   oc get template -n test

8. 브라우저에서 OpenShift 콘솔로 이동합니다.

   1. https://OPENSHIFT_IP_ADDR:8443 을 사용하고 OPENSHIFT_IP_ADDR 을 OpenShift 서버의 IP 주소로 바꿉니다.
   2. 인증 정보를 사용하여 OpenShift 콘솔에 로그인합니다(예: 사용자 이름 developer 및 암호 developer).

절차

1. 시스템의 적절한 디렉터리로 이동합니다.

2. 쉘 프롬프트에서 다음 mvn 명령을 입력하여 Spring Boot 프로젝트를 생성합니다.

   mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
     -DarchetypeCatalog=https://maven.repository.redhat.com/ga/io/fabric8/archetypes/archetypes-catalog/2.2.0.fuse-760024-redhat-00001/archetypes-catalog-2.2.0.fuse-760024-redhat-00001-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=spring-boot-camel-xml-archetype \
     -DarchetypeVersion=2.2.0.fuse-760024-redhat-00001

   archetype 플러그인은 대화형 모드로 전환되어 나머지 필드를 입력하라는 메시지를 표시합니다.

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse76-spring-boot
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse76-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   메시지가 표시되면 groupId 값으로 org.example.fis 를 입력하고 artifactId 값으로 fuse76-spring-boot 를 입력합니다. 나머지 필드의 기본값을 수락합니다.

3. 위의 명령이 BUILD SUCCESS 상태로 종료되면 fuse76-spring-boot 하위 디렉터리에 OpenShift 프로젝트에서 새 Fuse가 있어야 합니다.

4. 이제 fuse76-spring-boot 프로젝트를 빌드하고 배포할 준비가 되었습니다. OpenShift에 로그인되어 있다고 가정하면 fuse76-spring-boot 프로젝트의 디렉터리로 변경한 다음 다음과 같이 프로젝트를 빌드하고 배포합니다.

   cd fuse76-spring-boot
   mvn fabric8:deploy -Popenshift

절차

1. 시스템의 적절한 디렉터리로 이동합니다.

2. 쉘 프롬프트에서 다음 mvn 명령을 입력하여 Spring Boot 2 프로젝트를 생성합니다.

   mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
     -DarchetypeCatalog=https://maven.repository.redhat.com/ga/io/fabric8/archetypes/archetypes-catalog/2.2.0.fuse-sb2-760038-redhat-00001/archetypes-catalog-2.2.0.fuse-sb2-760038-redhat-00001-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=spring-boot-camel-xml-archetype \
     -DarchetypeVersion=2.2.0.fuse-sb2-760038-redhat-00001

   archetype 플러그인은 대화형 모드로 전환되어 나머지 필드를 입력하라는 메시지를 표시합니다.

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse76-spring-boot
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse76-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   메시지가 표시되면 groupId 값으로 org.example.fis 를 입력하고 artifactId 값으로 fuse76-spring-boot 를 입력합니다. 나머지 필드의 기본값을 수락합니다.

3. 위의 명령이 BUILD SUCCESS 상태로 종료되면 fuse76-spring-boot 하위 디렉터리에 OpenShift 프로젝트에서 새 Fuse가 있어야 합니다.

4. 이제 fuse76-spring-boot 프로젝트를 빌드하고 배포할 준비가 되었습니다. OpenShift에 로그인되어 있다고 가정하면 fuse76-spring-boot 프로젝트의 디렉터리로 변경한 다음 다음과 같이 프로젝트를 빌드하고 배포합니다.

   cd fuse76-spring-boot
   mvn fabric8:deploy -Popenshift

절차

1. Spring Boot pom.xml 파일에 다음 종속성을 추가합니다.

   <dependency>
       <groupId>org.apache.camel</groupId>
       <artifactId>camel-spring-boot-starter</artifactId>
   </dependency>

2. 아래 코드 조각에 표시된 대로 Camel 경로가 포함된 클래스를 추가합니다. 이러한 경로가 클래스 경로에 추가되면 경로가 자동으로 시작됩니다.

   package com.example;
   
   import org.apache.camel.builder.RouteBuilder;
   import org.springframework.stereotype.Component;
   
   @Component
   public class MyRoute extends RouteBuilder {
   
       @Override
       public void configure() throws Exception {
           from("timer:foo")
             .to("log:bar");
       }
   }

3. 선택 사항: Camel이 유지되도록 기본 스레드를 차단하여 유지하려면 다음 중 하나를 수행하십시오.

   1. spring-boot-starter-web 종속성을 포함합니다.

   2. 또는 application.properties 또는 application.yml 파일에 camel.springboot.main-run-controller=true 를 추가합니다.

      camel.springboot.* 속성을 사용하여 application.properties 또는 application.yml 파일에서 Camel 애플리케이션을 사용자 지정할 수 있습니다.

4. 선택 사항: Quarkus의 ID 이름을 사용하여 사용자 지정 useful을 참조하려면 src/main/resources/application.properties (또는 application.yml) 파일에서 옵션을 구성합니다. 다음 예제에서는ans ID를 사용하여 xslt 구성 요소가 사용자 지정 8080을 참조하는 방법을 보여줍니다.

   1. myExtensionFactory ID로 사용자 지정 8080을 참조하십시오.

      camel.component.xslt.saxon-extension-functions=myExtensionFactory

   2. 그런 다음 Spring Boot @Bean 주석을 사용하여 사용자 지정 8080을 만듭니다.

      @Bean(name = "myExtensionFactory")
      public ExtensionFunctionDefinition myExtensionFactory() {
          }

      또는 jackson ObjectMapper의 경우 camel-jackson data-format에서 다음을 수행하십시오.

      camel.dataformat.json-jackson.object-mapper=myJacksonMapper

절차

1. application.properties 파일에서 속성을 정의합니다.  

   route.from = jms:invoices

   또는 Camel 적절한 항목을 시스템 속성으로 설정합니다. 예를 들면 다음과 같습니다.

   java -Droute.to=jms:processed.invoices -jar mySpringApp.jar

2. 다음과 같이 구성된 속성을 Camel 경로에서 자리 표시자로 사용합니다.

   @Component
   public class MyRouter extends RouteBuilder {
   
     @Override
     public void configure() throws Exception {
       from("{{route.from}}").to("{{route.to}}");
     }
   
   }

절차

1. 다음과 같이 @SpringBootTest 주석에 대한 속성으로 단위 테스트 클래스에 포함 또는 제외 패턴을 지정합니다.

   @RunWith(CamelSpringBootRunner.class)
   @SpringBootTest(classes = {MyApplication.class);
      properties = {"camel.springboot.java-routes-include-pattern=**/Foo*"})
   public class FooTest {

   FooTest 클래스에서 포함 패턴은 **/Foo* 이며, 이는 Cryostat 스타일 패턴을 나타냅니다. 여기에서 패턴은 선행 패키지 이름과 일치하는 이중 별표로 시작됩니다. /foo* 는 클래스 이름이 FooRoute로 시작해야 함을 의미합니다.

2. 다음 maven 명령을 사용하여 테스트를 실행합니다.

   mvn test -Dtest=FooTest

절차

1. 샘플 application.properties 파일입니다. Kubernetes yaml 설명자에서 다음 옵션을 교체합니다.

   # Cluster
   cluster.nodename=1
   cluster.base-dir=./target/tx
   
   # Transaction Data
   spring.jta.transaction-manager-id=${cluster.nodename}
   spring.jta.log-dir=${cluster.base-dir}/store/${cluster.nodename}
   
   # Narayana recovery settings
   snowdrop.narayana.openshift.recovery.enabled=true
   snowdrop.narayana.openshift.recovery.current-pod-name=${cluster.nodename}
   # You must enable resource filtering in order to inject the Maven artifactId
   snowdrop.narayana.openshift.recovery.statefulset=${project.artifactId}
   snowdrop.narayana.openshift.recovery.status-dir=${cluster.base-dir}/status

2. 종료와 관련된 트랜잭션 및 정보를 모두 저장하려면 공유 볼륨이 필요합니다. 다음과 같이 StatefulSet yaml 설명자에 마운트할 수 있습니다.

   apiVersion: apps/v1beta1
   kind: StatefulSet
   #...
   spec:
   #...
     template:
   #...
       spec:
         containers:
         - env:
           - name: CLUSTER_BASE_DIR
             value: /var/transaction/data
             # Override CLUSTER_NODENAME with Kubernetes Downward API (to use `pod-0`, `pod-1` etc. as tx manager id)
           - name: CLUSTER_NODENAME
             valueFrom:
               fieldRef:
                 apiVersion: v1
                 fieldPath: metadata.name
   #...
           volumeMounts:
           - mountPath: /var/transaction/data
             name: the-name-of-the-shared-volume
   #...

절차

1. Camel Spring Boot XA 프로젝트를 다운로드합니다.

   git clone --branch spring-boot-camel-xa-1.0.0.fuse-760022-redhat-00001 https://github.com/jboss-fuse/spring-boot-camel-xa

2. spring-boot-camel-xa 디렉토리로 이동하여 다음 명령을 실행합니다.

   mvn clean install

3. OpenShift 서버에 로그인합니다.

   oc login -u developer -p developer

4. test 라는 새 프로젝트 네임스페이스를 생성합니다(아직 존재하지 않는다고 가정).

   oc new-project test

   test 프로젝트 네임스페이스가 이미 있는 경우 해당 네임스페이스로 전환합니다.

   oc project test

5. 종속 항목을 설치합니다.

   • 사용자 이름으로 사용자 이름 및 암호 Thepassword1! 를 사용하여 postgresql 를 설치합니다.

     oc new-app --param=POSTGRESQL_USER=theuser --param=POSTGRESQL_PASSWORD='Thepassword1!' --env=POSTGRESQL_MAX_PREPARED_TRANSACTIONS=100 --template=postgresql-persistent

   • 사용자 이름으로 사용자 이름 및 암호 Thepassword1! 를 사용하여 A-MQ 브로커를 설치합니다.

     oc new-app --param=MQ_USERNAME=theuser --param=MQ_PASSWORD='Thepassword1!' --template=amq63-persistent

6. 트랜잭션 로그에 대한 영구 볼륨 클레임을 생성합니다.

   oc create -f persistent-volume-claim.yml

7. 빠른 시작을 빌드하고 배포합니다.

   mvn fabric8:deploy -P openshift

8. 원하는 복제본 수까지 확장합니다.

   oc scale statefulset spring-boot-camel-xa --replicas 3

   참고: Pod 이름은 트랜잭션 관리자 ID(spring.jta. Cryostat-manager-id 속성)로 사용됩니다. 현재 구현은 트랜잭션 관리자 ID의 길이도 제한합니다. 다음 사항에 유의하십시오.

   • StatefulSet의 이름은 트랜잭션 시스템의 식별자이므로 변경할 수 없습니다.
   • 모든 Pod 이름의 길이가 23자보다 작거나 같도록 StatefulSet의 이름을 지정해야 합니다. Pod 이름은 <statefulset-name>-0, <statefulset-name>-1 등을 사용하여 OpenShift에 의해 생성됩니다. Narayana는 동일한 ID를 가진 여러 복구 관리자가 없도록하기 위해 최선을 다하므로 Pod 이름이 제한보다 길면 마지막 23 바이트가 트랜잭션 관리자 ID로 사용됩니다 (와 같은 일부 문자를 제거 한 후).

9. 빠른 시작이 실행되면 다음 명령을 사용하여 기본 서비스 URL을 가져옵니다.

   NARAYANA_HOST=$(oc get route spring-boot-camel-xa -o jsonpath={.spec.host})

절차

1. audit_log 테이블의 메시지 목록을 가져옵니다.

   curl -w "\n" http://$NARAYANA_HOST/api/

2. 처음에는 목록이 비어 있습니다. 이제 첫 번째 요소를 삽입할 수 있습니다.

   curl -w "\n" -X POST http://$NARAYANA_HOST/api/?entry=hello

   잠시 기다린 후 새 목록을 받으십시오.

   curl -w "\n" http://$NARAYANA_HOST/api/

3. 새 목록에는 hello 및 hello-ok 이라는 두 개의 메시지가 포함되어 있습니다. hello-ok 은 메시지가 발신 큐로 전송된 다음 기록되었음을 확인합니다. 여러 메시지를 추가하고 로그를 볼 수 있습니다.

절차

1. fail 이라는 메시지를 보냅니다.

   curl -w "\n" -X POST http://$NARAYANA_HOST/api/?entry=fail

2. 잠시 기다린 후 새 목록을 받으십시오.

   curl -w "\n" http://$NARAYANA_HOST/api/

3. 이 메시지는 경로 끝에 예외를 생성하므로 트랜잭션이 항상 롤백됩니다. audit_log 표에서 메시지의 추적을 찾을 수 없습니다.

절차

1. OpenShift 서버에 개발자로 로그인합니다.

   oc login -u developer -p developer

2. openshift 프로젝트에 로그인합니다.

   oc project openshift

3. Maven 워크플로를 사용하여 빠른 시작 프로젝트를 생성합니다.

   mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
   -DarchetypeCatalog=https://maven.repository.redhat.com/ga/io/fabric8/archetypes/archetypes-catalog/2.2.0.fuse-760024-redhat-00001/archetypes-catalog-2.2.0.fuse-760024-redhat-00001-archetype-catalog.xml \
   -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
   -DarchetypeArtifactId=spring-boot-camel-amq-archetype \
   -DarchetypeVersion=2.2.0.fuse-760024-redhat-00001

4. archetype 플러그인은 대화형 모드로 전환되어 나머지 필드를 입력하라는 메시지를 표시합니다.

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse76-spring-boot-camel-amq
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse76-spring-boot-camel-amq
   version: 1.0-SNAPSHOT
   package: org.example.fis
   Y: :Y

   메시지가 표시되면 groupId 값으로 org.example.fis 를 입력하고 artifactId 값으로 fuse76-spring-boot-camel-amq 를 입력합니다. 나머지 필드의 기본값을 수락합니다.

5. 빠른 시작 디렉터리 fuse76-spring-boot-camel-amq 로 이동합니다.

   cd fuse76-spring-boot-camel-amq

6. 다음 명령을 실행하여 구성 파일을 AMQ Online에 적용합니다. 이러한 구성 파일은 관리자 권한이 있는 AMQ Online 사용자와 큐를 생성합니다.

   oc login -u system:admin
   oc apply -f src/main/resources/k8s

7. mvn 명령을 실행하여 OpenShift 서버에 퀵스타트를 배포합니다.

   mvn fabric8:deploy -Popenshift

8. 빠른 시작이 성공적으로 실행 중인지 확인하려면 다음을 수행하십시오.

   1. 브라우저에서 OpenShift 웹 콘솔(https://OPENSHIFT_IP_ADDR, OPENSHIFT_IP_ADDR을 클러스터의 IP 주소로 교체)로 이동하고 인증 정보(예: 사용자 이름 developer 및 암호, developer 사용)로 콘솔에 로그인합니다.
   2. 왼쪽 패널에서 홈을 확장한 다음 상태를 클릭하여 openshift 프로젝트의 Project Status 페이지를 확인합니다.
   3. fuse76-spring-boot-camel-amq 를 클릭하여 퀵 스타트에 대한 개요 정보 페이지를 확인합니다.
   4. 왼쪽 패널에서 워크로드를 확장합니다.
   5. 포드 를 클릭한 다음 fuse76-spring-boot-camel-amq-xxxxx 를 클릭합니다. 빠른 시작에 대한 Pod 세부 정보가 표시됩니다.

   6. 로그를 클릭하여 애플리케이션의 로그를 확인합니다.

      출력에 메시지가 성공적으로 전송됨이 표시됩니다.

      10:17:59.825 [Camel (camel) thread #10 - timer://order] INFO  generate-order-route - Generating order order1379.xml
      10:17:59.829 [Camel (camel) thread #8 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Sending order order1379.xml to the UK
      10:17:59.829 [Camel (camel) thread #8 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Done processing order1379.xml
      10:18:02.825 [Camel (camel) thread #10 - timer://order] INFO  generate-order-route - Generating order order1380.xml
      10:18:02.829 [Camel (camel) thread #7 - JmsConsumer[incomingOrders]] INFO  jms-cbr-route - Sending order order1380.xml to another country
      10:18:02.829 [Camel (camel) thread #7 - JmsConsumer[incomingOrders]] INFO jms-cbr-route - Done processing order1380.xml

9. 웹 인터페이스에서 경로를 보려면 Open Java Console 을 클릭하고 AMQ 큐에서 메시지를 확인합니다.

1. 보안 마운트에서 재귀적으로 읽기
2. 애플리케이션 이름( spring.application.name참조)
3. 일부 라벨 일치

절차

1. 시스템의 적절한 디렉터리로 이동합니다.

2. Maven 명령을 시작하여 Karaf 프로젝트를 생성합니다.

   mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
     -DarchetypeCatalog=https://maven.repository.redhat.com/ga/io/fabric8/archetypes/archetypes-catalog/2.2.0.fuse-760024-redhat-00001/archetypes-catalog-2.2.0.fuse-760024-redhat-00001-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=karaf-camel-log-archetype \
     -DarchetypeVersion=2.2.0.fuse-760024-redhat-00001

3. archetype 플러그인이 대화형 모드로 전환하여 나머지 필드를 입력하라는 메시지를 표시합니다.

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse76-karaf-camel-log
   Define value for property 'version':  1.0-SNAPSHOT: :
   Define value for property 'package':  org.example.fis: :
   Confirm properties configuration:
   groupId: org.example.fis
   artifactId: fuse76-karaf-camel-log
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   메시지가 표시되면 groupId 값으로 org.example.fis 를 입력하고 artifactId 값에 대해 fuse76-karaf-camel-log 를 입력합니다. 나머지 필드의 기본값을 수락합니다.

4. 위의 명령이 BUILD SUCCESS 상태로 종료되면 fuse76-karaf-camel-log 하위 디렉터리에 OpenShift 프로젝트에서 새 Fuse가 있어야 합니다.

5. 이제 fuse76-karaf-camel-log 프로젝트를 빌드하고 배포할 준비가 되었습니다. OpenShift에 로그인되어 있다고 가정하면 fuse76-karaf-camel-log 프로젝트의 디렉터리로 변경한 다음 다음과 같이 프로젝트를 빌드하고 배포합니다.

   cd fuse76-karaf-camel-log
   mvn fabric8:deploy -Popenshift

절차

1. 프로젝트의 pom.xml 을 열고 startupFeatures 섹션에 fabric8-karaf-checks 기능을 추가합니다.

   pom.xml

   <startupFeatures>
     ...
     <feature>fabric8-karaf-checks</feature>
     ...
   </startupFeatures>

   fabric8-maven-plugin:resources 목표는 fabric8-karaf-checks 기능을 사용하는지 여부를 감지하고 컨테이너 구성에 준비 및 활성 프로브를 자동으로 추가합니다.

절차

1. 기본 서비스 계정에 view 역할을 추가하여 클러스터링을 활성화합니다. 그러면 사용자에게 기본 서비스 계정에 대한 보기 액세스 권한이 부여됩니다. 빌드, 배포 및 기타 Pod를 실행하려면 각 프로젝트에 서비스 계정이 필요합니다. 쉘 프롬프트에서 다음 oc 클라이언트 명령을 입력합니다.

   oc login -u developer -p developer
   oc policy add-role-to-user view -z default

2. OpenShift 템플릿에 설치된 Fuse를 확인합니다.

   oc get template -n openshift

3. 다음 명령을 입력하여 EAP 빠른 시작으로 Red Hat Fuse 7.6 Camel CDI를 실행하는 데 필요한 리소스를 생성합니다. 빠른 시작에 대한 배포 구성 및 빌드 구성을 생성합니다. 빠른 시작 및 생성된 리소스에 대한 정보가 터미널에 표시됩니다.

   oc new-app s2i-fuse76-eap-camel-cdi
   
   --> Creating resources ...
       service "s2i-fuse76-eap-camel-cdi" created
       service "s2i-fuse76-eap-camel-cdi-ping" created
       route.route.openshift.io "s2i-fuse76-eap-camel-cdi" created
       imagestream.image.openshift.io "s2i-fuse76-eap-camel-cdi" created
       buildconfig.build.openshift.io "s2i-fuse76-eap-camel-cdi" created
       deploymentconfig.apps.openshift.io "s2i-fuse76-eap-camel-cdi" created
   --> Success
       Access your application via route 's2i-fuse76-eap-camel-cdi-OPENSHIFT_IP_ADDR'
       Build scheduled, use 'oc logs -f bc/s2i-fuse76-eap-camel-cdi' to track its progress.
       Run 'oc status' to view your app.

4. 브라우저에서 OpenShift 웹 콘솔로 이동하고(https://OPENSHIFT_IP_ADDR, OPENSHIFT_IP_ADDR 을 클러스터의 IP 주소로 교체) 인증 정보로 로그인합니다(예: 사용자 이름 developer 및 암호, 개발자).
5. 왼쪽 패널에서 홈을 확장합니다. Projects 를 클릭한 다음 openshift 프로젝트를 선택하여 프로젝트 대시보드를 확인합니다.
6. 워크로드 탭을 클릭합니다. 선택한 네임스페이스(예: openshift)의 기존 애플리케이션이 모두 표시됩니다.

7. s2i-fuse76-eap-camel-cdi 를 클릭하여 퀵 스타트에 대한 개요 정보 페이지를 확인합니다.

   

8. 리소스 탭을 클릭한 다음 경로 섹션에 표시된 링크를 클릭하여 애플리케이션에 액세스합니다.

   

   링크의 형식은 http://s2i-fuse76-eap-camel-cdi-OPENSHIFT_IP_ADDR 입니다. 브라우저에 다음과 같은 메시지가 표시됩니다.

   Hello world from 172.17.0.3

9. URL에서 name 매개변수를 사용하여 이름을 지정할 수도 있습니다. 예를 들어 브라우저에 URL http://s2i-fuse76-eap-camel-cdi-openshift.apps.cluster-name.openshift.com/?name=jdoe 을 입력하면 응답이 표시됩니다.

   Hello jdoe from 172.17.0.3

10. View Logs (로그 보기)를 클릭하여 애플리케이션의 로그를 확인합니다.

11. 실행 중인 Pod를 종료하려면 다음을 수행합니다.

    1. 개요 탭을 클릭하여 애플리케이션의 개요 정보 페이지로 돌아갑니다.
    2. Pod 아이콘 옆에 있는 아래쪽 화살표 를 클릭하여 Pod를 중지하도록 0으로 축소합니다.

절차

1. apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv0001
   spec:
     accessModes:
       - ReadWriteOnce
     capacity:
       storage: 2Mi
     hostPath:
       path: /data/pv0001/

2. oc create -f pv.yaml

3. oc get pv

절차

1. spec:
     template:
       spec:
         containers:
           - volumeMounts:
             - name: vol0001
               mountPath: /usr/share/data
         volumes:
           - name: vol0001
             persistentVolumeClaim:
               claimName: pvc0001

2. mvn fabric8:resource-apply

3. oc describe deploymentconfig <application-dc-name>

절차

1. $ oc get is -n openshift
   NAME                            DOCKER REPO                                           TAGS                            UPDATED
   fuse7-console                   172.30.1.1:5000/openshift/fuse7-console               1.0,1.1,1.2,1.3,1.4,1.5,1.6     About an hour ago
   fuse7-eap-openshift             172.30.1.1:5000/openshift/fuse7-eap-openshift         1.0,1.1,1.2,,1.3,1.4,1.5,1.6    About an hour ago
   fuse7-java-openshift            172.30.1.1:5000/openshift/fuse7-java-openshift        1.0,1.1,1.2,1.3,1.4,1.5,1.6     About an hour ago
   fuse7-karaf-openshift           172.30.1.1:5000/openshift/fuse7-karaf-openshift       1.0,1.1,1.2,1.3,1.4,1.5,1.6     About an hour ago...
   fuse-apicurito-generator        172.30.1.1:5000/openshift/fuse-apicurito-generator    1.2,1.3,1.4,1.5,1.6             About an hour ago...
   apicurito-ui                    172.30.1.1:5000/openshift/apicurito-ui                1.2,1.3,1.4,1.5,1.6             About an hour ago...

2. oc import-image -n openshift fuse7-java-openshift:1.6
   oc import-image -n openshift fuse7-karaf-openshift:1.6
   oc import-image -n openshift fuse7-eap-openshift:1.6
   oc import-image -n openshift fuse7-console:1.6
   oc import-image -n openshift apicurito-ui:1.6
   oc import-image -n openshift fuse-apicurito-generator:1.6

절차

1. oc login URL -u ADMIN_USER -p ADMIN_PASS

2. BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-760043-redhat-00003
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cdi-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cxf-jaxrs-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-cxf-jaxws-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/eap-camel-jpa-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-log-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-camel-rest-sql-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/karaf-cxf-rest-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-amq-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-config-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-drools-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-infinispan-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-camel-xml-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-cxf-jaxrs-template.json
   oc replace --force -n openshift -f ${BASEURL}/quickstarts/spring-boot-cxf-jaxws-template.json

   참고