Resolver problemas do ServiceBrokers do Kf

Siga estas etapas para resolver vários problemas que podem ocorrer ao usar o ServiceBrokers do Kf.

Não é possível excluir o objeto

Execute o comando abaixo para conferir as informações dos recursos. Depois, verifique as causas listadas aqui:

kubectl get servicebrokers.kf.dev -n SPACE_NAME SERVICEBROKER_NAME -o yaml

A CLI do kf ajuda a verificar alguns dos problemas:

kf doctor --space SPACE_NAME servicebroker/SERVICEBROKER_NAME
Possível causaSolução
O carimbo de data/hora da exclusão está no futuro.

Com a diferença no relógio, metadata.deletionTimestamp ainda pode estar no futuro. Aguarde alguns minutos para ver se o objeto foi excluído.

Há finalizadores no objeto.

Os finalizadores estão presentes no objeto. Eles precisam ser removidos pelo controlador que os definiu antes da exclusão do objeto.

Se você quiser forçar uma exclusão sem esperar os finalizadores, edite o objeto para removê-los da matriz metadata.finalizers.

Aviso: remover os finalizadores sem permitir que os controladores sejam concluídos pode causar erros, problemas de segurança, perda de dados ou recursos órfãos.

Pode ser que existam objetos dependentes.

O objeto pode estar aguardando que os dependentes sejam excluídos antes de ser removido. Consulte o guia sobre coleta de lixo do Kubernetes para saber mais. Peça a um admin para verificar todos os objetos no namespace e no cluster e ver se um deles está bloqueando a exclusão.

Se você precisar remover o objeto sem esperar dependências, use kubectl delete com a flag de cascata definida como: --cascade=orphan.

Inconsistência do estado de geração de objetos

Execute o comando abaixo para conferir as informações dos recursos. Depois, verifique as causas listadas aqui:

kubectl get servicebrokers.kf.dev -n SPACE_NAME SERVICEBROKER_NAME -o yaml

A CLI do kf ajuda a verificar alguns dos problemas:

kf doctor --space SPACE_NAME servicebroker/SERVICEBROKER_NAME
Possível causaSolução
O objeto tem inconsistências na versão de geração.

Em geral, ocorre quando o controlador do Kf não lê a versão mais recente do objeto. Esse erro costuma ter uma recuperação automática quando as réplicas do Kubernetes alcançam a consistência posterior, e isso normalmente não requer ação dos usuários.

Falha na reconciliação de objetos

Execute o comando abaixo para conferir as informações dos recursos. Depois, verifique as causas listadas aqui:

kubectl get servicebrokers.kf.dev -n SPACE_NAME SERVICEBROKER_NAME -o yaml

A CLI do kf ajuda a verificar alguns dos problemas:

kf doctor --space SPACE_NAME servicebroker/SERVICEBROKER_NAME
Possível causaSolução
Objeto com erro TemplateError

Esse erro geralmente ocorre se o usuário inseriu uma propriedade inválida na especificação de recurso Spec ou se a configuração no espaço/cluster é inválida.

Para entender a causa raiz, o usuário pode ler a mensagem de erro mais longa no status.conditions do objeto usando o comando: kubectl describe RESOURCE_TYPE RESOURCE_NAME -n space. Por exemplo, kubectl describe serviceinstance my-service -n my-space.

Objeto com erro ChildNotOwned (conflitos de nome)

Esse erro geralmente significa que os objetos que o controlador está tentando criar já existem. Isso acontece quando o usuário cria um recurso K8s com o mesmo nome do que o controlador está tentando criar. Com mais frequência, isso ocorre quando o usuário exclui um recurso e, em seguida, o controlador do Kf tenta recriá-lo. Se um recurso filho ainda estiver presente, o proprietário dele será o recurso antigo que não existe mais.

Para corrigir o erro, recomendamos que o usuário exclua o recurso afetado e o recrie. Para remover o objeto, use um comando de exclusão do Kf ou kubectl delete RESOURCE_TYPE RESOURCE_NAME -n SPACE. Por exemplo, kf delete-space my-space ou kubectl delete space my-space.

Para recriar um recurso, use um comando do Kf. Por exemplo, kf create-space my-space.

Objeto com erro ReconciliationError

Esse erro geralmente significa que algo deu errado com a chamada HTTP feita (pelo controlador do Kf) para o serviço da API Kubernetes para criar/atualizar o recurso.

Para entender a causa raiz, o usuário pode ler a mensagem de erro mais longa no status.conditions do objeto usando o comando: kubectl describe RESOURCE_TYPE RESOURCE_NAME -n space. Por exemplo, kubectl describe serviceinstance my-service -n my-space.