Identità oggetto GCS
01Un nome oggetto può rappresentare stati distinti.
Una rotta Google Cloud Storage segue la semantica di oggetti e generazioni. Bucket e prefissi definiscono l'ambito; metadati, generazioni, checksum e precondizioni aiutano a distinguere nuovo lavoro, sostituzioni, duplicati e modifiche concorrenti.
| Decisione | Approccio di integrazione |
|---|---|
| Bucket, prefisso, generazione | Definisci progetto, bucket, prefisso, convenzioni delle cartelle, regole di inclusione, metadati attesi e se il workload comprende ogni generazione oppure soltanto l'oggetto corrente. Mantieni il listing abbastanza selettivo da rendere prevedibili lavoro e costi. |
| Ritenta solo lo stato previsto | Separa le risposte transitorie dagli errori permanenti di configurazione e ritenta soltanto operazioni con idempotenza compresa. Precondizioni sulla generazione, backoff configurabile e riconciliazione evitano di sovrascrivere dati più recenti o ripetere lavoro completato. |
| Il checksum chiude la consegna | Concorda nomi degli oggetti, gestione delle generazioni, verifica dei checksum, content type, classe di storage, retention, versioning, quarantena e pulizia della sorgente. Queste scelte stabiliscono quando la consegna è completa e come provarlo in seguito. |
| Autenticazione e accesso | Seleziona Application Default Credentials o credenziali Google configurate e scope richiesti. Verifica IAM bucket, confini del progetto e rinnovo credenziali nell’ambiente di esecuzione. |
Rotta Flower basata sulle generazioni
02Separa discovery, movimento del contenuto e mutazione dell'oggetto.
Flower può percorrere un ambito del bucket, ispezionare proprietà, leggere in streaming o per intervalli, copiare oggetti e gestire la classe di storage. Il flusso dichiarativo aggiunge selezione, validazione, lineage e recovery.
Inventario con evidenze immutabili
Registra nome, generazione, dimensione, stato dei metadati e checksum che hanno qualificato l'oggetto. Una sostituzione con lo stesso nome diventa nuovo lavoro, non un replay ambiguo.
Stream senza perdere l'identità
Per contenuti grandi o trasformati, porta l'identità lungo la pipeline e valida la destinazione completa. Le letture per intervalli devono restare legate a una generazione per non mescolare sostituzioni concorrenti.
Classifica gli esiti dei retry
Flower coordina retry e backoff per interruzioni temporanee del servizio, mentre permessi, controlli sulle generazioni e policy di conservazione guidano riconciliazione e alert operativi. Ogni esito segue un percorso chiaro.
Contratto di produzione GCS
03Proteggi la concorrenza senza sprecare operazioni storage.
La consistenza forte elimina parte dell'incertezza, non il contratto operativo. Cache pubbliche, generazioni, costi delle richieste, location, classi, retention e hold cambiano comunque la rotta corretta.
Policy delle precondizioni
Stabilisci quando servono create-only, generation-match o metageneration-match. Una condizione fallita indica che il mondo è cambiato: va riconciliata, non trattata come errore di rete.
Location e classe di storage
Scegli la location per latenza, resilienza, governance e costo di trasferimento. Conserva o rimappa consapevolmente la classe; una migrazione non deve spostare dati freddi in un tier caldo costoso.
Esiti di retention e hold
Retention o hold possono rendere la pulizia intenzionalmente impossibile. Esponi lo stato come evidenza di governance, mantieni l'oggetto riconciliato ed evita falsi allarmi permanenti.