Nesta página, mostramos como editar uma instância do Filestore usando o Console do Cloud ou a CLI gcloud
.
Depois de criada, é possível modificar uma instância do Filestore das seguintes maneiras:
- Aumente sua capacidade.
- Reduzir a capacidade (somente instâncias do 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 nós-i, também será preciso adicionar capacidade. Para verificar o uso do nó-i, 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-i, não será possível armazenar mais arquivos no compartilhamento de arquivos, mesmo que a capacidade máxima alocada não tenha sido atingida. A única maneira de adicionar inodes é adicionar capacidade. No entanto, alcançar o máximo de nós-i é raro e só será 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 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 | 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 instâncias SSD de alta escala e do Enterprise pode demorar mais do que as instâncias de nível Básico. O tempo real necessário depende da quantidade de dados armazenados na instância e da carga na instância do Filestore. 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 dimensionar uma instância do Enterprise e de SSD de alta escala para um nível de capacidade inferior ao 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
Console do Cloud
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:
No Console do Cloud, acesse a página de instâncias do Filestore.
Clique no código da instância que você quer editar.
Na página Detalhes da instância, clique em Editar para acessar a página Editar instância.
Altere a descrição da instância, as regras de controle de acesso com base em IP e a capacidade conforme necessário. Para detalhes, consulte Como criar instâncias.
Clique em Salvar.
gcloud
Antes de começar
Para usar a CLI gcloud
, instale a CLI gcloud
ou use o Cloud Shell
criado no Console do Cloud:
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]
em que:
- 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 do Enterprise, especifique uma região. Para todas as outras instâncias, especifique uma zona. 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ãogcloud
. 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) ouTiB
.Para ver sua cota disponível, acesse a página "Cotas" no Console do Cloud:
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" } ], } }
em que:
- 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
ouREAD_ONLY
. O valor padrão éREAD_WRITE
. - squash-mode pode ter os valores
ROOT_SQUASH
ouNO_ROOT_SQUASH
.ROOT_SQUASH
remove o acesso de nível raiz aos clientes com endereço IP dentro de ip-range, enquantoNO_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
.
- 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:
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
- Crie outra instância.
- Monte o compartilhamento de arquivos do Filestore em uma instância de VM do Compute Engine.
- Acesse o compartilhamento de arquivos do Filestore em um cluster do Google Kubernetes Engine.