Cette page explique comment utiliser la réplication entre buckets, qui utilise le service de transfert de stockage pour copier de manière asynchrone des objets nouveaux et mis à jour d'un bucket source vers un bucket de destination. Lorsque vous utilisez la réplication entre buckets, vous créez et gérez des jobs de réplication, qui sont un type de jobs 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 un job de réplication
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 un job de réplication pour des buckets existants ou pour de nouveaux buckets lors du processus de création de bucket.
Pour créer un job de réplication pour un nouveau bucket, suivez les instructions de création d'un bucket.
Pour créer un job 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 Réplication entre buckets, puis cliquez sur
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 Sélectionner 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 la 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.
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.
Pour savoir comment créer 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 du job de réplication, affichez les journaux Cloud Logging pour le service de transfert de stockage.
Afficher la liste des jobs de réplication
Vous ne pouvez pas lister les jobs de réplication à l'aide de la console Google Cloud. Consultez la section Afficher un job de réplication pour savoir comment afficher un seul job de réplication à la fois.
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.
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 un job de réplication
- 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 le job de réplication entre buckets.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Réplication entre buckets, puis cliquez sur
Modifier.Le volet Modifier la réplication entre les buckets s'ouvre et affiche le job de réplication pour chaque bucket de destination.
Sur la page Buckets, vous pouvez consulter la colonne Réplication, qui indique si un bucket exécute un job de réplication Turbo ou un job de réplication entre buckets. Pour savoir comment afficher la colonne Réplication, consultez Afficher des colonnes.
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.
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 un job de réplication
Vous pouvez mettre à jour les champs suivants d'un job de réplication :
Description du job de réplication
Configuration d'un job de réplication
Configuration des notifications publiées dans Pub/Sub
Comportement de journalisation des opérations de jobs de réplication
État du job de réplication (activé, désactivé ou supprimé)
Lorsque vous utilisez la console Google Cloud, vous ne pouvez mettre à jour un job de réplication qu'en le suspendant ou en le 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 Réplication entre buckets, puis cliquez sur
Modifier.Dans le volet Modifier la réplication entre les buckets, cliquez sur
Suspendre ou sur Réactiver à côté du job de réplication que vous souhaitez mettre à jour.
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.
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 un job de réplication
- 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 arrêter la réplication.
Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.
Recherchez l'option Réplication entre buckets, puis cliquez sur
Modifier.Dans le volet Modifier la réplication entre les buckets, cliquez sur
Supprimer à côté du job de réplication que vous souhaitez supprimer.Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.
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.
Pour savoir comment supprimer 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.