Configura la replicación de instancias

Google Cloud console

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

   Ir a Instancias de Filestore

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

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

4. Haz clic en Crear réplica.

5. Haz clic en el vínculo de la documentación para revisar el objetivo de punto de recuperación (RPO) admitido y, luego, haz clic en Siguiente.

6. Ingresa todos los campos obligatorios y opcionales según sea necesario.

   • La capacidad especificada debe ser mayor o igual que la fuente.
   • Las siguientes especificaciones deben coincidir con la instancia de origen:
     • Nivel de servicio, incluido el rango de capacidad
     • Protocolo de Filestore
   • Para reducir el riesgo de pérdida de datos, se recomienda a los usuarios que elijan una región y una zona exclusivas 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 se complete la operación. Cuando termine, la réplica aparecerá en la instancia de origen en la página Instancias.

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

gcloud

1. Puedes crear una instancia de 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 \
   

Reemplaza lo siguiente:

• INSTANCE-ID por el nombre de la instancia que deseas crear, como my-replica.
• SOURCE-INSTANCE por el nombre y la ubicación de la instancia de origen para la que deseas 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 de Google Cloud proyecto en el que se encuentra la instancia de origen.
• LOCATION con la ubicación en la que quieres 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 por el nivel de servicio que necesitas, como ZONAL. El nivel y el rango de capacidad deben coincidir con la fuente.
• 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.25TB. La capacidad debe ser mayor o igual que la de la fuente y, si corresponde, debe estar en el mismo rango de capacidad.

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. Usa cURL para llamar a la API de 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"
   

   Aquí:

   • 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.
   • PROJECT es el nombre del proyecto en el que residirá tu réplica. Por ejemplo, my-genomics-project El origen y la réplica deben estar ubicados en el mismo proyecto.
   • 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, my-genomics-instance
   • DESCRIPTION es una descripción de la instancia de réplica que deseas crear. Por ejemplo, My genomics 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, my-genomics-replica

Google Cloud console

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

   Ir a Instancias de Filestore

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

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

4. Aquí puedes ver el Estado de la réplica y el Último punto de sincronización, una marca de tiempo de la última vez que se copió una copia completa de tus 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 \
   

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. Observa que la replicación no se especifica, ya que aún no se habilitó:

  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. Observa 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 de REST

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

2. Usa cURL para llamar a la API de 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"

   Aquí:

   • 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 deseas ver. Por ejemplo, my-genomics-instance

Google Cloud console

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

   Ir a Instancias de Filestore

   Las réplicas se enumeran en sus 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 \
   

   Reemplaza lo siguiente:

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

   La respuesta muestra un resultado similar al 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. Usa cURL para llamar a la API de 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"

   Aquí:

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

Google Cloud console

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

   Ir a Instancias de Filestore

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

3. Haz clic en Interrumpir replicación.

4. Lee la alerta antes de continuar.

   Separar la replicación detendrá la sincronización de datos permanentemente y convertirá las instancias activas y en espera en instancias normales. No se replicarán los cambios realizados después del último punto de sincronización registrado. Esta acción es irreversible.

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

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

gcloud

1. Puedes promover una instancia de réplica ejecutando 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 promover, 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. Usa cURL para llamar a la API de 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"

   Aquí:

   • 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 deseas promover. Por ejemplo, my-genomics-replica

Google Cloud console

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

   Ir a Instancias de Filestore

   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 del proyecto, ejecuta el comando instances list:

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

   Reemplaza lo siguiente:

   • 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, 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. Usa cURL para llamar a la API de 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"

   Aquí:

   • 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 deseas borrar. Por ejemplo, my-genomics-instance

Google Cloud console

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

1. Antes de comenzar, asegúrate de tener acceso a los siguientes roles:

   • Visualizador de Monitoring
   • Editor de Monitoring

   Para ver cómo otorgar acceso a estos roles, consulta Cómo otorgar acceso a Cloud Monitoring.

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

   Ir 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.

3. Haz clic en la sección desplegable Selecciona 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. Selecciona la sección expandible Instancia y, luego, haz clic en RPO.

6. 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.