Uso de um sistema de arquivos do SFS existente por meio de um PV estático

Pré-requisitos

• Você criou um cluster e instalou o complemento Armazenamento do contêiner do CCE (Everest) no cluster.
• Se você quiser criar um cluster usando comandos, use kubectl para se conectar ao cluster. Para mais detalhes, consulte Conexão a um cluster usando o kubectl.
• Você criou um sistema de arquivos do SFS que está na mesma VPC que o cluster.

Restrições

• Vários PVs podem usar o mesmo sistema de arquivos do SFS ou SFS Turbo com as seguintes restrições:
  • Não monte todos as PVCs/PVs que usam o mesmo sistema de arquivos do SFS ou SFS Turbo subjacente em um pod. Isso leva a uma falha de inicialização do pod porque nem todos as PVCs podem ser montados no pod devido aos mesmos valores de volumeHandle desses PVs.
  • Sugere-se que o parâmetro persistentVolumeReclaimPolicy nos PVs seja definido como Retain. Caso contrário, quando um PV for excluído, o volume subjacente associado poderá ser excluído. Neste caso, outros PVs associados ao mau funcionamento do volume subjacente.
  • Quando o volume subjacente é usado repetidamente, ative o isolamento e a proteção de ReadWriteMany na camada da aplicação para evitar a substituição e a perda de dados.

Usar um sistema de arquivos do SFS existente no console

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster.
2. Crie estaticamente uma PVC e PV.
   1. Escolha Storage no painel de navegação e clique na guia PersistentVolumeClaims (PVCs). Clique em Create PVC no canto superior direito. Na caixa de diálogo exibida, configure os parâmetros de PVC.

      Parâmetro	Descrição
      PVC Type	Neste exemplo, selecione SFS.
      PVC Name	Digite o nome da PVC, que deve ser exclusivo no mesmo namespace.
      Creation Method	Se o armazenamento subjacente estiver disponível, crie um volume de armazenamento ou use um volume de armazenamento existente para criar estaticamente uma PVC com base em se um PV foi criado. Se nenhum armazenamento subjacente estiver disponível, selecione Dynamically provision. Para mais detalhes, consulte Uso de um sistema de arquivos do SFS através de um PV dinâmico. Neste exemplo, selecione Create new para criar um PV e uma PVC ao mesmo tempo no console.
      PVa	Selecione um PV existente no cluster. Crie um PV com antecedência. Para obter detalhes, consulte "Criação de um volume de armazenamento" em Operações relacionadas. Você não precisa especificar esse parâmetro neste exemplo.
      SFSb	Clique em Select SFS. Na página exibida, selecione o sistema de arquivos do SFS que atende aos seus requisitos e clique em OK. NOTA: Atualmente, somente SFS 3.0 Capacity-Oriented é suportado.
      PV Nameb	Digite o nome do PV, que deve ser exclusivo no mesmo cluster.
      Access Modeb	Os volumes do SFS suportam apenas ReadWriteMany indicando que um volume de armazenamento pode ser montado em vários nós no modo de leitura/gravação. Para mais detalhes, consulte Modos de acesso a volume.
      Reclaim Policyb	Você pode selecionar Delete ou Retain para especificar a política de recuperação do armazenamento subjacente quando a PVC é excluída. Para mais detalhes, consulte Política de recuperação da PV. NOTA: Se vários PVs usarem o mesmo volume de armazenamento subjacente, use Retain para evitar a exclusão em cascata de volumes subjacentes.
      Mount Optionsb	Insira os pares chave-valor do parâmetro de montagem. Para mais detalhes, consulte Configuração de opções de montagem de volume do SFS.

      

      a: o parâmetro está disponível quando Creation Method está definido como Use existing.

      b: o parâmetro está disponível quando Creation Method está definido como Create new.

   2. Clique em Create para criar uma PVC e um PV.

      Você pode escolher Storage no painel de navegação e exibir a PVC e o PV criados nas páginas de guia PersistentVolumeClaims (PVCs) e PersistentVolumes (PVs), respectivamente.

3. Crie uma aplicação.
   1. No painel de navegação à esquerda, clique em Workloads. No painel direito, clique na guia Deployments.
   2. Clique em Create Workload no canto superior direito. Na página exibida, clique em Data Storage na área Container Settings e clique em Add Volume para selecionar PVC.
      Monte e use volumes de armazenamento, conforme mostrado na Tabela 1. Para obter detalhes sobre outros parâmetros, consulte Cargas de trabalho.

      Tabela 1 Montagem de um volume de armazenamento

      Parâmetro	Descrição
      PVC	Selecione um volume do SFS existente.
      Mount Path	Digite um caminho de montagem, por exemplo, /tmp. Este parâmetro indica o caminho do contêiner no qual um volume de dados será montado. Não monte o volume em um diretório do sistema como / ou /var/run. Caso contrário, os contêineres estarão com defeito. Monte o volume em um diretório vazio. Se o diretório não estiver vazio, verifique se não há arquivos que afetem a inicialização do contêiner. Caso contrário, os arquivos serão substituídos, causando falhas de inicialização do contêiner ou falhas de criação de carga de trabalho. AVISO: Se um volume for montado em um diretório de alto risco, use uma conta com permissões mínimas para iniciar o contêiner. Caso contrário, arquivos de alto risco no host podem ser danificados.
      Subpath	Digite um subcaminho, por exemplo, tmp, indicando que os dados no caminho de montagem do contêiner serão armazenados na pasta tmp do volume. Um subcaminho é usado para montar um volume local para que o mesmo volume de dados seja usado em um único pod. Se este parâmetro for deixado em branco, o caminho raiz é usado por padrão.
      Permission	Read-only: você só pode ler os dados nos volumes montados. Read/Write: você pode modificar os volumes de dados montados no caminho. Os dados recém-gravados não serão migrados se o contêiner for migrado, o que pode causar perda de dados.

      Neste exemplo, o disco é montado no caminho /data do contêiner. Os dados de contêiner gerados nesse caminho são armazenados no sistema de arquivos do SFS.

      

   3. Após a configuração, clique em Create Workload.

      Depois que a carga de trabalho for criada, os dados no diretório de montagem do contêiner serão armazenados persistentemente. Verifique o armazenamento referindo-se a Verificar a persistência e o compartilhamento de dados.

(kubectl) Usar um sistema de arquivos do SFS existente

1. Use o kubectl para se conectar ao cluster.
2. Crie um PV.
   1. Crie o arquivo pv-sfs.yaml.
      SFS Capacity-Oriented:

      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # (Optional) The PV is deleted while the underlying volume is retained.
        name: pv-sfs    # PV name.
      spec:
        accessModes:
        - ReadWriteMany      # Access mode. The value must be ReadWriteMany for SFS.
        capacity:
          storage: 1Gi     # SFS volume capacity.
        csi:
          driver: disk.csi.everest.io   # Dependent storage driver for the mounting.
          fsType: nfs
          volumeHandle: <your_volume_id>   # SFS Capacity-Oriented volume ID.
          volumeAttributes:
            everest.io/share-export-location: <your_location>  # Shared path of the SFS volume.
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
        persistentVolumeReclaimPolicy: Retain    # Reclaim policy.
        storageClassName: csi-nas               # Storage class name. csi-nas indicates that SFS Capacity-Oriented is used.
        mountOptions: []                         # Mount options.

      Tabela 2 Parâmetros principais

      Parâmetro	Obrigatório	Descrição
      everest.io/reclaim-policy: retain-volume-only	Não	Opcional. Atualmente, apenas retain-volume-only é suportado. Este campo é válido somente quando a versão do everest for 1.2.9 ou posterior e a política de recuperação for Delete. Se a política de recuperação for Delete e o valor atual for retain-volume-only, o PV associado será excluído enquanto o volume de armazenamento subjacente for retido, quando uma PVC for excluída.
      volumeHandle	Sim	Se um volume orientado do SFS Capacity-Oriented for usado, insira o ID do volume. Faça logon no console, escolha Service List > Storage > Scalable File Service e selecione SFS Turbo. Na lista, clique no nome do sistema de arquivos do SFS de destino. Na página de detalhes, copie o conteúdo seguinte do ID.
      everest.io/share-export-location	Sim	Caminho compartilhado do sistema de arquivos. Para um sistema de arquivos do SFS Capacity-Oriented, faça logon no console, escolha Service List > Storage > Scalable File Service e obtenha o caminho compartilhado da coluna Mount Address.
      mountOptions	Sim	Opções de montagem. Se não for especificado, as seguintes configurações são usadas por padrão. Para mais detalhes, consulte Configuração de opções de montagem de volume do SFS. mountOptions: - vers=3 - timeo=600 - nolock - hard
      persistentVolumeReclaimPolicy	Sim	Uma política de recuperação é suportada quando a versão do cluster é ou posterior a 1.19.10 e a versão do everest é ou posterior a 1.2.9. As políticas de recuperação Delete e Retain são suportadas. Para mais detalhes, consulte Política de recuperação da PV. Se vários PVs usarem o mesmo volume do SFS, use Retain para impedir que o volume subjacente seja excluído com um PV. Delete: Se everest.io/reclaim-policy não for especificada, ambos os volumes de PV e SFS serão excluídos quando uma PVC for excluída. Se everest.io/reclaim-policy estiver definida para retain-volume-only, quando uma PVC for excluída, o PV será excluído, mas os recursos de volumes do SFS serão retidos. Retain: quando uma PVC é excluída, o PV e os recursos de armazenamento subjacentes não são excluídos. Em vez disso, você deve excluir manualmente esses recursos. Depois disso, o PV está no estado Released e não pode ser vinculado à PVC novamente.
      storage	Sim	Capacidade solicitada na PVC, em Gi. Para SFS, esse campo é usado apenas para verificação (não pode estar vazio ou 0). Seu valor é fixado em 1, e qualquer valor que você definir não terá efeito para sistemas de arquivos do SFS.

   2. Execute o seguinte comando para criar um PV:

      kubectl apply -f pv-sfs.yaml

3. Crie uma PVC.
   1. Crie o arquivo pvc-sfs.yaml.

      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany               # The value must be ReadWriteMany for SFS.
        resources:
          requests:
            storage: 1Gi               # SFS volume capacity.
      storageClassName: csi-nas # Storage class name, which must be the same as the PV's storage class.
        volumeName: pv-sfs    # PV name.

      Tabela 3 Parâmetros principais

      Parâmetro	Obrigatório	Descrição
      storage	Sim	Capacidade solicitada na PVC, em Gi. O valor deve ser o mesmo que o tamanho de armazenamento do PV existente.
      volumeName	Sim	Nome do PV, que deve ser o mesmo que o nome do PV em 1.

   2. Execute o seguinte comando para criar uma PVC:

      kubectl apply -f pvc-sfs.yaml

4. Crie uma aplicação.
   1. Crie um arquivo chamado web-demo.yaml. Neste exemplo, o volume do SFS é montado no caminho /data.

      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    # Volume name, which must be the same as the volume name in the volumes field.
                mountPath: /data  # Location where the storage volume is mounted.
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    # Volume name, which can be customized.
                persistentVolumeClaim:
                  claimName: pvc-sfs    # Name of the created PVC.

   2. Execute o seguinte comando para criar uma carga de trabalho na qual o volume do SFS está montado:

      kubectl apply -f web-demo.yaml

      Depois que a carga de trabalho for criada, os dados no diretório de montagem do contêiner serão armazenados persistentemente. Verifique o armazenamento referindo-se a Verificar a persistência e o compartilhamento de dados.

Verificar a persistência e o compartilhamento de dados

1. Exiba a aplicação implementada e os arquivos.
   1. Execute o seguinte comando para exibir o pod criado:

      kubectl get pod | grep web-demo

      Saída esperada:

      web-demo-846b489584-mjhm9   1/1     Running   0             46s
      web-demo-846b489584-wvv5s   1/1     Running   0             46s

   2. Execute os seguintes comandos em sequência para visualizar os arquivos no caminho /data dos pods:

      kubectl exec web-demo-846b489584-mjhm9 -- ls /data
      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      Se nenhum resultado for retornado para ambos os pods, nenhum arquivo existirá no caminho /data.

2. Execute o seguinte comando para criar um arquivo chamado static no caminho /data:

   kubectl exec web-demo-846b489584-mjhm9 --  touch /data/static

3. Execute o seguinte comando para exibir os arquivos no caminho /data:

   kubectl exec web-demo-846b489584-mjhm9 -- ls /data

   Saída esperada:

   static

4. Verifique a persistência dos dados.
   1. Execute o seguinte comando para excluir o pod chamado web-demo-846b489584-mjhm9:

      kubectl delete pod web-demo-846b489584-mjhm9

      Saída esperada:

      pod "web-demo-846b489584-mjhm9" deleted

      Após a eliminação, o controlador de Implementação cria automaticamente uma réplica.

   2. Execute o seguinte comando para exibir o pod criado:

      kubectl get pod | grep web-demo

      A saída esperada é a seguinte, na qual web-demo-846b489584-d4d4j é o pod recém-criado:

      web-demo-846b489584-d4d4j   1/1     Running   0             110s
      web-demo-846b489584-wvv5s    1/1     Running   0             7m50s

   3. Execute o seguinte comando para verificar se os arquivos no caminho /data do pod novo foram modificados:

      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      Saída esperada:

      static

      Se o arquivo static ainda existir, os dados podem ser armazenados persistentemente.

5. Verifique o compartilhamento de dados.
   1. Execute o seguinte comando para exibir o pod criado:

      kubectl get pod | grep web-demo

      Saída esperada:

      web-demo-846b489584-d4d4j   1/1     Running   0             7m
      web-demo-846b489584-wvv5s   1/1     Running   0             13m

   2. Execute o seguinte comando para criar um arquivo chamado share no caminho /data de qualquer pod: Neste exemplo, selecione o pod chamado web-demo-846b489584-d4d4j.

      kubectl exec web-demo-846b489584-d4d4j --  touch /data/share

      Verifique os arquivos no caminho /data do pod.

      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      Saída esperada:

      share
      static

   3. Verifique se o arquivo share existe no caminho /data de outro pod (web-demo-846b489584-wvv5s) também para verificar o compartilhamento de dados.

      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      Saída esperada:

      share
      static

      Depois de criar um arquivo no caminho /data de um pod, se o arquivo também for criado no caminho /data do outro pod, os dois pods compartilharão o mesmo volume.

Operações relacionadas