OpenShift 上的 Fuse 指南

流程

1. 以管理员身份登录 OpenShift 服务器：

   oc login -u system:admin

2. 登录到您要安装镜像流的 OpenShift 项目。我们建议您将 openshift 项目用于 OpenShift 镜像流上的 Fuse。

   oc project openshift

3. 使用您的红帽客户门户网站帐户或 Red Hat Developer Program 帐户凭证创建 docker-registry secret。将 <pull_secret_name > 替换为您要创建的 secret 的名称。

   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

   注意

   您需要在镜像流所在的每个新命名空间中创建 docker-registry secret，并在使用 registry.redhat.io 的每个命名空间中创建一个 docker-registry secret。

4. 要使用 secret 为 pod 拉取镜像，请将 secret 添加到您的服务帐户。服务帐户的名称必须与服务帐户 pod 使用的名称匹配。以下示例使用 default，这是 default 服务帐户。

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

5. 要使用 secret 来推送和拉取构建镜像，该 secret 必须可在 pod 中挂载。要挂载 secret，请使用以下命令：

   oc secrets link builder <pull_secret_name>

流程

1. 启动 OpenShift 4 服务器。

2. 以管理员身份登录 OpenShift 服务器。

   oc login -u system:admin

3. 验证您是否使用创建了 docker-registry secret 的项目。

   oc project openshift

4. 查看 Samples operator 的当前配置。

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

5. 配置 Samples operator 以忽略添加的 fuse 模板和镜像流。

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

6. 添加 Fuse imagestreams 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-fuse78-eap-camel-amq
     - s2i-fuse78-eap-camel-cdi
     - s2i-fuse78-eap-camel-cxf-jaxrs
     - s2i-fuse78-eap-camel-cxf-jaxws
     - s2i-fuse78-karaf-camel-amq
     - s2i-fuse78-karaf-camel-log
     - s2i-fuse78-karaf-camel-rest-sql
     - s2i-fuse78-karaf-cxf-rest
     - s2i-fuse78-spring-boot-2-camel-amq
     - s2i-fuse78-spring-boot-2-camel-config
     - s2i-fuse78-spring-boot-2-camel-drools
     - s2i-fuse78-spring-boot-2-camel-infinispan
     - s2i-fuse78-spring-boot-2-camel-rest-3scale
     - s2i-fuse78-spring-boot-2-camel-rest-sql
     - s2i-fuse78-spring-boot-2-camel
     - s2i-fuse78-spring-boot-2-camel-xa
     - s2i-fuse78-spring-boot-2-camel-xml
     - s2i-fuse78-spring-boot-2-cxf-jaxrs
     - s2i-fuse78-spring-boot-2-cxf-jaxws
     - s2i-fuse78-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse78-spring-boot-2-cxf-jaxws-xml

7. 在 OpenShift 镜像流上安装 Fuse。

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

   注意

   如果显示错误，显示消息 "Error from server (AlreadyExists): imagestreams.image.openshift.io <imagestreamname> already exists"，使用以下命令将现有镜像流替换为最新的镜像流。

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

8. 在 OpenShift quickstart 模板上安装 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 \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-780019-redhat-00005/quickstarts/${template}
    done

9. 安装 Spring Boot 2 quickstart 模板：

   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-780019-redhat-00005/quickstarts/${template}
    done

10. （可选） 查看 OpenShift 模板上安装的 Fuse:

    oc get template -n openshift

流程

1. 启动 OpenShift 4.x 服务器。
2. 在 Web 浏览器中，导航到浏览器中的 OpenShift 控制台。使用您的凭证登录到控制台。
3. 点 Operators，然后点 OperatorHub。
4. 在搜索字段中，键入 API Designer。
5. 点 API Designer 卡。API Designer operator install 页面将打开。

6. 点 Install。此时会打开 Install Operator 页面。

   1. 对于 Installation mode，请从集群中的命名空间列表中选择一个命名空间（项目），

   2. 对于 Approval Strategy，选择 Automatic 或 Manual 来配置 OpenShift 如何处理对 API Designer Operator 的更新。

      • 如果选择 Automatic 更新，当 API Designer Operator 的新版本可用时，OpenShift Operator Lifecycle Manager (OLM)将自动升级 API Designer 的运行实例，而无需人为干预。
      • 如果选择手动 更新，则当有新版 Operator 可用时，OLM 会创建更新请求。作为集群管理员，您必须手动批准该更新请求，才能将 API Designer operator 更新至新版本。
7. 点 Install 使 API Designer Operator 可供指定命名空间（项目）使用。
8. 要验证项目中是否安装了 API Designer，请点 Operators，然后点 Installed Operators 查看列表中的 API Designer。

流程

1. 启动 OpenShift 服务器。

2. 以管理员身份登录 OpenShift 服务器。

   oc login -u system:admin

3. 验证您是否使用创建了 docker-registry secret 的项目。

   oc project openshift

4. 在 OpenShift 镜像流上安装 Fuse。

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

5. 安装 Quickstart 模板：

   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 \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json ;
    do
    oc create -n openshift -f \
    https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-780019-redhat-00005/quickstarts/${template}
    done

6. 安装 Spring Boot 2 quickstart 模板：

   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-780019-redhat-00005/quickstarts/${template}
    done

7. 安装 Fuse 控制台的模板。

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

   注意

   有关部署 Fuse 控制台的详情，请参考在 OpenShift 中设置 Fuse 控制台。

8. 安装 Apicurito 模板：

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

9. （可选） 查看 OpenShift 镜像和模板中安装的 Fuse：

   oc get template -n openshift

流程

1. 安装内部 ROOT CA。

   cd /etc/pki/ca-trust/source/anchors
   sudo curl -O https://password.corp.redhat.com/RH-IT-Root-CA.crt
   sudo update-ca-trust extract
   sudo update-ca-trust update

   此证书允许系统向 registry 验证其自身。

2. 登录到 Red Hat Container Registry。

   docker login -u USERNAME -p PASSWORD registry.redhat.io

3. 从 registry.redhat.io 拉取 OpenShift 镜像上的 Fuse。

   docker pull registry.redhat.io/fuse7/fuse-java-openshift:1.8
   docker pull registry.redhat.io/fuse7/fuse-karaf-openshift:1.8
   docker pull registry.redhat.io/fuse7/fuse7-fuse-console:1.8
   docker pull registry.redhat.io/fuse7/fuse7-fuse-apicurito:1.8
   docker pull registry.redhat.io/fuse7/fuse7-fuse-apicurito-generator:1.8

4. 标记拉取的镜像流。

   docker tag registry.redhat.io/fuse7/fuse-java-openshift:1.8 docker-registry.upshift.redhat.com/fuse7/fuse-java-openshift:1.8
   docker tag registry.redhat.io/fuse7/fuse-karaf-openshift:1.8 docker-registry.upshift.redhat.com/fuse-karaf-openshift:1.8
   docker tag registry.redhat.io/fuse7/fuse7-fuse-console:1.8 docker-registry.upshift.redhat.com/fuse7-fuse-console:1.8
   docker tag registry.redhat.io/fuse7/fuse7-fuse-apicurito:1.8 docker-registry.upshift.redhat.com/fuse7-fuse-apicurito:1.8
   docker tag registry.redhat.io/fuse7/fuse7-fuse-apicurito-generator:1.8 docker-registry.upshift.redhat.com/fuse7-fuse-apicurito-generator:1.8

5. 将标记的镜像流推送到内部 Docker registry。

   docker push docker-registry.upshift.redhat.com/fuse7/fuse-java-openshift:1.8
   docker push docker-registry.upshift.redhat.com/fuse-karaf-openshift:1.8
   docker push docker-registry.upshift.redhat.com/fuse7-fuse-console:1.8
   docker push docker-registry.upshift.redhat.com/fuse7-fuse-apicurito:1.8
   docker push docker-registry.upshift.redhat.com/fuse7-fuse-apicurito-generator:1.8

流程

1. 以管理员身份登录 OpenShift 服务器。

   oc login -u system:admin

2. 使用您的红帽客户门户网站帐户或 Red Hat Developer Program 帐户凭证创建 docker-registry secret。将 <pull_secret_name > 替换为您要创建的 secret 的名称。

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

3. 要使用 secret 为 pod 拉取镜像，请将 secret 添加到您的服务帐户。服务帐户的名称必须与服务帐户 pod 使用的名称匹配。

   oc secrets add serviceaccount/builder secrets/psi-internal-registry
   oc secrets add serviceaccount/default secrets/psi-internal-registry --for=pull
   oc secrets add serviceaccount/builder secrets/psi-internal-registry

4. 要使用 secret 来推送和拉取构建镜像，该 secret 必须可在 pod 中挂载。要挂载该机密，请使用以下命令：

   oc secrets link default psi-internal-registry
   oc secrets link default psi-internal-registry --for=pull
   oc secrets link builder psi-internal-registry

流程

1. 从 OpenShift 镜像流 json 文件下载 Red Hat Fuse。

   curl -o fis-image-streams.json {BASEURL}

2. 打开 fis-image-streams.json 文件，并找到对 registry.redhat.io 的所有引用。例如，

   {
   "name": "1.8",
   "annotations": {
   "description": "Red Hat Fuse 7.8 Karaf S2I images.",
   "openshift.io/display-name": "Red Hat Fuse 7.8 Karaf",
   "iconClass": "icon-rh-integration",
   "tags": "builder,jboss-fuse,java,karaf,xpaas,hidden",
   "supports":"jboss-fuse:7.8.0,java:8,xpaas:1.2",
   "version": "1.8"
   },
   "referencePolicy": {
   "type": "Local"
   },
   "from": {
   "kind": "DockerImage",
   "name": "registry.redhat.io/fuse7/fuse-karaf-openshift:1.8"
   }
   },

3. 将文件中的所有 registry.redhat.io 引用替换为 psi-internal-registry 名称。例如，

   {
   "name": "1.8",
   "annotations": {
   "description": "Red Hat Fuse 7.8 Karaf S2I images.",
   "openshift.io/display-name": "Red Hat Fuse 7.8 Karaf",
   "iconClass": "icon-rh-integration",
   "tags": "builder,jboss-fuse,java,karaf,xpaas,hidden",
   "supports":"jboss-fuse:7.8.0,java:8,xpaas:1.2",
   "version": "1.8"
   },
   "referencePolicy": {
   "type": "Local"
   },
   "from": {
   "kind": "DockerImage",
   "name": "docker-registry.upshift.redhat.com/fuse7/fuse-karaf-openshift:1.8"
   }
   },

4. 替换所有引用后，运行以下命令在 OpenShift 镜像流上安装 Fuse：

   oc create -f fis-image-streams.json -n {namespace}

流程

1. 在准备在 OpenShift 项目中构建和部署 Fuse 时，请按如下所示登录 OpenShift 服务器：

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

   其中，OPENSHIFT_IP_ADDR 是 OpenShift 服务器的 IP 地址的占位符，因为此 IP 地址并不总是相同。

   注意

   developer 用户（具有开发人员密码）是 CDK 在虚拟 OpenShift 服务器上自动创建的标准帐户。如果您要访问远程服务器，请使用 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-sb2-780019-redhat-00005
   
   oc create -n test -f ${BASEURL}/fis-image-streams.json

   命令输出显示 Fuse 在 OpenShift 项目的 Fuse 中。

4. 安装 Quickstart 模板。

   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 \
    karaf-camel-amq-template.json \
    karaf-camel-log-template.json \
    karaf-camel-rest-sql-template.json \
    karaf-cxf-rest-template.json ;
    do
    oc create -n test -f \
    ${BASEURL}/quickstarts/${template}
    done

5. 安装 Spring Boot 2 quickstart 模板：

   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-780019-redhat-00005/quickstarts/${template}
    done

6. 安装 Fuse 控制台的模板。

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

   注意

   有关部署 Fuse 控制台的详情，请参考在 OpenShift 中设置 Fuse 控制台。

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. 在 shell 提示符中，输入以下 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-780040-redhat-00002/archetypes-catalog-2.2.0.fuse-sb2-780040-redhat-00002-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=spring-boot-camel-xml-archetype \
     -DarchetypeVersion=2.2.0.fuse-sb2-780040-redhat-00002

   archetype 插件切换到交互模式，以提示您输入剩余的字段。

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse78-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: fuse78-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   出现提示时，为 groupId 值输入 org.example.fis，为 artifactId 值输入 fuse78-spring-boot。接受剩余的字段的默认值。

3. 如果上述命令以 BUILD SUCCESS 状态退出，则现在应在 fuse78-spring-boot 子目录下具有 OpenShift 项目的 Fuse。

4. 您现在已准备好构建和部署 fuse78-spring-boot 项目。假设您仍然登录 OpenShift，请更改到 fuse78-spring-boot 项目的目录，然后进行构建和部署项目，如下所示：

   cd fuse78-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. 或者将 camel.springboot.main-run-controller=true 添加到 application.properties 或 application.yml 文件中。

      您可以使用 camel.springboot unset 属性在 application.properties 或 application.yml 文件中自定义 Camel 应用程序。

4. 可选。要使用 bean 的 ID 名称来引用自定义 bean，请在 src/main/resources/application.properties （或 application.yml）文件中配置选项。以下示例显示了如何使用 bean ID 来引用自定义 bean。

   1. 请参阅 id myExtensionFactory 的自定义 bean。

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

   2. 然后，使用 Spring Boot @Bean 注释创建自定义 bean。

      @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. 在单元测试类中指定 include 或 exclude 模式，作为 @SpringBootTest 注解的属性，如下所示：

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

   在 FooTest 类中，include 模式为 **/Foo*，它代表 Ant 风格模式。此处的模式以双星号开头，与前导软件包名称匹配。/foo* 表示类名称必须以 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-7.8.0.fuse-sb2-780031-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.transaction-manager-id 属性)。当前的实现还限制了事务管理器 ID 的长度。请注意：

   • StatefulSet 的名称是事务系统的标识符，因此不得更改。
   • 您应该为 StatefulSet 命名，以便其所有 pod 名称长度都小于或等于 23 个字符。OpenShift 使用惯例创建 Pod 名称： <statefulset-name>-0, <statefulset-name>-1 等。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 工作流创建 Quickstart 项目。

   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-780040-redhat-00002/archetypes-catalog-2.2.0.fuse-sb2-780040-redhat-00002-archetype-catalog.xml \
   -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
   -DarchetypeArtifactId=spring-boot-camel-amq-archetype \
   -DarchetypeVersion=2.2.0.fuse-sb2-780040-redhat-00002

4. archetype 插件切换到交互模式，以提示您输入剩余的字段。

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse78-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: fuse78-spring-boot-camel-amq
   version: 1.0-SNAPSHOT
   package: org.example.fis
   Y: :Y

   出现提示时，为 groupId 值输入 org.example.fis，在 artifactId 值中输入 fuse78-spring-boot-camel-amq。接受剩余的字段的默认值。

5. 导航到 Quickstart 目录 fuse78-spring-boot-camel-amq。

   cd fuse78-spring-boot-camel-amq

6. 运行以下命令，将配置文件应用到 AMQ Online。这些配置文件创建 AMQ Online 用户和队列，两者均具有 admin 特权。

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

7. 运行 mvn 命令将快速启动部署到 OpenShift 服务器。

   mvn fabric8:deploy -Popenshift

8. 验证 Quickstart 是否已成功运行：

   1. 在浏览器中打开 OpenShift Web 控制台(https://OPENSHIFT_IP_ADDR，将 OPENSHIFT_IP_ADDR 替换为集群的 IP 地址)，并使用您的凭证（例如，使用用户名和密码 developer）登录到控制台。
   2. 在左侧面板中，展开 Home，然后单击 Status 以查看 openshift 项目的 Project Status 页面。
   3. 点 fuse78-spring-boot-camel-amq 查看快速启动的 Overview 信息页面。
   4. 在左侧面板中，展开 Workloads。
   5. 单击 Pods，然后单击 fuse78-spring-boot-camel-amq-xxxxx。此时会显示快速启动的 pod 详情。

   6. 点 Logs 查看应用程序的日志。

      输出显示消息成功发送。

      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. 要查看 Web 界面中的路由，请点 Open Java Console 并检查 AMQ 队列中的消息。

1. 从 secret 挂载递归读取
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-sb2-780040-redhat-00002/archetypes-catalog-2.2.0.fuse-sb2-780040-redhat-00002-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=karaf-camel-log-archetype \
     -DarchetypeVersion=2.2.0.fuse-sb2-780040-redhat-00002

3. archetype 插件切换到交互模式以提示您输入剩余的字段

   Define value for property 'groupId': : org.example.fis
   Define value for property 'artifactId': : fuse78-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: fuse78-karaf-camel-log
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

   出现提示时，为 groupId 值输入 org.example.fis，为 artifactId 值输入 fuse78-karaf-camel-log。接受剩余的字段的默认值。

4. 如果上述命令以 BUILD SUCCESS 状态退出，则现在应在 fuse78-karaf-camel-log 子目录下具有 OpenShift 项目的 Fuse。

5. 您现在已准备好构建和部署 fuse78-karaf-camel-log 项目。假设您仍然登录 OpenShift，请更改到 fuse78-karaf-camel-log 项目的目录，然后构建和部署项目，如下所示：

   cd fuse78-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 功能，并将 Kubernetes 就绪度和存活度探测自动添加到您的容器的配置中。

流程

1. 将 view 角色添加到 default 服务帐户以启用集群。这会授予用户对 default 服务帐户的 view 访问权限。每个项目都需要服务帐户来运行构建、部署和其他容器集。在 shell 提示符中输入以下 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 quickstart 运行 Red Hat Fuse 7.8 Camel CDI 所需的资源。它为快速启动创建部署配置和构建配置。有关快速启动和创建的资源的信息显示在终端上。

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

4. 在浏览器中打开 OpenShift Web 控制台(https://OPENSHIFT_IP_ADDR，将 OPENSHIFT_IP_ADDR 替换为集群的 IP 地址)，并使用您的凭证登录控制台（例如，使用用户名 developer 和密码 developer）。
5. 在左侧面板中，展开 Home。点 Status 查看 Project Status 页面。此时会显示所选命名空间中的所有现有应用程序（如 openshift）。

6. 单击 s2i-fuse78-eap-camel-cdi 以查看快速启动的 Overview 信息页面。

   

7. 单击 Resources 选项卡，然后单击 Routes 部分中显示的链接来访问应用程序。

   

   该链接的格式是 http://s2i-fuse78-eap-camel-cdi-OPENSHIFT_IP_ADDR。在您的浏览器中显示类似如下的信息：

   Hello world from 172.17.0.3

8. 您还可以使用 URL 中的 name 参数指定一个名称。例如，如果您在浏览器中输入 URL http://s2i-fuse78-eap-camel-cdi-openshift.apps.cluster-name.openshift.com/?name=jdoe，您会看到响应：

   Hello jdoe from 172.17.0.3

9. 单击 View Logs 以查看应用的日志。

10. 关闭正在运行的 pod，

    1. 单击 Overview 选项卡，以返回到应用的概览信息页面。
    2. 点 Desired Count 旁边的 图标。此时会显示 Edit Count 窗口。
    3. 使用向下箭头向下扩展到零，以停止 pod。

流程

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,1.7,1.8     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,1.7,1.8    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,1.7,1.8     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,1.7,1.8     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,1.7,1.8             About an hour ago
   apicurito-ui                   172.30.1.1:5000/openshift/apicurito-ui               1.2,1.3,1.4,1.5,1.6,1.7,1.8             About an hour ago

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

流程

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-sb2-780019-redhat-00005
   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/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

   注意