En esta página se describe cómo usar la replicación entre contenedores, que usa el Servicio de transferencia de Storage para copiar objetos nuevos y actualizados de forma asíncrona de un contenedor de origen a un contenedor de destino. Cuando usas la replicación entre contenedores, creas y gestionas tareas de replicación, que son un tipo de tarea del Servicio de transferencia de Storage.
Antes de empezar
Para usar la replicación entre contenedores, debes completar los pasos previos. Para obtener instrucciones, consulta la sección Antes de empezar de la documentación del Servicio de transferencia de Storage.
Crear una tarea de replicación
Consola
Cuando creas un trabajo de replicación entre contenedores mediante la consola deGoogle Cloud , se concede automáticamente al agente de servicio del Servicio de transferencia de Storage el rol storage.legacyBucketOwner en el contenedor de origen y el rol storage.legacyBucketWriter en el de destino.
Cuando usas la consola Google Cloud , puedes crear un trabajo de replicación para segmentos que ya tengas o para segmentos nuevos durante el proceso de creación.
Para crear un trabajo de replicación para un nuevo contenedor, siga las instrucciones para crear un contenedor.
Para crear un trabajo de replicación para un contenedor, sigue estos pasos:
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de segmentos, haga clic en el nombre del segmento de origen cuyos objetos quiera replicar.
En la página Detalles del segmento, haga clic en la pestaña Configuración.
Busca la opción Replicación entre contenedores y haz clic en Editar.
En el panel Editar replicación entre contenedores que se abre, haga clic en Añadir un destino.
En la sección Choose a destination (Elegir un destino), selecciona un contenedor de destino y haz clic en Next (Siguiente).
En la sección Elegir configuración de replicación, haga lo siguiente:
Opcional: Para filtrar los objetos que se van a replicar por prefijo de nombre de objeto, seleccione la casilla Replicate objects based on prefix (Replicar objetos según el prefijo) en la sección Choose which objects to replicate (Elegir los objetos que se van a replicar).
Para incluir objetos por prefijo, introduce un prefijo en la sección Incluir objetos con prefijo y, a continuación, haz clic en Añadir un prefijo.
Para excluir objetos por prefijo, introduce un prefijo en la sección Excluir objetos con prefijo y, a continuación, haz clic en Añadir prefijo.
Opcional: Para definir una clase de almacenamiento para los objetos replicados, seleccione una clase de almacenamiento en el menú de la sección Definir clase de almacenamiento para objetos replicados.
Si omite este paso, los objetos replicados usarán la clase de almacenamiento del segmento de destino de forma predeterminada.
- Haz clic en Guardar.
Línea de comandos
Para obtener instrucciones sobre cómo crear un trabajo de replicación con Google Cloud CLI, consulta Crear un trabajo de replicación con Google Cloud CLI.
APIs REST
API JSON
Para obtener instrucciones sobre cómo crear un trabajo de replicación con la API JSON, consulta Crear un trabajo de replicación con la API JSON.
Para comprobar el estado del trabajo de replicación, consulta los registros de Cloud Logging del servicio de transferencia de Storage.
Mostrar tareas de replicación
Consola
No puedes enumerar los trabajos de replicación mediante la consola de Google Cloud . Consulta Ver un trabajo de replicación para obtener instrucciones sobre cómo ver un solo trabajo de replicación a la vez.
Línea de comandos
Para obtener instrucciones sobre cómo enumerar las tareas de replicación con la CLI de Google Cloud, consulta el artículo Enumerar tareas de replicación con la CLI de Google Cloud.
APIs REST
API JSON
Para obtener instrucciones sobre cómo enumerar trabajos de replicación con la API JSON, consulta Enumerar trabajos de replicación con la API JSON.
Ver una tarea de replicación
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de segmentos, haz clic en el nombre del segmento de origen cuyo trabajo de replicación entre segmentos quieras ver.
En la página Detalles del segmento, haga clic en la pestaña Configuración.
Busca la opción Replicación entre contenedores y haz clic en Editar.
Aparecerá el panel Editar réplica entre contenedores, que muestra el trabajo de réplica de cada contenedor de destino.
En la página Contenedores, puede ver la columna Replicación, que muestra si un contenedor tiene un trabajo de replicación turbo o un trabajo de replicación entre contenedores en curso. Para obtener instrucciones sobre cómo mostrar la columna Replicación, consulta Mostrar columnas.
Línea de comandos
Para obtener instrucciones sobre cómo ver un trabajo de replicación con Google Cloud CLI, consulta Ver un trabajo de replicación con Google Cloud CLI.
APIs REST
API JSON
Para obtener instrucciones sobre cómo ver un trabajo de replicación con la API JSON, consulta Ver un trabajo de replicación con la API JSON.
Actualizar una tarea de replicación
Puede actualizar los siguientes campos de un trabajo de replicación:
Descripción del trabajo de replicación
La configuración para ejecutar una tarea de replicación
La configuración de las notificaciones publicadas en Pub/Sub
Comportamiento de registro de las operaciones de tareas de replicación
El estado del trabajo de replicación (si está habilitado, inhabilitado o eliminado)
Consola
Cuando usas la Google Cloud consola, solo puedes actualizar un trabajo de replicación pausándolo o reanudándolo.
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de segmentos, haga clic en el nombre del segmento de origen cuya replicación quiera pausar o reanudar.
En la página Detalles del segmento, haga clic en la pestaña Configuración.
Busca la opción Replicación entre contenedores y haz clic en Editar.
En el panel Editar replicación entre contenedores que aparece, haga clic en Pausar o Reanudar junto al trabajo de replicación que quiera actualizar.
Línea de comandos
Para obtener instrucciones sobre cómo actualizar un trabajo de replicación con la CLI de Google Cloud, consulta Actualizar un trabajo de replicación con la CLI de Google Cloud.
APIs REST
API JSON
Para obtener instrucciones sobre cómo actualizar un trabajo de replicación con la API JSON, consulta Actualizar un trabajo de replicación con la API JSON.
Eliminar una tarea de replicación
Consola
- En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
En la lista de segmentos, haga clic en el nombre del segmento de origen cuya replicación quiera detener.
En la página Detalles del segmento, haga clic en la pestaña Configuración.
Busca la opción Replicación entre contenedores y haz clic en Editar.
En el panel Editar replicación entre contenedores que aparece, haga clic en Eliminar junto al trabajo de replicación que quiera eliminar.
En el cuadro de diálogo que aparece, haz clic en Confirmar.
Línea de comandos
Para obtener instrucciones sobre cómo eliminar un trabajo de replicación con Google Cloud CLI, consulta Eliminar un trabajo de replicación con Google Cloud CLI.
APIs REST
API JSON
Para obtener instrucciones sobre cómo eliminar un trabajo de replicación con la API JSON, consulta Eliminar un trabajo de replicación con la API JSON.
Siguientes pasos
Monitoriza los objetos replicados.