このトピックでは、ユーザー提供のサービスインスタンスを作成および更新する方法について説明します。

注意事項：この記事は、Cloud Foundry Documentaion User-Provided Service Instances (last updated: May 13, 2017)の独自の翻訳とコメントです。内容を保証するものではありません。

コメント: Bluemixでもユーザー提供サービスを利用することができます。また、Bluemixコンソール画面から、バインド／アンバインドができ、アプリケーションにVCAP変数として与えることができます。具体的なユーザー提供サービスの実装例は Bluemix Pythonマイクロサービスの開発へ投稿しました。

概要

ユーザーが提供するサービス・インスタンスにより、開発者はマーケット・プレイスでは利用できないサービスをCloud Foundry上で動作するアプリケーションで使用できます。

ユーザー提供のサービス・インスタンスを使用して、サービス資格情報をアプリケーションに供給したり、アプリケーション・ログのストリームをsyslog互換コンシューマにトリガすることができます。これらの2つの機能は、単独で、または同時に使用することができます。

作成されると、ユーザー提供のサービス・インスタンスは、マーケット・プレイスを通じて作成されたサービス・インスタンスのように動作します。リスティング、名前変更、削除、バインディング、およびバインド解除の詳細については、「サービス・インスタンスとアプリケーション・バインディングの管理」を参照してください。

ユーザー提供のサービスインスタンスを作成する

cf create-user-provided-serviceの別名は cf cups です。

アプリにサービス資格情報を供給する

開発者が、Cloud Foundryの外部で管理されているOracleデータベースと通信するためのURL、ポート、ユーザー名、およびパスワードを取得したとします。開発者は、カスタム環境変数を手動で作成して、これらの資格情報を使用してアプリケーションを構成することができます（もちろん、これらの資格情報をアプリケーションにハードコードすることはありません）。

ユーザーが提供するサービス・インスタンスにより、使い慣れたアプリケーション・バインディング操作と、Cloud Foundryがマーケット・プレイスサービス（VCAP_SERVICES）の資格情報を自動的に配信するために使用する同じアプリケーション実行環境変数を使用して、開発者がアプリケーションを構成できます。

cf cups SERVICE_INSTANCE -p '{"username":"admin","password":"pa55woRD"}'

対話モードでサービス・インスタンスを作成するには、カンマで区切ったパラメータ名のリストとともに-pオプションを使用します。 cf CLIは、各パラメータ値の入力を求めるプロンプトを表示します。

cf cups SERVICE_INSTANCE -p "host, port, dbname, username, password"

ユーザー提供のサービス・インスタンスが作成されると、1つまたは複数のアプリケーションに資格情報を配信するには、「アプリケーション・バインディング」を参照してください。

アプリ・ログをサービスにストリームする

ユーザーが提供するサービスインスタンスにより、開発者はアプリケーションログを市場で入手できないsyslog互換アグリゲーションサービスまたはアナリティクスサービスにストリーミングできます。 syslogプロトコルの詳細については、RFC 5424およびRFC 6587を参照してください。

-lオプションを使用してサービスのURLを指定して、ユーザー提供のサービスインスタンスを作成します。

cf cups SERVICE_INSTANCE -l syslog://example.log-aggregator.com

アプリケーション・ログをサービスにストリームするには、ユーザー提供のサービス・インスタンスをアプリケーションにバインドします。

アプリのプロキシ

ユーザが提供するサービスインスタンスにより、開発者はアプリケーション要求を事前処理のためにルートサービスにプロキシすることができます。ルートサービスのユーザー提供サービスインスタンスを作成するには、-rオプションを使用してルートサービスのURLを指定します。

$ cf create-user-provided-service my-user-provided-route-service -r https://my-route-service.example.com
Creating user provided service my-user-provided-route-service in org my-org / space my-space as user@example.com...
OK

注：ユーザー提供サービスを作成する場合、指定されたルートサービスURLはhttpsでなければなりません。

ユーザー提供のルート・サービスに要求をプロキシするには、サービス・インスタンスをルートにバインドする必要があります。詳細については、「ルートサービスを使用したアプリケーション要求の管理」を参照してください。

ユーザー提供のサービスインスタンスを更新する

cf update-user-provided-serviceを使用すると、ユーザ提供サービスのインスタンスの属性を更新できます。新しい資格情報が古い資格情報を上書きし、提供されていないパラメータが削除されます。

update-user-supplied-serviceのエイリアスはuupsです。