Memecahkan masalah Kf

Gunakan langkah-langkah ini untuk memecahkan berbagai masalah yang dapat terjadi saat menjalankan Kf.

Kegagalan saat menginstal Kf

Error dari server (Permintaan Tidak Valid): Karakter tidak valid

Jika Anda melihat error ini saat menyetel default konfigurasi, kemungkinan nilai variabel lingkungan ${DOMAIN} yang digunakan dalam perintah menyertakan '$' yang di-escape. Gunakan tanda petik tunggal untuk menentukan domain dengan nama spasi atau penggantian lainnya:

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

Error dengan objek Kubernetes Kf

Ikuti petunjuk berikut untuk memecahkan masalah objek Kf Kubernetes.

  1. Temukan nama jenis resource Kubernetes yang ingin Anda pecahkan masalahnya dengan mencantumkan semua resource Kf:

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

    Contoh output:

    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. Dapatkan instance resource yang ingin Anda selesaikan masalahnya menggunakan kubectl. Jika objek tidak ada di namespace, hapus tanda -n:

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

    Contoh:

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

  3. Pilih masalah Anda dari tab di bawah:

    Objek tidak disesuaikan

    1. Periksa nilai metadata.generation. Nomor ini bertambah setiap kali objek diperbarui. Jika angkanya sangat tinggi, kemungkinan ada dua pengontrol Kubernetes yang memperebutkan objek. Periksa cluster Anda untuk melihat apakah ada kebijakan yang diterapkan ke objek yang mungkin mengubahnya dari status yang diinginkan.
    2. Periksa apakah namespace tempat objek berada sedang dihapus. Jika ya, objek mungkin tidak disesuaikan.
    3. Periksa apakah kolom status.observedGeneration ada. Jika tidak, pengontrol mungkin belum dieksekusi terhadap objek. Validasi bahwa cluster dan pengontrol responsif menggunakan kf doctor.
    4. Pastikan kolom metadata.generation cocok dengan kolom status.observedGeneration. Jika tidak, validasi bahwa cluster dan pengontrol responsif menggunakan kf doctor.

    5. Periksa kegagalan dalam daftar status.conditions terhadap daftar alasan umum error berikut:

      • NotOwned: Ada resource lain yang ada di cluster atau namespace yang sama dengan yang coba dibuat oleh objek ini. Baca pesan untuk menemukan nama duplikat dan ganti nama resource yang bertentangan atau objek Kf.
      • TemplateError: Ada kesalahan konfigurasi dalam spesifikasi resource Kf atau konfigurasi Kf yang menyebabkan resource turunan direkonsiliasi secara tidak benar. Validasi setelan objek Kf dan ruang Kf.
      • CacheOutdated: Pengontrol Kf tidak menerima update dari Kubernetes dengan cukup cepat. Periksa kondisi cluster Kubernetes.
      • ReconciliationError: Pengontrol Kf tidak dapat membuat resource turunan yang diperlukan. Periksa untuk memastikan cluster Anda dalam kondisi baik, Kf berjalan, dan tidak ada kebijakan yang diterapkan yang mencegah Kf membuat objek yang dirujuk dalam pesan.

    Objek tidak dihapus

    1. Periksa apakah metadata.deletionTimestamp objek telah ditetapkan. Jika tidak disetel, berarti penghapusan yang diminta tidak berhasil.
    2. Periksa apakah metadata.deletionTimestamp objek sudah berlalu. Jika di masa mendatang, objek mungkin tidak dihapus.
    3. Periksa apakah daftar metadata.finalizers ada di objek. Jika finalizer ada, objek harus menunggu hingga finalizer dihapus sebelum objek dihapus. Jika Anda ingin menghapus secara paksa tanpa menunggu finalizer, edit objek untuk menghapusnya.
    4. Objek turunan mungkin ada yang mencegah objek dihapus. Minta administrator memeriksa semua objek di namespace dan cluster untuk melihat apakah salah satunya perlu dihapus secara manual terlebih dahulu.