第10章 プロジェクトを Red Hat Fuse に公開する


このチュートリアルでは、プロジェクトを Red Hat Fuse に公開するプロセスについて説明します。Red Hat Fuse Tooling を実行しているのと同じマシンに Red Hat Fuse のインスタンスがインストールされていることを前提としています。

ゴール

このチュートリアルでは、次のタスクを完了します。

  • Red Hat Fuse サーバーを定義します
  • 公開オプションを設定します
  • Red Hat Fuse サーバーを起動し、ZooOrderApp プロジェクトをパブリッシュする
  • Red Hat Fuse サーバーに接続します
  • ZooOrderApp プロジェクトのバンドルが正常にビルドされ、公開されたかどうかを確認する
  • ZooOrderApp プロジェクトのアンインストール

前提条件

このチュートリアルを開始する前に、次のものが必要です。

  • Red Hat Fuse インスタンスへのアクセス
  • コンピューターにインストールされている Java 8
  • 次のいずれかから生じる ZooOrderApp プロジェクト:

Red Hat Fuse Server の定義

サーバーを定義するには:

  1. Fuse Integration パースペクティブを開きます。
  2. 右下のパネルの Servers タブをクリックして、Servers ビューを開きます。
  3. 以下をクリックします。利用可能なサーバーはありません。このリンクをクリックして、新しいサーバーを作成...リンクをクリックすると、Define a New Server ページが表示されます。

    注記

    すでにサーバーが定義されているときに新しいサーバーを定義するには、Servers ビュー内を右クリックして、New Server を選択します。

  4. Red Hat JBoss Middleware ノードを展開して、使用可能なサーバーオプションを公開します。

    tutDefineNewServer
  5. Red Hat Fuse サーバーを選択します。
  6. Server's host name ( localhost) と Server name (Fuse n.n Runtime Server) のデフォルトを受け入れ、Next へをクリックして Runtime ページを開きます。

    tutFuseRuntimeDef1
    注記

    Fuse をまだインストールしていない場合は、Download and install runtime リンクを使用して今すぐダウンロードできます。

    すでにサーバーを定義している場合、ツールはこのページをスキップし、代わりに設定の詳細ページを表示します。

  7. Name のデフォルトを受け入れます。
  8. Home Directory フィールドの横にある Browse をクリックして、インストールに移動して選択します。
  9. Execution Environment の横にあるドロップダウンメニューからランタイム JRE を選択します。

    JavaSE-1.8(推奨) を選択します。必要に応じて、Environments ボタンをクリックしてリストから選択します。

    注記

    Fuse サーバーには Java 8 が必要です (推奨)。Execution Environment で選択するには、事前にインストールしておく必要があります。

  10. Alternate JRE オプションはそのままにしておきます。
  11. Next をクリックして Fuse Server のランタイム定義を保存し、Fuse server configuration details ページを開きます。

    NewServerDetailsTut
  12. SSH Port のデフォルト (8101) を受け入れます。

    ランタイムは SSH ポートを使用して、サーバーの Karaf シェルに接続します。このデフォルトが正しくない場合は、Red Hat Fuse installDir/etc/org.apache.karaf.shell.cfg ファイルを確認して正しいポート番号を検出できます。

  13. User Name に、サーバーへのログインに使用する名前を入力します。

    これは、Red Hat Fuse installDir`/etc/users.properties` ファイルに保存されているユーザー名です。

    注記

    /etc/users.properties ファイルのデフォルトのユーザーがアクティベートされている場合 (アンコメント)、ツールは User Name および Password にデフォルトユーザーの名前およびパスワードを自動入力します。

    設定されていない場合は、user=password,role のフォーマットを使用してそのファイルにユーザーを追加するか (例: joe=secret,Administrator)、karaf jaas コマンドセットを使用して設定できます。

    • jaas:realms: レルムを一覧表示します。
    • jaas:manage --index 1: 最初の (サーバー) レルムを編集します。
    • jaas:useradd <username> <password>: ユーザーと関連するパスワードを追加します。
    • jaas:roleadd <username> Administrator: 新規ユーザーのロールを指定します。
    • jaas:update: 新しいユーザー情報を使用してレルムを更新します。

      サーバーに対して jaas レルムがすでに選択されている場合は、コマンド JBossFuse:karaf@root>jaas:users を実行してユーザー名を検出できます。

  14. Password には、サーバーにログインする際に User name に必要なパスワードを入力します。

    これは、Red Hat Fuse の installDir/etc/users.properties ファイルまたは karaf jaas コマンドによって設定されたパスワードです。

  15. Finish をクリックします。

    Runtime Server [stopped, Synchronized]Servers ビューに表示されます。

  16. Servers ビューで、ランタイムサーバーを展開します。

    JBFuseServersView

    JMX[Disconnected] は、Runtime Server [stopped, Synchronized] エントリーの下にノードとして表示されます。

公開オプションの設定

パブリッシュオプションを使用して、ZooOrderApp プロジェクトを稼働中のサーバーにパブリッシュする方法およびタイミングを設定できます。

  • プロジェクトに加えられた変更を保存するとすぐに自動的に
  • プロジェクトを変更して保存した後、設定された間隔で自動的に
  • 手動で、公開操作を選択した場合

このチュートリアルでは、ZooOrderApp プロジェクトへの変更を保存したら直ちにパブリッシュするように設定します。これを行うには、以下を行います。

  1. Servers ビューで、Runtime Server [stopped, Synchronized] エントリーをダブルクリックして、その概要を表示します。
  2. サーバーの Overview ページで、Publishing セクションを展開してオプションを表示します。

    srvEditorPubOpts

    Automatically publish when resources change オプションが有効になっていることを確認します。

    必要に応じて、Publishing interval の値を変更して、変更が加えられたときにプロジェクトの公開を高速化または遅延させます。

  3. Servers ビューで、 Start the server をクリックします。
  4. サーバーが起動するまで数秒待ちます。その場合:

    • Terminal ビューにスプラッシュ画面が表示されます。

      tutServerStartShellV
    • Servers ビューには以下が表示されます。

      tutServerStartServerV
    • JMX Navigator は、n.n Runtime Server[Disconnected と表示します:

      tutServerStartJMXNav
  5. Servers ビューで、n.n Runtime Server [Started] を右クリックし、Add and Removeを選択して、Add and Remove ページを開きます。

    tutAddRemove1

    If server is started, publish changes immediately オプションがオンになっていることを確認します。

  6. ZooOrderApp を選択し、Add をクリックして Fuse サーバーに割り当てます。

    tutAddRemove2
  7. Finish をクリックします。

    Servers ビューには、次のように表示されます。

    tutCBRrtePublishedSrvV
    • Runtime Server [Started, Synchronized]

      注記

      サーバーの場合、synchronized とは、サーバーで公開されているすべてのモジュールがローカルの対応するモジュールと同一であることを意味します。

    • ZooOrderApp [Started, Synchronized]

      注記

      モジュールの場合、synchronized とは、公開されたモジュールがローカルの対応するモジュールと同一であることを意味します。自動公開が有効になっているため、ZooOrderApp プロジェクトに加えられた変更は、(Publishing interval の値に応じて) 数秒で公開されます。

    • JMX[Disconnected]

ランタイムサーバーへの接続

ランタイムサーバーへの接続後、ZooOrderApp プロジェクトのパブリッシュされた要素が表示され、それらと対話できます。

  1. Servers ビューで、JMX[Disconnected] をダブルクリックしてランタイムサーバーに接続します。
  2. JMX NavigatorCamel フォルダーを展開し、ZooOrderApp の要素を表示します。

    tutJMXconnected
  3. Bundles ノードをクリックして、ランタイムサーバーにインストールされているバンドルのリストを Properties ビューに入力します。

    tutCBRrouteBundleInstall
  4. Search フィールドに ZooOrderApp と入力します。対応するバンドルが表示されます。

    tutCBRrouteBundleSearch
    注記

    または、Terminal ビューで osgi:list コマンドを実行し、サーバーランタイムにインストールされているバンドルに関する生成されたリストを表示することもできます。ツールは、osgi:list コマンドが表示する OSGi バンドルに異なる命名スキームを使用します。この場合、コマンドは Camel Blueprint Quickstart を返します。これはインストールされたバンドルのリストの最後に表示される

    プロジェクトの pom.xml ファイルの <build> セクションで、バンドルのシンボリック名およびそのバンドル名 (OSGi) が maven-bundle-plugin エントリーに一覧表示されます。

    tutBundleNamesPom

ZooOrderApp プロジェクトのアンインストール

注記

公開されたリソースをアンインストールするために、JMX 接続を切断したり、サーバーを停止したりする必要はありません。

ランタイムサーバーから ZooOrderApp リソースを削除するには、以下を実行します。

  1. Servers ビューで、n.n Runtime Server を右クリックしてコンテキストメニューを開きます。
  2. Add and Remove を選択します:

    tutUnpubCBRroute
  3. Configured 列で ZooOrderApp を選択し、Remove をクリックして ZooOrderApp リソースを Available 列に移動します。
  4. Finish をクリックします。
  5. Servers ビューで、JMX[Connected] を右クリックし、Refresh をクリックします。

    JMX[Connected] 下の Camel ツリーが消えます。

    注記

    JMX Navigator でも、Server Connections > n.n Runtime Server[Connected]Camel ツリーが消失します。

  6. Properties ビューに Bundles ページが表示されたら、リストの最後までスクロールして、ZooOrderApp のバンドルがリストされていないことを確認します。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.