IBM Mobile Foundation Custom Resource (CR) の構成

パラメーター

(オプション) カスタム定義コンソール・ログイン秘密の作成

デフォルトでは、デプロイメント中にすべての Mobile Foundation コンポーネントのコンソール・ログイン秘密が自動的に作成されます。 オプションで、Server、Analytics、および Application Center コンソールにアクセスするためのログイン秘密を作成することを明示的に選択できます。 以下に例を示します。

Server の場合:

kubectl create secret generic serverlogin --from-literal=MFPF_ADMIN_USER=admin --from-literal=MFPF_ADMIN_PASSWORD=admin

Analytics の場合:

kubectl create secret generic analyticslogin --from-literal=MFPF_ANALYTICS_ADMIN_USER=admin --from-literal=MFPF_ANALYTICS_ADMIN_PASSWORD=admin

Analytics Receiver の場合:

kubectl create secret generic analytics_recvrsecret --from-literal=MFPF_ANALYTICS_RECVR_USER=admin --from-literal=MFPF_ANALYTICS_RECVR_PASSWORD=admin

Application Center の場合:

kubectl create secret generic appcenterlogin --from-literal=MFPF_APPCNTR_ADMIN_USER=admin --from-literal=MFPF_APPCNTR_ADMIN_PASSWORD=admin

注: これらの秘密が提供されていない場合、Mobile Foundation のインストール時に、デフォルトのユーザー名とパスワード (admin/admin) を使用して作成されます。

(オプション) 入口構成のための TLS 秘密の作成

外部クライアントがホスト名を使用して Mobile Foundation コンポーネントに到達できるようにするために、ホスト名ベースの入口を使用してそれらの Mobile Foundation コンポーネントを構成できます。 この入口は、TLS の秘密鍵と証明書を使用することで保護できます。 TLS の秘密鍵と証明書は、tls.key および tls.crt という鍵名を使用して秘密で定義する必要があります。

以下のコマンドを使用すると、入口リソースと同じ名前空間に秘密 mf-tls-secret が作成されます。

kubectl create secret tls mf-tls-secret --key=/path/to/tls.key --cert=/path/to/tls.crt

その後、カスタム・リソース構成 yaml の global.ingress.secret フィールドに秘密の名前を指定します。

(オプション) デプロイメントのためのカスタム鍵ストア秘密の作成

独自の鍵ストアとトラストストアを使用する秘密を作成することで、Server、Push、Analytics、および Application Center デプロイメントに対して独自の鍵ストアとトラストストアを提供できます。

リテラル KEYSTORE_PASSWORD および TRUSTSTORE_PASSWORD を使用して鍵ストアおよびトラストストアのパスワードとともに keystore.jks および truststore.jks を含む秘密を事前に作成し、各構成要素の keystoreSecret フィールドに秘密名を指定します。

以下は、keystore.jks、truststore.jks およびそのパスワードを使用してサーバー・デプロイメントのための鍵ストア秘密を作成する例です。

kubectl create secret generic server-secret --from-file=./keystore.jks --from-file=./truststore.jks --from-literal=KEYSTORE_PASSWORD=worklight --from-literal=TRUSTSTORE_PASSWORD=worklight

注: ファイルおよびリテラルの名前は、上記のコマンドで示したものと同じでなければなりません。 Helm チャートの構成時にデフォルトの鍵ストアをオーバーライドするには、各構成要素の keystoresSecretName 入力フィールドにこの秘密名を指定します。

(オプション) 機密クライアントのための秘密の作成

Mobile Foundation サーバーを、管理サービスの機密クライアントを使用して事前定義します。 これらのクライアントの資格情報は、mfpserver.adminClientSecret フィールドと mfpserver.pushClientSecret フィールドに指定します。

これらの秘密は、以下のように作成できます。

kubectl create secret generic mf-admin-client --from-literal=MFPF_ADMIN_AUTH_CLIENTID=admin --from-literal=MFPF_ADMIN_AUTH_SECRET=admin

kubectl create secret generic mf-push-client --from-literal=MFPF_PUSH_AUTH_CLIENTID=admin --from-literal=MFPF_PUSH_AUTH_SECRET=admin

Helm チャートのインストール時に mfpserver.pushClientSecret フィールド、mfpserver.adminClientSecret フィールド、および mfpserver.liveupdateClientSecret フィールドの値を指定しなかった場合、以下の資格情報を使用してデフォルトのクライアント秘密がそれぞれ次のように作成されます。

• mfpserver.adminClientSecret の場合、admin/nimda
• mfpserver.pushClientSecret の場合、push/hsup
• mfpserver.liveupdateClientSecret の場合、liveupdate / etadpuevil

(オプション) カスタム・サーバー構成

構成をカスタマイズするには (例: ログ・トレース設定を変更する、新しい jndi プロパティーを追加するなど)、構成 XML ファイルを使用して configmap を作成する必要があります。 これにより、新しい構成設定を追加することや、Mobile Foundation コンポーネントの既存の構成をオーバーライドすることができます。

Mobile Foundation コンポーネントは、configMap (mfpserver-custom-config) を介してカスタム構成にアクセスします。これは、以下のように作成できます。

kubectl create configmap mfpserver-custom-config --from-file=<configuration file in XML format>

上記のコマンドを使用して作成した configmap を、Mobile Foundation のデプロイ時に Helm チャートのカスタム・サーバー構成で指定する必要があります。

以下は、mfpserver-custom-config configmap を使用してトレース・ログ仕様を「warning」に設定する例です (デフォルト設定は「info」)。

• サンプル構成 XML (logging.xml)

<server>
        <logging maxFiles="5" traceSpecification="com.ibm.mfp.*=debug:*=warning"
        maxFileSize="20" />
</server>

• configmap を作成し、Helm チャートのデプロイメント時に同じ内容を追加する

kubectl create configmap mfpserver-custom-config --from-file=logging.xml

• (Mobile Foundation コンポーネントの) messages.log の変更に注意してください - プロパティー traceSpecification を com.ibm.mfp.=debug:*=warning に設定します。

(オプション) カスタム生成 LTPA 鍵の使用

デフォルトでは、Mobile Foundation のイメージには、各 Mobile Foundation コンポーネントの一連の ltpa.keys がバンドルされます。 実稼働環境で、すぐに使用可能な ltpa.keys をカスタム生成したもので更新する必要がある場合、カスタム構成を使用して、config xml とともにカスタム生成した ltpa.keys を追加できます。

以下は、構成のサンプル ltpa.xml です。

<server description="mfpserver">
    <ltpa
        keysFileName="ltpa.keys" />
    <webAppSecurity ssoUseDomainFromURL="true" />
</server>

以下は、カスタム LTPA 鍵を追加するコマンドの例です。

kubectl create configmap mfpserver-custom-config --from-file=ltpa.xml --from-file=ltpa.keys

LTPA 鍵の生成の詳細、およびその他の詳細については、Libertyの資料を参照してください。

注: カスタム構成を追加するために複数の custom-configmaps を使用することはサポートされていません。代わりに、以下のようにカスタム構成 configmap を作成することをお勧めします。

kubectl create configmap mfpserver-custom-config --from-file=ltpa.xml --from-file=ltpa.keys --from-file=moreconfig.xml