Crea una instancia

En esta página, se muestra cómo crear una instancia de Filestore mediante la consola de Google Cloud o gcloud CLI.

Instrucciones para crear una instancia

Consola de Google Cloud

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

    Vaya a la página de instancias de Filestore

  2. Haz clic en Crear instancia.

  3. Ingresa todos los campos obligatorios y opcionales, según sea necesario, de acuerdo con las instrucciones de las secciones siguientes de esta página.

  4. Haz clic en Crear.

gcloud

Antes de comenzar

Para usar gcloud CLI, debes instalar gcloud CLI o usar Cloud Shell que está integrado en la consola de Google Cloud:

Ve a la consola de Google Cloud.

Comando de gcloud para crear una instancia de Filestore

Puedes crear una instancia de Filestore mediante la ejecución del comando filestore instances create. La cuota para instancias varía según la región y el nivel. Para obtener más información, consulta Cuotas o Cómo solicitar un aumento de cuota.

gcloud filestore instances create instance-id \
    [--project=project-id] \
    [--location=location] \
    --tier=tier \
    --file-share=name="file-share-name",capacity=file-share-size \
    --network=name="vpc-network",[connect-mode=connect-mode],[reserved-ip-range="reserved-ip-address"]
    [--labels=key=value,[key=value,…]]
    [--kms-key=kms-key]

Reemplaza lo siguiente:

  • instance-id por el ID de la instancia de Filestore que deseas crear Consulta la sección sobre cómo asignar un nombre a la instancia.
  • project-id por el ID del proyecto de Google Cloud que contiene la instancia de Filestore Puedes omitir esta marca si la instancia de Filestore está en el proyecto predeterminado gcloud. Para configurar el proyecto predeterminado, ejecuta el comando config set project:

      gcloud config set project project-id
    
  • location por la ubicación en la que quieres que resida la instancia de Filestore. Consulta Cómo seleccionar una ubicación. Puedes omitir esta marca si la instancia de Filestore se encuentra en la ubicación predeterminada gcloud. Para establecer la ubicación predeterminada, ejecuta el comando config set filestore/zone:

      gcloud config set filestore/zone zone
    

    Para el nivel empresarial, usa el comando config set filestore/region:

      gcloud config set filestore/region region
    
  • tier por el nivel de servicio que quieres usar.

  • file-share-name por el nombre que especificas para el recurso compartido de archivos NFS que se entrega desde la instancia. Consulta Asigna un nombre a los archivos compartidos.

  • file-share-size es el tamaño que deseas para el recurso compartido de archivos. Consulta la sección sobre cómo asignar capacidad.

  • vpc-network por el nombre de la red de VPC que deseas que use la instancia Consulta Selecciona la red de VPC. Si deseas especificar una VPC compartida desde un proyecto de servicio, debes especificar el nombre de la red completamente calificado, que tiene el formato projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME y connect-mode=PRIVATE_SERVICE_ACCESS. Por ejemplo:

    --network=name=projects/host/global/networks/shared-vpc-1,connect-mode=PRIVATE_SERVICE_ACCESS
    

    No puedes especificar una red heredada para el valor vpc-network. Si es necesario, crea una nueva red de VPC para usar mediante las instrucciones de Crea una nueva red de VPC en modo automático.

  • connect-mode con DIRECT_PEERING o PRIVATE_SERVICE_ACCESS. Si especificas una VPC compartida como la red, también debes especificar PRIVATE_SERVICE_ACCESS como el modo de conexión.

  • reserved-ip-address por el rango de direcciones IP para la instancia de Filestore Si especificas connect-mode=PRIVATE_SERVICE_ACCESS y quieres usar un rango de direcciones IP reservado, debes especificar el nombre de un rango de direcciones asignado en lugar de un rango CIDR. Consulta Configura una dirección IP reservada. Te recomendamos omitir esta marca para permitir que Filestore encuentre de forma automática un rango de direcciones IP libre y lo asigne a la instancia.

  • key por la etiqueta que deseas agregar. No es necesario agregar etiquetas cuando se crea una instancia de Filestore. También puedes agregar, borrar o actualizar las etiquetas después de crear una instancia. Para obtener más información, consulta Administra etiquetas.

  • value por el valor de una etiqueta.

  • kms-key es el nombre completo de la clave de encriptación de Cloud KMS que quieres usar cuando quieres administrar tu propia encriptación de datos. El formato se ve así:

    projects/KMS_PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY
    

Ejemplo

El siguiente comando crea una instancia con las siguientes características:

  • El ID es render1.
  • El proyecto es myproject.
  • La zona es us-central1-c.
  • El nivel es BASIC_HDD.
  • El nombre del archivo compartido es my_vol.
  • El tamaño del archivo compartido es de 2 TiB.
  • La red de VPC es default.
  • El rango reservado de direcciones IP es 10.0.7.0/29.
  • Otorga acceso de lectura y escritura con squash de raíz al cliente con la dirección IP 10.0.2.0.
gcloud filestore instances create render1 \
  --project=myproject \
  --zone=us-central1-c \
  --tier=BASIC_HDD \
  --network=name="default",reserved-ip-range="10.0.7.0/29"
  --flags-file=nfs-export-options.json

nfs-export-options.json contenidos del archivo:

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

Comprende las instancias y los recursos compartidos

Una instancia de Filestore representa la capacidad de almacenamiento físico.

Un recurso compartido representa una parte asignada de ese almacenamiento con un punto de acceso individual y único.

Todos los niveles de servicio ofrecen opciones de almacenamiento con una proporción de 1:1 de uso compartido a instancia. Como alternativa, los recursos compartidos de Filestore para GKE, disponibles solo para instancias de nivel empresarial, ofrecen acceso a varios recursos compartidos en una sola instancia.

Los administradores usan los nombres o ID de las instancias para gestionarlas. Los clientes usan los nombres de los archivos compartidos para conectarse a los recursos exportados desde esas instancias.

Ingresa un nombre para la instancia

El nombre de tu instancia de Filestore, o ID de instancia, se usa para identificar la instancia y se usa en los comandos de gcloud. Los ID de instancia deben cumplir con el elemento <label> de RFC 1035. En particular, deben cumplir con los siguientes requisitos:

  • Tener entre 1 y 63 caracteres largos
  • Comenzar con una letra minúscula.
  • Constar de guiones, letras minúsculas o dígitos.
  • Terminar con letras minúsculas o dígitos.

El ID de la instancia debe ser único en el proyecto y la zona de Google Cloud en los que se encuentra. Una vez que se crea una instancia, no se puede cambiar su ID.

Selecciona un nivel de servicio

El nivel de servicio de una instancia de Filestore es una combinación de su tipo de instancia y tipo de almacenamiento. Una vez que se crea una instancia, su nivel de servicio no se puede cambiar.

Tipo de instancia

Selecciona el tipo de instancia que mejor se adapte a tus necesidades. En la siguiente tabla, se destacan las diferencias entre los tipos de instancias Basic, Zonal y Enterprise:

Capacidad Básico Zonal Enterprise
Capacidad De 1 TiB a 63.9 TiB De 1 TiB a 100 TiB 1 TiB a 10 TiB
Escalabilidad Escala verticalmente en incrementos de 1 GiB o sus múltiplos
  • Rango de capacidad baja y zonal: Aumenta o reduce la escala verticalmente en incrementos de 256 GiB o sus múltiplos.
  • Rango de capacidad alta y zonal: Aumenta o reduce la escala verticalmente en incrementos de 2.5 TiB o sus múltiplos.
Escala verticalmente en incrementos de 256 GiB o sus múltiplos
Rendimiento
  • HDD básico: Estático
  • SSD básico: paso de rendimiento a 10 TiB
Escala de forma lineal con la capacidad,
dentro de los límites del rango de capacidad elegido
Escala de forma lineal con la capacidad
Protocolo NFSv3 NFSv3 y NFSv4.1 NFSv3 y NFSv4.1

Las operaciones Create para instancias zonales y empresariales pueden tardar entre 15 minutos y una hora en completarse, según el tamaño de la instancia.

La cuota del almacén de archivos se consume cuando se inicia la creación de la instancia, pero no se te factura por ella durante este tiempo.

Para obtener una descripción más detallada de las funciones compatibles disponibles por nivel de servicio, consulta la página Niveles de servicio.

Tipo de almacenamiento

Para crear una instancia, selecciona el tipo de almacenamiento según tus necesidades de rendimiento. Por ejemplo, selecciona el nivel de servicio SSD básico para las cargas de trabajo críticas para el rendimiento.

En la siguiente tabla, se destaca la diferencia de rendimiento entre los niveles de servicio:

Especificación HDD básico SSD básico Zonal con rango de capacidad
más bajo
Zonal con rango de capacidad
más alto
Enterprise
IOPS de lectura
  • Capacidad entre 1 y 10 TiB: 600
  • Capacidad superior a 10 TiB: 1,000
60,000 De 9,200 a 89,700 De 92,000 a 920,000 De 12,000 a 117,000
IOPS de escritura
  • Capacidad entre 1 y 10 TiB: 1,000
  • Capacidad superior a 10 TiB: 5,000
25,000 De 2,600 a 25,350 De 26,000 a 260,000 De 4,000 a 40,000
Capacidad de procesamiento de lectura (MB/s)
  • Capacidad de 1 a 10 TiB: 100
  • Capacidad superior a 10 TiB: 180
1,200 De 260 a 2,535 De 2,600 a 26,000 De 120 a 1,200
Capacidad de procesamiento de escritura (MB/s)
  • Capacidad entre 1 y 10 TiB: 100
  • Capacidad superior a 10 TiB: 120
350 88-858 De 880 a 8,800 De 100 a 1,000

Para obtener más información sobre el rendimiento, consulta las páginas Rendimiento o Niveles de servicio.

Capacidad asignada

Asigna capacidad a la cantidad que necesitas cuando creas la instancia. A medida que te acercas al límite de capacidad, puedes escalar verticalmente la capacidad según sea necesario sin afectar el entorno de ejecución. Para obtener información sobre cómo supervisar la capacidad de tus instancias, consulta Supervisa instancias.

En gcloud CLI, puedes especificar la capacidad en números enteros con GiB o TiB. La unidad predeterminada es GiB.

En la siguiente tabla, se muestran los tamaños de instancia disponibles para cada nivel:

Nivel Tamaño mínimo Tamaño máximo Tamaño del paso incremental
HDD básico 1 TiB 63.9 TiB 1 GiB
SSD básico 2.5 TiB 63.9 TiB 1 GiB
Zonal con un rango de capacidad menor 1 TiB 9.75 TiB 256 GiB
Zonal con un rango de capacidad más alto 10 TiB 100 TiB 2.5 TiB
Empresa 1 TiB 10 TiB 256 GiB

El tamaño de las instancias puede ser cualquier valor de gibibyte completo o su equivalente en tebibyte que se encuentre entre el tamaño mínimo y máximo de la instancia y sea divisible por su tamaño del paso incremental. Por ejemplo, los tamaños válidos para las instancias de nivel zonal con un rango de capacidad más alto incluyen 10 TiB, 12.5 TiB y 15 TiB.

Una vez creadas, las instancias de nivel básico solo pueden escalar verticalmente en tamaño. Todos los demás niveles de servicio pueden aumentar o reducir la escala verticalmente en la capacidad. Para obtener más información, consulta Edita instancias y Escala la capacidad.

Cuota de capacidad total

A cada proyecto se le asignan cuotas de capacidad independientes para las instancias de nivel básico, zonal y empresarial de cada región. Una vez que alcances el límite de la cuota, no podrás crear más instancias de Filestore ni aumentar la capacidad de las instancias existentes. Para ver tu cuota disponible, ve a la página Cuotas en la consola de Google Cloud:

Ir a la página Cuotas

Para obtener información sobre cómo solicitar más cuota, consulta Cómo solicitar aumentos de cuota.

Asigna un nombre al archivo compartido

Un archivo compartido es el directorio de una instancia de Filestore en el que se almacenan todos los archivos compartidos. También es lo que activas o mapeas en la VM de cliente.

El nombre del sistema de archivos compartidos debe cumplir con los siguientes requisitos:

  • Tener entre 1 y 32 caracteres para los niveles zonal y empresarial, y de 1 a 16 caracteres para los niveles básicos
  • Comenzar con una letra.
  • Constar de letras mayúsculas o minúsculas, números y guiones bajos.
  • Debe terminar con una letra o un número.

Selecciona la red de VPC

La red que seleccionas para usar con Filestore puede ser una red de VPC estándar o una red de VPC compartida. En ambos casos, la red que elijas debe tener suficientes recursos de IP disponibles para dedicarse a la instancia de Filestore; de lo contrario, la instancia no se podrá crear.

Los clientes deben estar en la misma red que la instancia de Filestore para acceder a los archivos almacenados en esa instancia. Una vez que se crea una instancia, esta selección de red no se puede cambiar.

Red compartida de VPC

Antes de crear una instancia en una red de VPC compartida en un proyecto de servicio, el administrador de red debe habilitar el acceso a servicios privados para la red de VPC compartida. Si creas la instancia en el proyecto host, no se requiere acceso a servicios privados.

Las redes de VPC compartida se muestran en la consola de Google Cloud en el siguiente formato:

projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME

Para obtener procedimientos detallados, consulta Crea una instancia en una red de VPC compartida.

Bloqueo de archivos NFS

Si las aplicaciones que planeas usar con esta instancia de Filestore requieren bloqueo de archivos NFS y eliges una de las siguientes opciones, es posible que debas abrir los puertos que usa Filestore en la red que elijas:

  • Una red de VPC que no sea la predeterminada
  • La red de VPC predeterminada con reglas de firewall modificadas

Para obtener más información, consulta Configura las reglas de firewall.

Seleccionar una ubicación

La ubicación hace referencia a la región y a la zona en la que se encuentra la instancia de Filestore. A fin de obtener el mejor rendimiento y evitar los cargos de herramientas de redes interregionales, asegúrate de que la instancia de Filestore se encuentre en la misma región que las VM de Compute Engine que necesitan acceder a ellas.

Para obtener más información sobre las regiones y zonas, consulta Geografía y regiones.

Configura el control de acceso basado en IP

De forma predeterminada, una instancia de Filestore otorga acceso de lectura y escritura de nivel raíz a todos los clientes, incluidas las VM de Compute Engine y los clústeres de GKE, que comparten el mismo proyecto de Google Cloud y la misma red de VPC. Si deseas restringir el acceso, puedes crear reglas que otorguen niveles de acceso específicos a clientes según su dirección IP. Una vez que se agregan las reglas, todas las direcciones IP y los rangos que no se especifican en una regla se revocan. Las instancias de nivel zonal y empresarial admiten ajustes de configuración para rangos de direcciones IP que se superponen. Para obtener más información, consulta Cómo superponer permisos.

En la siguiente tabla, se describen los privilegios de cada nivel de acceso. Estos niveles de acceso solo se usan en la consola de Google Cloud. En gcloud CLI y la API, debes especificar los parámetros de configuración de las reglas directamente.

Nivel de acceso Configuración de la regla Descripción
admin
  • read-write
  • no-root-squash
El cliente puede ver y modificar todos los archivos, carpetas y metadatos como un usuario raíz. También puede otorgar la propiedad de los archivos o las carpetas estableciendo los parámetros uid y gid. Al hacerlo, otorga acceso a los clientes que no tienen acceso de nivel raíz al archivo compartido.
admin-viewer
  • read-only
  • no-root-squash
El cliente puede ver todos los archivos, carpetas y metadatos como un usuario raíz, pero no puede modificarlos.
editor
  • read-write
  • root-squash
El cliente puede ver y modificar los archivos, las carpetas y los metadatos según sus uid y gid asignados.
viewer
  • read-only
  • root-squash
El cliente puede ver los archivos, las carpetas y los metadatos según sus uid y gid asignados.

root-squash asigna todas las solicitudes de uid 0 y gid 0 a anon_uid y anon_gid, respectivamente. Esta configuración quita el acceso de nivel raíz a los clientes que intentan acceder al recurso compartido de archivos como usuario raíz.

Cuando crees reglas de acceso basadas en IP, ten en cuenta lo siguiente:

  • Debes especificar un rango o una dirección IP interna y el nivel de acceso otorgado.
  • Al menos una regla debe otorgar acceso a admin cuando se crea la instancia. Esta regla se puede quitar una vez que se crea la instancia.
  • Las instancias de nivel zonal y empresarial admiten ajustes de configuración para los rangos de direcciones IP superpuestas. No se admiten instancias de nivel básico. Para obtener más información, consulta Cómo superponer permisos.

En la consola de Google Cloud, puedes crear hasta 4 reglas diferentes (administrador, administrador-visualizador, editor y visualizador) que involucren hasta 64 rangos o direcciones IP diferentes.

En gcloud CLI, puedes configurar hasta 64 direcciones IP o bloques CIDR diferentes por instancia de Filestore en un máximo de 10 reglas diferentes. Una regla se define como la combinación de las configuraciones access-mode, squash-mode y anon_uid/anon_gid. Los campos anon_uid y anon_gid tienen valores predeterminados de 65534 y solo se pueden configurar a través de la API y lgcloud CLIud.

Ejemplo

Este es un ejemplo de tres reglas de acceso basadas en IP diferentes:

  • access-mode=READ_ONLY, squash-mode=ROOT_SQUASH, anon_uid=10000.
  • access-mode=READ_WRITE, squash-mode=ROOT_SQUASH, anon_gid=150.
  • access-mode=READ_WRITE, squash-mode=NO_ROOT_SQUASH.

Para crear reglas de control de acceso basadas en IP con gcloud CLI, usa la marca --flags-file con los comandos instances create o instances update y apunta a un archivo de configuración JSON. Por ejemplo, si el archivo de configuración JSON se llama nfs-export-options.json, la marca sería la siguiente:

--flags-file=nfs-export-options.json

Ejemplo de archivo de configuración JSON:

   {
  "--file-share":
    {
      "capacity": "2048",
      "name": "my_vol",
      "nfs-export-options": [
        {
          "access-mode": "READ_WRITE",
          "ip-ranges": [
            "10.0.0.0/29",
            "10.2.0.0/29"
          ],
          "squash-mode": "ROOT_SQUASH",
          "anon_uid": 1003,
          "anon_gid": 1003
        },
         {
          "access-mode": "READ_ONLY",
          "ip-ranges": [
            "192.168.0.0/26"
          ],
          "squash-mode": "NO_ROOT_SQUASH"
        }
      ]
    }
}
  • ip-ranges es la dirección IP o el rango al que se le otorga acceso. Puedes especificar varias direcciones IP o rangos de IP separándolos con una coma. Solo las instancias de nivel empresarial y zonales admiten parámetros de configuración para los rangos de direcciones IP superpuestos. Para obtener más información, consulta Permisos superpuestos.
  • access-mode es el nivel de acceso para otorgar a los clientes cuya dirección IP se encuentra dentro de ip-range. 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.

Clientes en rangos que no son de RFC 1918

Si planeas conectar clientes que no sean de RFC 1918 a la instancia de Filestore, debes otorgarles acceso de forma explícita a la instancia de Filestore mediante el control de acceso basado en IP.

Campos opcionales

En las siguientes secciones, se describen los campos opcionales.

Agrega una descripción de la instancia

Una descripción de la instancia te permite escribir descripciones, notas o instrucciones simples para ti y otros usuarios. Por ejemplo, puedes incluir información sobre lo siguiente:

  • Tipos de archivos almacenados en la instancia.
  • Quién tiene acceso a la instancia.
  • Instrucciones para obtener acceso a la instancia.
  • Para qué se usa la instancia.

Las descripciones de las instancias se limitan a 2,048 caracteres. No existen restricciones para los caracteres permitidos. Una vez que se crea una instancia de Filestore, puedes actualizar la descripción de la instancia en cualquier momento según sea necesario. Para obtener más información sobre la actualización de descripciones de instancias, consulta Edita instancias.

Agregar una etiqueta

Las etiquetas son pares clave-valor que puedes usar para agrupar las instancias relacionadas y almacenar metadatos de una instancia. Puedes agregar, borrar o modificar etiquetas en cualquier momento. Para obtener más información, consulta Administra etiquetas.

Configura un rango de direcciones IP reservado

Cada instancia de Filestore debe tener un rango de direcciones IP asociado. Se admiten los rangos de direcciones IP RFC 1918 y que no son RFC 1918 (GA).

Se recomienda que los usuarios permitan que Filestore determine automáticamente un rango de direcciones IP gratuito y lo asigne a la instancia. Cuando selecciones tu propio rango, ten en cuenta los siguientes requisitos de recursos de IP de Filestore:

  • Se debe usar la notación CIDR.

  • Debe ser un rango de subred de VPC válido.

  • Las instancias de nivel básico requieren un tamaño de bloque de 29. Por ejemplo, 10.123.123.0/29.

  • Las instancias de nivel zonal y empresarial requieren un tamaño de bloque de 26. Por ejemplo, 172.16.123.0/26.

  • El rango de direcciones IP no debe superponerse con lo siguiente:

    • Subredes existentes en la red de VPC que usa la instancia de Filestore.

    • Subredes existentes en una red de VPC que intercambia el tráfico con la que usa la instancia de Filestore. Para obtener más detalles, consulta Subredes que se superponen al momento del intercambio de tráfico.

    • Rangos de direcciones IP asignados a cualquier otra instancia existente de Filestore en esa red.

    • El rango de direcciones 172.17.0.0/16, ya que está reservado para componentes internos Para obtener más información, consulta Problemas conocidos.

  • Debe haber al menos un intercambio de tráfico entre redes de VPC o conexiones de acceso a servicios privados por VPC.

Para ver los rangos de direcciones IP de las subredes de tu red, ve a la página Redes de VPC en Google Cloud Console:

Ir a la página Redes de VPC

Puedes obtener el rango de direcciones IP reservadas para cualquier instancia de Filestore en la página de instancias de Filestore en Google Cloud Console:

Vaya a la página de instancias de Filestore

Si deseas usar el acceso privado a servicios y especificar un rango de direcciones IP reservado, debes especificar el nombre de un rango de direcciones asignado para la conexión. Si no especificas un nombre de rango, Filestore usa de forma automática cualquiera de los rangos asignados asociados con la conexión de acceso privado a los servicios.

Usar una clave de encriptación administrada por el cliente

De forma predeterminada, Google Cloud encripta los datos cuando están en reposo automáticamente mediante claves de encriptación administradas por Google. Si necesitas más control sobre las claves que protegen tus datos, puedes usar claves de encriptación administradas por el cliente (CMEK) para Filestore. Para obtener más información, consulta Encripta datos con claves de encriptación administradas por el cliente.

¿Qué sigue?