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 (somente instâncias Enterprise e 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. Se o sistema de arquivos ficar sem inodes, também será preciso adicionar capacidade. Para verificar o uso do inode, execute:

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, 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 é raro e só é uma preocupação se você precisar armazenar muitos arquivos pequenos.

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

O escalonamento de uma instância não afeta a disponibilidade dela e pode ser realizado enquanto a instância estiver em uso. A tabela a seguir mostra como a capacidade de compartilhamento de arquivos pode ser escalonada com base no nível do serviço:

Nível de serviço HDD básico SSD básico SSD de alta escala Empresas
Direção do escalonamento Somente para cima Somente para cima Para cima e para baixo Para cima e para baixo
Aumento de escalonamento 1GiB 1GiB 2.5TiB 256GiB
Capacidade mínima 1TiB 2.5TiB 10TiB 1TiB
Capacidade máxima 63.9TiB 63.9TiB 100TiB 10TiB

O escalonamento da capacidade de uma instância de SSD de alta escala pode demorar mais do que as instâncias de nível empresarial e básico. O tempo real necessário varia de acordo com a quantidade de dados armazenados na instância e a carga na instância do Filestore. Para garantir que as 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 do SSD Enterprise e de alta escala para um nível de capacidade menor do que o necessário para armazenar os dados e metadados do 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. Altere a descrição da instância, as regras de controle de acesso baseadas em IP e a 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:

Acessar o Console do Cloud

o comando gcloud para editar uma instância;

Para editar uma instância do Filestore, execute o comando instances update. Se você precisar atualizar as regras de configuração para controle de acesso baseado em IP, use 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: Além disso, se você estiver atualizando uma instância de SSD de alta escala, use o comando gcloud beta filestore instances update:

 gcloud [beta] filestore instances update instance-id
     --[project="project-id"]
     --[location=location]
     --[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
    
  • location é o local onde a instância do Filestore reside. Para instâncias da Enterprise, especifique uma região. Especifique uma zona para todas as outras instâncias. 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 GiB (padrão) ou TiB.

    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 do 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 no nível raiz dos clientes com endereços IP que se enquadram em 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 TiB.

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

A seguir