Spring Boot へのデプロイ

手順

1. https://developers.redhat.com/launch に移動します。

2. START をクリックします。

   ランチャーウィザードによって、Red Hat アカウントにログインするよう要求されます。

3. Log in or register ボタンをクリックし、ログインします。
4. Launcher ページで Deploy an Example Application ボタンをクリックします。
5. Create Example Application ページで Create Example Application as フィールドに名前 fuse-circuit-breaker を入力します。
6. Select an Example をクリックします。

7. Example ダイアログで、Circuit Breaker オプションを選択します。Select a Runtime ドロップダウンメニューが表示されます。

   1. Select a Runtime ドロップダウンメニューで Fuse を選択します。
   2. バージョンのドロップダウンメニューで 7.7 (Red Hat Fuse) を選択します。2.21.2 (Community) バージョンは選択しないでください。
   3. Save をクリックします。
8. Create Example Application ページで Download をクリックします。
9. Your Application is Ready ダイアログが表示されたら、Download.zip をクリックします。ブラウザーが生成されたブースタープロジェクト (ZIP ファイルとしてパッケージ) をダウンロードします。
10. アーカイブユーティリティーを使用して、生成されたプロジェクトをローカルファイルシステムの任意の場所にデプロイメントします。

1. シェルプロンプトを開き、Maven を使用してコマンドラインからプロジェクトをビルドします。

   cd PROJECT_DIR
   mvn clean package

   Copy to Clipboard Toggle word wrap

2. 新しいシェルプロンプトを開き、以下のように name サービスを起動します。

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

   Copy to Clipboard Toggle word wrap

   Spring Boot が起動すると、以下のような出力が表示されます。

   ...
   2017-12-08 15:44:24.223  INFO 22758 --- [           main] o.a.camel.spring.SpringCamelContext      : Total 1 routes, of which 1 are started
   2017-12-08 15:44:24.227  INFO 22758 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.20.0 (CamelContext: camel-1) started in 0.776 seconds
   2017-12-08 15:44:24.234  INFO 22758 --- [           main] org.jboss.fuse.boosters.cb.Application   : Started Application in 4.137 seconds (JVM running for 4.744)

   Copy to Clipboard Toggle word wrap

3. 新しいシェルプロンプトを開き、以下のように greetings サービスを起動します。

   cd greetings-service
   mvn spring-boot:run -DskipTests

   Copy to Clipboard Toggle word wrap

   Spring Boot が起動すると、以下のような出力が表示されます。

   ...
   2017-12-08 15:46:58.521  INFO 22887 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
   2017-12-08 15:46:58.524  INFO 22887 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
   2017-12-08 15:46:58.536  INFO 22887 --- [           main] org.jboss.fuse.boosters.cb.Application   : Started Application in 6.263 seconds (JVM running for 6.819)

   Copy to Clipboard Toggle word wrap

   greetings サービスは、URL http://localhost:8080/camel/greetings で REST エンドポイントを公開します。

4. http://localhost:8080 にアクセスします。

   このページを開くと、Greeting Service が呼び出されます。

   

   View larger image

   

   このページには、サーキットブレーカーの状態を監視する Hystrix ダッシュボードへのリンクも提供されます。

   

   View larger image

   

5. Camel Hystrix によって提供されるサーキットブレーカー機能を実証するには、name サービスが実行されているシェルプロンプトウインドウで Ctrl+C を押して、バックエンド name サービスを中止します。

   これで name サービスが利用できなくなるため、呼び出されたときに greetings サービスがハングしないよう、サーキットブレーカーが作動します。

6. Hystrix Monitor ダッシュボードおよび Greeting Service の出力で変更を確認します。

   

   View larger image

   

1. プロジェクトをダウンロードし、ローカルファイルシステムでアーカイブをデプロイメントします。

2. プロジェクトをビルドします。

   cd PROJECT_DIR
   mvn clean package

   Copy to Clipboard Toggle word wrap

3. サービスを実行します。

   mvn spring-boot:run

   Copy to Clipboard Toggle word wrap

4. Web ブラウザーで http://localhost:8080 を開きます。このページは、5 秒ごとに Greeting Service を呼び出します。Greetings サービスは、target/classes/application.properties ファイルから booster.nameToGreetvalue を使用して応答します。

   Greeting Service は default へのグリーティングを 5 秒ごとに出力します。

   

   View larger image

   

5. booster.nameToGreet の値を変更します。

   1. エディターで target/classes/application.properties ファイルを開きます。

   2. booster.nameToGreetvalue の値を、default から他の値 (例: Thomas) に変更します。

      booster.nameToGreetvalue=Thomas

      Copy to Clipboard Toggle word wrap
6. ターミナルウィンドウで CTRL+C を押してサービスを停止します。

7. サービスを再実行します。

   mvn spring-boot:run

   Copy to Clipboard Toggle word wrap

8. Web ブラウザーで http://localhost:8080 ページに戻り、Greeting Service の Results ウィンドウで変更された値を確認します。

   

   View larger image

   

1. プロジェクトをダウンロードし、ローカルファイルシステムでアーカイブをデプロイメントします。

2. プロジェクトをビルドします。

   cd PROJECT_DIR
   mvn clean package

   Copy to Clipboard Toggle word wrap

3. サービスを実行します。

   mvn spring-boot:run

   Copy to Clipboard Toggle word wrap
4. Web ブラウザーで http://localhost:8080 を開きます。

5. HTTP GET リクエストの例を実行するには、camel/greetings/{name} ボタンをクリックします。

   localhost:8080/camel/greetings/Jacopo URL で新しい Web ブラウザーウインドウが開きます。URL {name} パラメーターのデフォルト値は Jacopo です。

   ブラウザーウインドウに JSON 応答が表示されます。

   

   View larger image

   

6. {name} パラメーターの値を変更するには、URL を変更します。たとえば、名前を Thomas に変更するには、URL localhost:8080/camel/greetings/Thomas を使用します。

   ブラウザーウインドウに更新された JSON 応答が表示されます。

   

   View larger image

   

7. REST API の Swagger ページを表示するには、API Swagger ページボタンをクリックします。

   ブラウザーウィンドウに API swagger ページが表示されます。

   

   View larger image

   

手順

1. 以下の依存関係を Spring Boot の pom.xml に追加します。

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

   Copy to Clipboard Toggle word wrap

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");
       }
   }

   Copy to Clipboard Toggle word wrap

3. 任意手順:Camel の稼働を維持するためにメインスレッドがブロックされた状態を維持するには、以下の 1 つを行います。

   1. spring-boot-starter-web 関係が含まれるようにします。

   2. または、camel.springboot.main-run-controller=true を application.properties または application.yml ファイルに追加します。

      application.properties または application.yml ファイルで camel.springboot.* properties を使用すると Camel アプリケーションをカスタマイズできます。

4. 任意手順:Bean の ID 名を使用してカスタム Bean を参照するには、src/main/resources/application.properties または application.yml ファイルのオプションを設定します。以下の例は、Bean ID を使用して xslt コンポーネントがカスタム Bean を参照する方法を示しています。

   1. ID myExtensionFactory でカスタム Bean を参照します。

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

      Copy to Clipboard Toggle word wrap

   2. 次に、Spring Boot の @Bean アノテーションを使用してカスタム Bean を作成します。

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

      Copy to Clipboard Toggle word wrap

      または、Jackson ObjectMapper の場合は、camel-jackson データ形式を以下のようにします。

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

      Copy to Clipboard Toggle word wrap

手順

1. application.properties ファイルにプロパティーを定義します。 

   route.from = jms:invoices

   Copy to Clipboard Toggle word wrap

   または、以下の例のように Camel プロパティーをシステムプロパティーとして設定します。

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

   Copy to Clipboard Toggle word wrap

2. 次のように、設定されたプロパティーを Camel ルートのプレースホルダーとして使用します。

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

   Copy to Clipboard Toggle word wrap

手順

1. 以下のように、ユニットテストクラスの include または exclude パターンを @SpringBootTest アノテーションへのプロパティーとして指定します。

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

   Copy to Clipboard Toggle word wrap

   FooTest クラスの include パターンは Ant スタイルパターンを表す **/Foo* です。このパターンは、すべてのパッケージ名と一致する 2 つのアスタリスクで始まります。/Foo* は、FooRoute のようにクラス名が Foo で始まる必要があることを意味します。

2. 以下の maven コマンドを使用してテストを実行します。

   mvn test -Dtest=FooTest

   Copy to Clipboard Toggle word wrap