流程

1. 以管理员身份登录您的 OpenShift 集群：

   oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443

2. 打开您要在其中部署 Fuse 的项目：

   oc project myproject

3. 使用您的红帽客户门户网站帐户创建 docker-registry secret，将 PULL_SECRET_NAME 替换为 psi-internal-registry 来创建：

   oc create secret docker-registry psi-internal-registry \
     --docker-server=docker-registry.redhat.io \
     --docker-username=CUSTOMER_PORTAL_USERNAME \
     --docker-password=CUSTOMER_PORTAL_PASSWORD \
     --docker-email=EMAIL_ADDRESS

   您应该看到以下输出：

   secret/psi-internal-registry created

   重要

   您必须在要向 registry.redhat.io 进行身份验证的每个 OpenShift 项目命名空间中创建此 docker-registry secret。

4. 将机密链接到您的服务帐户，以使用机密拉取镜像。以下示例使用 default 服务帐户、构建器 服务帐户和 deployer 服务帐户：

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

   服务帐户名称必须与 OpenShift 容器集使用的名称匹配。

   注意

   如果您不想使用红帽用户名和密码来创建 pull secret，您可以使用 registry 服务帐户创建身份验证令牌。

流程

1. 启动 OpenShift 4 服务器。

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

   oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443

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 镜像流 Skipped Imagestreams 部分，并将 Fuse 和 Spring Boot 2 模板添加到 Skipped Templates 部分。

   [...]
   spec:
     architectures:
     - x86_64
     managementState: Managed
     skippedImagestreams:
     - fuse-console-rhel8
     - fuse-eap-openshift-jdk8-rhel7
     - fuse-eap-openshift-jdk11-rhel8
     - fuse-java-openshift-rhel8
     - fuse-java-openshift-jdk11-rhel8
     - fuse-karaf-openshift-rhel8
     - fuse-karaf-openshift-jdk11-rhel8
     - fuse-apicurito-generator-rhel8
     - fuse-apicurito-rhel8
     skippedTemplates:
     - s2i-fuse711-eap-camel-amq
     - s2i-fuse711-eap-camel-cdi
     - s2i-fuse711-eap-camel-cxf-jaxrs
     - s2i-fuse711-eap-camel-cxf-jaxws
     - s2i-fuse711-karaf-camel-amq
     - s2i-fuse711-karaf-camel-log
     - s2i-fuse711-karaf-camel-rest-sql
     - s2i-fuse711-karaf-cxf-rest
     - s2i-fuse711-spring-boot-2-camel-amq
     - s2i-fuse711-spring-boot-2-camel-config
     - s2i-fuse711-spring-boot-2-camel-drools
     - s2i-fuse711-spring-boot-2-camel-infinispan
     - s2i-fuse711-spring-boot-2-camel-rest-3scale
     - s2i-fuse711-spring-boot-2-camel-rest-sql
     - s2i-fuse711-spring-boot-2-camel
     - s2i-fuse711-spring-boot-2-camel-xa
     - s2i-fuse711-spring-boot-2-camel-xml
     - s2i-fuse711-spring-boot-2-cxf-jaxrs
     - s2i-fuse711-spring-boot-2-cxf-jaxws
     - s2i-fuse711-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse711-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-7_11_1-00016-redhat-00002
   
   oc create -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 \
    ${BASEURL}/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 \
    ${BASEURL}/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. 点 Red Hat Integration - API Designer 卡。Red Hat Integration - API Designer Operator 安装页面将打开。

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

   1. 对于 Update Channel，请选择 fuse-console-7.11.x。
   2. 对于 Installation 模式，从集群上的命名空间列表中选择命名空间（项目）。

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

      • 如果选择自动 更新，当 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 查看列表中的 Red Hat Integration - 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-7_11_1-00016-redhat-00002
   
   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 \
    ${BASEURL}/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 \
    ${BASEURL}/quickstarts/${template}
    done

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

   oc create -n openshift -f ${BASEURL}/fis-console-cluster-template.json
   oc create -n openshift -f ${BASEURL}/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. 登录到 registry.redhat.io。

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

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

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

4. 标记拉取的镜像流。

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

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

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

流程

1. 以管理员身份登录您的 OpenShift 集群：

   oc login --user system:admin --token=my-token --server=https://my-cluster.example.com:6443

2. 打开您要在其中部署 Fuse 的项目：

   oc project myproject

3. 使用您的红帽客户门户网站帐户创建 docker-registry secret，将 PULL_SECRET_NAME 替换为 psi-internal-registry 来创建：

   oc create secret docker-registry psi-internal-registry \
     --docker-server=docker-registry.redhat.io \
     --docker-username=CUSTOMER_PORTAL_USERNAME \
     --docker-password=CUSTOMER_PORTAL_PASSWORD \
     --docker-email=EMAIL_ADDRESS

   您应该看到以下输出：

   secret/psi-internal-registry created

   重要

   您必须在要向 registry.redhat.io 进行身份验证的每个 OpenShift 项目命名空间中创建此 docker-registry secret。

4. 将机密链接到您的服务帐户，以使用机密拉取镜像。以下示例使用 default 服务帐户、构建器 服务帐户和 deployer 服务帐户：

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

   服务帐户名称必须与 OpenShift 容器集使用的名称匹配。

   注意

   如果您不想使用红帽用户名和密码来创建 pull secret，您可以使用 registry 服务帐户创建身份验证令牌。

流程

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

   curl -o fis-image-streams.json https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/fis-image-streams.json

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

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

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

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

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-7_11_1-00016-redhat-00002
   
   oc create -n test -f ${BASEURL}/fis-image-streams.json

   命令输出显示了 OpenShift 项目上 Fuse 项目中现已提供的 Fuse 镜像流。

4. 安装 Quickstart 模板。

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002
   
   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 模板：

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002
   
   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 \
    ${BASEURL}/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. 使用您的凭据（例如，使用用户名 developer 和密码 developer）登录 OpenShift 控制台。

流程

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

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

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

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

3. 如果上述命令以 BUILD SUCCESS 状态退出，则现在您应当在 fuse711-spring-boot 子目录下在 OpenShift 项目中有一个新的 Fuse。

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

   cd fuse711-spring-boot
   mvn oc: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.* 属性在 application.properties 或 application. yml 文件中自定义 Camel 应用程序。

4. 可选。要使用 bean 的 ID 名称引用自定义 bean，请在 src/main/resources/application.properties （或 application.yml）文件中配置选项。以下示例显示了 xslt 组件如何使用 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/v1
   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.11.1.fuse-sb2-7_11_1-00022-redhat-00002 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 oc:deploy -Popenshift

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 表中找到消息的任何 trace。

流程

1. 以开发者身份登录到 OpenShift 服务器。

   oc login -u developer -p developer

2. 为快速入门创建一个新项目，例如：

   oc new-project quickstart

3. 使用 Maven archetype 检索 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-790047-redhat-00004/archetypes-catalog-2.2.0.fuse-sb2-790047-redhat-00004-archetype-catalog.xml -DarchetypeGroupId=org.jboss.fuse.fis.archetypes -DarchetypeArtifactId=spring-boot-camel-amq-archetype -DarchetypeVersion=2.2.0.fuse-sb2-790047-redhat-00004

4. 进入 Quickstart directory fuse711-spring-boot-camel-amq。

   cd fuse711-spring-boot-camel-amq

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

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

6. 为应用程序创建 ConfigMap，例如：

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: spring-boot-camel-amq-config
     namespace: quickstarts
   data:
     service.host: 'fuse-broker-amqps-0-svc'
     service.port.amqp: '5672'
     service.port.amqps: '5671'

7. 使用步骤 3 中的 ImageStream，运行 mvn 命令，将 quickstart 部署到 OpenShift 服务器：

   mvn oc:deploy -Popenshift -Djkube.generator.fromMode=istag -Djkube.generator.from=openshift/fuse-java-openshift:1.9

8. 验证快速启动是否已成功运行：

   1. 导航到浏览器中的 OpenShift Web 控制台（https://OPENSHIFT_IP_ADDR，将 OPENSHIFT_IP_ADDR 替换为集群的 IP 地址），并使用您的凭证（例如，使用用户名 developer 和密码 developer）登录控制台。
   2. 在左侧面板中，展开 Home，然后单击 Status 以查看 openshift 项目的 Project Status 页面。
   3. 单击 fuse711-spring-boot-camel-amq，以查看 Quickstart 的 Overview 信息页面。
   4. 在左侧侧面板中展开 Workloads。
   5. 单击 Pods，然后单击 fuse711-spring-boot-camel-amq-xxxxx。此时会显示 Quickstart 的 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-7_11_1-00018-redhat-00002/archetypes-catalog-2.2.0.fuse-sb2-7_11_1-00018-redhat-00002-archetype-catalog.xml \
     -DarchetypeGroupId=org.jboss.fuse.fis.archetypes \
     -DarchetypeArtifactId=karaf-camel-log-archetype \
     -DarchetypeVersion=2.2.0.fuse-sb2-7_11_1-00018-redhat-00002

3. archetype 插件切换到互动模式，提示您输入其余字段

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

   在提示时，输入 org.example.fis 作为 groupId 值，为 artifactId 值输入 fuse711-karaf-camel-log。接受其余字段的默认值。

4. 如果以上命令以 BUILD SUCCESS 状态退出，则现在您应该在 fuse711-karaf-camel-log 子目录中有一个新的 Fuse。

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

   cd fuse711-karaf-camel-log
   mvn oc:deploy -Popenshift

流程

1. 打开项目的 pom.xml，并在 boot Features 部分添加 fabric8-karaf-checks 功能。

   pom.xml

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

   oc:resources 目标将检测您使用 fabric8-karaf-checks 功能，并将 Kubernetes 用于就绪度和存活度探测来添加到容器的配置中。

流程

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

   oc new-app s2i-fuse7-eap-camel-cdi
   
   --> Creating resources ...
       service "s2i-fuse7-eap-camel-cdi" created
       service "s2i-fuse7-eap-camel-cdi-ping" created
       route.route.openshift.io "s2i-fuse7-eap-camel-cdi" created
       imagestream.image.openshift.io "s2i-fuse7-eap-camel-cdi" created
       buildconfig.build.openshift.io "s2i-fuse7-eap-camel-cdi" created
       deploymentconfig.apps.openshift.io "s2i-fuse7-eap-camel-cdi" created
   --> Success
       Access your application via route 's2i-fuse7-eap-camel-cdi-OPENSHIFT_IP_ADDR'
       Build scheduled, use 'oc logs -f bc/s2i-fuse7-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-fuse7-eap-camel-cdi 以查看 Quickstart 的 Overview 信息页面。

   

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

   

   该链接的格式为 http://s2i-fuse7-eap-camel-cdi-OPENSHIFT_IP_ADDR。这在浏览器中显示如下信息：

   Hello world from 172.17.0.3

8. 您还可以使用 URL 中的 name 参数指定名称。例如，如果您输入 URL http://s2i-fuse7-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. 使用以下示例配置创建名为 pv.yaml 的配置文件。这会在主机上置备一个路径，作为名为 pv001 的 PersistentVolume。

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

   这里的主机路径为 /data/pv0001，存储容量限制为 2MB。例如，在使用 OpenShift CDK 时，它将从托管 OpenShift 集群的虚拟机中置备目录 /data/pv0001。

2. 创建 PersistentVolume。

   oc create -f pv.yaml

3. 验证 PersistentVolume 的创建。这将列出 OpenShift 集群中配置的所有 PersistentVolume ：

   oc get pv

流程

1. 如下所示，创建示例容器配置，它将 PersistentVolumeClaim pvc0001 挂载到它的文件系统的 /usr/share/data 处。

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

   现在，应用程序写入的目录 /usr/share/data 的任何数据都会在容器重启后保留。

2. 将此配置添加到 OpenShift 应用的 Fuse 中的 src/main/jkube/deployment.yml 文件中，并使用以下命令创建 OpenShift 资源：

   mvn oc:resource-apply

3. 验证创建的 DeploymentConfiguration 是否有卷挂载和卷。

   oc describe deploymentconfig <application-dc-name>

   对于 OpenShift Quickstart 上的 Fuse，将 & lt;application-dc-name > 替换为 Maven 项目名称，如 spring-boot-camel。

流程

1. OpenShift 镜像流上的 Fuse 通常安装在 OpenShift 服务器上的 openshift 项目中。要在 OpenShift 上检查 OpenShift 镜像中的 Fuse 状态，以管理员身份登录到 OpenShift，然后输入以下命令：

   $ oc get is -n openshift
   NAME                           DOCKER REPO                                          TAGS                                    	UPDATED
   fuse-console-rhel8               172.30.1.1:5000/openshift/fuse7/fuse-console-rhel8              1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse7-eap-openshift-jdk8-rhel7   172.30.1.1:5000/openshift/fuse7/fuse-eap-openshift-jdk8-rhel7        1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse7-eap-openshift-jdk11-rhel8  172.30.1.1:5000/openshift/fuse7/fuse-eap-openshift-jdk11-rhel8        1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse7-java-openshift-rhel8       172.30.1.1:5000/openshift/fuse7/fuse-java-openshift-rhel8       1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse7-java-openshift-jdk11-rhel8 172.30.1.1:5000/openshift/fuse7/fuse-java-openshift-jdk11-rhel8       1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse7-karaf-openshift-rhel8      172.30.1.1:5000/openshift/fuse7/fuse-karaf-openshift-rhel8      1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   fuse-apicurito-generator-rhel8   172.30.1.1:5000/openshift/fuse7/fuse-apicurito-generator-rhel8   1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago
   apicurito-ui-rhel8               172.30.1.1:5000/openshift/fuse7/apicurito-ui-rhel8               1.5,1.6,1.7,1.8,1.9,1.10,1.11    About an hour ago

2. 现在，您可以一次更新每个镜像流：

   oc import-image -n openshift fuse7/fuse7-java-openshift-rhel8:1.11
   oc import-image -n openshift fuse7/fuse7-java-openshift-jdk11-rhel8:1.11
   oc import-image -n openshift fuse7/fuse7-karaf-openshift-rhel8:1.11
   oc import-image -n openshift fuse7/fuse7-eap-openshift-jdk8-rhel7:1.11
   oc import-image -n openshift fuse7/fuse7-eap-openshift--jdk11-rhel8:1.11
   oc import-image -n openshift fuse7/fuse7-console-rhel8:1.11
   oc import-image -n openshift fuse7/apicurito-ui-rhel8:1.11
   oc import-image -n openshift fuse7/fuse-apicurito-generator-rhel8:1.11

流程

1. 您需要管理员特权来更新 OpenShift 模板上的 Fuse。以管理员身份登录到 OpenShift 服务器，如下所示：

   oc login URL -u ADMIN_USER -p ADMIN_PASS

   其中 URL 是 OpenShift 服务器和 ADMIN_USER 的 URL，ADMIN_PASS 是 OpenShift 服务器上管理员帐户的凭据。

2. 在 OpenShift 模板上安装补丁的 Fuse。在命令提示符下输入以下命令：

   BASEURL=https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002
   
   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

   注意

   BASEURL 指向 Git 存储库的 GA 分支，用于存储 Quickstart 模板。它始终具有 HEAD 的最新模板。因此，每次运行前面的命令时，都将获得模板的最新版本。

1. 删除 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 delete -n openshift -f \
    ${BASEURL}/quickstarts/${template}
    done

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

3. 删除镜像流。

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

4. 删除 Samples Operator 中的项目。

   编辑 Samples Operator 的配置：

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

5. 从 skippedImagestreams 和 skippedTemplates 部分删除 Fuse 和 Spring Boot 2 模板。