Cette page explique comment utiliser la réplication entre les buckets, qui utilise le service de transfert de stockage pour copier de manière asynchrone les objets nouveaux et mis à jour d'un bucket source vers un bucket de destination. Lorsque vous utilisez la réplication entre les buckets, vous créez et gérez des tâches de réplication, qui sont un type de tâche dans le service de transfert de stockage.
Avant de commencer
Pour utiliser la réplication entre buckets, vous devez suivre les étapes préalables. Pour obtenir des instructions, consultez la section Avant de commencer dans la documentation du service de transfert de stockage.
Créer une tâche de réplication
Console
Lorsque vous créez une tâche de réplication entre les buckets à l'aide de la console Google Cloud, le rôle storage.legacyBucketOwner est automatiquement attribué à l'agent de service du service de transfert de stockage sur le bucket source et le rôle storage.legacyBucketWriter sur le bucket de destination.
Lorsque vous utilisez la console Google Cloud, vous pouvez créer une tâche de réplication pour des buckets existants ou pour de nouveaux buckets lors du processus de création de bucket.
Pour créer une tâche de réplication pour un nouveau bucket, suivez les instructions de création d'un bucket.
Pour créer une tâche de réplication pour un bucket existant, procédez comme suit:
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket source dont vous souhaitez répliquer les objets.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Replication cross-bucket (Réplication entre buckets), puis cliquez sur Edit (Modifier).
Dans le volet Modifier la réplication entre buckets qui s'ouvre, cliquez sur Ajouter une destination.
Dans la section Choisir une destination, sélectionnez un bucket de destination, puis cliquez sur Suivant.
Dans la section Choisir les paramètres de réplication, procédez comme suit:
Facultatif: Pour filtrer les objets à répliquer en fonction du préfixe de leur nom, cochez la case Répliquer les objets en fonction du préfixe dans la section Choisir les objets à répliquer.
Pour inclure des objets par préfixe, saisissez un préfixe dans la section Inclure les objets avec un préfixe, puis cliquez sur Ajouter un préfixe.
Pour exclure des objets par préfixe, saisissez un préfixe dans la section Exclure les objets avec un préfixe, puis cliquez sur Ajouter un préfixe.
Facultatif: Pour définir une classe de stockage pour les objets répliqués, sélectionnez une classe de stockage dans le menu de la section Définir une classe de stockage pour les objets répliqués.
Si vous ignorez cette étape, les objets répliqués utilisent la classe de stockage du bucket de destination par défaut.
- Cliquez sur Enregistrer.
Ligne de commande
Pour obtenir des instructions Google Cloud CLI sur la création d'une tâche de réplication, consultez Créer une tâche de réplication à l'aide de la Google Cloud CLI.
API REST
API JSON
Pour obtenir des instructions sur la création d'une tâche de réplication à l'aide de l'API JSON, consultez Créer une tâche de réplication à l'aide de l'API JSON.
Pour vérifier l'état de la tâche de réplication, consultez Cloud Logging pour les journaux du service de transfert de stockage.
Lister les tâches de réplication
Console
Vous ne pouvez pas lister les jobs de réplication à l'aide de la console Google Cloud. Pour savoir comment afficher un seul job de réplication à la fois, consultez la section Afficher un job de réplication.
Ligne de commande
Pour obtenir des instructions sur l'utilisation de la Google Cloud CLI pour lister les jobs de réplication, consultez Lister les jobs de réplication à l'aide de la Google Cloud CLI.
API REST
API JSON
Pour obtenir des instructions sur la liste des tâches de réplication à l'aide de l'API JSON, consultez Lister les tâches de réplication à l'aide de l'API JSON.
Afficher une tâche de réplication
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket source dont vous souhaitez afficher la tâche de réplication entre buckets.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Replication cross-bucket (Réplication entre buckets), puis cliquez sur Edit (Modifier).
Le volet Modifier la réplication entre buckets s'affiche. Il affiche la tâche de réplication pour chaque bucket de destination.
Sur la page Buckets (Buckets), vous pouvez afficher la colonne Replication (Réplication), qui indique si un bucket exécute une tâche de réplication Turbo ou une tâche de réplication entre buckets. Pour savoir comment afficher la colonne Replication (Réplication), consultez Afficher les colonnes.
Ligne de commande
Pour obtenir des instructions Google Cloud CLI sur l'affichage d'une tâche de réplication, consultez Afficher une tâche de réplication à l'aide de Google Cloud CLI.
API REST
API JSON
Pour obtenir des instructions sur l'affichage d'une tâche de réplication à l'aide de l'API JSON, consultez Afficher une tâche de réplication à l'aide de l'API JSON.
Mettre à jour une tâche de réplication
Vous pouvez mettre à jour les champs suivants d'une tâche de réplication:
Description de la tâche de réplication
Configuration pour exécuter une tâche de réplication
Configuration des notifications publiées dans Pub/Sub
Comportement de journalisation des opérations de tâche de réplication
État de la tâche de réplication (activée, désactivée ou supprimée)
Console
Lorsque vous utilisez la console Google Cloud, vous ne pouvez mettre à jour une tâche de réplication qu'en la mettant en pause ou en la réactivant.
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket source dont vous souhaitez suspendre ou réactiver la réplication.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Replication cross-bucket (Réplication entre les buckets), puis cliquez sur Edit (Modifier).
Dans le volet Modifier la réplication entre les buckets qui s'affiche, cliquez sur Mettre en veille ou Réactiver à côté de la tâche de réplication que vous souhaitez mettre à jour.
Ligne de commande
Pour obtenir des instructions Google Cloud CLI sur la mise à jour d'une tâche de réplication, consultez Mettre à jour une tâche de réplication à l'aide de Google Cloud CLI.
API REST
API JSON
Pour savoir comment mettre à jour une tâche de réplication à l'aide de l'API JSON, consultez Mettre à jour une tâche de réplication à l'aide de l'API JSON.
Supprimer une tâche de réplication
Console
- Dans la console Google Cloud, accédez à la page Buckets Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket source que vous souhaitez arrêter de répliquer.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Replication cross-bucket (Réplication entre buckets), puis cliquez sur Edit (Modifier).
Dans le volet Modifier la réplication entre les buckets qui s'affiche, cliquez sur Supprimer à côté de la tâche de réplication que vous souhaitez supprimer.
Dans la boîte de dialogue qui s'affiche, cliquez sur Confirmer.
Ligne de commande
Pour obtenir des instructions Google Cloud CLI sur la suppression d'une tâche de réplication, consultez Supprimer une tâche de réplication à l'aide de Google Cloud CLI.
API REST
API JSON
Pour obtenir des instructions sur la suppression d'une tâche de réplication à l'aide de l'API JSON, consultez Supprimer une tâche de réplication à l'aide de l'API JSON.