Identidad de objeto GCS
01Un nombre de objeto puede representar varios estados.
Una ruta Google Cloud Storage sigue la semántica de objetos y generaciones. Buckets y prefijos delimitan el ámbito; metadatos, generaciones, checksums y precondiciones distinguen trabajo nuevo, sustituciones, duplicados y cambios concurrentes.
| Decisión | Enfoque de integración |
|---|---|
| Bucket, prefijo, generación | Define proyecto, bucket, prefijo, convenciones de carpetas, reglas de inclusión, metadatos esperados y si la carga incluye cada generación o solo el objeto actual. Mantén los listados acotados para que trabajo y coste sean previsibles. |
| Reintenta solo el estado previsto | Separa respuestas transitorias de errores permanentes de configuración y reintenta solo operaciones cuya idempotencia se entienda. Las precondiciones de generación, el backoff configurable y la reconciliación evitan sobrescribir datos recientes o repetir trabajo terminado. |
| El checksum cierra la entrega | Acuerda nombres de objetos, generaciones, verificación de checksums, tipo de contenido, clase de almacenamiento, retención, versiones, cuarentena y limpieza del origen. Estas decisiones determinan cuándo termina la entrega y cómo demostrarlo después. |
| Autenticación y acceso | Selecciona Application Default Credentials o credenciales Google configuradas y scopes requeridos. Verifica IAM del bucket, límites del proyecto y renovación. |
Ruta Flower basada en generaciones
02Separa descubrimiento, movimiento y mutación del objeto.
Flower recorre un ámbito, inspecciona propiedades, lee en streaming o por rangos, copia y gestiona la clase. El flujo declarativo añade selección, validación, linaje y recuperación.
Inventario con evidencia inmutable
Registra nombre, generación, tamaño, estado de metadatos y checksum que calificaron el objeto. Un reemplazo con el mismo nombre se convierte en trabajo nuevo, no en repetición ambigua.
Transmite sin perder identidad
Para contenido grande o transformado, conserva la identidad en el pipeline y valida el destino. Las lecturas por rangos deben seguir ligadas a una generación para evitar mezclas.
Clasifica resultados de reintento
Flower coordina reintentos y esperas ante interrupciones temporales, mientras permisos, generaciones y políticas de conservación guían conciliación y alertas. Cada resultado sigue una ruta operativa clara.
Contrato de producción GCS
03Protege la concurrencia sin desperdiciar operaciones.
La coherencia fuerte reduce incertidumbre, pero no sustituye el contrato. Caché pública, generaciones, costes, ubicaciones, clases, retención y bloqueos cambian la ruta.
Política de precondiciones
Define cuándo exigir solo creación, coincidencia de generación o metageneración. Un fallo significa que el estado cambió: reconcilia en vez de tratarlo como error de red.
Ubicación y clase
Elige ubicación por latencia, resiliencia, gobierno y coste. Conserva o remapea la clase de forma deliberada; una migración no debe poner datos fríos en un nivel caro.
Resultados de retención y bloqueo
Retención o bloqueo pueden impedir la limpieza de forma intencionada. Muestra ese estado como evidencia de gobierno, mantén el objeto reconciliado y evita una falsa alarma permanente.