OpenShift ユーザエクスペリエンス

シナリオ

このラボでは、Red Hat OpenShift Container Platform でアプリケーションをデプロイするデモを行います。デプロイしたアプリの詳細情報を閲覧します。 また、OperatorHub から Operator をインストールします。

ゴール

• Web コンソールのパースペクティブ(DeveloperとAdministrator)を理解
• Gitリポジトリからアプリケーションをビルドしてデプロイ
• デプロイしたアプリを、ウェブコンソールのトポロジービューを通して確認
• OperatorHub から Operator をインストール

Developer パースペクティブ

OpenShift Container PlatformのWebコンソールには、Administrator パースペクティブとDeveloperパースペクティブの2つのパースペクティブがあります。Developerパースペクティブでは、開発者のユースケースに特化したワークフローを提供します。

• Developerパースペクティブに切り替えます。

  アプリケーションを作成するためのオプションを持つTopologyビューが表示されます。

Project 作成

プロジェクトによって、あるユーザーのコミュニティが他のコミュニティから切り離された状態でコンテンツを整理・管理できます。プロジェクトはKubernetesネームスペースに対するOpenShiftの拡張で、ユーザーのセルフプロビジョニングを可能にする機能を追加したものです。 ほとんどの場合に互換性があります。

• Project ドロップダウンメニューをクリック -> Create Project を選択します。

NOTE:

異なるプロジェクトはそれぞれに対応した異なるユーザー権限とクォータを持つことができます

• Name を <英字氏名>-test として、プロジェクトを作成します。 例） yamadataro-test

  プロジェクトが <英字氏名>-test に切り替わったことを確認します。

  　プロジェクト名はOpenShiftクラスタ内で一意である必要があります。

アプリケーションデプロイメント

Web コンソールの Developer パースペクティブでは、Add ビューからアプリケーションおよび関連サービスを作成できます。OpenShift Container Platform にデプロイするためにはいくつかのオプションがあります（例 Dockerfile、Git、Catalog、YAMLなど）。

• Devfile：これはDevfilev2仕様を使用してアプリケーションスタックを作成します。devfile.yamlリポジトリには、Devfilev2形式で名前が付けられたファイルが含まれている必要があります。
• Dockerfile：これにより、既存のDockerfileからコンテナイメージが作成されます。
• ビルダーイメージ：これは、Source-to-Imageと呼ばれるメカニズムを使用して、ソースコードから直接コンテナーイメージを自動的に作成します。

本手順では、GitHub にある既存のコードベースを利用して、OpenShift Container Platform上でアプリケーションを作成、構築、デプロイします。Developerパースペクティブでアプリケーションを作成するための Import from git オプションを使います。

アプリケーションの作成

• Add ビューで Import From Git をクリックし、Import from Git フォームを表示します。

• Git セクションで、アプリケーションの作成に使用するコードベースの Git リポジトリー URL を入力します。

https://github.com/sclorg/nodejs-ex.git

• Edit Import Strategy をあえて選択し、適切なビルダーイメージが検出されているかを確認します。

  • Builder セクションで、URL の検証後に、自動的に選択されます（スターのマークが付きます）。
  • ビルダーイメージが自動検出されていない場合は、ビルダーイメージを選択します。必要に応じて、Builder Image Version のドロップダウンリストを使用してバージョンを変更できます。

• General セクションで、以下を確認します（特に変更不要です）。

  • Application ：アプリケーションを分類するために一意の名前 (nodejs-ex-app など) を入力します。
  • Name ：このアプリケーション用に作成されたリソースを分類するために一意な名前を入力します。これは Git リポジトリー URL をベースとして自動的に設定されます。

• Resources セクションで、デフォルトのリソース Deployment を選択します

NOTE:

OpenShift Deployment Configsに加えて、Kubernetes Deployments もサポートされています。

• その他の設定は変更せず、Create をクリックします。

NOTE :

Knative Service オプションは、Serverless Operator がクラスターにインストールされている場合にのみ、Import from git 形式で表示されます。

Topology ビュー

1. Web コンソールのDeveloperパースペクティブにあるTopologyビューでは、プロジェクト内のすべてのアプリケーション、そのビルドステータス、およびそれらに関連するコンポーネントとサービスを視覚的に表示します。

NOTE:

• アプリケーションを作成したら、Topology ビューに自動的に移動します。

  • ここでは、アプリケーション Pod のステータスの確認、パブリック URL でのアプリケーションへの迅速なアクセス、ソースコードへのアクセスとその変更、最終ビルドのステータスの確認ができます。

  • ズームインおよびズームアウトにより、特定のアプリケーションの詳細を表示することができます。

  • グラフィカルな表示が表示されない場合は、Web コンソールの右上にある「Topologyビュー」アイコンをクリックします。（下記参照）

以下のように、異なるタイプのリソースオブジェクトのインジケーターと共に、アプリケーションリソース名が追加されます。

• D: Deployment
• DC: Deployment Configs
• SS: StatefulSet
• DS: Daemonset

注: OpenShift Deployment Configsに加えて、Kubernetes Deployments もサポートされていることに注意します。 Kubernetes Deploymentは、Deployment Configs で利用可能な機能の多くを共有しており、OpenShift Container Platform 4.5からはデフォルトのデプロイメントリソースオブジェクトとなっています。

アプリケーションの中心のロゴをクリックすると、右側から詳細画面が表示され、関連するリソースを閲覧することができます。

NOTE:

アイコンの緑のチェックにマウスを合わせると、ビルド Complete と表示され、ビルドが完了していることが分かります。また、右上の四角と矢印のアイコン URL を開くは、アプリケーションに接続するためのへのリンクが提供されています。Github のキャラクター オクトキャット をクリックすると、Github でソースコードの編集を行う事が出来ます。
右ペインの詳細 (Delailes) タブに表示されている青い円の横にある上や下の矢印を押すと、Pod の数の増減が出来ます。簡単にスケールアップ、スケールダウンが出来るオペレーション是非試してみてください。

• 右上の URL を開く アイコンをクリックして、アプリケーションのルートにアクセスしてみてください。

NOTE :

Advanced Options セクションでは、Create a route to the application がデフォルトで選択されるため、公開されている URL を使用してアプリケーションにアクセスできます。 アプリケーションをパブリックルートに公開したくない場合は、チェックボックスをクリアできます。

アプリケーションデプロイメント (dc-metro-map)

各自で実施してみてください。

アプリケーションの作成

• 以下の設定で、アプリケーションをデプロイしてみてください。

  • GitHub レポジトリ URL：

    https://github.com/RedHatGov/openshift-workshops.git
    

  • "Show advanced Git options"を表示し、表示されたメニューから"Context dir"を設定します：

    /dc-metro-map
    

• その他の設定は変更せず、Create をクリックします。

• Route からアプリケーションにアクセスしてみてください。

Monitoring ビューの確認 (OpenShift Monitoring)

Red Hat は最近、モニタリング機能(Kibana)をWebコンソールに統合しました。プロジェクト全体のメトリクスとイベントについてはこちらからご覧ください。

• 左側のパネルで Observeをクリックします。

• Dashboard タブ

  Dashboardタブは、プロジェクトのメトリクスをまとめて表示します。

• Metrics タブ

  Metricsタブは、Prometheus Metricsのカスタムグラフを作成することができます。

• Events タブ

  Eventsタブは、報告されたイベントが一つのストリームとして表示され、フィルターできます。

Pod の確認 (Readiness Probe / Liveness Probes)

Administrator パースペクティブから確認します。

• 左側のメニューから、 Workloads -> Pods を選びます

  • プロジェクトの Pods ページは、プロジェクトの中で現在実行中の全てのPodを表示します。
    • Running, Pending などコンテナの状態を確認することができます。
    • Ready カラムは Readiness チェックにもとづいたコンテナ内アプリケーションの状態が表示されます。

• openshift-workshops-git-XXXXX Pod をリストから選びます。

  • それぞれの Pod ページでは以下が表示されます。
    • Containers セクション
      • イメージ名とコンテナの状態を含む情報が表示されます
      • Podのステータスとそれをホストする OpenShift ノード

• openshift-workshops-git という名前のコンテナをクリックして Container Details ページを開く。

  • アプリケーションコンテナの Readiness Probe と Liveness Probes を確認します。

    NOTE:

    該当のアプリケーションでは、Readiness Probe/Liveness Probesが設定されていません。 詳細な利用法はこちらの情報を参考にしてみてください。

• メトリクス タブ を参照する

  • メモリ、CPU などリソースの使用量が表示されます。
    Memory Usage, CPU Usage, Filesystem のグラフ

• そのほか、各タブを見ていきます。

  • Logs タブ

    • Podのメッセージはここに表示され、更新されるにしたがって追跡することができます。
    • 更新によるログの出力を一時停止および再開することができます。

  • Terminal タブ

    • デバッグやテストのためにコンテナ内でコマンドを実行することができます。

  • Events タブ

    • このリストはPodのDeploymentで何かがおかしいかを探したり、イベントの連鎖を追跡したりするために使えます。

OperatorHub から Operatorのインストール

Administrator パースペクティブから確認します。

OpenShift Pipelineのインストール

• OpenShift Pipelineをインストール
  • Administratorパースペクティブの下の左側のメニューから、Operators → OperatorHubに移動します。
  • 検索ボックスでOpenShift Pipelineを検索し、 表示された結果からRed Hat OpenShift Pipelinesをクリックします。

• 説明ビューで、Install をクリックして、すべてのインストール設定を確認します。

• Update Channelが pipelines-1.8 に設定されていることを確認し、 Install をクリックしてOperatorのインストールを開始します。

• 数秒後、以下のような画面が表示され、インストールが正常に完了します。また、Installed Operatorsの画面の[Status]列を確認することで、インストールステータスが成功であるかどうかを確認できます。

追加のデモ （オプション）

興味のある Operator をインストールしてみてください（OpenShift Logging などなど）。