Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:NAS volume FAQ

Última atualização: Aug 24, 2026

Este tópico explica como solucionar problemas comuns em volumes NAS.

Tempo prolongado de montagem de volumes NAS

Se você configurar o parâmetro securityContext.fsgroup no modelo da aplicação, o kubelet executará operações de chmod ou chown em todos os arquivos do diretório montado após cada montagem. Quanto maior a quantidade de arquivos no diretório, mais demoradas serão essas operações, aumentando o tempo total de montagem.

Escolha uma das soluções abaixo conforme sua necessidade:

  • Solução 1 (Recomendada para Kubernetes 1.20 e versões posteriores): Defina fsGroupChangePolicy como OnRootMismatch. Com essa configuração, as operações de chmod e chown ocorrem apenas na montagem inicial e somente se as permissões não coincidirem. As montagens subsequentes não acionam essas operações, restaurando os tempos normais de montagem. Para obter mais informações sobre o parâmetro fsGroupChangePolicy, consulte Configurar um contexto de segurança para um Pod ou contêiner.

  • Solução 2 (Caso fsGroup não seja necessário): Remova o parâmetro fsgroup da seção securityContext. Sem a configuração de securityContext.fsgroup, o kubelet não altera as permissões e o tempo de montagem permanece inalterado.

  • Solução 3 (Quando for necessário especificar a propriedade dos arquivos): Monte manualmente o diretório de destino em uma instância ECS. Execute os comandos chown e chmod para definir o UID de destino e o mode. Em seguida, utilize o volume NAS com FlexVolume. Para saber mais sobre o uso de volumes NAS com FlexVolume, consulte Use a statically provisioned NAS volume e Use a dynamically provisioned NAS volume.

Falha na montagem de volume NAS devido a timeout

Geralmente, isso indica um problema de isolamento de rede: o ponto de montagem do NAS e o cluster não estão na mesma VPC, causando um erro de timeout. Verifique se o ponto de montagem e o cluster pertencem à mesma VPC e tente novamente.

Erro chown: option not permitted ao usar um volume NAS

O erro chown: option not permitted indica que o contêiner não tem permissão para alterar a propriedade de arquivos no volume NAS. Para corrigir esse problema, inicie o contêiner com privilégios de root.

Falha na montagem de volume NAS

A montagem de um PV do NAS falha com o seguinte erro:

Unable to mount volumes for pod "dp-earnings-pod_default(906172c6-3d68-11e8-86e0-00163e00****)": timeout expired waiting for volumes to attach/mount for pod "default"/"dp-earnings-pod". list of unattached/unmounted volumes=[vol1 vol2]

Esse erro ocorre porque o plug-in FlexVolume não está instalado no cluster. Para resolver, instale o plug-in seguindo as instruções em Install and upgrade the FlexVolume plug-in.

Criação de PV bloqueada por fila cheia no controlador

Se o reclaimPolicy da StorageClass estiver definido como Delete e archiveOnDelete como false, a fila de tarefas poderá ficar cheia caso os subdiretórios sejam criados mais rápido do que o controlador consegue excluí-los. Isso impede a criação de novos PVs.

Defina archiveOnDelete como true. Quando um PV é excluído, o controlador apenas renomeia o subdiretório no sistema de arquivos NAS em vez de remover os arquivos. Essa operação é quase instantânea e evita o bloqueio da fila de tarefas.

Aviso

Quando archiveOnDelete está definido como true, os subdiretórios renomeados não são excluídos automaticamente. Gerencie a exclusão dos arquivos por conta própria. Métodos comuns incluem configurar uma tarefa de exclusão agendada em um nó ou iniciar vários Pods para excluir simultaneamente subdiretórios que seguem um padrão de nomenclatura específico.