Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:CSI storage FAQ

Última atualização: Jun 27, 2026

Esta página aborda as perguntas mais frequentes sobre a montagem e o uso de volumes persistentes com componentes da Container Storage Interface (CSI) no Container Service for Kubernetes (ACK).

Se um pod estiver em estado anormal ou se a montagem de um volume persistente falhar, consulte Solucionar problemas de armazenamento para obter um fluxo completo de diagnóstico.

Problemas comuns

Os problemas a seguir se aplicam independentemente do tipo de armazenamento.

Volumes persistentes de disco de nuvem

Tipo

Problema

Criação

Montagem

Uso

Expansão

Desmontagem

Outros

Volumes persistentes NAS

Categoria

Problema

Montagem

Uso

Desmontagem

Tempo limite de desmontagem excedido e pod preso no estado Terminating

Volumes persistentes OSS

ossfs 1,0

Categoria

Problema

Montagem

Uso

Dimensionamento

Preciso expandir um volume quando a capacidade real de armazenamento excede a configuração do volume?

Desmontagem

Falha na desmontagem de um volume OSS provisionado estaticamente e o pod permanece no estado Terminating

ossfs 2,0

Categoria

Problema

Montagem

Dimensionamento

Preciso expandir um volume quando a capacidade real de armazenamento excede a configuração do volume?

Uso

Como reiniciar o processo ossfs 2,0

Componentes de armazenamento

Categoria

Problema

Problemas de componentes

Falhas na atualização de componentes

CNFS

Alerta de evento "IPAddress ... for Service ... has a wrong reference" após atualização do cluster ACK

Sintoma

Após atualizar o cluster, a execução de kubectl get events -A retorna eventos Warning contínuos:

IPAddress: <IP_ADDRESS> for Service kube-system/cnfs-cache-ds-service has a wrong reference; cleaning up

Esse problema geralmente ocorre nos seguintes cenários:

  1. A versão do componente storage-operator no cluster é anterior à v1,33.1.

  2. O cluster foi atualizado de uma versão anterior à 1,33 para a versão 1,33 ou posterior.

Causa

Versões do storage-operator anteriores à v1,33.1 têm um problema conhecido em que tentam criar continuamente um Service já existente. No Kubernetes 1.33 e posteriores, o recurso MultiCIDRServiceAllocator é ativado por padrão. Esse comportamento repetitivo de criação aciona o recurso, fazendo com que o sistema entre em um loop de criação e exclusão rápida de resources IPAddress temporários.

Solução

Atualize o componente storage-operator.

Por que o kube-system/cnfs-cache-ds-service é recriado automaticamente após eu excluí-lo manualmente?

Sintoma

Após excluir manualmente o cnfs-cache-ds-service no namespace kube-system, a exclusão parece ser bem-sucedida, mas o serviço reaparece logo em seguida.

Causa

O componente storage-operator gerencia o estado desejado dos resources do cluster. Seu loop de reconciliação funciona da seguinte forma:

  1. Estado desejado: No ConfigMap do storage-operator, o status de instalação do cnfs-cache-ds-service está definido como true.

  2. Monitoramento contínuo: O componente verifica continuamente o cluster para confirmar se o serviço existe.

  3. Reconciliação automática: Quando você exclui o serviço, o controlador detecta a incompatibilidade e o recria imediatamente para corresponder ao estado desejado.

Solução

Opção 1: Atualizar o componente storage-operator (recomendado)

Consulte Atualizar o componente storage-operator.

Opção 2: Modifique a configuração do storage-operator (temporário)

Esta opção impede que o serviço cnfs-cache-ds seja recriado automaticamente, atualizando o estado desejado do operador.

  1. Edite o ConfigMap do storage-operator no namespace kube-system.

    kubectl edit configmap storage-operator -n kube-system
  2. No campo data, localize cnfs-cache-ds e altere o valor de sua chave install de "true" para "false".

    cnfs-cache-ds:
      install: "false"
      # ...other configurations...
  3. Salve as alterações e saia do editor. O storage-operator aplica a nova configuração.

  4. Exclua o serviço.

    kubectl delete service cnfs-cache-ds-service -n kube-system