Helm を使用した IBM Cloud Kubernetes クラスター上の Mobile Foundation のセットアップ

概説

以下の指示に従い、Helm チャートを使用して IBM Cloud Kubernetes クラスター (IKS) 上で MobileFirst Server インスタンス、、MobileFirst Analytics インスタンス、および MobileFirst Application Center インスタンスを構成します。

以下は、入門のための基本的な手順です。

• 前提条件を満たす
• IBM Cloud Private 用の IBM Mobile Foundation のパスポート・アドバンテージ・アーカイブ (PPA アーカイブ) をダウンロードする
• IBM Cloud Kubernetes クラスターに PPA アーカイブをロードする
• MobileFirst Server、MobileFirst Analytics (オプション)、および MobileFirst Application Center (オプション) をインストールし、構成する

ジャンプ先:

• 前提条件
• IBM Mobile Foundation パスポート・アドバンテージ・アーカイブのダウンロード
• IBM Mobile Foundation パスポート・アドバンテージ・アーカイブのロード
• 環境変数
• IBM Mobile Foundation Helm チャートのインストールおよび構成
• Helm チャートのインストール
• インストールの検査
• サンプル・アプリケーション
• Helm チャートおよびリリースのアップグレード
• アンインストール
• トラブルシューティング

前提条件

IBM Cloud アカウントが必要であり、IBM Cloud Kubernetes クラスターをセットアップしておく必要があります。

コンテナーおよびイメージを管理するために、IBM Cloud CLI プラグイン・セットアップの一部としてホスト・マシンに以下をインストールします。

• IBM Cloud CLI (ibmcloud)
• Kubernetes CLI (kubectl)
• IBM Cloud Container Registry プラグイン (cr)
• IBM Cloud Container Service プラグイン (ks)
• Docker をインストールし、セットアップする
• Helm (helm) CLI を使用して Kubernetes クラスターを処理するために、ibmcloud クライアントを構成する必要があります。
  1. クラスター・ページにログインしていることを確認します。 (注: IBMid アカウントが必要です。)
  2. IBM Mobile Foundation Chart をデプロイする先の Kubernetes クラスターをクリックします。
  3. クラスターが作成された後、「アクセス」タブの指示に従います。

     注: クラスターの作成には数分かかります。 クラスターが正常に作成された後、「ワーカー・ノード (Worker Nodes)」タブをクリックし、パブリック IP をメモします。

CLI を使用して IBM Cloud Kubernetes クラスターにアクセスするために、IBM Cloud クライアントを構成する必要があります。 詳細はこちら。

IBM Mobile Foundation パスポート・アドバンテージ・アーカイブのダウンロード

IBM Mobile Foundation のパスポート・アドバンテージ・アーカイブ (PPA) は、ここから入手できます。 Mobile Foundation の PPA アーカイブには、以下の Mobile Foundation コンポーネントの Docker イメージと Helm チャートが含まれます。

• MobileFirst Server
• MobileFirst Push
• MobileFirst Analytics
• MobileFirst Application Center

データベース初期化タスクを簡単に実行できるようにするために、MobileFirst DB 初期化コンポーネントが使用されます。 これにより、(必要に応じて) データベースで Mobile Foundation スキーマおよび表の作成が処理されます (存在しない場合)。

IBM Mobile Foundation パスポート・アドバンテージ・アーカイブのロード

以下のステップに従って、PPA アーカイブを IBM Cloud Kubernetes クラスターにロードします。

1. IBM Cloud プラグインを使用してクラスターにログインします。 コマンド・リファレンスについては、IBM Cloud CLI の資料 (https://cloud.ibm.com/docs/cli?topic=cloud-cli-getting-started#overview) を参照してください。

   以下に例を示します。

    ibmcloud login -a cloud.ibm.com
   

   統合 ID を使用する場合、--sso オプションを組み込みます。オプションとして SSL の検証をスキップできます。上記のコマンドで --skip-ssl-validation フラグを使用します。 これにより、HTTP 要求の SSL 検証がバイパスされます。 このパラメーターを使用すると、セキュリティーの問題が発生する場合があります。

2. IBM Cloud Container Registry にログインし、以下のコマンドを使用して Container Service を初期化します。

    ibmcloud cr login
    ibmcloud ks init
   

3. 以下のコマンドを使用してデプロイメントの地域を設定します (例えば、米国南部)。

    ibmcloud cr region-set
   

4. 以下の手順に従い、クラスターへのアクセス権限を取得します。

   1. いくつかの CLI ツールと Kubernetes Service のプラグインをダウンロードし、インストールします。

       curl -sL https://ibm.biz/idt-installer | bash
      

   2. ご使用のクラスター用の kubeconfig ファイルをダウンロードします。

       ibmcloud ks cluster-config --cluster my_cluster_name
      

   3. KUBECONFIG 環境変数を設定します。 前のコマンドからの出力をコピーし、ご使用の端末に貼り付けます。 コマンド出力は、以下の例のようになります。

       export KUBECONFIG=/Users/$USER/.bluemix/plugins/container-service/clusters/my_namespace/kube-config-dal10-my_namespace.yml
      

   4. ワーカー・ノードをリストして、クラスターに接続できることを確認します。

       kubectl get nodes
      

5. 以下のステップを実行して、Mobile Foundation のPPA アーカイブをロードします。
   1. PPA アーカイブを解凍します。
   2. ロードしたイメージに、IBM Cloud Container レジストリー名前空間と適切なバージョンのタグを付けます。
   3. イメージをプッシュします。
   4. (オプション) ワーカー・ノードがアーキテクチャー (amd64、ppc64le、s390x など) の組み合わせに基づく場合、マニフェストを作成し、そのマニフェストをプッシュします。

   以下は、amd64 アーキテクチャーに基づいたワーカー・ノードに mfpf-server イメージと mfpf-push イメージをロードする例です。 mfpf-appcenter および mfpf-analytics についても同じプロセスに従う必要があります。

   
    # 1. PPA アーカイブを解凍する
   
    mkdir -p ppatmp ; cd ppatmp
    tar -xvzf ibm-mobilefirst-foundation-icp.tar.gz
    cd ./images
    for i in *; do docker load -i $i;done
   
    # 2. ロードしたイメージに、IBM Cloud Container レジストリー名前空間と適切なバージョンのタグを付ける
   
    docker tag mfpf-server:1.1.0-amd64 us.icr.io/my_namespace/mfpf-server:1.1.0
    docker tag mfpf-dbinit:1.1.0-amd64 us.icr.io/my_namespace/mfpf-dbinit:1.1.0
    docker tag mfpf-push:1.1.0-amd64 us.icr.io/my_namespace/mfpf-push:1.1.0
   
    # 3. すべてのイメージをプッシュする
   
    docker push us.icr.io/my_namespace/mfpf-server:1.1.0
    docker push us.icr.io/my_namespace/mfpf-dbinit:1.1.0
    docker push us.icr.io/my_namespace/mfpf-push:1.1.0
   
    # 4. 解凍したアーカイブをクリーンアップする
   
    rm -rf ppatmp
   

   以下は、マルチアーキテクチャーに基づくワーカー・ノードに mfpf-server イメージと mfpf-push イメージをロードする例です。 mfpf-appcenter および mfpf-analytics についても同じプロセスに従う必要があります。

    # 1. PPA アーカイブを解凍する
   
    mkdir -p ppatmp ; cd ppatmp
    tar -xvzf ibm-mobilefirst-foundation-icp.tar.gz
    cd ./images
    for i in *; do docker load -i $i;done
   
    # 2. ロードしたイメージに、IBM Cloud Container レジストリー名前空間と適切なバージョンのタグを付ける
   
    ## 2.1 mfpf-server にタグ付けする
   
    docker tag mfpf-server:1.1.0-amd64 us.icr.io/my_namespace/mfpf-server:1.1.0-amd64
    docker tag mfpf-server:1.1.0-s390x us.icr.io/my_namespace/mfpf-server:1.1.0-s390x
    docker tag mfpf-server:1.1.0-ppc64le us.icr.io/my_namespace/mfpf-server/mfpf-server:1.1.0-ppc64le
   
    ## 2.2 mfpf-dbinit にタグ付けする
   
    docker tag mfpf-dbinit:1.1.0-amd64 us.icr.io/my_namespace/mfpf-dbinit:1.1.0-amd64
    docker tag mfpf-dbinit:1.1.0-s390x us.icr.io/my_namespace/mfpf-dbinit:1.1.0-s390x
    docker tag mfpf-dbinit:1.1.0-ppc64le us.icr.io/my_namespace/mfpf-dbinit/mfpf-dbinit:1.1.0-ppc64le
   
    ## 2.3 mfpf-push にタグ付けする
   
    docker tag mfpf-push:1.1.0-amd64 us.icr.io/my_namespace/mfpf-push:1.1.0-amd64
    docker tag mfpf-push:1.1.0-s390x us.icr.io/my_namespace/mfpf-push:1.1.0-s390x
    docker tag mfpf-push:1.1.0-ppc64le us.icr.io/my_namespace/mfpf-push/mfpf-push:1.1.0-ppc64le
   
    # 3. すべてのイメージをプッシュする
   
    ## 3.1 mfpf-server イメージをプッシュする
   
    docker push us.icr.io/my_namespace/mfpf-server:1.1.0-amd64
    docker push us.icr.io/my_namespace/mfpf-server:1.1.0-s390x
    docker push us.icr.io/my_namespace/mfpf-server/mfpf-server:1.1.0-ppc64le
   
    ## 3.3 mfpf-dbinit イメージをプッシュする
   
    docker push us.icr.io/my_namespace/mfpf-dbinit:1.1.0-amd64
    docker push us.icr.io/my_namespace/mfpf-dbinit:1.1.0-s390x
    docker push us.icr.io/my_namespace/mfpf-dbinit/mfpf-dbinit:1.1.0-ppc64le
   
    ## 3.3 mfpf-push イメージをプッシュする
   
    docker push us.icr.io/my_namespace/mfpf-push:1.1.0-amd64
    docker push us.icr.io/my_namespace/mfpf-push:1.1.0-s390x
    docker push us.icr.io/my_namespace/mfpf-push/mfpf-push:1.1.0-ppc64le
   
    # 4. [オプション] マニフェストを作成してプッシュする
   
    ## 4.1 manifest-lists を作成する
   
    docker manifest create us.icr.io/my_namespace/mfpf-server:1.1.0 us.icr.io/my_namespace/mfpf-server:1.1.0-amd64 us.icr.io/my_namespace/mfpf-server:1.1.0-s390x us.icr.io/my_namespace/mfpf-server/mfpf-server:1.1.0-ppc64le  --amend
    docker manifest create us.icr.io/my_namespace/mfpf-dbinit:1.1.0 us.icr.io/my_namespace/mfpf-dbinit:1.1.0-amd64 us.icr.io/my_namespace/mfpf-dbinit:1.1.0-s390x us.icr.io/my_namespace/mfpf-dbinit/mfpf-dbinit:1.1.0-ppc64le  --amend
    docker manifest create us.icr.io/my_namespace/mfpf-push:1.1.0 us.icr.io/my_namespace/mfpf-push:1.1.0-amd64 us.icr.io/my_namespace/mfpf-push:1.1.0-s390x us.icr.io/my_namespace/mfpf-push/mfpf-push:1.1.0-ppc64le  --amend
   
    ## 4.2 マニフェストにアノテーションを付ける
   
    ### mfpf-server
   
    docker manifest annotate us.icr.io/my_namespace/mfpf-server:1.1.0 us.icr.io/my_namespace/mfpf-server:1.1.0-amd64 --os linux --arch amd64
    docker manifest annotate us.icr.io/my_namespace/mfpf-server:1.1.0 us.icr.io/my_namespace/mfpf-server:1.1.0-s390x --os linux --arch s390x
    docker manifest annotate us.icr.io/my_namespace/mfpf-server:1.1.0 us.icr.io/my_namespace/mfpf-server/mfpf-server:1.1.0-ppc64le --os linux --arch ppc64le
   
   
    ### mfpf-dbinit
   
    docker manifest annotate us.icr.io/my_namespace/mfpf-dbinit:1.1.0 us.icr.io/my_namespace/mfpf-dbinit:1.1.0-amd64 --os linux --arch amd64
    docker manifest annotate us.icr.io/my_namespace/mfpf-dbinit:1.1.0 us.icr.io/my_namespace/mfpf-dbinit:1.1.0-s390x --os linux --arch s390x
    docker manifest annotate us.icr.io/my_namespace/mfpf-dbinit:1.1.0 us.icr.io/my_namespace/mfpf-dbinit/mfpf-dbinit:1.1.0-ppc64le --os linux --arch ppc64le
   
   
    ### mfpf-push
   
    docker manifest annotate us.icr.io/my_namespace/mfpf-push:1.1.0 us.icr.io/my_namespace/mfpf-push:1.1.0-amd64 --os linux --arch amd64
    docker manifest annotate us.icr.io/my_namespace/mfpf-push:1.1.0 us.icr.io/my_namespace/mfpf-push:1.1.0-s390x --os linux --arch s390x
    docker manifest annotate us.icr.io/my_namespace/mfpf-push:1.1.0 us.icr.io/my_namespace/mfpf-push/mfpf-push:1.1.0-ppc64le --os linux --arch ppc64le
   
    ## 4.3 マニフェスト・リストをプッシュする
   
    docker manifest push us.icr.io/my_namespace/mfpf-server:1.1.0
    docker manifest push us.icr.io/my_namespace/mfpf-dbinit:1.1.0
    docker manifest push us.icr.io/my_namespace/mfpf-push:1.1.0
   
    # 5. 解凍したアーカイブをクリーンアップする
   
    rm -rf ppatmp
   

注:

1. ibmcloud cr ppa-archive load コマンドによるアプローチは、マルチ・アーキテクチャー・サポートを備えた PPA パッケージをサポートしていません。 したがって、パッケージを解凍して手動で IBM Cloud Container リポジトリーにプッシュする必要があります (古い PPA バージョンを使用しているユーザーは、次のコマンドを使用してロードする必要があります)。

1. マルチ・アーキテクチャーとは intel (amd64)、power64 (ppc64le)、s390x などのアーキテクチャーを指します。 マルチ・アーキテクチャーは ICP 3.1.1 以降でのみサポートされます。

  ibmcloud cr ppa-archive-load --archive <archive_name> --namespace <namespace> [--clustername <cluster_name>]

Mobile Foundation の archive_name は、IBM パスポート・アドバンテージからダウンロードした PPA アーカイブの名前です。

Helm チャートは、(IBM Cloud Private Helm リポジトリーに保管される ICP Helm チャートと異なり) クライアント内に保管されるか、ローカルに保管されます。 チャートは、ppa-import/charts (または charts) ディレクトリー内で見つけることができます。

IBM Mobile Foundation Helm チャートのインストールおよび構成

MobileFirst Server をインストールし、構成するには、以下のものが事前に必要になります。

このセクションでは、秘密の作成手順について説明します。

秘密オブジェクトを使用すると、パスワード、OAuth トークン、ssh キーなどの機密情報を保管および管理できます。 このような情報は、ポッド定義やコンテナー・イメージに保管するよりも、秘密に保管した方がより安全でフレキシブルです。

• (必須) DB2 データベース・インスタンスを構成し、使用できるよう準備する必要があります。 MobileFirst Server Helm を構成するには、データベース情報が必要です。 MobileFirst Server には、スキーマと表が必要であり、それらがこのデータベースに作成されます (存在しない場合)。

• (必須) Server、Push、および Application Center に対してデータベース秘密を作成します。 このセクションでは、データベースへのアクセスを制御するためのセキュリティー・メカニズムについて説明します。 指定のサブコマンドを使用して秘密を作成し、データベースの詳細で作成した秘密の名前を指定します。

以下のコード・スニペットを実行して、Mobile Foundation サーバーのデータベース秘密を作成します。

	# mfpserver 秘密を作成する
	cat <<EOF | kubectl apply -f -
	apiVersion: v1
	data:
	  MFPF_ADMIN_DB_USERNAME: encoded_uname
	  MFPF_ADMIN_DB_PASSWORD: encoded_password
	  MFPF_RUNTIME_DB_USERNAME: encoded_uname
	  MFPF_RUNTIME_DB_PASSWORD: encoded_password
	  MFPF_PUSH_DB_USERNAME: encoded_uname
	  MFPF_PUSH_DB_PASSWORD: encoded_password
	kind: Secret
	metadata:
	  name: mfpserver-dbsecret
	type: Opaque
	EOF

以下のコード・スニペットを実行して、Application Center のデータベース秘密を作成します。

	# appcenter 秘密を作成する
	cat <<EOF | kubectl apply -f -
	apiVersion: v1
	data:
	  APPCNTR_DB_USERNAME: encoded_uname
	  APPCNTR_DB_PASSWORD: encoded_password
	kind: Secret
	metadata:
	  name: appcenter-dbsecret
	type: Opaque
	EOF

注: 以下のコマンドを使用してユーザー名とパスワードの詳細をエンコードできます。

	export $MY_USER_NAME=<myuser>
	export $MY_PASSWORD=<mypassword>

	echo -n $MY_USER_NAME | base64
	echo -n $MY_PASSWORD | base64

• (必須) Server、Analytics、および Application Center のコンソールにログインするには、事前に作成したログイン秘密が必要です。 例えば、次のとおりです。

   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=ANALYTICS_ADMIN_USER=admin --from-literal=ANALYTICS_ADMIN_PASSWORD=admin
  

  Application Center の場合。

   kubectl create secret generic appcenterlogin --from-literal=APPCENTER_ADMIN_USER=admin --from-literal=APPCENTER_ADMIN_PASSWORD=admin
  

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

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

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

  以下のように、ファイル keystore.jks、truststore.jks とそのパスワードを保持します。

  例えば、次のとおりです。

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

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

• (オプション) 外部クライアントがホスト名を使用して 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
  

  その後、global.ingress.secret フィールドに、入口ホスト名と秘密の名前を指定します。 Helm チャートのデプロイ時に values.yaml を変更して、適切な入口ホスト名と入口秘密名を追加します。

  注: 他の Helm リリースに対して入口ホスト名が既に使用されている場合、同じ入口ホスト名は使用しないでください。

• (オプション) 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
  

  注: Mobile Foundation Helm チャートのデプロイメント時に mfpserver.pushClientSecret フィールドと mfpserver.adminClientSecret フィールドに値を指定しなかった場合、mfpserver.adminClientSecret に対してはデフォルトの認証 ID/クライアント秘密である admin/nimda が、mfpserver.pushClientSecret に対してはデフォルトの認証 ID/クライアント秘密である push/hsup が生成され、使用されます。

• (必須) Mobile Foundation Analytics Chart のインストールを開始する前に、永続ボリュームと永続ボリューム要求を必要に応じて構成します。 永続ボリュームを用意して Mobile Foundation Analytics を構成します。 永続ボリュームの作成に関する IBM Cloud Kubernetes の資料で詳しく説明されている手順に従います。

環境変数

以下の表に、MobileFirst Server インスタンス、MobileFirst Analytics、、および MobileFirst Application Center で使用される環境変数を示します。

Kibana を使用して ログを分析する場合のチュートリアルについては、こちらを参照してください。

Helm チャートのインストール

MobileFirst Analytics のインストール

MobileFirst Analytics のインストールはオプションです。 MobileFirst Server での分析を使用可能にする場合は、MobileFirst Server をインストールする前に、まず MobileFirst Analytics を構成してインストールする必要があります。

インストールを開始する前に、IBM Mobile Foundation Helm チャートのインストールおよび構成 (#configure-install-mf-helmcharts) のすべての必須セクションに対処したか確認します。

以下の手順に従い、IBM Cloud Kubernetes クラスターに IBM MobileFirst Analytics をインストールし、構成します。

1. Kubernetes クラスターを構成するために、以下のコマンドを実行します。

    ibmcloud cs cluster-config <iks-cluster-name>
   

2. 以下のコマンドを使用して、デフォルトの Helm チャートの値を取得します。

    helm inspect values <mfp-analytics-helm-chart.tgz>  > values.yaml
   

   MobileFirst Analytics の場合の例:

    helm inspect values ibm-mfpf-analytics-prod-2.0.0.tgz > values.yaml
   

3. Helm チャートをデプロイする前に values.yaml を変更して適切な値を追加します。 データベースの詳細、入口ホスト名、秘密などが追加されていることを確認し、values.yaml を保存します。

詳しくは、環境変数セクションを参照してください。

1. Helm チャートをデプロイするために、以下のコマンドを実行します。

    helm install -n <iks-cluster-name> -f values.yaml <mfp-analytics-helm-chart.tgz>
   

   Analytics サーバーをデプロイする場合の例:

    helm install -n mfpanalyticsonkubecluster -f analytics-values.yaml ./ibm-mfpf-analytics-prod-2.0.0.tgz
   

MobileFirst Server のインストール

MobileFirst Server のインストールを開始する前に、DB2 データベースが事前構成されていることを確認してください。

以下のステップに従って、IBM Cloud Kubernetes クラスター上に IBM MobileFirst Server をインストールし、構成します。

1. Kube クラスターを構成します。

    ibmcloud cs cluster-config <iks-cluster-name>
   

2. 以下のコマンドを使用して、デフォルトの Helm チャートの値を取得します。

    helm inspect values <mfp-server-helm-chart.tgz>  > values.yaml
   

   MobileFirst Server の場合の例:

    helm inspect values ibm-mfpf-server-prod-2.0.0.tgz > values.yaml
   

3. values.yaml を変更して、Helm チャートをデプロイするための適切な値を追加します。 データベース詳細、入口、スケーリングなどが追加されていることを確認し、values.yaml を保存します。

4. Helm チャートをデプロイするために、以下のコマンドを実行します。

    helm install -n <iks-cluster-name> -f values.yaml <mfp-server-helm-chart.tgz>
   

   サーバーをデプロイする場合の例:

    helm install -n mfpserveronkubecluster -f server-values.yaml ./ibm-mfpf-server-prod-2.0.0.tgz
   

注: AppCenter をインストールする場合、対応する Helm チャート (例えば、ibm-mfpf-appcenter-prod-2.0.0.tgz.tgz) を使用して、上記のステップに従ってください。

インストールの検査

Mobile Foundation コンポーネントをインストールし、構成した後、IBM Cloud CLI、Kubernetes CLI、および helm コマンドを使用することで、インストール済み環境およびデプロイされたポッドの状況を確認できます。

IBM Cloud CLI 資料の CLI コマンド・リファレンス、および Helm 資料 の Helm CLI を参照してください。

IBM Cloud ポータルにある IBM Cloud Kubernetes クラスターのページから、「Kubernetes ダッシュボード」ボタンを使用して Kubernetes コンソールを開いて、クラスター成果物を管理できます。

コンソールへのアクセス

インストールが成功したら、<protocol>://<public_ip>:<node_port>/mfpconsole を使用して、IBM Operations Console にアクセスできます。
IBM MobileFirst Analytics Console には、<protocol>://<public_ip>:<port>/analytics/console を使用してアクセスできます。 プロトコルには、http または https を使用できます。 また、NodePort デプロイメントの場合、ポートは NodePort になることに注意してください。 インストールされている チャートの IP アドレスおよび NodePort を取得するには、Kubernetes ダッシュボードで以下の手順に従います。

• パブリック IP を取得するには - 「Kubernetes」 > 「ワーカー・ノード (Worker Nodes)」を選択し、「パブリック IP (Public IP)」で IP アドレスをメモします。
• ノード・ポートは、Kubernetes ダッシュボードで見つけることができます。「サービス」を選択し、「内部エンドポイント (internal endpoints)」で「TCP ノード・ポート (TCP Node Port)」のエントリー (5 桁のポート) をメモします。

コンソールにアクセスするための NodePort アプローチに加えて、サービスには、Ingress ホスト経由でアクセスすることもできます。

以下のステップに従ってコンソールにアクセスします。

1. IBM Cloud ダッシュボードに移動します。
2. Analytics/Server/AppCenter がデプロイされている Kubernetes クラスターを選択し、「概要」ページを開きます。
3. 入口ホスト名の Ingress サブドメインを見つけ、以下のようにコンソールにアクセスします。
   • IBM Mobile Foundation Operational コンソールにアクセスする場合、 <protocol>://<ingress-hostname>/mfpconsole を使用します。
   • IBM Mobile Foundation Analytics コンソールにアクセスする場合、 <protocol>://<ingress-hostname>/analytics/console を使用します。
   • IBM Mobile Foundation Application Center コンソールにアクセスする場合、 <protocol>://<ingress-hostname>/appcenterconsole を使用します。
4. nginx 入口では、SSL サービス・サポートはデフォルトでは無効になっています。 https を介してコンソールにアクセスするとき、接続に注意してください。 以下の手順に従い、入口で SSL サービスを有効にします。
   1. IBM Cloud Kubernetes クラスター・ページから、Kubernetes ダッシュボードを起動します。
   2. 左側のパネルで、「入口 (Ingresses)」オプションをクリックします。
   3. 入口名を選択します。
   4. 右上の「編集」ボタンをクリックします。
   5. yaml ファイルを変更し、ssl-services アノテーションを追加します。 例:

    "annotations": {
      "ingress.bluemix.net/ssl-services": "ssl-service=my_service_name1;ssl-service=my_service_name2",
      .....
      ....
      ...
      ...
    }
   

   1. 「更新」をクリックします。

注: ポート 9600 は、Kubernetes サービスで内部的に公開され、 Analytics インスタンスによってトランスポート・ポートとして使用されます。

サンプル・アプリケーション

IBM Cloud Kubernetes クラスターで実行される IBM MobileFirst Server 上にサンプル・アダプターをデプロイし、サンプル・アプリケーションを実行するには、 チュートリアルを参照してください。

Helm チャートおよびリリースのアップグレード

Helm チャート/リリースをアップグレードする方法については、バンドル製品のアップグレードを参照してください。

Helm リリース・アップグレードのサンプル・シナリオ

1. values.yaml の値の変更によって Helm リリースをアップグレードするには、--set フラグを指定した helm upgrade コマンドを使用します。 -set フラグは複数回指定できます。 コマンド・ラインで指定された右端のセットの優先順位が最も高くなります。

     helm upgrade --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
   

2. ファイル内に値を指定して Helm リリースをアップグレードするには、-f フラグを指定した helm upgrade コマンドを使用します。 –values フラグまたは -f フラグは複数回使用できます。 コマンド・ラインで指定された右端のファイルの優先順位が最も高くなります。 以下の例で、myvalues.yaml と override.yaml の両方に Test というキーが含まれている場合、override.yaml に設定された値が優先されます。

     helm upgrade -f myvalues.yaml -f override.yaml <existing-helm-release-name> <path of new helm chart>
   

3. 最後のリリースの値を再利用し、値の一部をオーバーライドすることによって Helm リリースをアップグレードするには、以下のようなコマンドを使用できます。

     helm upgrade --reuse-values --set <name>=<value> --set <name>=<value> <existing-helm-release-name> <path of new helm chart>
   

アンインストール

MobileFirst Server および MobileFirst Analytics をアンインストールするには、Helm CLI を使用します。 以下のコマンドを使用して、インストールされているチャートおよび関連するデプロイメントを完全に削除します。

helm delete --purge <release_name>

release_name は、デプロイ済みの Helm チャートのリリース名です。

トラブルシューティング

このセクションでは、Mobile Foundation のデプロイ中に発生する可能性のあるエラー・シナリオの特定および解決についてガイドします。

1. Helm のインストールが失敗した。 エラー: 使用可能なティラー・ポッドが見つかりません (Error: could not find a ready tiller pod)

• 以下の一連のコマンドをそのまま実行し、helm のインストールを再試行します。

    helm init
    kubectl create serviceaccount --namespace kube-system tiller
    kubectl create clusterrolebinding tiller-cluster-rule --clusterrole=cluster-admin --serviceaccount=kube-system:tiller
    kubectl patch deploy --namespace kube-system tiller-deploy -p '{"spec":{"template":{"spec":{"serviceAccount":"tiller"}}}}'
    helm init --service-account tiller --upgrade
  

1. Helm チャートのデプロイ中にイメージをプルできない - イメージをプルできません。エラー: ErrImagePull (Failed to pull image, Error: ErrImagePull)

• helm のデプロイメントの前に pullSecret イメージが values.yaml に追加されていることを確認します。 イメージ・プル秘密が存在しない場合、プル秘密を作成し、それを values.yaml ファイル内の image.pullSecret に割り当てます。

プル秘密の作成例:

 kubectl create secret docker-registry iks-secret-name --docker-server=us.icr.io --docker-username=iamapikey --docker-password=Your_IBM_Cloud_API_key --docker-email=your_email_id

注: 認証のために IBM Cloud API 鍵を使用する場合、--docker-username=iamapikey の値をそのまま保持します。

1. 入口を通じてコンソールにアクセスしている最中に接続の問題が発生する

• この問題を解決するには、Kubernetes ダッシュボードを起動し、「入口 (Ingresses)」オプションを選択します。 入口 yaml を編集し、以下のように入口ホストの詳細を追加します。

  例:

  
  "spec": {
      "tls": [
        {
          "hosts": [
            “ingress_host_name”
          ],
          "secretName": "ingress-secret-name"
        }
      ],
      "rules": [
        {
       ….
   ….