New Object Storage guide for Swift to S3-compatible object storage migration

pages/index.md

@@ -743,6 +743,7 @@
                 + [Object Storage - Master asynchronous replication across your buckets](storage_and_backup/object_storage/s3_asynchronous_replication)
                 + [Object Storage - Getting Started with Versioning](storage_and_backup/object_storage/s3_versioning)
                 + [Object Storage - How to connect Object Storage buckets with other resources in a vRack](storage_and_backup/object_storage/connect_other_ressources_in_vrack_private_network)
+                + [Object Storage - How to migrate from OVHcloud Swift Object Storage to OVHcloud S3-compatible Object Storage](storage_and_backup/object_storage/s3_migration_swift_to_s3)
             + [Configure Object Storage with your solutions](public-cloud-storage-object-storage-configure-object-storage-with-your-solutions)
                 + [Object Storage - Third-party applications compatibility](storage_and_backup/object_storage/s3_ecosystem)
                 + [Object Storage - Use Object Storage with Rclone](storage_and_backup/object_storage/s3_rclone)

pages/storage_and_backup/object_storage/s3_migration_swift_to_s3/guide.en-gb.md

@@ -0,0 +1,148 @@
+---
+title: Object Storage - How to migrate from OVHcloud Swift Object Storage to OVHcloud S3-compatible Object Storage
+excerpt: This guide provides details on how to migrate from OVHcloud Swift Object Storage to OVHcloud S3-compatible Object Storage using Rclone
+updated: 2025-10-16
+---
+
+## Objective
+
+OVHcloud offers two types of Object Storage: one based on OpenStack Swift and the other based on native S3<sup>1</sup> APIs.
+
+If you want to know more about available Object Storage offerings and classes, refer to our guide "[Object Storage - Choosing the right storage class for your needs](/pages/storage_and_backup/object_storage/s3_choosing_the_right_storage_class_for_your_needs)".
+
+This guide provides detailed steps to help you migrate from OVHcloud Swift Object Storage to OVHcloud S3-compatible Object Storage using [Rclone](https://rclone.org/) tool, a command-line tool that can be used to manage cloud storage resources.
+
+> [!warning]
+>
+> OVHcloud provides services which you are responsible for with regard to their configuration and management. You are therefore responsible for ensuring they function correctly.
+>
+> This guide is designed to assist you in common tasks as much as possible. If you encounter any difficulties performing these actions, please contact a [specialist service provider](/links/partner) and/or discuss the issue with our [community of users](/links/community). OVHcloud cannot provide you with technical support in this regard.
+>
+
+## Requirements
+
+- An **OVHcloud account** with access to both Swift Object Storage containers and S3-compatible buckets.
+- An **OVHcloud Swift Object Storage source container** in your current Object Storage with:
+    - Your bucket name.
+    - Your associated user and password.
+    - The associated region ID.
+- An **OVHcloud S3-compatible Object Storage destination bucket** with:
+    - Your bucket name.
+    - Your associated access and secret keys.
+    - The associated region ID.
+- An **OVHcloud Public Cloud instance** with Rclone installed working as the management workstation in our scenario. To get the best results, within your budget, we suggest at least the following specifications:
+    - b3-16: 4 v-cores and 16 GB of RAM
+    - c3-16: 8 v-cores and 16 GB of RAM
+
+## Instructions
+
+### 1 - Installing Rclone
+
+If you haven’t done it already, install **Rclone** by following the instructions from [its documentation](https://rclone.org/install/), based on your OS configuration.
+
+### 2 - Configuring Rclone
+
+After installing **Rclone** on your virtual machine, configure its connection to both the source container and destination buckets. To do so, you can either follow Rclone step by step configuration or you can also create and modify the configuration file yourself.
+
+#### 2.1 - Using Rclone config command
+
+```bash
+$ rclone config
+```
+
+This command will open the configuration menu and will guide you step by step with the configuration. Then:
+
+- For your source container: we recommand using your OpenStack user and associated rclone config file from the [OVHcloud Control Panel](/links/manager). Follow the steps in [this guide](/pages/storage_and_backup/object_storage/pcs_sync_rclone_object_storage) to access the config file associated to your OpenStack user.
+- For your destination bucket: the official OVHcloud provider configuration is available [here](https://rclone.org/s3/#ovhcloud) and will guide you step by step.
+
+#### 2.2 - Using Rclone config file
+
+As said, you can also create and modify the configuration file yourself with the following command:
+
+```bash
+$ rclone config file
+```
+
+If the configuration file doesn’t exist, you’ll be prompted to add the following configuration using your preferred editor. For example, on Linux you can use `nano` :
+
+```bash
+$ nano /home/<your linux user>/.config/rclone/rclone.conf
+```
+
+In both cases your configuration blocks should look like:
+
+```bash
+[ovhcloud-swift]
+type = swift
+env_auth = false
+auth_version = 3
+auth = https://auth.cloud.ovh.net/v3
+endpoint_type = public
+tenant_domain = default
+tenant = <tenant number>
+domain = default
+user = <your user>
+key = <your key>
+region = <region>
+
+[ovhcloud-s3]
+type = s3
+provider = OVHcloud
+env_auth = false
+access_key_id = OVH-ACCESS-KEY
+secret_access_key = OVH-SECRET-KEY
+endpoint = s3.<region>.io.cloud.ovh.net
+region = <region>
+```
+
+> [!primary]
+>
+> To get the list of OVHcloud region endpoints, refer to our guide "[Object Storage - Endpoints and Object Storage geoavailability](/pages/storage_and_backup/object_storage/s3_location)".
+>
+
+You can then test your two connections using the `rclone config` command by as below:
+
+```bash
+$ rclone config
+```
+
+### 3 - Running Rclone
+
+Depending on your strategy you can use two different commands to start the migration.
+
+You can you use the `rclone sync` command to start the migration of one or all buckets. As detailed in the documentation, the `rclone sync`command will make source and destination identical. Be careful then when using it.
+
+You can also use the `rclone copy` command that will copy files from your source to your destination.
+
+In both cases, remember to change `source-container-name` and `destination-bucket-name` to your OVHcloud Swift source container and your OVHcloud S3-compatible desintation bucket names, respectively:
+
+```bash
+$ rclone sync ovhcloud-swift:source-container-name/ ovhcloud-s3:destination-bucket-name/ --progress
+```
+
+or:
+
+```bash
+$ rclone copy ovhcloud-swift:source-container-name/ ovhcloud-s3:destination-bucket-name/ --progress
+```
+
+`--progress` shows progress during transfer.
+
+### Migration status
+
+We recommend comparing the source and destination buckets after migration. Your source and OVHcloud destination buckets can be compared via command line or directly from the [OVHcloud Control Panel](/links/manager)
+
+You can check the size of both buckets and number of objects using this command line:
+
+```bash
+rclone size <your source provider name>:source-bucket-name/
+rclone size ovhcloud:ovh-bucket-name/
+```
+
+## Go further
+
+If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for assisting you on your specific use case of your project.
+
+Join our [community of users](/links/community).
+
+<sup>1</sup>: S3 is a trademark of Amazon Technologies, Inc. OVHcloud’s service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies, Inc.

pages/storage_and_backup/object_storage/s3_migration_swift_to_s3/guide.fr-fr.md

@@ -0,0 +1,147 @@
+---
+title: "Object Storage - Comment migrer un Object Storage Swift OVHcloud vers un Object Storage OVHcloud compatible S3"
+excerpt: "Découvrez comment migrer un Object Storage Swift OVHcloud vers un Object Storage OVHcloud compatible S3 en utilisant Rclone"
+updated: 2025-10-16
+---
+
+## Objectif
+
+OVHcloud propose deux types d'Object Storage : l'un basé sur OpenStack Swift et l'autre basé sur les API natives S3<sup>1</sup>.
+
+Si vous souhaitez en savoir plus sur les offres et classes d'Object Storage disponibles, référez-vous à notre guide « [Object Storage - Choisir une classe de stockage adaptée à vos besoins](/pages/storage_and_backup/object_storage/s3_choosing_the_right_storage_class_for_your_needs) ».
+
+Ce guide fournit des étapes détaillées pour vous aider à migrer un Object Storage Swift OVHcloud vers un Object Storage OVHcloud compatible S3 en utilisant l'outil [Rclone](https://rclone.org/), un outil en ligne de commande permettant de gérer des ressources de stockage cloud.
+
+> [!warning]
+>
+> OVHcloud met à votre disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous revient de ce fait d'en assurer le bon fonctionnement.
+>
+> Nous mettons à votre disposition ce guide afin de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un [prestataire spécialisé](/links/partner) et/ou de contacter l'éditeur du logiciel si vous éprouvez des difficultés. En effet, nous ne serons pas en mesure de vous fournir une assistance.
+>
+
+## Prérequis
+
+- Posséder un **compte OVHcloud** avec un accès aux conteneurs Object Storage Swift et aux buckets compatibles S3.
+- Disposer d'un **conteneur source Object Storage Swift OVHcloud** dans votre Object Storage actuel avec :
+    - Le nom de votre bucket.
+    - Votre nom d'utilisateur et mot de passe associés.
+    - L'ID de la région associée.
+- Disposer **bucket de destination Object Storage OVHcloud compatible S3** avec :
+    - Le nom de votre bucket.
+    - Vos clés d'accès et clés secrètes associées.
+    - L'ID de la région associée.
+- Détenir une **machine virtuelle OVHcloud** avec Rclone installé, servant de station de gestion dans notre scénario. Pour obtenir les meilleurs résultats, dans votre budget, nous vous recommandons au moins les spécifications suivantes :
+    - b3-16 : 4 v-cores et 16 Go de RAM.
+    - c3-16 : 8 v-cores et 16 Go de RAM.
+
+## En pratique
+
+### 1 - Installation de Rclone
+
+Si vous ne l'avez pas déjà fait, installez **Rclone** en suivant les instructions de [sa documentation](https://rclone.org/install/), en fonction de la configuration de votre système d'exploitation.
+
+### 2 - Configuration de Rclone
+
+Après avoir installé **Rclone** sur votre machine virtuelle, configurez sa connexion au conteneur source et aux buckets de destination. Pour ce faire, vous pouvez soit suivre la configuration pas à pas de Rclone, soit créer et modifier vous-même le fichier de configuration.
+
+#### 2.1 - Utilisation de la commande Rclone config
+
+```bash
+$ rclone config
+```
+
+Cette commande ouvrira le menu de configuration et vous guidera pas à pas dans la configuration. Ensuite :
+
+- Pour votre conteneur source : nous vous recommandons d'utiliser votre utilisateur OpenStack et le fichier de configuration Rclone associé depuis [l'espace client OVHcloud](/links/manager). Suivez les étapes de [ce guide](/pages/storage_and_backup/object_storage/pcs_sync_rclone_object_storage) pour accéder au fichier de configuration associé à votre utilisateur OpenStack.
+- Pour votre bucket de destination : la configuration officielle du fournisseur OVHcloud est disponible [ici](https://rclone.org/s3/#ovhcloud) et vous guidera pas à pas.
+
+#### 2.2 - Utilisation du fichier de configuration Rclone
+
+Comme indiqué, vous pouvez également créer et modifier vous-même le fichier de configuration avec la commande suivante :
+
+```bash
+$ rclone config file
+```
+
+Si le fichier de configuration n'existe pas, vous serez invité à ajouter la configuration suivante en utilisant votre éditeur préféré. Par exemple, sous Linux, vous pouvez utiliser `nano` :
+
+```bash
+$ nano /home/<votre utilisateur Linux>/.config/rclone/rclone.conf
+```
+Dans les deux cas, vos blocs de configuration doivent ressembler à :
+
+```bash
+[ovhcloud-swift]
+type = swift
+env_auth = false
+auth_version = 3
+auth = https://auth.cloud.ovh.net/v3
+endpoint_type = public
+tenant_domain = default
+tenant = <numéro de tenant (locataire)>
+domain = default
+user = <votre utilisateur>
+key = <votre clé>
+region = <région>
+
+[ovhcloud-s3]
+type = s3
+provider = OVHcloud
+env_auth = false
+access_key_id = OVH-ACCESS-KEY
+secret_access_key = OVH-SECRET-KEY
+endpoint = s3.<région>.io.cloud.ovh.net
+region = <région>
+```
+
+> [!primary]
+>
+> Pour obtenir la liste des endpoints des régions OVHcloud, consultez notre guide « [Object Storage - Endpoints et géo-disponibilité de l’Object Storage](/pages/storage_and_backup/object_storage/s3_location) ».
+>
+
+Vous pouvez ensuite tester vos deux connexions en utilisant la commande `rclone config` comme suit :
+
+```bash
+$ rclone config
+```
+
+### 3 - Exécution de Rclone
+
+En fonction de votre stratégie, vous pouvez utiliser deux commandes différentes pour lancer la migration.
+
+Vous pouvez utilisez la commande `rclone sync` pour migrer un ou tous les buckets. Comme indiqué dans la documentation, la commande `rclone sync` rendra la source et la destination identiques. Soyez donc prudent lors de son utilisation.
+
+Vous pouvez également utiliser la commande `rclone copy` qui copiera les fichiers de votre source vers votre destination.
+
+Dans les deux cas, n'oubliez pas de remplacer `source-container-name` et `destination-bucket-name` par le nom de votre conteneur source Swift OVHcloud et le nom de votre bucket de destination OVHcloud compatible S3, respectivement :
+
+```bash
+$ rclone sync ovhcloud-swift:source-container-name/ ovhcloud-s3:destination-bucket-name/ --progress
+```
+
+ou :
+
+```bash
+$ rclone copy ovhcloud-swift:source-container-name/ ovhcloud-s3:destination-bucket-name/ --progress
+```
+
+`--progress` affiche l'avancement pendant le transfert.
+
+### Statut de la migration
+
+Nous vous recommandons de comparer les buckets source et destination après la migration. Vos buckets source et destination OVHcloud peuvent être comparés en ligne de commande ou directement depuis [l'espace client OVHcloud](/links/manager)
+
+Vous pouvez vérifier la taille des deux buckets et le nombre d'objets en utilisant cette commande :
+
+```bash
+rclone size <nom de votre fournisseur source>:source-bucket-name/
+rclone size ovhcloud:ovh-bucket-name/
+```
+
+## Aller plus loin
+
+Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](/links/professional-services) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.
+
+Échangez avec notre [communauté d'utilisateurs](/links/community).
+
+<sup>1</sup> : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services de OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.

pages/storage_and_backup/object_storage/s3_migration_swift_to_s3/meta.yaml

@@ -0,0 +1,3 @@
+id:  13b937f0-57fb-41c8-b485-3cd9adf89ed8
+full_slug: public-cloud-storage-object-storage-migrate-from-swift-to-s3
+reference_category: public-cloud-storage-object-storage-tutorials