Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Use estas etapas para resolver vários problemas que podem ocorrer ao executar o Kf.
Falhas ao instalar o Kf
Erro do servidor (Solicitação inválida): caractere inválido
Se você vir esse erro ao definir padrões de configuração, é provável que o valor da variável de ambiente ${DOMAIN} usada no comando inclua um "$" de escape. Use aspas simples para definir um domínio com um nome de espaço ou outra substituição:
Error from server (BadRequest): invalid character '$' in string escape code
Erros com objetos Kf Kubernetes
Siga estas instruções para solucionar problemas em objetos do
Kubernetes KF.
Encontre o nome do tipo de recurso do Kubernetes que você quer solucionar
listando todos os recursos do Kubernetes:
kubectl get apps.kf.dev my-app -n my-space -o yaml
Selecione seu problema nas guias abaixo:
O objeto não está fazendo reconciliação
Verifique o valor de metadata.generation. Esse número é incrementado
sempre que o objeto é atualizado. Quando esse número é extremamente alto, é
provável que dois controladores do Kubernetes estejam lutando pelo objeto. Verifique
o cluster para ver se alguma política está sendo aplicada ao objeto,
o que pode alterar o estado pretendido.
Verifique se o namespace do objeto está sendo excluído. Se estiver,
o objeto poderá não ser reconciliado.
Verifique se o campo status.observedGeneration existe. Caso contrário,
o controlador pode não ter sido executado no objeto ainda. Confira
se o cluster e os controladores estão íntegros usando kf doctor.
Verifique se o campo metadata.generation corresponde ao
campo status.observedGeneration. Caso contrário, confirme se
o cluster e os controladores estão íntegros usando kf doctor.
Verifique se há falhas na lista do status.conditions com esta lista de
motivos comuns de erro:
NotOwned: há outro recurso que existe no cluster ou
no namespace daquele que esse objeto está tentando criar. Leia a mensagem
para encontrar o nome duplicado e renomear o recurso conflitante
ou o objeto Kf.
TemplateError: há uma configuração incorreta na especificação do recurso Kf
ou na configuração do Kf que faz com que o
recurso filho seja reconciliado incorretamente. Valide as configurações do
objeto Kf e do espaço
Kf.
CacheOutdated: o controlador Kf não está recebendo
atualizações do Kubernetes rápido o suficiente. Verifique a integridade do cluster do
Kubernetes.
ReconciliationError: o controlador Kf não pode
criar o recurso filho necessário. Verifique se o cluster
está íntegro, se o Kf está em execução e se não há
políticas aplicadas que impeçam o Kf
de criar o objeto referenciado na mensagem.
O objeto não está excluindo
Verifique se o metadata.deletionTimestamp do objeto foi definido. Se não tiver sido,
a exclusão solicitada não funcionou.
Verifique se o metadata.deletionTimestamp do objeto está no passado. Se ele está
no futuro, o objeto poderá não ser excluído.
Verifique se existe uma lista metadata.finalizers no objeto. Se houver finalizadores,
o objeto precisará aguardar a remoção antes da
exclusão. Se você quiser forçar uma exclusão sem esperar os
finalizadores, edite o objeto para removê-los.
É possível que haja objetos filhos que estejam impedindo que o objeto seja
excluído. Peça a um administrador para verificar todos os objetos no namespace e no
cluster e ver se um deles precisa ser excluído manualmente primeiro.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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 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."]]
