Spostare i bucket

Questa pagina descrive la procedura per spostare i bucket da una località a un'altra. Per informazioni sullo spostamento dei bucket, vedi Spostamento dei bucket.

Prima di iniziare

Prima di poter spostare i bucket, completa i seguenti passaggi:

1. Configura Storage Intelligence.

2. Abilita l'eliminazione temporanea.

3. Controlla le quote e i limiti per assicurarti che la nuova località disponga di quote sufficienti per ospitare i dati del bucket.

4. Determina il tipo di ricollocamento del bucket per capire se è necessario un tempo di inattività per la scrittura.

5. Rimuovi tutti i tag bucket esistenti.

6. Se utilizzi i report sull'inventario, salva le configurazioni.

7. Ottieni i ruoli richiesti, descritti nella sezione seguente.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per trasferire i bucket, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per riassegnare i bucket. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Sposta bucket

Questa sezione descrive il processo di trasferimento dei bucket Cloud Storage da una località a un'altra. Quando sposti un bucket, avvii il processo di copia incrementale dei dati, lo monitori e poi avvii il passaggio di sincronizzazione finale. Per ulteriori informazioni su questi passaggi, consulta Comprendere la procedura di spostamento dei bucket.

Eseguire una prova

Per ridurre al minimo i potenziali problemi durante il processo di trasferimento dei bucket, ti consigliamo di eseguire una prova dry run. Una prova dry run simula il processo di spostamento del bucket senza spostare i dati, aiutandoti a rilevare e risolvere i problemi in anticipo. La prova dry run verifica le seguenti incompatibilità:

• Chiavi di crittografia gestite dal cliente (CMEK) o chiavi di crittografia fornite dal cliente (CSEK)
• Criteri di conservazione bloccati
• Oggetti con blocchi temporanei
• Caricamenti multiparte

Anche se una prova generale non può identificare ogni possibile problema, in quanto alcuni problemi potrebbero emergere solo durante la migrazione live a causa di fattori quali la disponibilità di risorse in tempo reale, riduce il rischio di affrontare problemi che richiedono molto tempo durante il trasferimento effettivo.

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION --dry-run

Avviare la copia incrementale dei dati

gcloud storage buckets relocate gs://BUCKET_NAME --location=LOCATION

Monitorare la copia incrementale dei dati

Il processo di trasferimento del bucket è un'operazione a lunga esecuzione che deve essere monitorata per vedere come procede. Puoi controllare regolarmente l'elenco delle operazioni a lunga esecuzione per visualizzare lo stato del passaggio di copia incrementale dei dati. Per informazioni su come ottenere i dettagli di un'operazione a lunga esecuzione, elencare o annullare operazioni a lunga esecuzione, consulta Utilizzare operazioni a lunga esecuzione in Cloud Storage.

L'esempio seguente mostra l'output generato da un'operazione di copia incrementale dei dati:

  done: false
  kind: storage#operation
  metadata:
  '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketMetadata
  commonMetadata:
    createTime: '2024-10-21T04:26:59.666Z
    endTime: '2024-12-29T23:39:53.340Z'
    progressPercent: 99
    requestedCancellation: false
    type: relocate-bucket
    updateTime: '2024-10-21T04:27:03.2892'
  destinationLocation: US-CENTRAL1
  finalizationState: 'READY'
  progress:
    byteProgressPercent: 100
    discoveredBytes: 200
    remainingBytes: 0
    discoveredObjectCount: 10
    remainingObjectCount: 8
    objectProgressPercent: 100
    discoveredSyncCount: 8
    remainingSyncCount: 0
    syncProgressPercent: 100
  relocationState: SYNCING
  sourceLocation: US
  validateOnly: false
  estimatedWriteDowntimeDuration: '7200s'
  writeDowntimeExpireTime: '2024-12-30T10:34:01.786Z'
  name: projects//buckets/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
  response:
    '@type': type.googleapis.com/google.storage.control.v2.RelocateBucketResponse
      selfLink: https://storage.googleusercontent.com/storage/v1_ds/b/my-bucket1/operations/Bar7-1b0khdew@nhenUQRTF_R-Kk4dQ5V1f8fzezkFcPh3XMvlTqJ6xhnqJ1h_QXFIeAirrEqkjgu4zPKSRD6WSSG5UGXil6w
 

La tabella seguente fornisce informazioni sui campi chiave nell'output generato dall'operazione di copia incrementale dei dati:

Se riscontri problemi durante l'interazione con altre funzionalità di Cloud Storage, consulta la sezione Limitazioni.

Avviare il passaggio di sincronizzazione finale

Il passaggio di sincronizzazione finale prevede un periodo durante il quale non puoi eseguire operazioni di scrittura sul bucket. Ti consigliamo di pianificare l'ultimo passaggio di sincronizzazione in un momento che riduca al minimo l'interruzione delle tue applicazioni.

Prima di procedere, verifica che il bucket sia completamente preparato controllando il valore di finalizationState nell'output del passaggio Copia incrementale dei dati. Per procedere, il valore di finalizationState deve essere READY.

Se avvii il passaggio di sincronizzazione finale in anticipo, il comando restituisce un messaggio di errore The relocate bucket operation is not ready to advance to finalization running state, ma il processo di trasferimento continua.

Ti consigliamo di attendere che il valore di progressPercent sia 99 prima di avviare il passaggio di sincronizzazione finale.

gcloud storage buckets relocate --finalize --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

 `name: projects/_/buckets/my-bucket/operations/AbCJYd8jKT1n-Ciw1LCNXIcubwvij_TdqO-ZFjuF2YntK0r74` 

gcloud storage buckets relocate --finalize --ttl TTL_DURATION --operation=projects/_/buckets/BUCKET_NAME/operations/OPERATION_ID

Convalidare la procedura di spostamento del bucket

Dopo aver avviato un trasferimento, verifica che sia stato completato correttamente. Questa sezione fornisce indicazioni per confermare il trasferimento dei dati.

Verifica la riuscita della procedura di trasferimento utilizzando i seguenti metodi:

• Esegui il polling delle operazioni a lunga esecuzione: il trasferimento del bucket è un'operazione a lunga esecuzione. Puoi eseguire il polling dell'operazione a lunga esecuzione utilizzando operation id per monitorare l'avanzamento dell'operazione e confermarne il completamento verificando lo stato success. Ciò comporta l'esecuzione periodica di query sullo stato dell'operazione finché non raggiunge uno stato terminale. Per informazioni sul monitoraggio delle operazioni di lunga durata, consulta Utilizzare le operazioni di lunga durata in Cloud Storage.

• Analizza le voci di Cloud Audit Logs: Cloud Audit Logs fornisce un record dettagliato di eventi e operazioni nel tuo ambiente Google Cloud . Puoi analizzare le voci di Cloud Audit Logs associate al trasferimento per verificarne la riuscita. Analizza i log per individuare eventuali errori, avvisi o comportamenti imprevisti che potrebbero indicare problemi durante il trasferimento. Per informazioni sulla visualizzazione dei log di Cloud Audit Logs, vedi Visualizzazione dei log di controllo.

  Le seguenti voci di log ti aiutano a determinare se lo spostamento è riuscito o meno:

  • Rilocazione riuscita: Relocate bucket succeeded. All existing objects are now in the new placement configuration.

  • Rilocazione non riuscita: Relocate bucket has failed. Bucket location remains unchanged.

  Utilizzando le notifiche Pub/Sub, puoi anche configurare avvisi che ti informano quando l'evento specifico di esito positivo o negativo viene visualizzato nei log. Per informazioni sulla configurazione delle notifiche Pub/Sub, consulta Configurare le notifiche Pub/Sub per Cloud Storage.

Completare le attività di riposizionamento dei bucket post

Dopo aver trasferito correttamente il bucket, completa i seguenti passaggi:

1. (Facoltativo) Ripristina i controlli dell'accesso basati su tag sul bucket.
2. Le configurazioni esistenti del report sull'inventario non vengono mantenute durante la procedura di trasferimento e dovrai ricrearle manualmente. Per informazioni sulla creazione di una configurazione di report dell'inventario, consulta Creare una configurazione di report dell'inventario.
3. Aggiorna le configurazioni dell'infrastruttura come codice, ad esempio Terraform e il connettore di configurazione Google Kubernetes Engine, per specificare la nuova posizione del bucket.
4. Gli endpoint regionali sono associati a località specifiche e dovrai modificare il codice dell'applicazione per riflettere il nuovo endpoint.

Come gestire le operazioni di riposizionamento dei bucket non riuscite

Prima di gestire le operazioni di riassegnazione dei bucket non riuscite, considera i seguenti fattori:

• Il trasferimento non riuscito di un bucket potrebbe lasciare risorse obsolete, come file temporanei o copie incomplete dei dati, nella destinazione. Devi attendere da 7 a 14 giorni prima di avviare un altro spostamento del bucket nella stessa destinazione. Puoi avviare immediatamente il trasferimento di un bucket in una destinazione diversa.

• Se la posizione di destinazione non è quella ottimale per i tuoi dati, potresti voler annullare il trasferimento. Tuttavia, non puoi avviare un trasferimento immediatamente. È necessario un periodo di attesa di massimo 14 giorni prima di poter avviare nuovamente la procedura di trasferimento. Questa limitazione è in vigore per garantire la stabilità ed evitare conflitti di dati.

Passaggi successivi

• Scopri di più sullo spostamento dei bucket.