Cómo reubicar buckets

En esta página, se describe el proceso para trasladar buckets de una ubicación a otra. Para obtener información sobre la reubicación de bucket, consulta Reubicación de buckets.

Antes de comenzar

Antes de reubicar buckets, completa los siguientes pasos:

1. Configura Storage Intelligence.

2. Habilita la opción de borrar de forma no definitiva.

3. Verifica las cuotas y los límites para asegurarte de que la nueva ubicación tenga cuotas suficientes para admitir los datos del bucket.

4. Determina el tipo de reubicación del bucket para saber si se requiere tiempo de inactividad de escritura.

5. Quita las etiquetas de bucket existentes.

6. Si usas informes de inventario, guarda tus configuraciones.

7. Obtén los roles necesarios, que se describen en la siguiente sección.

Obtén las funciones necesarias

Para obtener los permisos que necesitas para reubicar buckets, pídele a tu administrador que te otorgue el rol de IAM Administrador de almacenamiento (roles/storage.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para reubicar buckets. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Reubicar buckets

En esta sección, se describe el proceso para cambiar la ubicación de los buckets de Cloud Storage. Cuando reubicas un bucket, inicias el proceso de copia de datos incremental, lo supervisas y, luego, inicias el paso de sincronización final. Para obtener más información sobre estos pasos, consulta Información sobre el proceso de reubicación bucket buckets.

Realiza una ejecución de prueba

Para minimizar los posibles problemas durante el proceso de reubicación del bucket, te recomendamos que realices una prueba de validación. Una prueba de validación simula el proceso de reubicación del bucket sin mover datos, lo que te ayuda a detectar y resolver problemas de forma anticipada. La ejecución de prueba verifica las siguientes incompatibilidades:

• Claves de encriptación administradas por el cliente (CMEK) o claves de encriptación proporcionadas por el cliente (CSEK)
• Políticas de retención bloqueadas
• Objetos con conservaciones temporales
• Cargas multiparte

Si bien una prueba no puede identificar todos los problemas posibles, ya que algunos solo pueden surgir durante la migración en vivo debido a factores como la disponibilidad de recursos en tiempo real, reduce el riesgo de enfrentar problemas que consumen mucho tiempo durante la reubicación real.

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

Inicia la copia de datos incrementales

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

Supervisa la copia de datos incremental

El proceso de reubicación del bucket es una operación de larga duración que se debe supervisar para ver cómo avanza. Puedes consultar periódicamente la lista de operaciones de larga duración para ver el estado del paso de copia de datos incremental. Para obtener información sobre cómo obtener detalles de una operación de larga duración, enumerar o cancelar operaciones de larga duración, consulta Usa operaciones de larga duración en Cloud Storage.

En el siguiente ejemplo, se muestra el resultado que genera una operación de copia de datos incremental:

  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
 

En la siguiente tabla, se proporciona información sobre los campos clave en el resultado que genera la operación de copia de datos incremental:

Si tienes problemas cuando interactúas con otras funciones de Cloud Storage, consulta Limitaciones.

Inicia el paso de sincronización final

El paso de sincronización final implica un período en el que no puedes realizar operaciones de escritura en el bucket. Te recomendamos que programes el paso de sincronización final en un momento que minimice las interrupciones en tus aplicaciones.

Antes de continuar, verifica que el bucket esté completamente preparado. Para ello, revisa el valor de finalizationState en el resultado del paso de copia de datos incremental. El valor de finalizationState debe ser READY para continuar.

Si inicias el paso de sincronización final antes de tiempo, el comando devolverá un mensaje de error The relocate bucket operation is not ready to advance to finalization running state, pero el proceso de reubicación continuará.

Te recomendamos que esperes hasta que el valor de progressPercent sea 99 antes de iniciar el paso de sincronización final.

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

Valida el proceso de reubicación del bucket

Después de iniciar una reubicación, verifica que se haya completado correctamente. En esta sección, se proporciona orientación para confirmar la transferencia correcta de datos.

Valida el éxito del proceso de reubicación con los siguientes métodos:

• Sondea operaciones de larga duración: La reubicación de buckets es una operación de larga duración. Puedes sondear la operación de larga duración con operation id para supervisar su progreso y confirmar que se completó correctamente verificando el estado success. Esto implica consultar periódicamente el estado de la operación hasta que alcance un estado final. Para obtener información sobre cómo supervisar operaciones de larga duración, consulta Usa operaciones de larga duración en Cloud Storage.

• Analiza las entradas de los registros de auditoría de Cloud: Los registros de auditoría de Cloud proporcionan un registro detallado de los eventos y las operaciones en tu entorno de Google Cloud . Puedes analizar las entradas de los Registros de auditoría de Cloud asociadas con la reubicación para validar su éxito. Analiza los registros para detectar errores, advertencias o comportamientos inesperados que puedan indicar problemas durante la transferencia. Para obtener información sobre cómo ver los registros de Registros de auditoría de Cloud, consulta Visualiza los registros de auditoría.

  Las siguientes entradas de registro te ayudan a determinar si la migración se realizó correctamente o no:

  • Reubicación exitosa: Relocate bucket succeeded. All existing objects are now in the new placement configuration.

  • No se pudo realizar la reubicación: Relocate bucket has failed. Bucket location remains unchanged.

  Con las notificaciones de Pub/Sub, también puedes configurar alertas que te notifiquen cuando el evento específico de éxito o falla aparezca en los registros. Para obtener información sobre cómo configurar las notificaciones de Pub/Sub, consulta Configura las notificaciones de Pub/Sub para Cloud Storage.

Completa las tareas posteriores a la reubicación del bucket

Después de que hayas reubicado correctamente tu bucket, completa los siguientes pasos:

1. Opcional: Restaura los controles de acceso basados en etiquetas en tu bucket.
2. Las configuraciones existentes de los informes de inventario no se conservan durante el proceso de reubicación, por lo que deberás volver a crearlas de forma manual. Para obtener información sobre cómo crear una configuración de informes de inventario, consulta Crea una configuración de informes de inventario.
3. Actualiza tus configuraciones de infraestructura como código, como Terraform y el conector de configuración de Google Kubernetes Engine, para especificar la nueva ubicación del bucket.
4. Los extremos regionales están vinculados a ubicaciones específicas, por lo que deberás modificar el código de tu aplicación para reflejar el nuevo extremo.

Cómo controlar las operaciones de reubicación de bucket fallidas

Ten en cuenta los siguientes factores antes de controlar las operaciones de reubicación de bucket fallidas:

• Si falla la reubicación de un bucket, es posible que queden recursos obsoletos, como archivos temporales o copias de datos incompletas, en el destino. Debes esperar entre 7 y 14 días antes de iniciar otra reubicación del bucket al mismo destino. Puedes iniciar la reubicación de un bucket a otro destino de inmediato.

• Si la ubicación de destino no es la óptima para tus datos, es posible que desees revertir la reubicación. Sin embargo, no puedes iniciar una reubicación de inmediato. Se requiere un período de espera de hasta 14 días antes de que puedas volver a iniciar el proceso de reubicación. Esta restricción se aplica para garantizar la estabilidad y evitar conflictos de datos.

¿Qué sigue?

• Obtén más información sobre la reubicación de buckets.