Gestisci la replica dell'istanza

Questa guida mostra come utilizzare la replica delle istanze Filestore.

Prima di iniziare

Completa i passaggi di configurazione necessari per utilizzare Filestore. La quota per le istanze varia in base a progetto, regione e livello. Assicurati di avere abbastanza tempo per completare queste attività. Per saperne di più, consulta Quote o Richiedere un aumento della quota.
Se non l'hai ancora fatto, crea un'istanza Filestore. Nel contesto di questa guida, si tratta dell'istanza di origine.

Nota: la replica dell'istanza è disponibile per i livelli di servizio regionale, zonale ed Enterprise.

Crea una replica dell'istanza

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze
Fai clic sull'ID istanza dell'istanza che vuoi replicare.
Fai clic sulla scheda Repliche.
Fai clic su Crea replica.
Fai clic sul link alla documentazione per esaminare l'obiettivo del punto di ripristino (RPO) supportato e fai clic su Avanti.
Compila tutti i campi obbligatori e quelli facoltativi in base alle tue esigenze.
- La capacità specificata deve essere maggiore o uguale a quella dell'origine.
- Le seguenti specifiche devono corrispondere all'istanza di origine:
  - Livello di servizio, incluso l'intervallo di capacità
  - Protocollo Filestore
- Per ridurre il rischio di perdita dei dati, ti consigliamo di scegliere una regione e una zona univoche per l'origine.
Fai clic su Avanti.
Controlla i dettagli e fai clic su Avanti.
Fai clic su Crea.
Attendi il completamento dell'operazione. Al termine, la replica verrà elencata sotto l'istanza di origine nella pagina Istanze.
Fai clic sull'ID istanza della replica per visualizzarne i dettagli.

gcloud

Puoi creare un'istanza di replica eseguendo il comando filestore instances create.

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

Dove:

INSTANCE_ID con il nome dell'istanza che vuoi creare, ad esempio my-replica.
SOURCE_INSTANCE con il nome e la posizione dell'istanza di origine per cui vuoi creare una replica. Ad esempio, projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
PROJECT_ID con l'ID progetto del progetto Google Cloud in cui si trova l'istanza di origine.
LOCATION con la posizione in cui vuoi che risieda l'istanza di replica, ad esempio us-central1-a. Se l'origine si trova in un livello di servizio zonale, devi specificare sia una regione che una zona per la replica.
NETWORK con il nome della rete che vuoi utilizzare, ad esempio default.
TIER con il livello di servizio di cui hai bisogno, ad esempio ZONAL. Il livello e l'intervallo di capacità devono corrispondere all'origine.
FILE_SHARE_NAME con il nome specificato per la condivisione di file NFS servita dall'istanza, ad esempio vol1.
FILE_SHARE_SIZE con le dimensioni che vuoi per la condivisione del file, ad esempio 1.25TiB.

API REST

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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"
```
Dove:
- TIER è il nome del livello di servizio che vuoi utilizzare per la replica. Ad esempio, REGIONAL.
- NETWORK è il nome della rete che vuoi utilizzare per la replica. Ad esempio, default. Devi utilizzare la stessa rete dell'origine.
- SHARE_NAME è il nome della condivisione file. Ad esempio, vol1.
- CAPACITY è la dimensione, in GiB, che vuoi allocare per la replica. Ad esempio, 1024. La capacità deve essere maggiore o uguale a quella dell'istanza di origine.
- PROJECT è il nome del progetto in cui risiederà la replica. Ad esempio, my-genomics-project. L'origine e la replica devono trovarsi nello stesso progetto.
- ACTIVE_LOCATION è la posizione in cui si trova l'origine. Ad esempio, us-east1.
- ACTIVE_NAME è il nome dell'istanza che vuoi replicare. Ad esempio, my-genomics-instance.
- DESCRIPTION è una descrizione dell'istanza di replica che vuoi creare. Ad esempio, My genomics replica.
- REPLICA_LOCATION è la posizione in cui vuoi che si trovi la replica. Ad esempio, us-central1.
- REPLICA_INSTANCE_NAME è il nome dell'istanza replica che vuoi creare. Ad esempio, my-genomics-replica.

Visualizzare lo stato della replica

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze
Fai clic sull'ID istanza della replica che vuoi visualizzare.
Nella sezione Descrizione, fai clic sulla scheda Repliche.
Qui puoi visualizzare lo stato della replica e l'ultimo punto di sincronizzazione, un timestamp dell'ultima volta che una copia completa dei tuoi dati è stata copiata nella replica.

gcloud

Per visualizzare le informazioni su un'istanza specifica, esegui il comando instances describe:

gcloud filestore instances describe INSTANCE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \

Dove:

INSTANCE_ID con l'ID istanza dell'istanza Filestore che vuoi visualizzare, ad esempio genomics-instance.
PROJECT_ID con l'ID progetto del progetto Google Cloud che contiene l'istanza Filestore.

LOCATION con la località in cui risiede l'istanza, ad esempio us-east1-b.

La risposta al comando instances describe è simile a uno dei seguenti esempi.

Questo esempio di risposta mostra un'istanza di origine con la replica dell'istanza attivata. Nota che il ruolo specificato è 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

Questo esempio di risposta mostra un'istanza di replica che è stata promossa a istanza normale. Tieni presente che la replica non è specificata perché non è ancora stata attivata:

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

Questo esempio di risposta mostra una replica accoppiata a un'istanza attiva. Nota che il ruolo è elencato come 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

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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"
```
Dove:
- PROJECT è il nome del progetto in cui si trova l'istanza. Ad esempio, my-genomics-project.
- LOCATION è la località in cui si trova l'istanza. Ad esempio, us-west1-a.
- INSTANCE_NAME è il nome dell'istanza che vuoi visualizzare. Ad esempio, my-genomics-instance.

Elenco di tutte le repliche in un progetto

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze

Le repliche sono elencate nelle istanze di origine associate.

gcloud

Per visualizzare un elenco di tutte le istanze nel progetto, esegui il comando instances list:

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

Dove:

PROJECT-ID con l'ID progetto del progetto che vuoi visualizzare.

La risposta restituisce un elenco di istanze e repliche, simile al seguente:

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

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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"
```
Dove:
- PROJECT è il nome del progetto in cui si trova l'istanza. Ad esempio, my-genomics-project.
- LOCATION è la località che vuoi cercare. Per cercare tutte le istanze in qualsiasi località all'interno di un progetto, utilizza -.

Metti in pausa la replica

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze
Fai clic sull'ID istanza della replica che vuoi utilizzare.
Nella sezione Descrizione, fai clic sulla scheda Repliche.
Nella sezione Dettagli istanza attiva, fai clic su Metti in pausa la replica.
Leggi l'avviso prima di continuare e conferma facendo clic su Sospendi replica.

Lo stato della replica cambia in In pausa. Al termine dell'operazione, lo Stato della replica cambia in In pausa e viene visualizzata la data in cui la replica è stata sospesa.

gcloud

Puoi mettere in pausa un'istanza di replica eseguendo il comando gcloud filestore instances pause-replica.

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

Dove:

INSTANCE_ID con l'ID istanza dell'istanza Filestore che vuoi mettere in pausa, ad esempio my-replica.
PROJECT_ID con l'ID progetto del progetto Google Cloud che contiene l'istanza Filestore.
LOCATION con la posizione in cui si trova la replica, ad esempio us-central1.

Al termine dell'operazione, viene restituita la seguente risposta o una simile:

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 REST

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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:pauseReplica"
```
Dove:
- PROJECT è il nome del progetto in cui si trova la replica. Ad esempio, my-genomics-project.
- LOCATION è la posizione in cui si trova la replica. Ad esempio, us-west1-a.
- REPLICA_NAME è il nome dell'istanza che vuoi mettere in pausa. Ad esempio, my-genomics-replica.

Riprendi replica

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze
Fai clic sull'ID istanza della replica che vuoi utilizzare.
Nella sezione Descrizione, fai clic sulla scheda Repliche.
Nella sezione Dettagli istanza attiva, fai clic su Riprendi replica.
Leggi l'avviso prima di continuare e conferma inserendo resume nel campo fornito.

Lo stato della replica cambia in Ripresa. Al termine dell'operazione, lo Stato della replica viene modificato in Pronto.

gcloud

Puoi ripristinare un'istanza di replica eseguendo il comando gcloud filestore instances resume-replica.

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

Dove:

INSTANCE_ID con l'ID istanza dell'istanza di replica Filestore che vuoi riprendere, ad esempio my-replica.
PROJECT_ID con l'ID progetto del progetto Google Cloud che contiene l'istanza replica Filestore.
LOCATION con la posizione in cui si trova la replica, ad esempio us-central1.

Al termine dell'operazione, viene restituita la seguente risposta o una simile:

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 REST

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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:resumeReplica"
```
Dove:
- PROJECT è il nome del progetto in cui si trova la replica. Ad esempio, my-genomics-project.
- LOCATION è la posizione in cui si trova la replica. Ad esempio, us-west1-a.
- REPLICA_NAME è il nome dell'istanza che vuoi riprendere. Ad esempio, my-genomics-replica.

Dividi replica e promuovi la replica

In questa sezione, interromperai la replica tra le istanze attiva e di standby. Questa azione promuove la replica a istanza normale.

Questa operazione è irreversibile e deve essere utilizzata con cautela.
Una volta promossa a istanza regolare, la risorsa può essere accoppiata a una nuova replica.
Il failback non è automatico. Una volta completata l'operazione di interruzione della replica, gli amministratori devono riconnettere le applicazioni alla nuova istanza di origine. Per saperne di più, consulta Promuovere la replica.

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze di Filestore.

Vai a Istanze
Fai clic sull'ID istanza della replica che vuoi utilizzare.
Fai clic su Interrompi replica.
Leggi l'avviso prima di continuare.

L'interruzione della replica arresta definitivamente la sincronizzazione dei dati e converte le istanze attive e in standby in istanze normali. Eventuali modifiche apportate dopo l'ultimo punto di sincronizzazione registrato non verranno replicate. L'operazione è irreversibile.
Inserisci l'ID istanza della replica, quindi fai clic su Interrompi la replica.
Attendi il completamento dell'operazione.

gcloud

Puoi promuovere un'istanza di replica eseguendo il comando gcloud filestore instances promote-replica.

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

Dove:

INSTANCE_ID con l'ID istanza dell'istanza Filestore che vuoi promuovere, ad esempio my-replica.
PROJECT_ID con l'ID progetto del progetto Google Cloud che contiene l'istanza Filestore.
LOCATION con la posizione in cui si trova la replica, ad esempio us-central1.

Al termine dell'operazione, viene restituita la seguente risposta o una simile:

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

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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"
```
Dove:
- PROJECT è il nome del progetto in cui si trova la replica. Ad esempio, my-genomics-project.
- LOCATION è la posizione in cui si trova la replica. Ad esempio, us-west1-a.
- REPLICA_NAME è il nome dell'istanza che vuoi promuovere. Ad esempio, my-genomics-replica.

Elimina un'istanza di replica

Console Google Cloud

Nella console Google Cloud , vai alla pagina Istanze Filestore.

Vai a Istanze

Le repliche sono elencate nelle istanze di origine associate. Se non vedi una replica, consulta i comandi gcloud per questa attività.
Fai clic sull'ID istanza dell'istanza che vuoi eliminare.
Fai clic su Elimina.

gcloud

Per visualizzare un elenco di tutte le istanze, incluse le repliche, nel progetto, esegui il comando instances list:
```
gcloud filestore instances list
    --project=PROJECT_ID \
```
Dove:
- PROJECT_ID con l'ID progetto del progetto che vuoi visualizzare.
Copia i dettagli dell'istanza che vuoi eliminare.

Puoi eliminare un'istanza eseguendo il comando filestore instances delete.

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

Dove:

INSTANCE_ID con l'ID istanza dell'istanza Filestore che vuoi eliminare, ad esempio my-replica.
LOCATION con la posizione in cui si trova la replica, ad esempio us-central1-a.

API REST

Avere gcloud CLI installata e inizializzata , il che ti consente di generare un token di accesso per l'intestazione Authorization.

Utilizza cURL per chiamare l'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"
```
Dove:
- PROJECT è il nome del progetto in cui si trova l'istanza. Ad esempio, my-genomics-project.
- LOCATION è la località in cui si trova l'istanza. Ad esempio, us-west1-a.
- INSTANCE_NAME è il nome dell'istanza che vuoi eliminare. Ad esempio, my-genomics-instance.

Monitorare la replica dell'istanza

Console Google Cloud

Per visualizzare le metriche di replica dell'istanza Filestore in una dashboard di Cloud Monitoring, segui questi passaggi:

Prima di iniziare, assicurati di disporre dell'accesso ai seguenti ruoli:
- Monitoring Viewer
- Monitoring Editor
Per scoprire come concedere l'accesso a questi ruoli, consulta Concedere l'accesso a Cloud Monitoring.
Nella console Google Cloud , vai alla pagina Esplora metriche:
Vai a Esplora metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Fai clic sulla sezione espandibile Seleziona una metrica.
Nel campo Filtra in base al nome della risorsa o della metrica, digita filestore e seleziona la sezione espandibile Istanza Filestore.
Seleziona la sezione espandibile Istanza e poi fai clic su RPO.
Viene visualizzata la metrica RPO times_since_last_replication. Questa metrica diventa disponibile diversi minuti dopo il completamento della sincronizzazione iniziale dei dati replicati.

Passaggi successivi

Scopri di più sulla replica delle istanze.
Leggi la documentazione di riferimento sulla replica delle istanze.

Gestisci la replica dell'istanza Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Crea una replica dell'istanza

Console Google Cloud

gcloud

API REST

Visualizzare lo stato della replica

Console Google Cloud

gcloud

API REST

Elenco di tutte le repliche in un progetto

Console Google Cloud

gcloud

API REST

Metti in pausa la replica

Console Google Cloud

gcloud

API REST

Riprendi replica

Console Google Cloud

gcloud

API REST

Dividi replica e promuovi la replica

Console Google Cloud

gcloud

API REST

Elimina un'istanza di replica

Console Google Cloud

gcloud

API REST

Monitorare la replica dell'istanza

Console Google Cloud

Passaggi successivi

Gestisci la replica dell'istanza