Configurar la replicación de instancias

En esta guía se explica cómo usar la replicación de instancias de Filestore.

Antes de empezar

1. Completa los pasos de configuración necesarios para usar Filestore. La cuota de instancias varía según el proyecto, la región y el nivel. Asegúrate de que tienes suficiente para completar estas tareas. Para obtener más información, consulta Cuotas o Solicitar un aumento de cuota.

2. Si aún no lo has hecho, crea una instancia de Filestore. En el contexto de esta guía, se trata de la instancia de origen.

   Nota: La replicación de instancias está disponible en los niveles de servicio
   regionales, zonales y Enterprise.

Crear una réplica de una instancia

Google Cloud consola

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

   Ir a instancias de Filestore

2. Haga clic en el ID de instancia de la instancia que quiera replicar.

3. En la sección Descripción, haga clic en la pestaña Réplicas.

4. Haz clic en Crear réplica.

5. Haz clic en el enlace de documentación para consultar el objetivo de punto de recuperación (RPO) admitido y, a continuación, haz clic en Siguiente.

6. Rellena todos los campos obligatorios y los opcionales que necesites.

   • La capacidad especificada debe ser igual o superior a la de la fuente.
   • Las siguientes especificaciones deben coincidir con la instancia de origen:
     • Nivel de servicio, incluida la capacidad
     • Protocolo Filestore
   • Para reducir el riesgo de pérdida de datos, se recomienda a los usuarios que elijan una región y una zona únicas para la fuente.

7. Haz clic en Siguiente.

8. Revisa los detalles y haz clic en Siguiente.

9. Haz clic en Crear.

10. Espera a que termine la operación. Cuando haya terminado, la réplica se mostrará en la página Instancias, debajo de la instancia de origen.

11. Haga clic en el ID de instancia de la réplica para ver sus detalles.

gcloud

1. Puedes crear una instancia réplica ejecutando el comando filestore instances create.

   gcloud filestore instances create INSTANCE-ID \
       --source-instance=SOURCE-INSTANCE \
       --project=PROJECT-ID \
       --location=LOCATION \
       --network=name="NETWORK" \
       --tier=TIER \
       --file-share=name="FILE-SHARE-NAME",capacity=FILE-SHARE-SIZE \
   

Haz los cambios siguientes:

• INSTANCE-ID con el nombre de la instancia que quieras crear, como my-replica.
• SOURCE-INSTANCE con el nombre y la ubicación de la instancia de origen de la que quieras crear una réplica. Por ejemplo, projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
• PROJECT-ID por el ID del proyecto Google Cloud en el que se encuentra la instancia de origen.
• LOCATION por la ubicación en la que quieras que se encuentre la instancia de réplica, como us-central1-a. Si la fuente está en un nivel de servicio zonal, debes especificar una región y una zona para la réplica.
• NETWORK con el nombre de la red que quieras usar, como default.
• TIER con el nivel de servicio que necesites, como ZONAL. El nivel y el intervalo de capacidad deben coincidir con los de la fuente.
• FILE-SHARE-NAME con el nombre que especifiques para el recurso compartido de archivos NFS que se sirve desde la instancia, como vol1.
• FILE-SHARE-SIZE con el tamaño que quieras para el archivo compartido, como 1.25TB. La capacidad debe ser igual o superior a la de la fuente y, si procede, debe estar en el mismo intervalo de capacidad.

API REST

1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     -d '{"tier": "TIER",
         "networks": { "network": "NETWORK" },
         "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"},
         "replication": {"replicas":[{"peer_instance": "projects/PROJECT/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"},
         "description": "DESCRIPTION" }' \
     "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"
   

   Donde:

   • TIER es el nombre del nivel de servicio que quieres usar en la réplica. Por ejemplo, REGIONAL.
   • NETWORK es el nombre de la red que quieres usar para la réplica. Por ejemplo, default. Debes usar la misma red que la fuente.
   • SHARE_NAME es el nombre del recurso compartido de archivos. Por ejemplo, vol1.
   • CAPACITY es el tamaño, en GiB, que quieres asignar a la réplica. Por ejemplo, 1024. La capacidad debe ser igual o superior a la de la instancia de origen.
   • PROJECT es el nombre del proyecto en el que se ubicará tu réplica. Por ejemplo, my-genomics-project. El origen y la réplica deben estar en el mismo proyecto.
   • ACTIVE_LOCATION es la ubicación en la que se encuentra la fuente. Por ejemplo, us-east1.
   • ACTIVE_NAME es el nombre de la instancia que quieres replicar. Por ejemplo, my-genomics-instance.
   • DESCRIPTION es una descripción de la instancia de réplica que quieres crear. Por ejemplo, My genomics replica.
   • REPLICA_LOCATION es la ubicación en la que quieres que se encuentre la réplica. Por ejemplo, us-central1.
   • REPLICA_INSTANCE_NAME es el nombre de la instancia de réplica que quieres crear. Por ejemplo, my-genomics-replica.

Ver el estado de una instancia

Google Cloud consola

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

   Ir a instancias de Filestore

2. Haga clic en el ID de instancia de la réplica que quiera ver.

3. En la sección Descripción, haga clic en la pestaña Réplicas.

4. Aquí puede ver el Estado de la réplica y el Último punto de sincronización, que es una marca de tiempo de la última vez que se copió una copia completa de sus datos en la réplica.

gcloud

1. Para ver información sobre una instancia específica, ejecuta el comando instances describe:

   gcloud filestore instances describe INSTANCE-ID \
       --project=PROJECT-ID \
       --location=LOCATION \
   

Haz los cambios siguientes:

• INSTANCE-ID por el ID de instancia de la instancia de Filestore que quieras ver, como genomics-instance.
• PROJECT-ID con el ID del proyecto Google Cloud que contiene la instancia de Filestore.

• LOCATION con la ubicación en la que reside la instancia, como us-east1-b.

  La respuesta al comando instances describe es similar a cualquiera de los siguientes ejemplos.

  En este ejemplo de respuesta se muestra una instancia de origen con la replicación de instancias habilitada. Fíjate en que el rol especificado es ACTIVE:

  createTime: '2024-06-17T22:17:26.475900265Z'
  fileShares:
  - capacityGb: '1024'
    name: vol1
  name: projects/genomics-project/locations/us-east1-b/instances/genomics-instance-source
  networks:
  - connectMode: DIRECT_PEERING
    ipAddresses:
    - 172.27.220.2
    modes:
    - MODE_IPV4
    network: default
    reservedIpRange: 172.27.220.0/26
  replication:
    replicas:
    - peerInstance: projects/genomics-project/locations/us-central1-a/instances/genomics-instance-replica
      state: READY
    role: ACTIVE
  state: READY
  tier: ZONAL
  

  En este ejemplo de respuesta se muestra una instancia de réplica que se ha ascendido a instancia normal. Ten en cuenta que la replicación no se especifica porque aún no se ha habilitado:

  createTime: '2024-06-20T17:11:56.048062134Z'
  fileShares:
  - capacityGb: '1024'
    name: vol1
  name: projects/genomics-project/locations/us-west2-a/instances/genomics-instance-replica
  networks:
  - connectMode: DIRECT_PEERING
    ipAddresses:
    - 10.155.90.194
    network: default
    reservedIpRange: 10.155.90.192/26
  satisfiesPzi: true
  state: READY
  tier: ZONAL
  

  En este ejemplo de respuesta se muestra una réplica que se ha emparejado con una instancia activa. Verás que el rol aparece como STANDBY:

  createTime: '2024-06-21T04:15:21.721579074Z'
  fileShares:
  - capacityGb: '1280'
    name: vol1
  name: projects/genomics-project/locations/us-west1-a/instances/genomics-replica
  networks:
  - connectMode: DIRECT_PEERING
    ipAddresses:
    - 10.153.44.194
    network: default
    reservedIpRange: 10.153.44.192/26
  replication:
    replicas:
    - peerInstance: projects/genomics-project/locations/us-west2-a/instances/genomics-instance
      state: READY
    role: STANDBY
  satisfiesPzi: true
  state: READY
  tier: ZONAL
  

API REST

1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

   Donde:

   • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project.
   • LOCATION es la ubicación en la que reside tu instancia. Por ejemplo, us-west1-a.
   • INSTANCE_NAME es el nombre de la instancia que quieres ver. Por ejemplo, my-genomics-instance.

Mostrar todas las instancias de un proyecto

Google Cloud consola

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

   Ir a instancias de Filestore

   Las réplicas se muestran en las instancias de origen asociadas.

gcloud

1. Para ver una lista de todas las instancias del proyecto, ejecuta el comando instances list:

   gcloud filestore instances list
       --project=PROJECT-ID \
   

   Haz los cambios siguientes:

   • PROJECT-ID por el ID del proyecto que quieras ver.

   La respuesta devuelve algo similar a lo siguiente:

   INSTANCE_NAME                       LOCATION     TIER      CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS     STATE  CREATE_TIME
   genomics-source-1                   us-east1-b   ZONAL     1024         vol1             172.27.220.2   READY  2024-06-17T22:17:26
   genomics-source-1-replica           us-west1-a   ZONAL     1024         vol1             10.142.57.194  READY  2024-06-17T23:47:19
   

API REST

1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

   Donde:

   • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project.
   • LOCATION es la ubicación que quieres buscar. Para buscar todas las instancias de cualquier ubicación de un proyecto, usa -.

Interrumpir la replicación y promocionar la réplica

En esta sección, romperás la replicación entre las instancias activa y de espera. Esta acción convierte la réplica en una instancia normal.

• Esta operación es irreversible y debe usarse con precaución.

• Una vez que se haya ascendido a una instancia normal, el recurso se podrá emparejar con una nueva réplica.

• La conmutación por error no es automática. Una vez que se haya completado la operación para interrumpir la replicación, los administradores deben volver a conectar sus aplicaciones a la nueva instancia de origen. Para obtener más información, consulta el artículo Promover una réplica.

Google Cloud consola

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

   Ir a instancias de Filestore

2. Haz clic en el ID de instancia de la réplica que quieras usar.

3. Haz clic en Romper replicación.

4. Lee la alerta antes de continuar.

   Si detienes la replicación, se interrumpirá permanentemente la sincronización de datos y se convertirán las instancias activa y de espera en instancias normales. Los cambios que se hagan después del último punto de sincronización registrado no se replicarán. Esta acción es irreversible.

5. Introduce el ID de instancia de la réplica y haz clic en Romper replicación.

6. Espera a que la operación se complete correctamente.

gcloud

1. Para promover una instancia de réplica, ejecuta el comando gcloud filestore instances promote-replica.

   gcloud filestore instances promote-replica INSTANCE-ID \
       --project=PROJECT-ID \
       --location=LOCATION \
   

Haz los cambios siguientes:

• INSTANCE-ID con el ID de instancia de la instancia de Filestore que quieras promocionar, como my-replica.
• PROJECT-ID por el ID del proyecto Google Cloud que contiene la instancia de Filestore.
• LOCATION con la ubicación en la que se encuentra la réplica, como us-central1.

Si se completa correctamente, se devuelve la siguiente respuesta o una similar:

capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
  name: vol1
maxCapacityGb: '9984'
maxShareCount: '1'
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.155.90.194
  network: default
  reservedIpRange: 10.155.90.192/26
protocol: NFS_V3
replication:
  replicas:
  - lastActiveSyncTime: '2024-06-21T00:13:23Z'
    peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
  role: STANDBY
satisfiesPzi: true
state: PROMOTING
tier: ZONAL

API REST

1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"

   Donde:

   • PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, my-genomics-project.
   • LOCATION es la ubicación en la que reside la réplica. Por ejemplo, us-west1-a.
   • REPLICA_NAME es el nombre de la instancia que quieres promocionar. Por ejemplo, my-genomics-replica.

Eliminar una instancia

Google Cloud consola

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

   Ir a instancias de Filestore

   Las réplicas se muestran en las instancias de origen asociadas. Si no ves ninguna réplica, consulta los gcloud comandos de esta tarea.

2. Haz clic en el ID de instancia de la instancia que quieras eliminar.

3. Haz clic en Eliminar.

gcloud

1. Para ver una lista de todas las instancias del proyecto, ejecuta el comando instances list:

   gcloud filestore instances list
       --project=PROJECT-ID \
   

   Haz los cambios siguientes:

   • PROJECT-ID por el ID del proyecto que quieras ver.

2. Copia los detalles de la instancia que quieras eliminar.

3. Para eliminar una instancia, ejecuta el comando filestore instances delete.

   gcloud filestore instances delete INSTANCE-ID \
       --location=LOCATION \
   

Haz los cambios siguientes:

• INSTANCE-ID con el ID de instancia de Filestore que quieras eliminar, como my-replica.
• LOCATION con la ubicación en la que se encuentra la réplica, como us-central1-a.

API REST

1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

2. Usa cURL para llamar a la API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     --request DELETE "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

   Donde:

   • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project.
   • LOCATION es la ubicación en la que reside tu instancia. Por ejemplo, us-west1-a.
   • INSTANCE_NAME es el nombre de la instancia que quieres eliminar. Por ejemplo, my-genomics-instance.

Monitorizar la replicación de instancias

Google Cloud consola

Para ver las métricas de replicación de instancias de Filestore en un panel de control de Cloud Monitoring, sigue estos pasos:

1. Antes de empezar, asegúrate de que tienes acceso a los siguientes roles:

   • Lector de supervisión
   • Editor de Monitoring

   Para ver cómo conceder acceso a estos roles, consulta Conceder acceso a Cloud Monitoring.

2. En la Google Cloud consola, ve a la página  Explorador de métricas:

   Ve al explorador de métricas.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

3. Haga clic en la sección desplegable Seleccionar una métrica.

4. En el campo Filtrar por nombre de recurso o métrica, escribe filestore y selecciona la sección desplegable Instancia de Filestore.

5. Seleccione la sección desplegable Instancia y, a continuación, haga clic en RPO.

6. Se muestra la métrica de RPO times_since_last_replication. Esta métrica estará disponible varios minutos después de que se complete la sincronización inicial de los datos replicados.

Siguientes pasos

• Acerca de la replicación de instancias
• Documentación de referencia de la replicación de instancias