Serverless アプリケーション

手順

1. 以下を使用して、サンプル YAML ファイルを serving.yaml にコピーし、これを適用します。

   $ oc apply -f serving.yaml

   Copy to Clipboard Toggle word wrap

2. 以下のコマンドを使用して、インストールが完了したことを確認します。

   $ oc get knativeserving/knative-serving -n knative-serving --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   Copy to Clipboard Toggle word wrap

   結果は以下のようになります。

   DeploymentsAvailable=True
   InstallSucceeded=True
   Ready=True

   Copy to Clipboard Toggle word wrap

手順

1. Knative Serving を削除するには、以下のコマンドを使用します。

   $ oc delete knativeserving knative-serving -n knative-serving

   Copy to Clipboard Toggle word wrap

2. コマンドが実行され、すべての Pod が knative-serving namespace から削除された後に、以下のコマンドを使用して namespace を削除します。

   $ oc delete namespace knative-serving

   Copy to Clipboard Toggle word wrap

手順

1. 以下のコマンドを実行して残りの Knative Serving CRD を削除します。

   $ oc delete crd knativeservings.serving.knative.dev

   Copy to Clipboard Toggle word wrap

手順

1. service.yaml ファイルが含まれているディレクトリーに移動します。

2. service.yaml ファイルを使用してアプリケーションをデプロイします。

   $ oc apply --filename service.yaml

   Copy to Clipboard Toggle word wrap

手順

1. OpenShift Container Platform Web コンソールで、Catalog → OperatorHub に移動し、アプリケーションが置かれている namespace に Prometheus Operator をインストールします。
2. Catalog → Developer Catalog に移動し、同じ namespace に Prometheus、Alertmanager、Prometheus Rule、および Service Monitor をインストールします。

手順

1. ServiceMonitor オブジェクトがデプロイされていることを確認します。

   $ oc get servicemonitor -n knative-serving
   NAME         AGE
   activator    11m
   autoscaler   11m
   controller   11m

   Copy to Clipboard Toggle word wrap

2. openshift.io/cluster-monitoring=true ラベルが Knative Serving namespace に追加されていることを確認します。

   $ oc get namespace knative-serving --show-labels
   NAME              STATUS   AGE   LABELS
   knative-serving   Active   4d    istio-injection=enabled,openshift.io/cluster-monitoring=true,serving.knative.dev/release=v0.7.0

   Copy to Clipboard Toggle word wrap

手順

1. OpenShift Container Platform Web コンソールに移動し、認証します。
2. Monitoring → Metrics に移動します。

3. Expression に入力し、Run queries を選択します。Knative Serving Autoscaler Pod をモニターするには、以下のサンプル式を使用します。

   autoscaler_actual_pods

   Copy to Clipboard Toggle word wrap

   これで、Knative Serving Autoscaler Pod のモニタリング情報をコンソールで表示できます。

手順

1. Elasticsearch の仮想化ツール Kibana UI を開くには、 以下のコマンドを使用して Kibana ルートを取得します。

   $ oc -n openshift-logging get route kibana

   Copy to Clipboard Toggle word wrap
2. ルートの URL を使用して Kibana ダッシュボードに移動し、ログインします。
3. インデックスが .all に設定されていることを確認します。インデックスが .all に設定されていない場合、OpenShift システムログのみが一覧表示されます。

4. knative-serving namespace を使用してログをフィルターできます。kubernetes.namespace_name:knative-serving を検索ボックスに入力して結果をフィルターします。

   注記

   Knative Serving はデフォルトで構造化ロギングを使用します。クラスターロギング Fluentd 設定をカスタマイズしてこれらのログの解析を有効にできます。これにより、ログの検索がより容易になり、ログレベルでのフィルターにより問題を迅速に特定できるようになります。

手順

1. 以下のコマンドを使用して、Kibana の URL を見つけます。

   $ oc -n cluster-logging get route kibana`

   Copy to Clipboard Toggle word wrap
2. URL をブラウザーに入力し、Kibana UI を開きます。
3. インデックスが .all に設定されていることを確認します。インデックスが .all に設定されていない場合、OpenShift システムログのみが一覧表示されます。

4. サービスがデプロイされている Kubernetes namespace を使用してログをフィルターします。フィルターを追加してサービス自体を特定します: kubernetes.namespace_name:default AND kubernetes.labels.serving_knative_dev\/service:{SERVICE_NAME}

   注記

   /configuration または /revision を使用してフィルターすることもできます。

5. kubernetes.container_name:<user-container> を使用して検索を絞り込み、ご使用のアプリケーションで生成されるログのみを表示することができます。それ以外の場合は、queue-proxy からのログが表示されます。

   注記

   アプリケーションで JSON ベースの構造化ロギングを使用することで、実稼働環境でのこれらのログの迅速なフィルターを実行できます。

手順

1. Red Hat OpenShift Cluster Manager サイトの Infrastructure Provider ページから、選択するインストールタイプのページに移動し、Download Command-line Tools をクリックします。

2. 表示されているサイトから、オペレーティングシステムの圧縮されたファイルをダウンロードします。

   注記

   oc は Linux、Windows、または macOS にインストールできます。

3. 圧縮ファイルを展開して、指定のパスにあるディレクトリーに配置します。

手順

1. イメージからサービスを デフォルト namespace に作成します。

   $ kn service create hello --image gcr.io/knative-samples/helloworld-go --env TARGET=Knative
   Creating service 'hello' in namespace 'default':
   
     0.085s The Route is still working to reflect the latest desired specification.
     0.101s Configuration "hello" is waiting for a Revision to become ready.
    11.590s ...
    11.650s Ingress has not yet been reconciled.
    11.726s Ready to serve.
   
   Service 'hello' created with latest revision 'hello-gsdks-1' and URL:
   http://hello.default.apps-crc.testing

   Copy to Clipboard Toggle word wrap

2. サービスを一覧表示します。

   $ kn service list
   NAME    URL                                     LATEST          AGE     CONDITIONS   READY   REASON
   hello   http://hello.default.apps-crc.testing   hello-gsdks-1   8m35s   3 OK / 3     True

   Copy to Clipboard Toggle word wrap

3. curl サービスエンドポイントコマンドを使用して、サービスが機能しているかどうかを確認します。

   $ curl http://hello.default.apps-crc.testing
   
   Hello Knative!

   Copy to Clipboard Toggle word wrap

4. サービスを更新します。

   $ kn service update hello --env TARGET=Kn
   Updating Service 'hello' in namespace 'default':
   
    10.136s Traffic is not yet migrated to the latest revision.
    10.175s Ingress has not yet been reconciled.
    10.348s Ready to serve.
   
   Service 'hello' updated with latest revision 'hello-dghll-2' and URL:
   http://hello.default.apps-crc.testing

   Copy to Clipboard Toggle word wrap

   サービスの環境変数 TARGET が Kn に設定されます。

5. サービスを記述します。

   $ kn service describe hello
   Name:       hello
   Namespace:  default
   Age:        13m
   URL:        http://hello.default.apps-crc.testing
   Address:    http://hello.default.svc.cluster.local
   
   Revisions:
     100%  @latest (hello-dghll-2) [2] (1m)
           Image:  gcr.io/knative-samples/helloworld-go (pinned to 5ea96b)
   
   Conditions:
     OK TYPE                   AGE REASON
     ++ Ready                   1m
     ++ ConfigurationsReady     1m
     ++ RoutesReady             1m

   Copy to Clipboard Toggle word wrap

6. サービスを削除します。

   $ kn service delete hello
   Service 'hello' successfully deleted in namespace 'default'.

   Copy to Clipboard Toggle word wrap

   次に、hello サービスに対して list を試行することにより、このサービスが削除されていることを確認できます。

   $ kn service list hello
   No services found.

   Copy to Clipboard Toggle word wrap