Kf のトラブルシューティング

Kf の実行時に発生する可能性のあるさまざまな問題のトラブルシューティング手順について説明します。

Kf インストール時の障害

Error from server (Bad Request): Invalid character

このエラーが構成のデフォルト設定時に表示された場合、コマンド内の ${DOMAIN} 環境変数の値に、エスケープされた「$」が含まれている可能性があります。一重引用符を使用して、スペース名など代わりとなるものでドメインを定義してください。

Error from server (BadRequest): invalid character '$' in string escape code

Kf Kubernetes オブジェクトのエラー

以下の手順に沿って、Kf Kubernetes オブジェクトのトラブルシューティングを行います。

  1. すべての Kf リソースを一覧表示して、トラブルシューティングする Kubernetes リソースタイプの名前を見つけます。

    kubectl api-resources --api-group=kf.dev

    出力例:

    NAME                      SHORTNAMES   APIGROUP   NAMESPACED   KIND
apps                                   kf.dev     true         App
builds                                 kf.dev     true         Build
clusterservicebrokers                  kf.dev     false        ClusterServiceBroker
routes                                 kf.dev     true         Route
servicebrokers                         kf.dev     true         ServiceBroker
serviceinstancebindings                kf.dev     true         ServiceInstanceBinding
serviceinstances                       kf.dev     true         ServiceInstance
spaces                                 kf.dev     false        Space

  2. kubectl を使用して、トラブルシューティングするリソースのインスタンスを取得します。オブジェクトが Namespace にない場合は、-n フラグを省略します。

    kubectl get api-resource-name.kf.dev object-name -n space-name -o yaml

    次に例を示します。

    kubectl get apps.kf.dev my-app -n my-space -o yaml

  3. 下のタブから問題を選択します。

    整合性の問題

    1. metadata.generation の値を確認します。この数は、オブジェクトが更新されるたびに増加します。この数が非常に大きい場合は、2 つの Kubernetes コントローラがオブジェクトに対して競合している可能性が考えられます。クラスタをチェックし、なんらかのポリシーが適用されることによって、あるべき状態からオブジェクトが変化しているかどうかを確認します。
    2. オブジェクトが属する Namespace が削除されているかどうかを確認します。削除されている場合は、オブジェクトが整合性のために調整されない可能性があります。
    3. status.observedGeneration フィールドが存在することを確認します。存在していない場合は、コントローラがオブジェクトに対してまだ実行されていない可能性があります。kf doctor を使用して、クラスタとコントローラが正常であることを確認します。
    4. metadata.generation フィールドが status.observedGeneration フィールドと一致していることを確認します。一致していない場合は、kf doctor を使用してクラスタとコントローラが正常な状態であることを確認します。

    5. よくあるエラーの原因を示した次のリストに照らし合わせて、status.conditions リストに障害がないかどうかを確認します。

      • NotOwned: クラスタまたは名前空間に、このオブジェクトが作成しようとしているリソースがすでに存在します。メッセージを読んで重複している名前を探し、競合しているリソースまたは Kf オブジェクトの名前を変更します。
      • TemplateError: Kf リソース仕様または Kf 構成に設定ミスがあり、子リソースが間違った形に調整されています。Kf オブジェクトと Kf スペースの設定を確認します。
      • CacheOutdated: Kf コントローラが Kubernetes からのアップデートを十分な早さで受信していません。Kubernetes クラスタの状態を確認します。
      • ReconciliationError: Kf コントローラが、必要な子リソースを作成できません。クラスタが正常な状態であること、Kf が実行中であること、メッセージで示されているオブジェクトを Kf で作成できなくなるポリシーが適用されていないことを確認します。

    削除の問題

    1. オブジェクトの metadata.deletionTimestamp が設定されていることを確認します。設定されていない場合、リクエストされた削除は機能しません。
    2. オブジェクトの metadata.deletionTimestamp が過去を示していることを確認します。未来を示している場合は、オブジェクトが削除されない可能性があります。
    3. オブジェクトに metadata.finalizers リストが存在するかどうかを確認します。存在する場合、ファイナライザが削除されてからでなければオブジェクトを削除できません。ファイナライザを待たずに削除を強制する場合は、オブジェクトを編集してファイナライザを削除します。
    4. オブジェクトの削除を妨げる子オブジェクトが存在する場合があります。Namespace とクラスタ内のすべてのオブジェクトをチェックして、いずれかを手動で削除する必要があるかどうかを確認するよう、管理者に依頼してください。