Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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 menetapkan 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 Kubernetes
Kf.
Temukan nama jenis resource Kubernetes yang ingin Anda pecahkan masalahnya dengan
mencantumkan semua resource Kf:
kubectl get apps.kf.dev my-app -n my-space -o yaml
Pilih masalah Anda dari tab di bawah:
Objek tidak direkonsiliasi
Periksa nilai metadata.generation. Jumlah ini bertambah setiap kali objek diperbarui. Jika jumlahnya sangat tinggi, kemungkinan
ada dua pengontrol Kubernetes yang memperebutkan objek. Periksa
kluster Anda untuk melihat apakah ada kebijakan yang diterapkan ke objek
yang mungkin mengubahnya dari status yang diinginkan.
Periksa apakah namespace yang menjadi bagian dari objek dihapus. Jika
ya, objek mungkin tidak akan direkonsiliasi.
Pastikan kolom status.observedGeneration ada. Jika tidak,
pengontrol mungkin belum dieksekusi terhadap objek. Validasi
bahwa cluster dan pengontrol berfungsi dengan baik menggunakan kf doctor.
Pastikan kolom metadata.generation cocok dengan
kolom status.observedGeneration. Jika tidak, validasikan bahwa
cluster dan pengontrol berfungsi dengan baik menggunakan kf doctor.
Periksa kegagalan dalam daftar status.conditions berdasarkan daftar
alasan error umum ini:
NotOwned: Ada resource lain yang ada di cluster atau
namespace seperti 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
atau konfigurasi Kf yang menyebabkan
resource turunan tidak direkonsiliasi dengan 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
Pastikan metadata.deletionTimestamp objek telah ditetapkan. Jika tidak
ditetapkan, penghapusan yang diminta tidak akan berfungsi.
Pastikan metadata.deletionTimestamp objek sudah berlalu. Jika di masa mendatang, objek mungkin tidak dihapus.
Periksa apakah daftar metadata.finalizers ada di objek. Jika finalizer
ada, objek harus menunggu finalizer dihapus sebelum
dihapus. Jika Anda ingin memaksa penghapusan tanpa menunggu
finalizer, edit objek untuk menghapusnya.
Mungkin ada objek turunan yang mencegah objek tersebut
dihapus. Minta administrator memeriksa semua objek di namespace dan
cluster untuk melihat apakah salah satunya perlu dihapus secara manual terlebih dahulu.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[],[],null,["# Troubleshoot Kf\n\nUse these steps to troubleshoot various issues that can occur when running Kf.\n\n\u003cbr /\u003e\n\nFailures when installing Kf\n---------------------------\n\n### Error from server (Bad Request): Invalid character\n\nIf you see this error when setting config defaults, it is likely the value of the `${DOMAIN}` env var used in the command includes an escaped '$'. Use single quotes to define a domain with a space name or other substitution: \n\n Error from server (BadRequest): invalid character '$' in string escape code\n\nErrors with Kf Kubernetes objects\n---------------------------------\n\nFollow these instructions to troubleshoot Kf Kubernetes\nobjects.\n\n1. Find the name of the Kubernetes resource type you want to troubleshoot by\n listing all Kf resources:\n\n kubectl api-resources --api-group=kf.dev\n\n Example output: \n\n NAME SHORTNAMES APIGROUP NAMESPACED KIND\n apps kf.dev true App\n builds kf.dev true Build\n clusterservicebrokers kf.dev false ClusterServiceBroker\n routes kf.dev true Route\n servicebrokers kf.dev true ServiceBroker\n serviceinstancebindings kf.dev true ServiceInstanceBinding\n serviceinstances kf.dev true ServiceInstance\n spaces kf.dev false Space\n\n2. Get the instance of the resource you want to troubleshoot using `kubectl`.\n If the object isn't in a namespace, omit the `-n` flag:\n\n kubectl get \u003cvar translate=\"no\"\u003eapi-resource-name\u003c/var\u003e.kf.dev \u003cvar translate=\"no\"\u003eobject-name\u003c/var\u003e -n \u003cvar translate=\"no\"\u003espace-name\u003c/var\u003e -o yaml\n\n For example: \n\n kubectl get apps.kf.dev my-app -n my-space -o yaml\n\n3. Select your problem from the tabs below:\n\n ### Object isn't reconciling\n\n 1. Check the value of `metadata.generation`. This number is incremented each time the object is updated. If the number is extremely high it's likely two Kubernetes controllers are fighting over the object. Check your cluster to see if any policies are being applied to the object which might be changing it from the desired state.\n 2. Check to see if the namespace the object belongs to is deleting. If it is, the object may not be reconciled.\n 3. Check that the `status.observedGeneration` field exists. If it doesn't, the controller might not have executed against the object yet. Validate that the cluster and controllers are healthy using `kf doctor`.\n 4. Check that the `metadata.generation` field matches the `status.observedGeneration` field. If it doesn't, validate that the cluster and controllers are healthy using `kf doctor`.\n 5. Check for failures in the `status.conditions` list against this list of\n common error reasons:\n\n - `NotOwned`: There is another resource that exists in the cluster or namespace as the one this object is trying to create. Read the message to find the duplicate name and either rename the conflicting resource or the Kf object.\n - `TemplateError`: There is a misconfiguration in the Kf resource spec or Kf configuration causing the child resource to be incorrectly reconciled. Validate the settings of the Kf object and the Kf space.\n - `CacheOutdated`: The Kf controller isn't receiving updates from Kubernetes fast enough. Check the health of the Kubernetes cluster.\n - `ReconciliationError`: The Kf controller can't create the necessary child resource. Check to make sure your cluster is healthy, Kf is running, and that there are no policies being enforced that are preventing Kf from creating the object referenced in the message.\n\n ### Object isn't deleting\n\n 1. Check that the `metadata.deletionTimestamp` of the object was set. If it wasn't set, then the requested deletion didn't work.\n 2. Check that the `metadata.deletionTimestamp` of the object is in the past. If it's in the future, the object may not delete.\n 3. Check if a `metadata.finalizers` list exists on the object. If finalizers are present, the object must wait for them to be removed before it is deleted. If you want to force a deletion without waiting for the finalizers, edit the object to remove them.\n 4. Child objects may exist that are preventing the object from being deleted. Have an administrator check all objects in the namespace and cluster to see if one of them needs to be manually deleted first."]]