O produto descrito nesta documentação, Anthos Clusters na AWS (geração anterior), está em modo de manutenção . Todas as novas instalações devem usar o produto da geração atual, Anthos Clusters na AWS .
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este tópico explica como instalar um driver de armazenamento CSI (Container Storage Interface) em seus clusters.
Visão geral
Por padrão, o GKE na AWS provisiona volumes do AWS EBS usando o StorageClass padrão. Se suas cargas de trabalho precisarem usar outro tipo de volume de armazenamento, você pode instalar um driver CSI compatível para fornecer acesso a ele.
A Container Storage Interface ( CSI ) é uma API de padrão aberto que fornece às cargas de trabalho do Kubernetes acesso a sistemas de armazenamento compatíveis. A CSI também permite o uso de recursos modernos de armazenamento, como redimensionamento e snapshots.
Após instalar um driver CSI, você precisa criar uma StorageClass do Kubernetes. Defina o driver CSI como o provisionador para a StorageClass. Em seguida, você pode definir a StorageClass como padrão ou configurar suas cargas de trabalho para usar a StorageClass. Para obter um exemplo de como criar um StatefulSet com uma StorageClass personalizada, consulte Usando StorageClasses com suas cargas de trabalho .
Instalar um driver CSI do fornecedor
Os fornecedores de armazenamento são responsáveis por fornecer instruções de instalação para seus drivers CSI. Consulte a lista de drivers CSI na documentação do CSI.
Siga as instruções de instalação do seu driver CSI e continue com as próximas etapas desta página.
Verifique a instalação do driver
Depois de instalar um driver CSI, você pode verificar a instalação executando os seguintes comandos.
Considerações sobre StorageClass apoiado por um driver CSI
Ao criar uma StorageClass, considere o seguinte:
Verifique a documentação do driver CSI para obter parâmetros específicos do driver que você fornece ao seu StorageClass, incluindo o nome do provisionador.
Você deve nomear a StorageClass com base em suas propriedades (como fast ou highly-replicated ), em vez do nome do driver ou dispositivo específico por trás dela. Ao nomear uma StorageClass com base em suas propriedades, você pode criar StorageClasses com o mesmo nome em diferentes clusters e ambientes. Em seguida, configure suas cargas de trabalho para usar a mesma StorageClass.
O que vem a seguir
Crie uma StorageClass que faça referência ao driver CSI.
[[["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-06-12 UTC."],[],[],null,["# Install storage drivers\n\nThis topic explains how to install a Container Storage Interface (CSI) storage\ndriver on your clusters.\n\nOverview\n--------\n\nBy default, GKE on AWS provisions AWS\n[EBS volumes](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html)\nusing the default [StorageClass](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/concepts/storage).\nIf your workloads need use another type of storage volume, you can install a\ncompatible CSI driver to provide access to it.\n\nThe `Container Storage Interface` ([CSI](https://github.com/container-storage-interface/spec/blob/master/spec.md))\nis an open standard API that gives Kubernetes workloads access to compliant\nstorage systems. CSI also enables the use of modern storage features such as\nresizing and snapshots.\n\nAfter installing a CSI driver, you need to create a Kubernetes\n[StorageClass](https://kubernetes.io/docs/concepts/storage/storage-classes/).\nYou set the CSI driver as the provisioner for the StorageClass. Then you can\n[set the StorageClass as default](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/storage-class#set_default),\nor configure your workloads to use the StorageClass.\nFor an example of how to create a StatefulSet with a custom StorageClass,\nsee [Using StorageClasses with your workloads](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/storage-class#example_statefulset).\n\nInstall a vendor's CSI driver\n-----------------------------\n\nStorage vendors are responsible for providing installation instructions for\ntheir CSI drivers. See the list of\n[CSI drivers](https://kubernetes-csi.github.io/docs/drivers.html)\nin the CSI documentation.\n\nFollow the installation instructions for your CSI driver, and then continue with\nthe next steps on this page.\n| **Important:** Google does not provide support or instructions for third-party drivers. Contact your storage vendor for support.\n\nVerify your driver installation\n-------------------------------\n\nAfter you install a CSI driver, you can verify the installation by running\nthe following commands. \n\n kubectl get csinodes \\\n -o jsonpath='{range .items[*]} {.metadata.name}{\": \"} {range .spec.drivers[*]} {.name}{\"\\n\"} {end}{end}'\n\nHow to use a CSI driver\n-----------------------\n\nTo use a CSI driver:\n\n1. Create a custom [StorageClass](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/storage-class#custom)\n that refers to the driver in its `provisioner` field.\n\n2. To provision storage, you can either:\n\n - Reference the StorageClass in a [StatefulSet](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/)'s `volumeClaimTemplates` specification.\n - [Set it as the cluster's default StorageClass](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/storage-class#set_default).\n\n### Considerations for StorageClass backed by a CSI driver\n\nWhen you create a StorageClass, consider the following:\n\n- Check your CSI driver documentation for\n [driver-specific parameters](https://kubernetes.io/docs/concepts/storage/storage-classes/#the-storageclass-resource)\n that you provide to your StorageClass, including the provisioner name.\n\n- You should name the StorageClass after its properties (such as `fast` or\n `highly-replicated`), rather than after the name of the specific driver or\n appliance behind it. When you name a StorageClass after its properties, you can\n create StorageClasses with the same name in different clusters and\n environments. Then configure your workloads to use the same StorageClass.\n\nWhat's next\n-----------\n\n- Create a [StorageClass](/kubernetes-engine/multi-cloud/docs/aws/previous-generation/how-to/storage-class#custom) which references the CSI driver."]]
