Configura la replica delle istanze

Console Google Cloud

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

   Vai alle istanze di Filestore

2. Fai clic sull'ID istanza dell'istanza che vuoi replicare.

3. Nella sezione Descrizione, fai clic sulla scheda Repliche.

4. Fai clic su Crea replica.

5. Fai clic sul link alla documentazione per esaminare l'obiettivo del punto di ripristino (RPO) supportato e fai clic su Avanti.

6. Compila tutti i campi obbligatori e quelli facoltativi, se necessario.

   • 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 di dati, agli utenti viene consigliato vivamente di scegliere una regione e una zona univoche per l'origine.

7. Fai clic su Avanti.

8. Controlla i dettagli e fai clic su Avanti.

9. Fai clic su Crea.

10. Attendi il completamento dell'operazione. Al termine, la replica verrà elencata sotto l'istanza di origine nella pagina Istanze.

11. Fai clic sull'ID istanza della replica per visualizzarne i dettagli.

gcloud

1. Puoi creare un'istanza di replica eseguendo il 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 \
   

Sostituisci quanto segue:

• 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 si trovi 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.25TB. La capacità deve essere maggiore o uguale a quella dell'origine e, se applicabile, lo stesso intervallo di capacità.

API REST

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

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

Console Google Cloud

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

   Vai alle istanze di Filestore

2. Fai clic sull'ID istanza della replica che vuoi visualizzare.

3. Nella sezione Descrizione, fai clic sulla scheda Repliche.

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

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

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

Sostituisci quanto segue:

• 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

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

2. 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 la tua istanza. Ad esempio, us-west1-a.
   • INSTANCE_NAME è il nome dell'istanza che vuoi visualizzare. Ad esempio, my-genomics-instance.

Console Google Cloud

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

   Vai alle istanze di Filestore

   Le repliche sono elencate nelle istanze di origine associate.

gcloud

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

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

   Sostituisci quanto segue:

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

   La risposta restituisce un risultato 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

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

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

Console Google Cloud

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

   Vai alle istanze di Filestore

2. Fai clic sull'ID istanza della replica che vuoi utilizzare.

3. Fai clic su Interrompi replica.

4. 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. Qualsiasi modifica apportata dopo l'ultimo punto di sincronizzazione registrato non verrà replicata. L'operazione è irreversibile.

5. Inserisci l'ID istanza della replica, quindi fai clic su Interrompi la replica.

6. Attendi il completamento dell'operazione.

gcloud

1. 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 \
   

Sostituisci quanto segue:

• 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

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

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

Console Google Cloud

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

   Vai alle istanze di Filestore

   Le repliche sono elencate nelle istanze di origine associate. Se non vedi una replica, consulta i comandi gcloud per questa attività.

2. Fai clic sull'ID istanza dell'istanza che vuoi eliminare.

3. Fai clic su Elimina.

gcloud

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

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

   Sostituisci quanto segue:

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

2. Copia i dettagli dell'istanza che vuoi eliminare.

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

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

Sostituisci quanto segue:

• 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

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

2. 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 la tua istanza. Ad esempio, us-west1-a.
   • INSTANCE_NAME è il nome dell'istanza che vuoi eliminare. Ad esempio, my-genomics-instance.

Console Google Cloud

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

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

2. Nella console Google Cloud , vai alla pagina leaderboard Esplora metriche:

   Vai a Esplora metriche

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

3. Fai clic sulla sezione espandibile Seleziona una metrica.

4. Nel campo Filtra per nome risorsa o metrica, digita filestore e seleziona la sezione espandibile Istanza Filestore.

5. Seleziona la sezione espandibile Istanza e poi fai clic su RPO.

6. Viene visualizzata la metrica RPO times_since_last_replication. Questa metrica diventa disponibile diversi minuti dopo il completamento della sincronizzazione iniziale dei dati replicati.