トラブルシューティング

手順

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

  $ microshift version

  Copy to Clipboard Toggle word wrap

  出力例

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

  Copy to Clipboard Toggle word wrap

手順

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

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

  Copy to Clipboard Toggle word wrap

  出力例

  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

  Copy to Clipboard Toggle word wrap

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

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

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

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

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

  $ sudo journalctl -u microshift

  Copy to Clipboard Toggle word wrap

手順

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

  $ sudo systemctl status microshift

  Copy to Clipboard Toggle word wrap

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

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

  $ sudo journalctl -u microshift

  Copy to Clipboard Toggle word wrap

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

  $ oc get pods -A

  Copy to Clipboard Toggle word wrap

手順

• /etc/microshift/config.yaml ファイルを編集して、memoryLimitMB 値を設定します。

  etcd:
    memoryLimitMB: 128

  Copy to Clipboard Toggle word wrap
  注記

  MicroShift の memoryLimitMB の最小許容値は 128 MB です。最小値に近い値は、etcd のパフォーマンスに影響を与える可能性が高くなります。制限が低いほど、etcd がクエリーに応答するまでにかかる時間が長くなります。制限が低すぎる場合、または etcd の使用量が多い場合、クエリーはタイムアウトになります。

手順

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

  $ sudo journalctl -u microshift

  Copy to Clipboard Toggle word wrap

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

  $ sudo journalctl -u greenboot-healthcheck

  Copy to Clipboard Toggle word wrap

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

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

  Copy to Clipboard Toggle word wrap

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

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

    $ sudo journalctl --list-boots

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

手順

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

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

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

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

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

  Copy to Clipboard Toggle word wrap

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

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

  Copy to Clipboard Toggle word wrap

前提条件

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