Edita instancias

En esta página, se muestra cómo editar una instancia de Filestore mediante Cloud Console o la herramienta de gcloud.

Una vez creada, puedes modificar una instancia de Filestore de las siguientes maneras:

  • Aumenta su capacidad
  • Disminuye su capacidad (solo instancias de SSD de escala masiva).
  • Cambia su descripción.
  • Administra las reglas de control de acceso basadas en IP.
  • Administra etiquetas (Para obtener más información, consulta Administra etiquetas.)

Capacidad de escalamiento

Cuando uses Filestore, te recomendamos supervisar el uso de tus instancias de Filestore para que puedas ajustar la capacidad según sea necesario. Por ejemplo, si observas que una instancia de nivel de escala masiva ya no necesita toda su capacidad asignada, podrías considerar reducirla. De manera similar, si observas que se está quedando sin capacidad, te recomendamos escalarla verticalmente para evitar que se interrumpan tus aplicaciones. También debes agregar capacidad si el sistema de archivos se queda sin inodos. Para verificar si este es el caso, ejecuta el siguiente comando desde la VM del cliente:

df -i

El comando mostrará algo similar a lo siguiente:

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

Cada archivo almacenado en el recurso compartido de archivos consume un solo inodo. Si el sistema de archivos se queda sin inodos, no podrás almacenar más archivos en el recurso compartido de archivos, incluso si no alcanzaste la capacidad asignada máxima. La única forma de agregar nodos es agregar capacidad. Sin embargo, llegar a la cantidad máxima de inodos es muy poco frecuente y solo sería una preocupación si necesitas almacenar una gran cantidad de archivos muy pequeños.

Diferencias en el comportamiento de escalamiento por nivel de servicio

Las instancias de nivel Básico solo se pueden escalar en incrementos de 1 GB o sus múltiplos. Las instancias de nivel de escala masiva pueden escalarse hacia arriba o hacia abajo en incrementos de 10 TB o sus múltiplos. Escalar una instancia no afecta su disponibilidad y se puede realizar mientras la instancia está en uso. En la siguiente tabla, se muestra cómo se puede escalar la capacidad de los archivos compartidos en función del nivel de servicio:

Nivel de servicio HDD básico SSD básico SSD de escala masiva
Dirección de escalamiento Solo verticalmente Solo verticalmente Verticalmente o reducir el escalamiento
Incremento de escalamiento 1GB 1GB 10TB
Capacidad mínima 1TB 2.5TB 60TB
Capacidad máxima 63.9TB 63.9TB 320TB

Además, las instancias de nivel SSD de escala masiva requieren mucho más tiempo para completar una operación de escalamiento en comparación con las instancias de HDD básico y SSD básico. Para escalar verticalmente la capacidad de una instancia de escala masiva, se requieren de 26 a 48 horas a fin de que se complete, y reducir el escalamiento requiere más de 20 horas para completarse. El tiempo real necesario varía según la cantidad de datos almacenados en la instancia y la carga en la VM del cliente. Para asegurarte de que tus instancias no se queden sin capacidad, realiza estas operaciones con anticipación.

Cuando se realiza una operación de escalamiento, no puedes cancelar la operación ni realizar otras modificaciones en la instancia. Las operaciones de lectura y escritura son ininterrumpidas. Tampoco puedes escalar una instancia de SSD de escala masiva a un nivel de capacidad que esté por debajo de lo necesario para almacenar sus metadatos y datos de archivo existentes. Intentar hacerlo da como resultado un error.

Instrucciones para editar una instancia

Cloud Console

Para editar las instancias de Filestore con Cloud Console, navega a la página Editar instancia, en la que puedes editar la descripción de la instancia, administrar las reglas de control de acceso basadas en IP y escalar el rendimiento de archivos compartidos:

  1. En Cloud Console, ve a la página de instancias de Filestore.

    Vaya a la página de instancias de Filestore

  2. Haz clic en el ID de la instancia que deseas editar.

  3. En la página Detalles de la instancia, haz clic en Editar para ir a la página Editar instancia.

  4. Realiza cambios en la descripción de la instancia, las reglas de control de acceso basadas en IP y la capacidad según sea necesario. Para obtener más información, consulta Crea instancias.

  5. Haga clic en Save.

gcloud

Antes de comenzar

Para usar la herramienta gcloud, debes instalar el SDK de Cloud o usa Cloud Shell que está integrado en Cloud Console:

Ir a Cloud Console

Comando gcloud para editar una instancia de Filestore

Para editar una instancia de Filestore, ejecuta el comando instances update. Si necesitas actualizar las reglas de configuración para el control de acceso basado en IP, debes usar el comando gcloud beta instances update con la marca --flags-file y especificar un archivo de configuración json. Si eliges este método, no necesitas usar la marca --file-share porque ya está incluida en el archivo de configuración 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]

Donde:

  • instance-id es el ID de la instancia de Filestore que deseas editar.
  • project-id es el ID del proyecto de Cloud que contiene la instancia de Filestore. Puedes omitir esta marca si la instancia de Filestore está en el proyecto predeterminado gcloud. Puedes configurar el proyecto predeterminado si ejecutas lo siguiente:

     gcloud config set project project-id
    
  • zone es la zona donde reside la instancia de Filestore. Ejecuta el comando gcloud filestore zones list para obtener una lista de zonas compatibles. Puedes omitir esta marca si la instancia de Filestore se encuentra en la zona predeterminada gcloud. Para configurar la zona predeterminada, ejecuta el siguiente comando:

     gcloud config set filestore/zone zone
    
  • file-share-name es el nombre del archivo compartido que se entrega desde la instancia de Filestore. Los nombres de los archivos compartidos no se pueden cambiar después de crear la instancia.

  • file-share-size es el tamaño nuevo que deseas para el recurso de archivos compartidos. Puedes especificar el tamaño del archivo compartido en números enteros con GB (predeterminado) o TB.

    Para ver tu cuota disponible, ve a la página Cuotas en Cloud Console:

    Ir a la página Cuotas

  • instance-description es la descripción opcional de la instancia de Filestore.

  • file-name es el nombre del archivo de configuración json para el control de acceso basado en IP.

    Ejemplo de archivo de configuración 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"
          }
        ],
      }
    }
    

    Donde:

    • ip-primero es la dirección IP o el rango al que se debe otorgar acceso. Puedes especificar varias direcciones IP o rangos si los separas con una coma. Ejemplo: 10.0.1.0, 10.0.2.0,...
    • access-mode es el nivel de acceso para otorgar a los clientes cuya dirección IP se encuentra dentro del ip-rango. Puede tener los valores de READ_WRITE o READ_ONLY. El valor predeterminado es READ_WRITE.
    • squash-mode puede tener los valores ROOT_SQUASH o NO_ROOT_SQUASH. ROOT_SQUASH quita el acceso de nivel raíz a los clientes cuya dirección IP se encuentra dentro de ip-range, mientras que NO_ROOT_SQUASH habilita el acceso raíz. El valor predeterminado es NO_ROOT_SQUASH.
    • anon_uid es el valor de ID de usuario que deseas asignar a anon_uid. El valor predeterminado es 65534.
    • anon_gid es el valor del ID del grupo que deseas asignar a anon_gid. El valor predeterminado es 65534.
Ejemplo

El siguiente ejemplo actualiza la instancia nfs-server al aumentar el tamaño del archivo compartido a 3 TB.

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

Qué sigue