Configurar o armazenamento conectado do Distributed Cloud

Esta página descreve como configurar o armazenamento conectado do Distributed Cloud, incluindo:

• Armazenamento Symcloud da Rakuten
• Esquemas de armazenamento local

Configurar o Distributed Cloud conectado para o armazenamento Symcloud

Por padrão, as cargas de trabalho executadas em um nó de rack conectado do Google Distributed Cloud não podem acessar o armazenamento local de outro nó de rack conectado do Distributed Cloud. No entanto, é possível configurar racks conectados do Distributed Cloud para usar o armazenamento Symcloud da Rakuten, que é uma solução de terceiros que atua como uma camada de abstração de armazenamento local em cada nó conectado do Distributed Cloud e disponibiliza o armazenamento local para cargas de trabalho executadas em outros nós conectados do Distributed Cloud. O armazenamento Symcloud é a opção de armazenamento padrão e única nos servidores conectados do Google Distributed Cloud.

O armazenamento Symcloud é implantado no Google Cloud Marketplace e está sujeito aos termos declarados nele. O Google oferece suporte limitado para o uso do armazenamento Symcloud com o Distributed Cloud conectado e pode envolver o provedor terceirizado para receber assistência. As atualizações de software para o armazenamento Symcloud estão incluídas nas atualizações de software do Distributed Cloud conectado.

Esta versão do Distributed Cloud conectado é fornecida com o armazenamento Symcloud 5.4.18 e oferece suporte a ele. Nenhuma outra versão do armazenamento Symcloud é compatível com esta versão do Distributed Cloud conectado.

Como receber uma licença de armazenamento Symcloud

É necessário receber uma licença de armazenamento Symcloud no formato YAML do Google Cloud Marketplace:

Acessar o Marketplace

Classes de armazenamento Symcloud

Esta seção descreve as classes de armazenamento que o armazenamento Symcloud pode ativar no cluster conectado do Distributed Cloud. O armazenamento Symcloud no Distributed Cloud conectado não oferece suporte à classe de armazenamento robin-rwx nem a volumes de modo de sistema de arquivos RWX configurados de maneira personalizada. Para mais informações sobre as classes de armazenamento Symcloud, consulte Como usar o Robin CNS no Kubernetes.

Classe de armazenamento robin

A classe de armazenamento robin é uma classe básica de armazenamento de leitura e gravação única (RWO, na sigla em inglês). O exemplo a seguir ilustra a instanciação da classe:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
    name: robin
    labels:
        app.kubernetes.io/instance: robin
        app.kubernetes.io/managed-by: robin.io
        app.kubernetes.io/name: robin
provisioner: robin
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: WaitForFirstConsumer

Aviso: o uso dessa classe de armazenamento de réplica única pode resultar em perda de dados, já que ela não oferece redundância em caso de falha do nó. Recomendamos o uso de uma classe de armazenamento que ofereça redundância com pelo menos três réplicas.

Classe de armazenamento robin-immediate

A classe de armazenamento robin-immediate é igual a robin, exceto pelo fato de que o volume permanente é criado imediatamente após a criação da declaração de volume permanente correspondente. O exemplo a seguir ilustra a instanciação da classe:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
    name: robin-immediate
    labels:
        app.kubernetes.io/instance: robin
        app.kubernetes.io/managed-by: robin.io
        app.kubernetes.io/name: robin
provisioner: robin
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: Immediate

Aviso: o uso dessa classe de armazenamento de réplica única pode resultar em perda de dados, já que ela não oferece redundância em caso de falha do nó. Recomendamos o uso de uma classe de armazenamento que ofereça redundância com pelo menos três réplicas.

Classe de armazenamento robin-repl-3

A classe robin-repl-3 é uma classe de armazenamento RWO com três réplicas que abrangem vários nós do Distributed Cloud. O exemplo a seguir ilustra a instanciação da classe:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
    name: robin-repl-3
    labels:
        app.kubernetes.io/instance: robin
        app.kubernetes.io/managed-by: robin.io
        app.kubernetes.io/name: robin
provisioner: robin
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: WaitForFirstConsumer
parameters:
    replication: "3"
    faultdomain: host

Pré-requisitos

Antes de começar, siga estas etapas:

1. Configure a geração de registros e o monitoramento do projeto conectado do Distributed Cloud de destino.
2. Crie o cluster conectado do Distributed Cloud de destino.
3. Configure a rede do Distributed Cloud para que os pods no cluster conectado do Distributed Cloud de destino possam alcançar o Google Cloud data center.
4. Vincule cada volume permanente local-block em cada nó do Distributed Cloud que você não quer que seja abstraído pelo armazenamento Symcloud. Se você desvincular um volume permanente local-block vinculado, a instalação do armazenamento Symcloud vai limpar o conteúdo desse volume permanente. Para instruções, consulte Vinculação na documentação do Kubernetes.

Instalar o armazenamento Symcloud em um nó conectado do Distributed Cloud

Para instalar o armazenamento Symcloud em um nó conectado do Distributed Cloud, siga estas etapas:

1. Use o comando a seguir para aplicar a licença de armazenamento Symcloud ao cluster. Substitua LICENSE_FILE pelo caminho completo e nome do arquivo de licença de armazenamento Symcloud.

   kubectl apply -f LICENSE_FILE -n robin-admin
   

2. Use o comando a seguir para verificar o status do serviço RobinCluster e de todos os nós de armazenamento Symcloud:

   kubectl describe robinclusters -n robinio
   

   O comando retorna uma saída semelhante a esta:

   [...]
   Status:
   [...]
   Phase:              Ready
   robin_node_status:
   [...]
    Status:           Ready
   [...]
    Status:           Ready
   [...]
    Status:           Ready
   [...]
   

   O status esperado para o serviço e os nós é Ready.

Definir o armazenamento Symcloud como a classe de armazenamento padrão

Use o comando a seguir para definir o armazenamento Symcloud como a classe de armazenamento padrão no cluster conectado do Distributed Cloud. Substitua STORAGE_CLASS por uma das classes de armazenamento Symcloud.

kubectl patch storageclass STORAGE_CLASS -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

Para mais informações sobre como definir a classe de armazenamento padrão, consulte Alterar o StorageClass padrão na documentação do Kubernetes.

Configurar volumes de armazenamento Symcloud abstraídos para cargas de trabalho

Esta seção fornece exemplos de como usar classes de armazenamento Symcloud para configurar o armazenamento abstraído para cargas de trabalho conectadas do Distributed Cloud. Para mais detalhes sobre como configurar volumes de armazenamento Symcloud, consulte Como usar o Robin CNS no Kubernetes.

Configurar um volume RWO ext4 no modo de sistema de arquivos

O exemplo a seguir ilustra como configurar uma declaração de volume permanente para um volume RWO no modo de sistema de arquivos com o sistema de arquivos ext4. Substitua STORAGE_CLASS por uma das classes de armazenamento Symcloud.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: rwo-fs-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: STORAGE_CLASS

Configurar um volume RWO no modo de bloco

O exemplo a seguir ilustra como configurar uma declaração de volume permanente para um volume RWO no modo de bloco. Substitua STORAGE_CLASS por uma das classes de armazenamento Symcloud.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: rwo-block-pvc
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: STORAGE_CLASS
  volumeMode: Block

Modificar a configuração de um volume atual

O exemplo a seguir ilustra como modificar a configuração de um volume RWO compactado LZ4 de armazenamento Symcloud usando anotações. Substitua STORAGE_CLASS por uma das classes de armazenamento Symcloud.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: compressed-rwo-fs-pvc
  annotations:
    robin.io/compression: LZ4
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: STORAGE_CLASS

O exemplo a seguir ilustra como modificar a configuração de um volume RWO de armazenamento Symcloud com o sistema de arquivos xfs usando anotações. Substitua STORAGE_CLASS por uma das classes de armazenamento Symcloud.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: rwo-xfs-pvc
  annotations:
    robin.io/fstype: xfs
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: STORAGE_CLASS

Configurar o cliente da CLI de armazenamento Symcloud

O armazenamento Symcloud fornece um cliente de interface de linha de comando (CLI) que pode ser usado para gerenciar a configuração do armazenamento Symcloud. Para configurar o cliente no cluster conectado do Distributed Cloud, siga estas etapas:

1. Receba o caminho da imagem de armazenamento Symcloud usado pela instância de serviço RobinCluster implantada no cluster conectado do Distributed Cloud e defina as variáveis de ambiente da seguinte maneira:

   image_robin=$(kubectl get robincluster -o jsonpath='{.items[].spec.image_robin}')
   image_registry_path=$(kubectl get robincluster -o jsonpath='{.items[].spec.image_registry_path}')
   ROBIN_CNS_IMAGE="$image_registry_path/$image_robin"
   

2. Crie um recurso robincli com o conteúdo a seguir:

   kind: Deployment
   apiVersion: apps/v1
   metadata:
    name: robincli
    namespace: default
    labels:
      name: robincli
   spec:
    replicas: 1
    selector:
      matchLabels:
        name: robincli
    template:
      metadata:
        annotations:
          product: robin
        labels:
          name: robincli
      spec:
        containers:
        - name: robincli
          image: ROBIN_CNS_IMAGE
          workingDir: /root
          command: ["/bin/bash","-c","mkdir -p /root/.robin; ln -s -t /usr/lib/python3.7/site-packages/ /opt/robin/current/python3/site-packages/robincli /opt/robin/current/python3/site-packages/stormgr_def.py /opt/robin/current/python3/site-packages/stormgr_lib.py; /opt/robin/current/bin/robin client add-context robin-master.robinio --set-current; while true; do sleep 10000; done"]
          resources:
            requests:
              memory: "10Mi"
              cpu: "100m"
   

   Substitua ROBIN_CNS_IMAGE pelo caminho completo do repositório e pelo nome da imagem que você recebeu na etapa 1.

3. Aplique o recurso robincli ao cluster conectado do Distributed Cloud.

4. Na instalação inicial, o armazenamento Symcloud gera um secret default-admin-user no namespace robinio com uma senha aleatória. Use os comandos a seguir para receber essas credenciais de login:

   1. Receba o nome de usuário:

      kubectl -n robinio get secret default-admin-user -o jsonpath='{.data.username}' | base64 -d
      

   2. Receba a senha:

       
      kubectl -n robinio get secret default-admin-user -o jsonpath='{.data.password}' | base64 -d
      

5. Faça login no pod recém-criado e execute o cliente:

   kubectl exec -it robincli -- bash
   

Limitações do armazenamento Symcloud

Ao usar o armazenamento Symcloud com o Distributed Cloud conectado, você só poderá alcançar alta disponibilidade se o cluster conectado do Distributed Cloud consistir em três ou mais nós conectados do Distributed Cloud.

Como remover nós que usam o armazenamento Symcloud de um cluster

As réplicas de volume de armazenamento Symcloud são armazenadas em nós de worker no cluster conectado do Distributed Cloud. Se você remover um nó do cluster, os dados de volume de armazenamento Symcloud armazenados nesse nó vão ficar indisponíveis. Para evitar isso, faça uma das seguintes ações:

• Se você estiver desativando todo o cluster, remova as cargas de trabalho e os volumes permanentes de armazenamento Symcloud correspondentes antes de desativar o cluster.

• Se você estiver removendo nós específicos do cluster, migre os dados da carga de trabalho armazenados nesses nós antes de remover esses nós do cluster. Para instruções, consulte Como evacuar volumes de um disco.

Configurar esquemas de armazenamento local

Um esquema de armazenamento é um agrupamento lógico de uma ou mais partições. Cada partição é uma unidade de armazenamento logicamente independente. As partições são criadas no cluster sequencialmente até que o espaço em disco físico seja esgotado. Cada esquema de armazenamento tem um nome exclusivo que o identifica.

Para criar um novo esquema de armazenamento local para o cluster conectado do Distributed Cloud, é necessário solicitá-lo ao Google. Depois que testarmos o esquema e o criarmos no cluster, você poderá aplicá-lo usando a CLI gcloud.

Não é possível modificar um esquema depois que ele é aplicado a um cluster. Para mudar um esquema atual, solicite a exclusão do esquema atual do Google e, em seguida, solicite a criação de um novo esquema para substituí-lo.

Definir partições para um esquema de armazenamento local

Antes de solicitar um esquema de armazenamento local, é necessário definir as partições desse esquema.

Uma partição tem as seguintes propriedades:

• Tamanho. É possível especificar um tamanho de partição em bytes binários ou usar todo o espaço restante no disco local.
• Tipo. É possível configurar uma partição como um volume permanente (PV) do Kubernetes ou um volume local do Linux no disco local.
• Modo. É possível configurar o volume armazenado na partição como um volume de bloco ou um volume de sistema de arquivos. Para partições de volume permanente, a classe de armazenamento da partição é local-block ou local-disks, respectivamente. Para partições de volume local, é possível especificar os pontos de vinculação e montagem para os sistemas de arquivos contidos.

Solicitar um esquema de armazenamento local

Para solicitar um novo esquema de armazenamento local para o cluster conectado do Distributed Cloud, entre em contato com o suporte do Google e forneça o tamanho, o tipo, o modo e, opcionalmente, os pontos de montagem e vinculação de cada partição que você quer criar no esquema.

Quando recebemos sua solicitação, executamos uma série de testes para garantir a robustez do esquema e, em seguida, o criamos no cluster conectado do Distributed Cloud.

Esquemas de armazenamento local padrão

O Distributed Cloud conectado é fornecido com os seguintes esquemas de armazenamento local padrão:

• default_control_plane_node. Esse esquema define as seguintes partições:

  • Uma partição de volume local de 100 GB no modo de sistema de arquivos.
  • Uma partição de volume permanente no modo de bloco que ocupa o espaço livre restante no disco.

• default_worker_node. Esse esquema define uma partição de volume permanente de 410 GB no modo de bloco.

Aplicar um esquema de armazenamento local a um cluster

Para aplicar um esquema de armazenamento local ao cluster conectado do Distributed Cloud, faça uma das seguintes ações:

• Para aplicar um esquema de armazenamento local aos nós do plano de controle do cluster, use a flag --control-plane-node-storage-schema ao criar o cluster. Para mais informações, consulte Criar um cluster.

• Para aplicar um esquema de armazenamento local aos nós de worker do cluster, use --node-storage-schema ao criar um pool de nós para o cluster. Para mais informações, consulte Criar um pool de nós.

O Distributed Cloud conectado cria as partições definidas no esquema de armazenamento local após a criação do cluster ou do pool de nós.