Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:CSI storage FAQ

Última atualização: Sep 21, 2026

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

Se um pod estiver em um estado anormal ou se um volume persistente falhar ao montar, consulte {{XREF_0}} para obter um fluxo de trabalho de diagnóstico completo.

Problemas comuns

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

Volumes persistentes de disco em cloud

Tipo

Problema

Criação

  • {{XREF_6}}

  • {{XREF_7}}

  • {{XREF_8}}

  • {{XREF_9}}

  • {{XREF_10}}

  • {{XREF_11}}

  • {{XREF_12}}

Montagem

  • {{XREF_13}}

  • {{XREF_14}}

  • {{XREF_15}}

  • {{XREF_16}}

  • {{XREF_17}}

  • {{XREF_18}}

  • {{XREF_19}}

  • {{XREF_20}}

  • {{XREF_21}}

  • {{XREF_22}}

  • {{XREF_23}}

  • {{XREF_24}}

  • {{XREF_25}}

  • {{XREF_26}}

  • {{XREF_27}}

Uso

  • {{XREF_28}}

  • {{XREF_29}}

Expansão

  • {{XREF_30}}

  • {{XREF_31}}

  • {{XREF_32}}

Desmontagem

  • {{XREF_33}}

  • {{XREF_34}}

  • {{XREF_35}}

  • {{XREF_36}}

  • {{XREF_37}}

  • {{XREF_38}}

Outros

  • {{XREF_39}}

  • {{XREF_40}}

Volumes persistentes de NAS

Categoria

Problema

Montagem

Uso

Desmontagem

A desmontagem atinge o tempo limite e o pod fica travado no estado Terminating

Volumes persistentes de OSS

ossfs 1.0

Categoria

Problema

Montagem

Uso

Dimensionamento

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

Desmontagem

A desmontagem de um volume OSS provisionado estaticamente falha e o pod permanece no estado Terminating

ossfs 2.0

Categoria

Problema

Montagem

Dimensionamento

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

Uso

Como reiniciar o processo do ossfs 2.0

Componentes de armazenamento

Categoria

Problema

Problemas de componentes

  • {{XREF_41}}

  • {{XREF_42}}

  • {{XREF_43}}

  • {{XREF_44}}

  • {{XREF_45}}

Falhas na atualização de componentes

  • {{XREF_46}}

  • {{XREF_47}}

  • {{XREF_48}}

  • {{XREF_49}}

  • {{XREF_50}}

  • {{XREF_51}}

  • {{XREF_52}}

CNFS

Alerta de evento "IPAddress ... for Service ... has a wrong reference" após a atualização de um 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 é atualizado de uma versão anterior à 1.33 para a versão 1.33 ou posterior.

Causa

As versões do storage-operator anteriores à v1.33.1 têm um problema conhecido em que tentam criar continuamente um Service que já existe. No Kubernetes 1.33 e versões posteriores, o recurso MultiCIDRServiceAllocator é ativado por padrão. Esse comportamento de criação repetitiva aciona o recurso, fazendo com que o sistema entre em um loop de criação e exclusão rápida de recursos 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 service reaparece logo em seguida.

Causa

O componente storage-operator gerencia o estado desejado dos recursos 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 a existência do service.

  3. Reconciliação automática: Quando você exclui o service, 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: Modificar a configuração do storage-operator (temporário)

Esta opção impede que o service cnfs-cache-ds seja recriado automaticamente ao atualizar o estado desejado do operator.

  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 service.

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