流程

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

   注意

   您需要在镜像流所在的每个命名空间以及使用 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-fuse77-eap-camel-amq
     - s2i-fuse77-eap-camel-cdi
     - s2i-fuse77-eap-camel-cxf-jaxrs
     - s2i-fuse77-eap-camel-cxf-jaxws
     - s2i-fuse77-eap-camel-jpa
     - s2i-fuse77-karaf-camel-amq
     - s2i-fuse77-karaf-camel-log
     - s2i-fuse77-karaf-camel-rest-sql
     - s2i-fuse77-karaf-cxf-rest
     - s2i-fuse77-spring-boot-camel
     - s2i-fuse77-spring-boot-camel-amq
     - s2i-fuse77-spring-boot-camel-config
     - s2i-fuse77-spring-boot-camel-drools
     - s2i-fuse77-spring-boot-camel-infinispan
     - s2i-fuse77-spring-boot-camel-rest-sql
     - s2i-fuse77-spring-boot-camel-rest-3scale
     - s2i-fuse77-spring-boot-camel-xa
     - s2i-fuse77-spring-boot-camel-xml
     - s2i-fuse77-spring-boot-cxf-jaxrs
     - s2i-fuse77-spring-boot-2-camel-amq
     - s2i-fuse77-spring-boot-2-camel-config
     - s2i-fuse77-spring-boot-2-camel-drools
     - s2i-fuse77-spring-boot-2-camel-infinispan
     - s2i-fuse77-spring-boot-2-camel-rest-3scale
     - s2i-fuse77-spring-boot-2-camel-rest-sql
     - s2i-fuse77-spring-boot-2-camel
     - s2i-fuse77-spring-boot-2-camel-xa
     - s2i-fuse77-spring-boot-2-camel-xml
     - s2i-fuse77-spring-boot-2-cxf-jaxrs
     - s2i-fuse77-spring-boot-2-cxf-jaxws
     - s2i-fuse77-spring-boot-2-cxf-jaxrs-xml
     - s2i-fuse77-spring-boot-2-cxf-jaxws-xml

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

   BASEURL=https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002/
   
   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 快速启动模板上安装 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://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//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-7_11_1-00016-redhat-00002/quickstarts/${template}
    done

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

    oc get template -n openshift

流程

1. 启动 OpenShift 4.x 服务器。
2. 在 Web 浏览器中，导航到浏览器中的 OpenShift 控制台。使用您的凭证登录到控制台。
3. 点 Catalog，然后点 OperatorHub。

4. 在搜索字段中，键入 API Designer。

   您可以在右侧面板中看到 API Designer 卡。

5. 点 API Designer。此时会出现 API Designer operator 安装窗口。

6. 点 Install。Create Operator Subscription 表单将打开。

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

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

      • 如果选择 Automatic 更新，当 API Designer 操作器有新版本可用时，OpenShift Operator Lifecycle Manager (OLM)会自动升级 API Designer 的运行实例，而无需人为干预。
      • 如果选择手动 更新，则当有新版 Operator 可用时，OLM 会创建更新请求。作为集群管理员，您必须手动批准该更新请求，才能将 API Designer Operator 更新至新版本。
7. 点 Subscribe 使 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://github.com/jboss-fuse/application-templates/blob/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 \
    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://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//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-7_11_1-00016-redhat-00002/quickstarts/${template}
    done

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

   oc create -n openshift -f https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//fis-console-cluster-template.json
   oc create -n openshift -f https://github.com/jboss-fuse/application-templates/blob/application-templates-2.1.0.fuse-sb2-7_11_1-00016-redhat-00002//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.7
   docker pull registry.redhat.io/fuse7/fuse-karaf-openshift:1.7
   docker pull registry.redhat.io/fuse7/fuse7-fuse-console:1.7
   docker pull registry.redhat.io/fuse7/fuse7-fuse-apicurito:1.7
   docker pull registry.redhat.io/fuse7/fuse7-fuse-apicurito-generator:1.7

4. 标记拉取的镜像流。

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

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

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

流程

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. 下载 Red Hat Fuse on OpenShift imagestream json 文件。

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

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

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

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

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

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 Server 上自动创建的标准帐户。如果您要访问远程服务器，请使用 OpenShift 管理员提供的 URL 和凭据。

2. 创建名为 test 的新项目命名空间（假设它尚不存在）。

   oc new-project test

   如果 test 项目命名空间已存在，请切换到它。

   oc project test

3. 在 OpenShift 镜像流上安装 Fuse：

   BASEURL=https://github.com/jboss-fuse/application-templates/blob/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 镜像流。

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 \
    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 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-7_11_1-00016-redhat-00002/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 项目。

   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': : fuse77-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: fuse77-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

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

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

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

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

流程

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': : fuse77-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: fuse77-spring-boot
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

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

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

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

   cd fuse77-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 mdadm 属性自定义 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/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.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. 安装依赖项。

   • 使用用户名 username 和密码 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-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-amq-archetype \
   -DarchetypeVersion=2.2.0.fuse-sb2-7_11_1-00018-redhat-00002

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

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

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

5. 导航到 quickstart 目录 fuse77-spring-boot-camel-amq。

   cd fuse77-spring-boot-camel-amq

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

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

7. 运行 mvn 命令，将 Quickstart 部署到 OpenShift 服务器。

   mvn fabric8:deploy -Popenshift

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

   1. 导航到浏览器中的 OpenShift Web 控制台(https://OPENSHIFT_IP_ADDR，将 OPENSHIFT_IP_ADDR 替换为集群的 IP 地址)，并使用您的凭证（例如，使用用户名 developer 和密码 developer）登录控制台。
   2. 在左侧面板中，展开 Home，然后单击 Status 以查看 openshift 项目的 Project Status 页面。
   3. 点 fuse77-spring-boot-camel-amq 查看 Quickstart 的 Overview 信息页面。
   4. 在左侧面板中，展开 Workloads。
   5. 单击 Pods，然后单击 fuse77-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': : fuse77-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: fuse77-karaf-camel-log
   version: 1.0-SNAPSHOT
   package: org.example.fis
    Y: : Y

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

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

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

   cd fuse77-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 client 命令：

   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.7 Camel CDI 所需的资源。它为快速入门创建部署配置和构建配置。终端会显示有关 Quickstart 和创建的资源的信息。

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

   

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

   

   链接的格式为 http://s2i-fuse77-eap-camel-cdi-OPENSHIFT_IP_ADDR。在浏览器中显示类似如下的消息：

   Hello world from 172.17.0.3

8. 您还可以使用 URL 中的 name 参数指定名称。例如，如果您在浏览器中输入 URL http://s2i-fuse77-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. 使用向下箭头缩减至零以停止容器集。

流程

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/fabric8/deployment.yml 文件中添加此配置，并使用以下命令创建 OpenShift 资源：

   mvn fabric8:resource-apply

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

   oc describe deploymentconfig <application-dc-name>

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

流程

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

   $ 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     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    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     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     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             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             About an hour ago

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

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

流程

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://github.com/jboss-fuse/application-templates/blob/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/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

   注意

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