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
Antes de comenzar
La cuota para una instancia zonal (de 10 TiB a 100 TiB) o regional (de 10 TiB a 100 TiB) comienza en
0
. Si quieres usar estos niveles, primero debes crear una solicitud de aumento de cuota y recibir la aprobación para poder crear una instancia.Si necesitas crear una instancia con un nivel de servicio heredado, como una SSD de gran escala o empresarial, debes ejecutar tus operaciones directamente a través de la API de Filestore o con
gcloud
. Estas operacionescreate
no son compatibles con la consola de Google Cloud.Para obtener más información, consulta Niveles de servicio.
Instrucciones de Google Cloud
En la consola de Google Cloud, ve a la página de instancias de Filestore.
Haz clic en Crear instancia.
Ingresa todos los campos obligatorios y opcionales, según sea necesario, de acuerdo con las instrucciones de las secciones siguientes de esta página.
Haz clic en Crear.
gcloud
Antes de comenzar
Para usar gcloud CLI, debes instalar la CLI de gcloud o usar la de Cloud Shell que está integrada 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 las instancias varía según el proyecto, la región y el nivel. Para obtener más información, consulta Cuotas o Solicita 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 Asigna un nombre a tu 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 comandoconfig set project
:gcloud config set project project-id
location por la ubicación en la que deseas 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 comandoconfig set filestore/zone
:gcloud config set filestore/zone zone
Para el nivel regional o empresarial, usa el comando
config set filestore/region
:gcloud config set filestore/region region
tier por el nivel de servicio que deseas 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 Asigna 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 red completamente calificado, que tiene el formato
projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME
y debes especificarconnect-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
oPRIVATE_SERVICE_ACCESS
. Si especificas una VPC compartida como la red, también debes especificarPRIVATE_SERVICE_ACCESS
como el modo de conexión.reserved-ip-address por el rango de direcciones IP de la instancia de Filestore Si especificas
connect-mode=PRIVATE_SERVICE_ACCESS
y deseas usar un rango de direcciones IP reservado, debes especificar el nombre de un rango de direcciones asignadas en lugar de un rango de CIDR. Consulta Configura una dirección IP reservada. Te recomendamos que omitas 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 una etiqueta que desees 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 completamente calificado de la clave de encriptación de Cloud KMS que deseas usar cuando deseas administrar tu propia encriptación de datos. El formato se ve de la siguiente manera:
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 uso 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 uso compartido a instancia de 1:1. Como alternativa, los usos compartidos de varios archivos de Filestore para GKE, disponibles solo para instancias de nivel empresarial, ofrecen acceso a varios recursos compartidos en una sola instancia.
Los administradores utilizan los nombres de las instancias, o IDs, para gestionarlas. Los clientes usan los nombres de los archivos compartidos para conectarse a los archivos compartidos 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 la que se encuentra. Una vez que se crea una instancia, no se puede cambiar su ID.
Selecciona un nivel de servicio
Selecciona el nivel de servicio que mejor se adapte a tus necesidades. Una vez que se crea una instancia, su nivel de servicio no se puede cambiar. En la siguiente tabla, se resumen las funciones disponibles por nivel de servicio:
Capacidades | HDD básico y SSD básico |
Zonal | Regional | Enterprise |
---|---|---|---|---|
Capacidad | De 1 TiB a 63.9 TiB | De 1 TiB a 100 TiB | De 1 TiB a 100 TiB | 1 TiB a 10 TiB |
Escalabilidad | Escala verticalmente en incrementos de 1 GiB o sus múltiplos. |
|
|
Aumenta o reduce la escala verticalmente en incrementos de 256 GiB o sus múltiplos. |
Rendimiento |
|
Escala de forma lineal con capacidad, dentro de los límites del rango de capacidad elegido |
Escala de forma lineal con capacidad, dentro de los límites del rango de capacidad elegido |
Escala de forma lineal con capacidad |
Protocolo | NFSv3 | NFSv3 y NFSv4.1 (vista previa) | NFSv3 y NFSv4.1 (vista previa) | NFSv3 y NFSv4.1 (vista previa) |
Las operaciones de Create
para instancias zonales, regionales 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.
Rendimiento
En la siguiente tabla, se proporciona una comparación más detallada del rendimiento entre los niveles de servicio:
Especificación | HDD básico | SSD básico | Zonal | Regional | Enterprise |
---|---|---|---|---|---|
IOPS de lectura |
|
60,000 |
|
|
Capacidad de 1 TiB a 10 TiB: de 12,000 a 120,000 |
IOPS de escritura |
|
25,000 |
|
|
Capacidad de 1 TiB a 10 TiB: de 4,000 a 40,000 |
Capacidad de procesamiento de lectura (MB/s) |
|
1,200 |
|
|
Capacidad de 1 TiB a 10 TiB: de 120 a 1,200 |
Capacidad de procesamiento de escritura (MB/s) |
|
350 |
|
|
Capacidad de 1 TiB a 10 TiB: de 100 a 1,000 |
Para obtener más información sobre el rendimiento, consulta Rendimiento.
Para obtener una descripción más detallada de las funciones disponibles por nivel de servicio, consulta Niveles de servicio.
Capacidad asignada
Asigna capacidad a la cantidad que necesites cuando crees 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 puedes 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 | 1 TiB | 9.75 TiB | 256 GiB |
Zonal | 10 TiB | 100 TiB | 2.5 TiB |
Regional | 1 TiB | 9.75 TiB | 256 GiB |
Regional | 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 de 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 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 su capacidad. Para obtener más información, consulta Edita instancias y Escala la capacidad.
Cuota de capacidad total
A cada proyecto se le asigna una cuota de capacidad distinta, definida por región y nivel de servicio. Los límites de cuota varían según el nivel de servicio.
Una vez que alcances el límite de 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:
Para obtener información sobre cómo solicitar un aumento de cuota, consulta Solicita 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, regional 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 eliges usar con Filestore puede ser una red de VPC estándar o una de VPC compartida. En ambos casos, la red que elijas debe tener suficientes recursos 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, no se puede cambiar esta selección de red.
Red compartida de VPC
Antes de poder crear una instancia en una red de VPC compartida en un proyecto de servicio, primero el administrador de red debe habilitar el acceso privado a servicios para la red de VPC compartida. Si creas la instancia en el proyecto host, no se requiere acceso privado a los servicios.
Las redes de VPC compartida se muestran en Google Cloud Console 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 alguna 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 reglas de firewall.
Selecciona 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 a 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 zonales, regionales y empresariales admiten ajustes de configuración para la superposición de rangos de direcciones IP. Para obtener más información, consulta Permisos superpuestos.
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 |
|
El cliente puede ver y modificar todos los archivos, carpetas y metadatos como un usuario raíz. También puede establecer los valores de uid y gid para otorgar propiedad a archivos o carpetas y, al hacerlo, otorgar acceso a los clientes que no tengan acceso de nivel raíz al archivo compartido. |
admin-viewer |
|
El cliente puede ver todos los archivos, carpetas y metadatos como un usuario raíz, pero no puede modificarlos. |
editor |
|
El cliente puede ver y modificar los archivos, las carpetas y los metadatos según sus uid y gid asignados. |
viewer |
|
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 cree la instancia. - Las instancias zonales, regionales y empresariales admiten ajustes de configuración para la superposición de rangos de direcciones IP. No se admiten las instancias de nivel básico. Para obtener más información, consulta Permisos superpuestos.
En la consola de Google Cloud, puedes crear hasta 4 reglas diferentes (admin
, admin-viewer
, editor
, viewer
) que incluyan hasta 64 direcciones IP o rangos de 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. 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 gcloud CLI.
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 apúntala 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 si los separas con una coma. Solo las instancias zonales, regionales y empresariales admiten parámetros de configuración para la superposición de rangos de direcciones IP. 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
oREAD_ONLY
. El valor predeterminado esREAD_WRITE
. - squash-mode puede tener los valores
ROOT_SQUASH
oNO_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 queNO_ROOT_SQUASH
habilita el acceso raíz. El valor predeterminado esNO_ROOT_SQUASH
. - anon_uid es el valor de ID de usuario que deseas asignar a
anon_uid
. El valor predeterminado es65534
. - anon_gid es el valor del ID del grupo que deseas asignar a
anon_gid
. El valor predeterminado es65534
.
Clientes en rangos que no son RFC 1918
Si planeas conectar clientes que no sean RFC 1918 a la instancia de Filestore, debes otorgarles acceso a la instancia de Filestore de forma explícita mediante el control de acceso basado en IP.
Campos opcionales
En las siguientes secciones, se describen los campos opcionales.
Agrega una descripción de instancia
Una descripción de instancia te permite escribir descripciones, notas o instrucciones 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 etiquetas
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 rangos de direcciones IP RFC 1918 y que no sean RFC 1918 (GA).
Una vez especificado, el rango de direcciones IP de una instancia es inmutable.
Se recomienda a los usuarios que dejen que Filestore determine de forma automática 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 básicas requieren un tamaño de bloque de 29. Por ejemplo,
10.123.123.0/29
.Las instancias zonales, regionales y empresariales 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
está reservado para los componentes internos de Filestore. Como resultado, se aplican las siguientes limitaciones:Los clientes de este rango no se pueden conectar a instancias de Filestore.
No se pueden crear instancias de Filestore dentro de este rango de IP. Para obtener más información, consulta Problemas conocidos.
Debe haber al menos una conexión de intercambio de tráfico entre redes de VPC o de acceso a servicios privados por VPC.
Puedes ver los rangos de direcciones IP de las subredes de tu red en la página Redes de VPC en la consola de Google Cloud:
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 de forma automática 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 detalles, consulta Encripta datos con claves de encriptación administradas por el cliente.
¿Qué sigue?
- Aprende a configurar una instancia para usarla con el protocolo NFSv4.1.
- Obtén información para conectar instancias a clientes:
- Activar el archivo compartido de Filestore en una instancia de VM de Compute Engine.
- Accede a las instancias de Filestore con el controlador de CSI de Filestore
- Usa instancias de Filestore como almacenes de datos externos para hosts de VMware ESXi en VMware Engine.
- Activa archivos compartidos en clientes remotos.
- Activa una instancia de Filestore en un servicio de Cloud Run para compartir datos entre contenedores y servicios.
- Ve cómo recuperar detalles de la instancia, como la dirección IP de la instancia, para acceder a los archivos compartidos de Filestore desde los clientes.
- Soluciona problemas de creación de instancias relacionados con Filestore
- Obtén más información sobre las redes y subredes de nube privada virtual (VPC).
- Obtén más información sobre los requisitos de recursos de red y de IP para Filestore.