Reubicar segmentos

En esta página se describe el proceso para cambiar la ubicación de los contenedores. Para obtener información sobre el cambio de ubicación de los segmentos, consulta Cambio de ubicación de los segmentos.

Antes de empezar

Antes de poder cambiar la ubicación de los contenedores, debes completar los siguientes pasos:

1. Configurar Storage Intelligence

2. Habilita la eliminación lógica.

3. Consulta las cuotas y los límites para asegurarte de que la nueva ubicación tenga cuotas suficientes para alojar los datos del contenedor.

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

5. Elimina las etiquetas de contenedor que haya.

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

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

Obtener los roles necesarios

Para obtener los permisos que necesitas para cambiar la ubicación de los segmentos, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Storage (roles/storage.admin) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para cambiar la ubicación de los contenedores. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

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

Reubicar segmentos

En esta sección se describe el proceso para cambiar la ubicación de los segmentos de Cloud Storage. Cuando cambias la ubicación de un contenedor, inicias el proceso de copia de datos incremental, lo monitorizas y, a continuación, inicias el paso de sincronización final. Para obtener más información sobre estos pasos, consulta Información sobre el proceso de cambio de ubicación de los contenedores.

Realizar una prueba de funcionamiento

Para minimizar los posibles problemas durante el proceso de cambio de ubicación de los contenedores, te recomendamos que hagas una prueba. Una prueba de funcionamiento simula el proceso de cambio de ubicación del contenedor sin mover datos, lo que te ayuda a detectar y resolver problemas en las primeras fases. La prueba de funcionamiento comprueba las siguientes incompatibilidades:

• Claves de encriptado gestionadas por el cliente (CMEK) o claves de encriptado proporcionadas por el cliente (CSEK)
• Políticas de retención bloqueadas
• Objetos con retenciones temporales
• Subidas multiparte

Aunque una prueba no puede identificar todos los problemas posibles, ya que algunos solo pueden surgir durante la migración activa debido a factores como la disponibilidad de recursos en tiempo real, reduce el riesgo de tener que afrontar problemas que requieren mucho tiempo durante la reubicación real.

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

Iniciar la copia de datos incremental

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

Monitorizar la copia de datos incremental

El proceso de cambio de ubicación de un contenedor es una operación de larga duración que debe monitorizarse para ver cómo avanza. Puede 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 los detalles de una operación de larga duración, enumerar o cancelar operaciones de larga duración, consulta Usar operaciones de larga duración en Cloud Storage.

En el siguiente ejemplo se muestra el resultado generado por 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 de la salida generada por la operación de copia de datos incremental:

Si tienes problemas al interactuar con otras funciones de Cloud Storage, consulta Limitaciones.

Iniciar el paso de sincronización final

El último paso de la sincronización implica un periodo durante el cual no puedes realizar operaciones de escritura en el contenedor. Te recomendamos que programes el paso de sincronización final en un momento que minimice las interrupciones en tus aplicaciones.

Antes de continuar, comprueba que el contenedor esté totalmente preparado consultando el valor de finalizationState en el resultado del paso copia de datos incrementales. 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

Validar el proceso de cambio de ubicación del segmento

Después de iniciar una reubicación, comprueba que se haya completado correctamente. En esta sección se explica cómo confirmar que la transferencia de datos se ha realizado correctamente.

Valide que el proceso de reubicación se ha completado correctamente con los siguientes métodos:

• Sondear operaciones de larga duración: la reubicación de un contenedor es una operación de larga duración. Puedes sondear la operación de larga duración mediante el operation id para monitorizar su progreso y confirmar que se ha completado correctamente verificando el estado success. Esto implica consultar periódicamente el estado de la operación hasta que alcance un estado terminal. Para obtener información sobre cómo monitorizar operaciones de larga duración, consulta Usar operaciones de larga duración en Cloud Storage.

• Analizar entradas de registros de auditoría de Cloud: los registros de auditoría de Cloud proporcionan un registro detallado de los eventos y las operaciones de tu entorno de Google Cloud . Puedes analizar las entradas de registros de auditoría de Cloud asociadas a la reubicación para comprobar si se ha completado correctamente. 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 auditoría de Cloud, consulta Ver registros de auditoría.

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

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

  • Reubicación fallida: Relocate bucket has failed. Bucket location remains unchanged.

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

Completar las tareas posteriores al cambio de ubicación del contenedor

Una vez que hayas cambiado la ubicación de tu contenedor, sigue estos pasos:

1. Opcional: Restaura los controles de acceso basados en etiquetas de tu contenedor.
2. Las configuraciones de informes de inventario no se conservan durante el proceso de cambio de ubicación, por lo que tendrá que volver a crearlas manualmente. Para obtener información sobre cómo crear una configuración de informe de inventario, consulta Crear una configuración de informe 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 endpoints regionales están vinculados a ubicaciones concretas, por lo que tendrás que modificar el código de tu aplicación para reflejar el nuevo endpoint.

Cómo gestionar las operaciones de cambio de ubicación de segmentos fallidas

Tenga en cuenta los siguientes factores antes de gestionar las operaciones de reubicación de cubos fallidas:

• Si no se puede cambiar la ubicación de un contenedor, es posible que queden recursos obsoletos en el destino, como archivos temporales o copias de datos incompletas. Debes esperar entre 7 y 14 días antes de iniciar otra reubicación de un contenedor en el mismo destino. Puedes iniciar una reubicación de un contenedor a otro destino inmediatamente.

• Si la ubicación de destino no es la óptima para tus datos, puede que quieras deshacer el cambio de ubicación. Sin embargo, no puedes iniciar una reubicación de inmediato. Debes esperar hasta 14 días para poder volver a iniciar el proceso de traslado. Esta restricción se ha implementado para garantizar la estabilidad y evitar conflictos de datos.

Siguientes pasos

• Consulta información sobre la reubicación de contenedores.