Nesta página, explicamos como instalar um driver de armazenamento da interface de armazenamento do contêiner (CSI, na sigla em inglês) nos clusters do GKE em bare metal.
Visão geral
A Container Storage Interface (CSI) é uma API padrão aberta compatível com os principais fornecedores de armazenamento que permite ao Kubernetes expor sistemas de armazenamento arbitrários a cargas de trabalho em contêineres.
Os volumes do Kubernetes são gerenciados por drivers de armazenamento específicos do fornecedor, que foram historicamente compilados em binários do Kubernetes. Antes, não era possível usar um driver de armazenamento que não estava incluído no Kubernetes. A instalação de um driver CSI adiciona compatibilidade com um sistema de armazenamento que não é compatível nativamente com o Kubernetes. Além disso, o CSI permite o uso de recursos de armazenamento modernos, como snapshots e redimensionamento.
Para usar um driver da CSI, você precisa criar um StorageClass do Kubernetes. Defina o driver da CSI como provisionador do StorageClass. Em seguida, é possível definir o StorageClass como padrão do cluster ou configurar as cargas de trabalho usando o StorageClass (exemplo de StatefulSet).
Instale o driver CSI de um fornecedor
Os fornecedores de armazenamento desenvolvem os próprios drivers CSI e são responsáveis por fornecer instruções de instalação. Em casos simples, a instalação envolve apenas a implantação de manifestos nos clusters. Veja a lista de drivers CSI na documentação da CSI.
Para armazenamento de produção, recomendamos a instalação de um driver CSI de um parceiro de armazenamento GDCV Ready.
Verificar a instalação de um driver
Depois de instalar um driver de CSI, é possível verificar a instalação executando:
kubectl get csinodes -o jsonpath='{range .items[*]} \
{.metadata.name}{": "} {range .spec.drivers[*]} {.name}{"\n"} {end}{end}'
Use um driver CSI
Para usar um driver CSI:
Crie um StorageClass do Kubernetes que faça referência ao driver no campo
provisioner
.Para provisionar armazenamento, é possível:
- Fazer referência ao StorageClass na especificação
volumeClaimTemplates
para um objeto StatefulSet. - Defini-lo como o StorageClass padrão do cluster.
- Fazer referência ao StorageClass na especificação
Considerações para StorageClasses apoiadas por um driver CSI
Ao criar um StorageClass, considere o seguinte:
- A documentação do driver CSI precisa incluir os parâmetros específicos do driver que você provisiona ao StorageClass, incluindo o nome do provisionador.
- Você precisa nomear o StorageClass de acordo com as propriedades dele, em vez do nome do driver ou appliance específico por trás dele. Nomear o StorageClass de acordo com as propriedades dele permite criar StorageClasses com o mesmo nome em vários clusters e ambientes, permitindo que seus aplicativos recebam armazenamento com as mesmas propriedades em todos os clusters.
Exemplo: StorageClass de referência em um StatefulSet
O exemplo de modelos a seguir mostra como definir um driver CSI em um StorageClass e, em seguida, como referenciar o StorageClass em uma carga de trabalho StatefulSet. O exemplo pressupõe que o driver já foi instalado no cluster.
O StorageClass simples a seguir, premium-rwo
, usa um driver CSI fictício,
csi.example.com
, como provisionador:
fast-sc.yaml
apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: premium-rwo provisioner: csi.example.com # CSI driver parameters: # You provide vendor-specific parameters to this specification type: example-parameter # Be sure to follow the vendor's instructions datastore: my-datastore reclaimPolicy: Retain allowVolumeExpansion: true
Você faz referência ao StorageClass na especificação volumeClaimTemplates
de um StatefulSet.
Quando você se referir a um StorageClass na especificação volumeClaimTemplates
de um StatefulSet, o Kubernetes fornecerá armazenamento estável usando PersistentVolumes (PVs).
O Kubernetes chama o provisionador definido no StorageClass para criar um novo
volume de armazenamento. Nesse caso, o Kubernetes chama o provedor fictício csi.example.com
,
que chama a API do provedor, para criar um volume. Depois que o
volume é provisionado, o Kubernetes cria automaticamente um PV para representar o
armazenamento.
Veja um StatefulSet simples que faz referência ao StorageClass:
statefulset.yaml
apiVersion: apps/v1 kind: StatefulSet metadata: name: web spec: replicas: 2 selector: matchLabels: app: nginx template: metadata: labels: app: nginx spec: containers: - name: nginx image: registry.k8s.io/nginx-slim:0.8 volumeMounts: - name: www mountPath: /usr/share/nginx/html volumeClaimTemplates: # This is the specification in which you reference the StorageClass - metadata: name: www spec: accessModes: [ "ReadWriteOnce" ] resources: requests: storage: 1Gi storageClassName: premium-rwo # This field references the existing StorageClass
A seguir
- Leia mais sobre os conceitos de armazenamento do GKE em bare metal
- Defina um StorageClass padrão para o cluster