开始使用

流程

1. 进入 https://developers.redhat.com/launch。

2. 单击 START。

   启动程序向导会提示您登录到您的红帽帐户。

3. 单击 登录或注册 按钮，然后登录。
4. 在 Launcher 页面上，单击 Deploy an Example Application 按钮。
5. 在 Create Example Application 页面上，在 Create Example Application 字段中输入 name fuse-circuit-breaker。
6. 点 Select an Example。

7. 在 Example 对话框中，选择 Circuit Breaker 选项。此时会出现 选择运行时 下拉菜单。

   1. 从 Select a Runtime 下拉菜单中选择 Fuse。
   2. 从版本下拉菜单中，选择 7.8 (Red Hat Fuse) （不要选择 2.21.2 (Community) 版本。
   3. 点 Save。
8. 在 Create Example Application 页面中，点 Download。
9. 当您看到您的应用程序 是 Ready 对话框时，点 Download.zip。您的浏览器下载生成的 booster 项目（打包为 ZIP 文件）。
10. 使用存档实用程序将生成的项目提取到本地文件系统中的方便位置。

流程

1. 打开 shell 提示符并使用 Maven 从命令行构建项目：

   cd fuse-circuit-breaker

   mvn clean package

   Maven 构建项目后，它会显示 Build Success 消息。

2. 打开一个新的 shell 提示符并启动名称服务，如下所示：

   cd name-service

   mvn spring-boot:run -DskipTests -Dserver.port=8081

   当 Spring Boot 启动时，您应该看到类似如下的输出：

   ...
   2019-05-06 20:19:59.401  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Route: route1 started and consuming from: servlet:/name?httpMethodRestrict=GET
   2019-05-06 20:19:59.402  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Total 1 routes, of which 1 are started
   2019-05-06 20:19:59.403  INFO 9553 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.21.0.fuse-730078-redhat-00001 (CamelContext: camel-1) started in 0.287 seconds
   2019-05-06 20:19:59.406  INFO 9553 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
   2019-05-06 20:19:59.473  INFO 9553 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8081 (http)
   2019-05-06 20:19:59.479  INFO 9553 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 5.485 seconds (JVM running for 9.841)

3. 打开一个新的 shell 提示符并启动问候服务，如下所示：

   cd greetings-service

   mvn spring-boot:run -DskipTests

   当 Spring Boot 启动时，您应该看到类似如下的输出：

   ...
   2019-05-06 20:22:19.051  INFO 9729 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
   2019-05-06 20:22:19.115  INFO 9729 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8080 (http)
   2019-05-06 20:22:19.123  INFO 9729 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 7.68 seconds (JVM running for 12.66)

   greetings 服务通过 http://localhost:8080/camel/greetings URL 公开 REST 端点。

4. 通过在 web 浏览器中打开 URL 或打开另一个 shell 提示符并输入以下 curl 命令来调用 REST 端点：

   curl http://localhost:8080/camel/greetings

   以下是响应：

   {"greetings":"Hello, Jacopo"}

5. 要演示 Camel Hystrix 提供的断路器功能，请在名称服务的 shell 提示符窗口中键入 Ctrl-C 来终止后端名称服务。

   现在，名称服务不可用，断路器在 中启动，以防止在调用时问候服务挂起。

6. 在网页浏览器中打开 http://localhost:8080/camel/greetings，或者在另一个 shell 提示符窗口中输入以下 curl 命令来调用问候 REST 端点：

   curl http://localhost:8080/camel/greetings

   以下是响应：

   {"greetings":"Hello, default fallback"}

   在运行 greetings 服务的窗口中，日志会显示以下信息序列：

   2019-05-06 20:24:16.952  INFO 9729 --- [-CamelHystrix-2] route2                                   :  Try to call name Service
   2019-05-06 20:24:16.956  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.956  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
   2019-05-06 20:24:16.957  INFO 9729 --- [-CamelHystrix-2] o.a.c.httpclient.HttpMethodDirector      : Retrying request
   2019-05-06 20:24:16.964  INFO 9729 --- [-CamelHystrix-2] route2                                   :  We are falling back!!!!

7. 有关此示例的更多信息，请打开 Circuit Breaker - Red Hat Fuse 页面，地址为 http://localhost:8080/ （同时 问候服务正在运行 ）。此页面包含一个到监控断路器状态的 Hystrix 仪表板的链接。

流程

1. 将 Apache Karaf 上 Fuse 下载的 .zip 归档文件解压缩到您的文件系统中 FUSE_INSTALL 的便捷位置。

2. 将管理员用户添加到 Fuse 运行时。

   1. 在文本编辑器中打开 FUSE_INSTALL/etc/users.properties 文件。
   2. 删除以 # admin = admin 开头的行开头的 # 字符。
   3. 删除以 # _g_\:admingroup 开头的行开头的 # 字符。

   4. 自定义用户条目的用户名、USERNAME 和密码 PASSWORD，以便您有一个用户条目和 admin 组条目，如下所示（连续行）：

      USERNAME = PASSWORD,_g_:admingroup
      _g_\:admingroup = group,admin,manager,viewer,systembundles,ssh

   5. 保存 etc/users.properties 文件。

3. 运行 CodeReady Studio 安装程序，如下所示：

   java -jar DOWNLOAD_LOCATION/codereadystudio-12.16.0.GA-installer-standalone.jar

4. 在安装过程中：

   1. 接受条款和条件。
   2. 选择您首选的安装路径。
   3. 选择 Java 8 JVM。
   4. 在 Select Platforms and Servers 步骤中，通过单击 Add 并浏览到 FUSE_INSTALL 目录的位置，配置 FUSE 运行时上的 Fuse。
   5. 在 Select Additional Features to Install 步骤中，选择 Red Hat Fuse Tooling。
5. CodeReady Studio 启动。出现 Searching for runtime 对话框时，单击 OK 以在 Karaf 运行时上创建 Fuse。

6. （可选） 为了从命令行使用 Apache Maven，您需要安装和配置 Maven。

   注意

   如果您只使用 CodeReady Studio，则不需要安装 Maven，因为 CodeReady Studio 已为您预安装并配置了 Maven。但是，如果您计划从命令行调用 Maven，则需要执行此步骤。

流程

1. 在 CodeReady Studio 中，创建一个新项目，如下所示：

   1. 选择 File→New→Fuse Integration Project。
   2. 在 Project Name 字段中输入 fuse-camel-cbr。
   3. 点击 Next。

   4. 在 Select a Target Environment 窗格中选择以下设置：

      • 选择 Standalone 作为部署平台。
      • 选择 Karaf 上的 Karaf/Fuse 作为运行时环境，并使用 Runtime （可选） 下拉菜单选择 fuse-karaf-7.8.0.fuse-780038-redhat-00001 Runtime 服务器作为目标运行时。
   5. 选择目标运行时后，会自动为您选择 Camel Version，字段将灰掉。
   6. 点击 Next。
   7. 在 Advanced Project Setup 窗格中，选择 Beginner→Content Based Router - Blueprint DSL 模板。
   8. 点 Finish。
   9. 如果系统提示您打开关联的 Fuse 集成透视图，请单击 Yes。

   10. 等待 CodeReady Studio 下载所需的工件，并在后台构建项目。

       重要

       如果您在 CodeReady Studio 中首次构建 Fuse 项目时，向导将 需要几分钟才能完成生成项目，因为它会从远程 Maven 存储库下载依赖项。在项目在后台构建时，请勿尝试中断向导或关闭 CodeReady Studio。

2. 将项目部署到服务器，如下所示：

   1. 在 Servers 视图(Fuse Integration 视角的左下角)中，如果服务器尚未启动，请选择 fuse-karaf-7.8.0.fuse-780038-redhat-00001 Runtime Server 服务器，然后单击绿色箭头来启动它。

      注意

      如果您看到对话框，警告：无法建立主机"localhost"的真实性。 单击 Yes 以连接到服务器并访问 Karaf 控制台。

   2. 等待 Console 视图中看到类似如下的消息：

      Karaf started in 1s. Bundle stats: 12 active, 12 total

   3. 服务器启动后，切回到 Servers 视图，右键单击服务器，然后从上下文菜单中选择 Add and Remove。
   4. 在 Add and Remove 对话框中，选择 fuse-camel-cbr 项目，然后点击 Add > 按钮。
   5. 点 Finish。

   6. 您可以通过进入 Terminal 视图并输入 bundle:list | tail 来检查项目的 OSGi 捆绑包是否已启动。您应该看到类似如下的输出：

      ...
      228 │ Active │  80 │ 1.0.0.201505202023          │ org.osgi:org.osgi.service.j
      232 │ Active │  80 │ 1.0.0.SNAPSHOT              │ Fuse CBR Quickstart

      注意

      Camel 路由启动后，它将在您的 Fuse 安装(不在 fuse-camel-cbr 项目中)创建一个目录 work/cbr/input。

3. 将项目的 src/main/data 目录中找到的文件复制到 FUSE_INSTALL/work/cbr/input 目录中。您可以在系统文件浏览器中（在 Eclipse 之外）执行此操作。

4. 稍等片刻，然后在 FUSE_INSTALL/work/cbr/output 目录中查看由国家组织的相同文件：

   1. work/cbr/output/others中的 order1.xml
   2. work/cbr/output/uk中的 order2.xml 和 order4.xml
   3. order3.xml 和 order5.xml in work/cbr/output/us

5. 取消部署项目，如下所示：

   1. 在 Servers 视图中，选择 Red Hat Fuse 7+ Runtime Server 服务器。
   2. 右键单击服务器，然后从上下文菜单中选择 Add and Remove。
   3. 在 Add and Remove 对话框中，选择 fuse-camel-cbr 项目，再单击 &lt ; Remove 按钮。
   4. 点 Finish。

流程

1. 从 shell 提示符运行 JBoss EAP 安装程序，如下所示：

   java -jar DOWNLOAD_LOCATION/jboss-eap-7.3.0-installer.jar

2. 在安装过程中：

   1. 接受条款和条件。
   2. 为 JBoss EAP 运行时选择您首选的安装路径 EAP_INSTALL。
   3. 创建管理用户，并小心记录这些管理用户凭证。
   4. 您可以在剩余的屏幕上接受默认设置。
3. 打开 shell 提示符，并将目录更改为 EAP_INSTALL。

4. 在 EAP_INSTALL 目录中，应用 JBoss EAP 7.3 Update 02。例如：

   bin/jboss-cli.sh "patch apply jboss-eap-7.3.x-patch.zip"

5. 在 EAP_INSTALL 目录中，在 EAP 安装程序上运行 Fuse，如下所示：

   java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.8.0.jar

6. 运行 CodeReady Studio 安装程序，如下所示：

   java -jar DOWNLOAD_LOCATION/codereadystudio-12.16.0.GA-installer-standalone.jar

7. 在安装过程中：

   1. 接受条款和条件。
   2. 选择您首选的安装路径。
   3. 选择 Java 8 JVM。
   4. 在 Select Platforms and Servers 步骤中，单击 Add 并浏览到 EAP_INSTALL 目录的位置来配置 JBoss EAP 运行时。
   5. 在 Select Additional Features to Install 步骤中，选择 Red Hat Fuse Tooling。
8. CodeReady Studio 启动。出现 搜索运行时 对话框时，单击 OK 以创建 JBoss EAP 运行时。

9. （可选） 为了从命令行使用 Apache Maven，您需要安装和配置 Maven。

   注意

   如果您只使用 CodeReady Studio，则不需要安装 Maven，因为 CodeReady Studio 已预安装并配置了 Maven。但是，如果您计划从命令行调用 Maven，则必须执行此步骤。

流程

1. 在 CodeReady Studio 中，创建一个新项目，如下所示：

   1. 选择 File→New→Fuse Integration Project。
   2. 在 Project Name 字段中，输入 eap-camel。
   3. 点击 Next。

   4. 在 Select a Target Environment 窗格中选择以下设置：

      • 选择 Standalone 作为部署平台。
      • 选择 EAP 上的 Wildfly/Fuse 作为运行时环境，并使用 Runtime （可选） 下拉菜单选择 JBoss EAP 7.x Runtime 服务器作为目标运行时。
   5. 选择目标运行时后，会自动为您选择 Camel Version，字段将灰掉。
   6. 点击 Next。
   7. 在 Advanced Project Setup 窗格中，选择 Spring Bean - Spring DSL 模板。

   8. 点 Finish。

      重要

      如果您在 CodeReady Studio 中首次构建 Fuse 项目时，向导将 需要几分钟时间才能完成生成项目。这是因为它从远程 Maven 存储库下载依赖项。在项目在后台构建时，不要中断向导或关闭 CodeReady Studio。

   9. 如果系统提示您打开关联的 Fuse 集成透视图，请单击 Yes。
   10. 等待 CodeReady Studio 下载所需的工件，并在后台构建项目。

2. 将项目部署到服务器，如下所示：

   1. 在 Servers 视图(Fuse Integration 视角的左下角)中，如果服务器尚未启动，请选择 Red Hat JBoss EAP 7.3 Runtime 服务器，然后单击绿色箭头以启动它。

   2. 等待 Console 视图中看到类似如下的消息：

      14:47:07,283 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.3.2.GA (WildFly Core 10.1.11.Final-redhat-00001) started in 3301ms - Started 314 of 576 services (369 services are lazy, passive or on-demand)

   3. 服务器启动后，切回到 Servers 视图，右键单击服务器，然后从上下文菜单中选择 Add and Remove。
   4. 在 Add and Remove 对话框中，选择 eap-camel 项目并点 Add >。
   5. 点 Finish。

3. 验证项目是否正常工作，如下所示：

   1. 浏览到以下 URL 以访问 eap-camel 项目中运行的服务： http://localhost:8080/camel-test-spring?name=Kermit
   2. 浏览器窗口应当显示响应 Hello Kermit。

4. 取消部署项目，如下所示：

   1. 在 Servers 视图中，选择 Red Hat JBoss EAP 7.3 Runtime 服务器。
   2. 右键单击服务器，然后从上下文菜单中选择 Add and Remove。
   3. 在 Add and Remove 对话框中，选择 eap-camel 项目，再点 < Remove。
   4. 点 Finish。

流程

1. 从 Maven 下载页面 下载最新版本的 Maven。

2. 确定您的系统已连接到互联网。

   在构建项目时，默认行为是 Maven 搜索外部存储库并下载所需的工件。Maven 查找可通过互联网访问的存储库。

   您可以更改此行为，以便 Maven 仅搜索位于本地网络上的存储库。也就是说，Maven 可以在离线模式下运行。在离线模式中，Maven 会在其本地存储库中查找工件。请参阅 第 4.3 节 “使用本地 Maven 存储库”。

流程

1. 在包含 pom.xml 文件的项目目录中，运行以下命令来下载 Maven 项目的存储库，如下所示：

   mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-project

   在本例中，构建项目所需的 Maven 依赖项和插件将下载到 /tmp/my-project 目录中。

2. 将此自定义 Maven 离线存储库在内部分发到没有互联网连接的任何机器。