トラブルシューティング

手順

• 次のコマンドを実行して、バージョン情報を確認します。

  $ microshift version

  出力例

  Red Hat build of MicroShift Version: 4.15-0.microshift-e6980e25
  Base OCP Version: 4.15

手順

• OpenShift CLI (oc) を使用してバージョン番号を取得するには、次のコマンドを実行して kube-public/microshift-version 設定マップを表示します。

  $ oc get configmap -n kube-public microshift-version -o yaml

  出力例

  apiVersion: v1
  data:
    major: "4"
    minor: "13"
    version: 4.13.8-0.microshift-fa441af87431
  kind: ConfigMap
  metadata:
    creationTimestamp: "2023-08-03T21:06:11Z"
    name: microshift-version
    namespace: kube-public

手順

• ベースデータベースのバージョン情報を表示するには、次のコマンドを実行します。

  $ microshift-etcd version

  出力例

  microshift-etcd Version: 4.15.1
  Base etcd Version: 3.5.10

• データベースの完全なバージョン情報を表示するには、次のコマンドを実行します。

  $ microshift-etcd version -o json

  出力例

  {
    "major": "4",
    "minor": "15",
    "gitVersion": "4.15.1",
    "gitCommit": "2e182312718cc9d267ec71f37dc2fbe2eed01ee2",
    "gitTreeState": "clean",
    "buildDate": "2024-01-09T06:51:40Z",
    "goVersion": "go1.20.10",
    "compiler": "gc",
    "platform": "linux/amd64",
    "patch": "",
    "etcdVersion": "3.5.10"
  }

• システムの起動後、数分間待たずに MicroShift を正常に停止したため。バックアップを正常に実行するには、システムがヘルスチェックとその他のバックグラウンドプロセスを完了する必要があります。

• MicroShift がエラーのために実行を停止した場合、データのバックアップを実行することはできません。

  • システムが健全な状態であることを確認してください。
  • バックアップを試みる前に、健全な状態で停止してください。
• データ用の十分なストレージがない場合、バックアップは失敗します。MicroShift データ用に十分なストレージがあることを確認してください。
• 十分な権限がない場合、バックアップが失敗する可能性があります。バックアップの作成および必要な設定を実行するための正しいユーザー権限があることを確認してください。

• 手動バックアップ中にログがコンソールに出力されます。

• rpm-ostree システムの自動バックアップのログは、MicroShift ジャーナルログの一部として自動的に生成されます。次のコマンドを実行してログを確認できます。

  $ sudo journalctl -u microshift

手順

• 次のコマンドを実行すると、クラスターのステータスが返され、システムのステータスを確認できます。

  $ sudo systemctl status microshift

  MicroShift の起動に失敗した場合、このコマンドは前回の実行時のログを返します。

• オプション: 次のコマンドを実行してログを表示できます。

  $ sudo journalctl -u microshift

• オプション: MicroShift が実行中の場合は、次のコマンドを入力してアクティブな Pod を表示できます。

  $ oc get pods -A

手順

• 次のコマンドを実行して、MicroShift ジャーナルログを確認します。

  $ sudo journalctl -u microshift

• 次のコマンドを実行して、Greenboot ジャーナルログを確認します。

  $ sudo journalctl -u greenboot-healthcheck

• 次のコマンドを実行して、特定のサービスの起動に関するジャーナルログを確認します。

  $ sudo journalctl --boot <boot> -u <service-name>

• 特定のブートの詳しいログを調べるには、次の 2 つのステップを使用します。まずブートをリストし、取得したリストから必要なものを選択します。

  • 次のコマンドを実行して、ジャーナルログに存在するブートをリスト表示します。

    $ sudo journalctl --list-boots

  • 次のコマンドを実行して、必要なブートのジャーナルログを確認します。

    $ sudo journalctl --boot <-my-boot-number>

手順

• ヘルスチェックステータスのレポートを表示するには、次のコマンドを使用します。

  $ systemctl show --property=SubState --value greenboot-healthcheck.service

  • start が出力される場合、greenboot チェックがまだ実行中であることを意味します。
  • exited が出力される場合、チェックが合格し、greenboot が終了したことを意味します。Greenboot は、システムが正常な状態の場合、green.d ディレクトリー内のスクリプトを実行します。
  • failed の出力は、チェックが合格しなかったことを意味します。システムがこの状態にある場合、Greenboot は red.d ディレクトリー内のスクリプトを実行し、システムを再起動する可能性があります。

• サービスの数値終了コードを示すレポートを表示するには、次のコマンドを使用します。0 は成功を、0 以外の値は失敗を意味します。

  $ systemctl show --property=ExecMainStatus --value greenboot-healthcheck.service

• Boot Status is GREEN - Health Check SUCCESS など、ブートステータスに関するメッセージを表示するレポートを表示するには、次のコマンドを使用します。

  $ cat /run/motd.d/boot-status

前提条件

• jq がインストールされている。
• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。