Administra la replicación de instancias

En esta guía, se muestra cómo configurar la replicación de instancias para vincular una instancia de origen con una réplica en espera. Puedes usar la replicación de instancias en los siguientes casos:

  • Protege las instancias contra las interrupciones: Mantén una instancia de conmutación por error entre regiones actualizada de forma continua para la recuperación ante desastres.
  • Migrar datos: Promueve una réplica en espera para migrar de forma permanente una instancia a una ubicación nueva con un tiempo de inactividad mínimo.
  • Ejecuta pruebas operativas: Pausa la replicación para activar temporalmente la réplica y ejecutar simulacros de recuperación ante desastres aislados o cargas de trabajo de prueba sin afectar tu instancia principal.

Antes de comenzar

Crea una instancia de Filestore para usarla como instancia de origen de tu réplica.

Habilita las APIs

Habilita la API de Filestore.

Roles necesarios para habilitar las APIs

Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para configurar la replicación de instancias y supervisar las réplicas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Si creas una réplica entre proyectos, debes tener el rol de editor de Cloud Filestore (roles/file.editor) establecido en los proyectos de origen y de réplica. Este rol incluye el permiso file.instances.create, que se requiere en el proyecto de origen para crear una réplica entre proyectos.

Crea una réplica de instancia

No puedes usar la consola de Google Cloud para crear una réplica entre proyectos. En su lugar, usa gcloud CLI o la API de REST.

Consola de Google Cloud

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

    Ir a Instancias

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

  3. En la página de detalles de la instancia, haz clic en la pestaña Replicaciones.

  4. Haz clic en Crear réplica.

  5. Verifica los detalles de la instancia de origen, revisa el objetivo de punto de recuperación admitido y haz clic en Siguiente.

  6. Crea la instancia. Para obtener más información, consulta Crea una instancia. Ten en cuenta lo siguiente:

    • La capacidad especificada debe ser mayor o igual que la capacidad de la instancia de origen.
    • El nivel de servicio y el protocolo de Filestore deben ser los mismos para la instancia de origen y la réplica.
    • Para una solución de recuperación ante desastres sólida, te recomendamos que elijas una región diferente para la réplica, en lugar de solo una zona diferente.

  7. Haz clic en Siguiente.

  8. Revisa los detalles y haz clic en Siguiente.

  9. Haz clic en Crear.

  10. Espera a que se complete la operación. Cuando finalice el proceso, la réplica aparecerá debajo de la instancia de origen en la página Replicaciones. Haz clic en el ID de instancia de la réplica para ver sus detalles.

gcloud

  1. Para crear una instancia de réplica, ejecuta el comando filestore instances create.

    gcloud filestore instances create INSTANCE_ID \
  --source-instance=projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/instances/SOURCE_INSTANCE_ID \
  --project=REPLICA_PROJECT_ID \
  --location=LOCATION \
  --network=name="NETWORK" \
  --tier=TIER \
  --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \

Reemplaza lo siguiente:

  • INSTANCE_ID por el nombre de la instancia de réplica que deseas crear. Por ejemplo, sample-replica
  • SOURCE_PROJECT_ID por el ID del proyecto Google Cloud en el que se encuentra la instancia de origen
  • SOURCE_LOCATION por la ubicación en la que reside la instancia de origen.
  • SOURCE_INSTANCE_ID por el nombre de la instancia de origen para la que deseas crear una réplica. Por ejemplo, sample-instance
  • REPLICA_PROJECT_ID con el ID del proyecto Google Cloud en el que deseas que resida la instancia de réplica.
  • LOCATION con la ubicación en la que deseas que resida la instancia de réplica, como us-central1-a. Si la fuente se encuentra en un nivel de servicio zonal, debes especificar una región y una zona para la réplica.
  • NETWORK por el nombre de la red que deseas usar, como default.
  • TIER con el nivel de servicio que necesitas, por ejemplo,ZONAL. El nivel y el rango de capacidad deben coincidir con la instancia de origen.
  • FILE_SHARE_NAME por el nombre que especificas para el recurso compartido de archivos NFS que se entrega desde la instancia, como vol1.
  • FILE_SHARE_SIZE con el tamaño que deseas para el recurso compartido de archivos, como 1.25TiB.

API de REST

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

  2. Para crear una réplica de instancia, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

    • TIER es el nombre del nivel de servicio que deseas usar para la réplica. Por ejemplo, REGIONAL
    • NETWORK es el nombre de la red que deseas usar para la réplica. Por ejemplo, default Debes usar la misma red que la fuente.
    • SHARE_NAME es el nombre del archivo compartido. Por ejemplo, vol1.
    • CAPACITY es el tamaño, en GiB, que deseas asignar a la réplica. Por ejemplo, 1024 La capacidad debe ser mayor o igual que la de la instancia de origen.
    • REPLICA_PROJECT_ID es el nombre del proyecto en el que deseas que resida la réplica. Por ejemplo, sample-project
    • SOURCE_PROJECT_ID es el nombre del proyecto en el que reside tu instancia de origen.
    • ACTIVE_LOCATION es la ubicación en la que reside la fuente. Por ejemplo, us-east1
    • ACTIVE_NAME es el nombre de la instancia que deseas replicar. Por ejemplo, sample-instance
    • DESCRIPTION es una descripción de la instancia de réplica que deseas crear. Por ejemplo, A sample replica.
    • REPLICA_LOCATION es la ubicación en la que deseas que resida la réplica. Por ejemplo, us-central1
    • REPLICA_INSTANCE_NAME es el nombre de la instancia de réplica que deseas crear. Por ejemplo, sample-replica

Cómo ver el estado de la réplica

Consola de Google Cloud

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

Ir a Replicaciones

  1. Haz clic en el ID de instancia de la réplica para ver sus detalles.

gcloud

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

    gcloud filestore instances describe <var>INSTANCE_ID</var> \
   --project=<var>PROJECT_ID</var> \
  --location=<var>LOCATION</var> \

Reemplaza lo siguiente:

  • INSTANCE_ID por el ID de la instancia de Filestore que deseas ver, como genomics-instance.
  • PROJECT_ID por el ID del proyecto de 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. Observa 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 promovió a instancia normal. Ten en cuenta que la replicación no se especifica porque aún no está activa:

    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 vinculó con una instancia activa. El rol de replicación es 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 de REST

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

  2. Para ver el estado de la réplica, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

    • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, sample-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 deseas ver. Por ejemplo, sample-instance

Enumera todas las réplicas de un proyecto

Consola de Google Cloud

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

    Ir a Replicaciones

En la tabla, se enumeran las instancias de origen con sus réplicas. Haz clic en el ID de instancia de la réplica para ver sus detalles.

gcloud

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

    gcloud filestore instances list
  --project=PROJECT_ID \

    Reemplaza PROJECT_ID por el ID del proyecto que deseas ver.

    La respuesta muestra una lista de instancias y réplicas, similar a la 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 de REST

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

  2. Para enumerar las réplicas en un proyecto específico, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

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

Pausar replicación

Consola de Google Cloud

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

    Ir a Instancias

  2. Haz clic en el ID de la instancia de la réplica que deseas pausar.

  3. En la sección Descripción, haz clic en la pestaña Replicaciones.

  4. En la sección Detalles de la instancia activa, haz clic en Pausar la replicación.

  5. Lee la alerta antes de continuar y haz clic en Pausar la replicación para confirmar.

El estado de la replicación cambia a Pausando. Una vez que finaliza la operación, el Estado de la replicación cambia a En pausa.

gcloud

Para pausar una réplica, ejecuta el comando gcloud filestore instances pause-replica.

  gcloud filestore instances pause-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Reemplaza lo siguiente:

  • INSTANCE_ID por el ID de la instancia de Filestore que deseas pausar, como my-replica.
  • PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de Filestore
  • LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra la siguiente respuesta o una similar:

createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-east1-b
fileShares:
- capacityGb: '1024'
  name: share
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.229.150.130
  modes:
  - MODE_IPV4
  network: default
  reservedIpRange: 10.229.150.128/26
performanceLimits:
  maxIops: '12000'
  maxReadIops: '12000'
  maxReadThroughputBps: '125829120'
  maxWriteIops: '4000'
  maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
    state: PAUSED
    stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
  role: STANDBY
state: READY
tier: REGIONAL

API de REST

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

  2. Para pausar una réplica, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

    • PROJECT es el nombre del proyecto en el que reside tu réplica. Por ejemplo, sample-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 deseas pausar. Por ejemplo, sample-replica

Reanudar la replicación

Consola de Google Cloud

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

    Ir a Instancias

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

  3. En la sección Descripción, haz clic en la pestaña Replicaciones.

  4. En la sección Detalles de la instancia activa, haz clic en Reanudar la replicación.

  5. Lee la alerta antes de continuar y confirma ingresando resume en el campo proporcionado.

El estado de la replicación cambia a Reanudando. Una vez que finalice la operación, el Estado de replicación cambiará a Listo.

gcloud

Para reanudar una instancia de réplica, ejecuta el comando gcloud filestore instances resume-replica.

  gcloud filestore instances resume-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Reemplaza lo siguiente:

  • INSTANCE_ID por el ID de la instancia de réplica de Filestore que deseas reanudar, como my-replica.
  • PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de réplica de Filestore
  • LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra la siguiente respuesta o una similar:

  createTime: '2025-12-22T14:03:33.727531128Z'
  customPerformanceSupported: true
  description: Replica of active, us-central1
  fileShares:
  - capacityGb: '1024'
    name: share
  name: projects/genomics-project/locations/us-central1/instances/my-replica
  networks:
  - connectMode: DIRECT_PEERING
    ipAddresses:
    - 10.229.150.130
    modes:
    - MODE_IPV4
    network: default
    reservedIpRange: 10.229.150.128/26
  performanceLimits:
    maxIops: '12000'
    maxReadIops: '12000'
    maxReadThroughputBps: '125829120'
    maxWriteIops: '4000'
    maxWriteThroughputBps: '104857600'
  protocol: NFS_V3
  replication:
    replicas:
    - peerInstance: projects/genomics-project/locations/us-central1/instances/my-source
      state: READY
      stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
    role: STANDBY
  state: READY
  tier: REGIONAL

API de REST

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

  2. Para reanudar la replicación, usa la siguiente solicitud:
curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request POST \
      -d '{}' \
      "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:resumeReplica"

Reemplaza lo siguiente:

  • PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, sample-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 deseas reanudar. Por ejemplo, sample-replica

Separa la replicación y promueve la réplica

Si se separa la replicación entre las instancias activa y en espera, la réplica se promoverá a una instancia normal. Esta operación es irreversible.

Consola de Google Cloud

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

    Ir a Instancias

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

  3. Haz clic en Interrumpir replicación.

  4. Ingresa el ID de instancia de la réplica y, luego, haz clic en Interrumpir replicación.

  5. Espera a que se complete la operación.

gcloud

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

Reemplaza lo siguiente:

  • INSTANCE_ID por el ID de la instancia de Filestore que deseas promocionar, como my-replica.
  • PROJECT_ID por el ID del proyecto de Google Cloud que contiene la instancia de Filestore
  • LOCATION por la ubicación en la que reside la réplica, como us-central1.

Cuando se completa correctamente, se muestra 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 de REST

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

  2. Para promover la réplica, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

    • PROJECT es el nombre del proyecto en el que se encuentra tu réplica. Por ejemplo, sample-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 deseas promover. Por ejemplo, sample-replica

Borra una instancia de réplica

Consola de Google Cloud

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

    Ir a Instancias

    Las réplicas se enumeran en sus instancias de origen asociadas. Si no ves una réplica, consulta los comandos gcloud para esta tarea.

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

  3. Haz clic en Borrar.

gcloud

  1. Para ver una lista de todas las instancias, incluidas las réplicas, ejecuta el comando instances list:

    gcloud filestore instances list
  --project=PROJECT_ID \

    Reemplaza PROJECT_ID por el ID del proyecto que deseas ver.

  2. Copia los detalles de la instancia que deseas borrar.

  3. Para borrar una instancia de réplica, ejecuta el comando filestore instances delete.

    gcloud filestore instances delete INSTANCE_ID \
  --location=LOCATION \

Reemplaza lo siguiente:

  • INSTANCE_ID con el ID de la instancia de Filestore que deseas borrar, como my-replica
  • LOCATION por la ubicación en la que reside la réplica, como us-central1-a.

API de REST

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

  2. Para borrar una instancia de réplica, usa la siguiente solicitud:

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

    Reemplaza lo siguiente:

    • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, sample-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 deseas borrar. Por ejemplo, sample-instance

Supervisa la replicación de instancias

Consola de Google Cloud

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

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

    Acceder al Explorador de métricas

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. Haz clic en la sección desplegable Selecciona una métrica.

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

  4. Selecciona la sección expandible Instancia y, luego, haz clic en RPO.

  5. Se muestra la métrica del RPO times_since_last_replication. Esta métrica está disponible varios minutos después de que se completa la sincronización inicial de los datos replicados.

¿Qué sigue?