Editar instâncias

Nesta página, mostramos como editar uma instância do Filestore usando o Console do Cloud ou a ferramenta gcloud.

Depois de criada, é possível modificar uma instância do Filestore das seguintes maneiras:

  • Aumente sua capacidade.
  • Diminuir a capacidade (apenas instâncias de SSD de alta escala).
  • Alterar a descrição dela.
  • Gerenciar regras de controle de acesso baseadas em IP.
  • Gerenciar rótulos. (Para mais informações, consulte Como gerenciar rótulos.)

Capacidade de escalonamento

Ao usar o Filestore, recomendamos que você monitore a utilização das instâncias do Filestore para ajustar a capacidade conforme necessário. Por exemplo, se você perceber que uma instância de nível de alta escala não precisa mais de toda a capacidade alocada, considere reduzi-la. Da mesma forma, se você perceber que está sem capacidade, convém aumentar a capacidade para evitar que os aplicativos fiquem sem falhas. Também é necessário adicionar capacidade se o sistema de arquivos ficar sem inodes. Para verificar se esse é o caso, execute o seguinte comando na VM do cliente:

df -i

O comando retorna algo semelhante ao seguinte:

Filesystem           Inodes  IUsed      IFree  IUse%  Mounted on
10.0.0.2:/vol1    134217728     13  134217715     1%  /mnt/test

Cada arquivo armazenado no compartilhamento de arquivos consome um inode. Se o sistema de arquivos ficar sem nós, não será possível armazenar mais arquivos no compartilhamento de arquivos, mesmo que você não tenha atingido a capacidade máxima alocada. A única maneira de adicionar inodes é adicionar capacidade. No entanto, alcançar o máximo de inodes é muito raro e só é uma preocupação se você precisar armazenar um grande número de arquivos muito pequenos.

Diferenças no comportamento de escalonamento por nível de serviço

As instâncias do nível básico só podem ser escalonadas em 1 incremento GB ou nos múltiplos. As instâncias de nível de alto escalonamento podem ser escalonadas para mais ou para menos em 10 TB incrementos ou múltiplos. O escalonamento de uma instância não afeta a disponibilidade dela e pode ser realizado enquanto a instância está em uso. A tabela a seguir mostra como a capacidade de compartilhamento de arquivos pode ser escalonada com base no nível de serviço:

Nível de serviço HDD básico SSD básico SSD de alta escala
Direção do escalonamento Somente para cima Somente para cima Para cima e para baixo
Aumento de escalonamento 1GB 1GB 10TB
Capacidade mínima 1TB 2.5TB 60TB
Capacidade máxima 63.9TB 63.9TB 320TB

Além disso, as instâncias de nível de SSD de alto escalonamento exigem muito mais tempo para concluir uma operação de escalonamento em comparação com as instâncias de HDD básico e SSD básico. O escalonamento vertical da capacidade de uma instância de alto escalonamento leva de 26 a 48 horas para ser concluído, e o escalonamento vertical leva mais de 20 horas para ser concluído. O tempo real necessário varia de acordo com a quantidade de dados armazenados na instância e a carga na VM do cliente. Para garantir que suas instâncias não fiquem sem capacidade, execute essas operações com antecedência.

Quando uma operação de escalonamento ocorre, não é possível cancelar a operação nem fazer outras edições na instância, mas as operações de leitura e gravação são ininterruptas. Também não é possível escalonar uma instância de SSD de alta escala para um nível de capacidade abaixo do que é necessário para armazenar os dados e metadados de arquivo atuais. A tentativa de fazer isso resultará em um erro.

Instruções para editar uma instância

Cloud Console

Para editar instâncias do Filestore usando o Console do Cloud, navegue até a página Editar instância, em que é possível editar a descrição da instância, gerenciar regras de controle de acesso baseadas em IP e escalonar o desempenho do compartilhamento de arquivos:

  1. No Console do Cloud, acesse a página de instâncias do Filestore.

    Acessar a página de instâncias do Filestore

  2. Clique no código da instância que você quer editar.

  3. Na página Detalhes da instância, clique em Editar para acessar a página Editar instância.

  4. Faça alterações na descrição da instância, nas regras de controle de acesso baseadas em IP e na capacidade conforme necessário. Para detalhes, consulte Como criar instâncias.

  5. Clique em Save.

gcloud

Antes de começar

Para usar a ferramenta gcloud, você precisa instalar o SDK do Cloud ou usar o Cloud Shell integrado ao Console do Cloud:

Acesse Console do Cloud

Comando gcloud para editar uma instância do Filestore

Para editar uma instância do Filestore, execute o comando instances update. Se for necessário atualizar as regras de configuração para o controle de acesso baseado em IP, use o comando gcloud beta instances update com a sinalização --flags-file e especifique um arquivo de configuração json. Se você escolher esse método, não será necessário usar a sinalização --file-share porque ela já está incluída no arquivo de configuração json:

 gcloud [beta] filestore instances update instance-id
     --[project="project-id"]
     --[zone=zone]
     --[file-share=name="file-share-name",capacity=file-share-size]
     --[description="instance-description"]
     --[flags-file=file-name.json]

onde:

  • instance-id é o ID da instância do Filestore que você quer editar.
  • project-id é o ID do projeto do Cloud que contém a instância do Filestore. É possível ignorar essa sinalização se a instância do Filestore estiver no projeto padrão gcloud. Para definir o projeto padrão, execute:

     gcloud config set project project-id
    
  • zone é a zona em que a instância do Filestore reside. Execute o comando gcloud filestore zones list para ver uma lista de zonas compatíveis. Pule essa sinalização se a instância do Filestore estiver na zona padrão gcloud. Para definir a zona padrão, execute:

     gcloud config set filestore/zone zone
    
  • file-share-name é o nome do compartilhamento de arquivos exibido pela instância do Filestore. Não é possível alterar os nomes de compartilhamento de arquivos após a criação da instância.

  • file-share-size é o novo tamanho que você quer que o compartilhamento de arquivos tenha. É possível especificar o tamanho do compartilhamento de arquivos em números inteiros usando GB (padrão) ou TB.

    Para ver sua cota disponível, acesse a página "Cotas" no Console do Cloud:

    Acessar a página "Cotas"

  • instance-description é a descrição opcional da instância do Filestore.

  • file-name é o nome do arquivo de configuração json para o controle de acesso baseado em IP.

    Exemplo de arquivo de configuração json:

     {
    "--file-share":
      {
        "capacity": "4096",
        "name": "my_vol",
        "nfs-export-options": [
          {
            "access-mode": "READ_WRITE",
            "ip-ranges": [
              "10.0.0.0",
              "10.2.0.0"
            ],
            "squash-mode": "ROOT_SQUASH",
            "anon_uid": 1003,
            "anon_gid": 1003
          },
           {
            "access-mode": "READ_ONLY",
            "ip-ranges": [
              "10.0.1.0/28"
            ],
            "squash-mode": "NO_ROOT_SQUASH"
          }
        ],
      }
    }
    

    onde:

    • ip-ranges é o endereço IP ou o intervalo para conceder acesso. É possível especificar vários endereços IP ou intervalos separando-os com uma vírgula. Exemplo: 10.0.1.0, 10.0.2.0...
    • access-mode é o nível de acesso a ser concedido aos clientes com endereço IP dentro de ip-range. Ele pode ter os valores de READ_WRITE ou READ_ONLY. O valor padrão é READ_WRITE.
    • squash-mode pode ter os valores ROOT_SQUASH ou NO_ROOT_SQUASH. ROOT_SQUASH remove o acesso de nível raiz aos clientes com endereço IP dentro de ip-range, enquanto NO_ROOT_SQUASH ativa o acesso raiz. O valor padrão é NO_ROOT_SQUASH.
    • anon_uid é o valor do ID do usuário que você quer mapear para anon_uid. O valor padrão é 65534.
    • anon_gid é o valor do ID do grupo que você quer mapear para anon_gid. O valor padrão é 65534.
Exemplo

O exemplo a seguir atualiza a instância nfs-server aumentando o tamanho do compartilhamento de arquivos para 3 TB.

 gcloud beta filestore instances update nfs-server --zone=us-central1-c --file-share=name="vol1",capacity=3TB

A seguir