CData Mule コネクタをオンプレミスまたはクラウドにデプロイ

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData Mule Connector for IBMCloudObjectStorage は、IBM Cloud Object Storage データをMule アプリケーションに接続し、身近なSQL クエリで読み機能を有効にします。Connector を使用することで、ユーザーはリアルタイムIBM Cloud Object Storage データにアクセスできるMule アプリケーションを簡単に作成できます。また、内部アクセスのためのオンプレミスサーバーへのデプロイや、ダイレクトクラウドアクセスのためのMuleSoft CloudHub へのデプロイが可能になります。

Mule アプリへのIBM Cloud Object Storage 接続を追加する

この記事では、CData Mule Connector for IBMCloudObjectStorage をアプリケーションに組み込み、そのアプリケーションをMuleSoft CloudHub およびオンプレミスサーバーにデプロイする手順を説明します。CData IBM Cloud Object Storage Connector に加えて、Mule およびAnypoint Studio をインストールする必要があります。

• CData MuleSoft Connector にIBM Cloud Object Storage 接続を埋め込みます。
• Anypoint Platform を介してMuleSoft CloudHub にデプロイ します。
• Anypoint Platform を介してオンプレミスサーバーにデプロイします。

IBM Cloud Object Storage 接続を埋め込む

以下のステップは、IBM Cloud Object Storage Connector をプロジェクトに追加し、接続とコネクタを構成する方法の概要です。

1. Anypoint Studio で新しいMule プロジェクトを作成します。
2. CData IBM Cloud Object Storage Connector をアプリケーションに追加します。
3. 新しいConnection を作成（または既存のものを編集）し、IBM Cloud Object Storage に接続するプロパティを設定します。（以下を参照）接続を設定したら、「Test Connection」をクリックしてIBM Cloud Object Storage への接続を確認します。

   Cloud Object Storage 接続プロパティの取得・設定方法

   Cloud Object Storage に接続する前に、Cloud Object Storage インスタンスを登録してCloud Object Storage API キーとCRN を取得していきます。

   Cloud Object Storage の新規インスタンスの登録

   IBM Cloud アカウントにCloud Object Storage がまだない場合は、以下の手順に従ってアカウントにSQL Query のインスタンスをインストールできます。

   1. IBM Cloud アカウントにログインします。
   2. Cloud Object Storage ページに移動して、インスタンス名を指定して「作成」をクリックします。Cloud Object Storage の新規インスタンスにリダイレクトされます。

   API キー

   API キーは以下の手順で取得できます。

   1. まずは、IBM Cloud アカウントにログインします。
   2. API キーページに移動します。
   3. 中央右隅のIBM Cloud APIキーの作成 をクリックして、新しいAPI キーを作成します。
   4. ポップアップウィンドウが表示されたら、API キーの名前を指定して作成をクリックします。ダッシュボードからはアクセスできなくなるため、API Key を控えておきましょう。

   Cloud Object Storage CRN

   デフォルトでは、CData 製品はCloud Object Storage CRN を自動で取得します。ただし、複数のアカウントがある場合は、CloudObjectStorageCRN を明示的に指定する必要があります。この値は、次の2つの方法で取得できます。

   • Services ビューをクエリする。これにより、IBM Cloud Object Storage インスタンスとそれぞれのCRN がリストされます。
   • IBM Cloud で直接CRN を見つける。これを行うには、IBM Cloud のダッシュボードに移動します。リソースリストで、ストレージからCloud Object Storage リソースを選択してCRN を取得します。

   IBM Cloud Object Storage への接続

   これで準備は完了です。以下の接続プロパティを設定してください。

   • InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使うと、OAuth 認証を繰り返す必要がなく、さらに自動でアクセストークンを設定できます。
   • ApiKey：セットアップ中に控えたAPI キーを指定。
   • CloudObjectStorageCRN（オプション）：控えておいたCloud Object Storage のCRN に設定。Cloud Object Storage アカウントが複数ある場合のみ設定する必要があります。

   プロパティを設定したら、これで接続設定は完了です。

4. Operation、Query タイプ、SQL クエリを使用してCData IBM Cloud Object Storage Connector を構成します。
5. アプリケーションを終了して保存します。

アプリケーションが完成したら、Anypoint Studio をAnypoint Platform と組み合わせて使用し、MuleSoft CloudHub インスタンスまたはオンプレミスサーバーにアプリケーションをデプロイできます。

MuleSoft CloudHub にデプロイする

1. 「Project」を右クリックし、「Anypoint Platform」->「Deploy to Cloud」を選択します。
2. デプロイメントを設定し、「Deploy Application」をクリックします。
3. デプロイが完了したら、Anypoint Platform Runtime Manager に移動してデプロイされたアプリケーションを管理します。

アプリケーションがデプロイされると、必要なパラメータを追加してApp URL に移動することで、Web 上のどこからでもアクセスできるようになります。

オンプレミスサーバーにデプロイする

Anypoint Platform を介してMule アプリケーションをオンプレミスサーバーにデプロイするには、Mule Server インスタンスをマシンにインストールする必要があります。以下のステップでは、Anypoint Platform にオンプレミスサーバーを追加し、Mule アプリケーションをデプロイする方法を説明します。

オンプレミスMule Server をAnypoint Platform に追加する

1. 実行中の場合、オンプレミスのMule Server を停止します。
2. Anypoint Platform に移動して「Add Server」をクリックし、サーバーを追加するセキュリティトークンを含むコマンドを表示します。

3. MuleSoft Runtime Manager Agent をセットアップします（Windows の場合、amc_setup.bat ... を実行）。

   %MULE_HOME%\bin> amc_setup -H 12ab3cd4-567e-8fa9-0123-4b56c7de8901---234567 MYSERVER

4. オンプレミスMule Server を開始します（Windows の場合、mule.bat を実行）。

   %MULE_HOME%\bin> mule

Mule アプリケーションをデプロイする

1. Anypoint Studio で、「project」を右クリックし、「Export」を選択します。
   • Mule フォルダにて、「Anypoint Studio Project to Mule Deployable Archive」を選択し、「Next」をクリックしてデプロイ可能なファイルを作成します。
2. Anypoint Platform Runtime Manager で「Applications」に移動し、「Deploy Application」をクリックします。
   • アプリケーションに名前を付けます。
   • Deployment Target としてオンプレミスサーバーを選択します。
   • 「Application File」の下で「Choose file」->「Upload file」とクリックし、エクスポートしたプロジェクトを選択します。
   • 「Deploy Application」をクリックします。

アプリケーションをオンプレミスサーバーにデプロイすると、サ－バーにアクセス可能な任意のブラウザからアクセスできるようになります。サーバーのアドレスとポートに移動し、アプリケーションに必要なURL パラメータを追加します。

これで、IBM Cloud Object Storage データを使用するMule アプリケーションがデプロイできました。Mule Connector for IBMCloudObjectStorage の30日間の無償トライアルをダウンロードして、Mule アプリケーションでCData の強力なデータ連携をご体感ください。