Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Migrer du serveur Couchbase vers Couchbase Capella sur AWS *Battulga Purevragchaa et Saurabh Shanbhag, Amazon Web Services* *Mark Gamble, aucun* ## Résumé Couchbase Capella est une base de données NoSQL en tant que service (DBaaS) entièrement gérée pour les applications critiques (par exemple, les profils utilisateurs ou les catalogues en ligne et la gestion des stocks). Couchbase Capella gère votre charge de travail DBaa S dans un compte Amazon Web Services (AWS) géré par Couchbase. Capella facilite l'exécution et la gestion de la réplication sur plusieurs clusters, plusieurs (région AWS, multicloud et cloud hybride) au sein d'une seule interface. Couchbase Capella vous aide à faire évoluer instantanément vos applications Couchbase Server, en vous aidant à créer des clusters multi-nœuds en quelques minutes. [https://docs.couchbase.com/server/current/eventing/eventing-overview.html](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) Il élimine également le besoin de gérer les installations, les mises à niveau, les sauvegardes et la maintenance générale des bases de données.  Ce modèle décrit les étapes et les meilleures pratiques pour migrer un environnement de [serveur Couchbase](https://www.couchbase.com/products/server) autogéré vers le cloud AWS. Le modèle fournit un processus reproductible pour migrer les données et les index des clusters Couchbase Server, exécutés sur site ou dans le cloud, vers Couchbase Capella. Ces étapes vous permettent d'éviter les problèmes lors de votre migration et d'accélérer l'ensemble de votre processus de migration. Ce modèle propose les deux options de migration suivantes : + **L'option 1** est appropriée si vous avez moins de 50 index à migrer.  + **L'option 2** est appropriée si vous avez plus de 50 index à migrer.  Vous pouvez également [configurer des exemples de données](https://docs.couchbase.com/server/current/manage/manage-settings/install-sample-buckets.html) sur votre serveur Couchbase autogéré afin de suivre le guide de migration. Si vous choisissez l'**option de migration 2**, ou si vous utilisez des étendues ou des collections autres que la valeur par défaut, vous devez utiliser l'exemple de fichier de configuration, qui se trouve dans la section *Informations supplémentaires*. ## Conditions préalables et limitations **Conditions préalables** + Un compte payant Couchbase Capella existant. Vous pouvez également créer un compte [Couchbase Capella sur AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) et utiliser l'essai gratuit de Couchbase Capella, puis passer à un compte payant pour configurer votre cluster en vue de la migration. Pour commencer avec la version d'essai, suivez les instructions de la section [Getting Started with Couchbase Capella](https://docs.couchbase.com/cloud/get-started/create-account.html). + Un environnement Couchbase Server autogéré existant sur site ou déployé chez un fournisseur de services cloud.  + Pour l'option de migration 2, Couchbase Shell et un fichier de configuration. Pour créer le fichier de configuration, vous pouvez utiliser le fichier d'exemple qui se trouve dans la section *Informations supplémentaires*. + Connaissance de l'administration de Couchbase Server et de Couchbase Capella. + Connaissance de l'ouverture de ports TCP et de l'exécution de commandes dans une interface de ligne de commande (CLI). Le processus de migration nécessite également les rôles et l'expertise décrits dans le tableau suivant. | | | Role | Expertise | Responsabilités | | --- |--- |--- | | Administrateur Couchbase | Connaissance de Couchbase Server et de Couchbase CapellaDes connaissances de base en ligne de commande sont utiles mais ne sont pas obligatoires | Tâches spécifiques à Couchbase Server et Capella | | Administrateur système, administrateur informatique | Connaissance de l'environnement et de l'administration autogérés du système Couchbase Server | Ouverture de ports et détermination des adresses IP sur les nœuds de cluster Couchbase Server autogérés | **Limites** + Ce modèle est utilisé pour migrer les données, les index et les index [Couchbase Full Text Search](https://docs.couchbase.com/server/current/fts/full-text-intro.html) depuis Couchbase Server vers Couchbase Capella sur AWS. [Le modèle ne s'applique pas à la migration de [Couchbase Eventing Service](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) ou à Couchbase Analytics.](https://docs.couchbase.com/server/current/analytics/introduction.html) + Couchbase Capella est disponible dans plusieurs régions AWS. Pour up-to-date plus d'informations sur les régions prises en charge par Capella, consultez [Amazon Web Services](https://docs.couchbase.com/cloud/reference/aws.html) dans la documentation de Couchbase. **Versions du produit** + [Édition Couchbase Server (Community ou Enterprise) version 5.x ou ultérieure](https://docs.couchbase.com/server/current/release-notes/relnotes.html) ## Architecture **Pile technologique source** + Serveur Couchbase **Pile technologique cible** + Canapé Capella **Architecture cible** ![\[La migration de Couchbase Capella vers le cluster Couchbase dans le plan de données Capella sur AWS s'effectue en quatre étapes.\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/images/pattern-img/14ac5a81-eade-4708-9335-f5602fa07824/images/95cd7f33-742e-4d10-8e2c-37c7b4d9df45.png) 1. Vous accédez à Couchbase Capella en utilisant le plan de contrôle **Capella**. Vous pouvez utiliser le plan de contrôle Capella pour effectuer les opérations suivantes : + Contrôlez et surveillez votre compte. + Gérez les clusters et les données, les index, les utilisateurs et les groupes, les autorisations d'accès, la surveillance et les événements. 1. Des clusters sont créés. 1. Le **plan de données Capella** se trouve dans le compte AWS géré par Couchbase. Après avoir créé un nouveau cluster, Couchbase Capella le déploie dans plusieurs zones de disponibilité de la région AWS sélectionnée. 1. Vous pouvez développer et déployer des applications Couchbase dans un VPC de votre compte AWS. [Généralement, ce VPC accède au plan de données Capella via le peering VPC.](https://docs.couchbase.com/cloud/clouds/private-network.html) ## Outils + [Couchbase Cross Data Center Replication (XDCR)](https://docs.couchbase.com/cloud/current/clusters/xdcr/xdcr.html) permet de répliquer les données entre des clusters situés dans différents fournisseurs de cloud et différents centres de données. Il est utilisé pour migrer des données vers Couchbase Capella à partir de clusters Couchbase Server autogérés. **Note** XDCR ne peut pas être utilisé avec Couchbase Server Community Edition pour migrer vers Couchbase Capella. Au lieu de cela, vous pouvez utiliser [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html). Pour plus d'informations, consultez l'épique *Migrate data from Community Edition*. + [Couchbase Shell est un shell](https://couchbase.sh/docs/) en ligne de commande permettant à Couchbase Server et Couchbase Capella d'accéder aux clusters Couchbase locaux et distants. Dans ce modèle, Couchbase Shell est utilisé pour migrer les index. + [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html) est un utilitaire Couchbase permettant d'exporter des données depuis le cluster Couchbase. Inclus dans les [outils CLI de Couchbase Server](https://docs.couchbase.com/server/current/cli/cli-intro.html). ## Épopées ### Préparer la migration | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Évaluez la taille du cluster de serveurs Couchbase autogéré. | Connectez-vous à la [console Web Couchbase](https://docs.couchbase.com/server/current/manage/manage-ui/manage-ui.html) pour Couchbase Server et évaluez les nœuds et les compartiments de votre cluster autogéré. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Vous utiliserez les configurations de votre cluster Couchbase Server autogéré comme guide général pour le dimensionnement et la configuration du cluster cible sur Couchbase Capella.[Pour obtenir de l'aide concernant un exercice plus détaillé de dimensionnement de Couchbase Capella, contactez Couchbase.](https://www.couchbase.com/contact) | Administrateur Couchbase | | Enregistrez la distribution du service Couchbase sur le cluster de serveurs Couchbase autogéré. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | | Enregistrez les adresses IP des nœuds du cluster Couchbase Server autogérés. | (Ignorez cette étape si vous utilisez Community Edition.) Enregistrez l'adresse IP de chaque nœud de votre cluster. Ils seront ajoutés ultérieurement à la liste des autorisations de votre cluster Couchbase Capella. | Administrateur Couchbase, administrateur système | ### Déployez et configurez des ressources sur Couchbase Capella | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Choisir un modèle. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | | Choisissez et configurez les nœuds. | Choisissez et configurez les nœuds en fonction de votre environnement de cluster Couchbase Server autogéré, notamment en ce qui concerne le nombre de nœuds, la distribution des services, le calcul ou la RAM et le stockage.Couchbase Capella utilise les meilleures pratiques de mise à l'[échelle multidimensionnelle](https://docs.couchbase.com/cloud/clusters/scale-cluster.html#scale-a-cluster). Les services et les nœuds ne peuvent être choisis qu'en fonction des meilleures pratiques de déploiement. Cela peut signifier que vous ne pouvez pas correspondre exactement aux configurations de votre cluster Couchbase Server autogéré. | Administrateur Couchbase | | Déployez le cluster. | Choisissez une zone de support et un package de support, puis déployez le cluster. Pour obtenir des instructions et des étapes détaillées, consultez la section [Création d'un cluster](https://docs.couchbase.com/cloud/clusters/create-cluster.html) dans la documentation de Couchbase.Si vous utilisez l'essai gratuit de Couchbase Capella, vous devez le convertir en compte payant avant de commencer votre migration. Pour convertir votre compte, ouvrez la section **Facturation** du plan de contrôle Couchbase Capella, puis choisissez **Ajouter** un identifiant d'activation. L'identifiant d'activation est envoyé à votre adresse e-mail de contact de facturation une fois que vous avez conclu un contrat d'achat avec Couchbase Sales ou après avoir effectué un achat via [AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) Marketplace. | Administrateur Couchbase | | Créez un utilisateur d'identification de base de données. | Un utilisateur d'identification de base de données est spécifique à un cluster et comprend un nom d'utilisateur, un mot de passe et un ensemble de privilèges de compartiment. Cet utilisateur est requis pour créer des compartiments et accéder aux données des compartiments. Dans le plan de contrôle Couchbase Capella, créez un identifiant de base de données pour le nouveau cluster en suivant les instructions de la section [Configurer les informations d'identification de base de données dans la documentation Couchbase](https://docs.couchbase.com/cloud/clusters/manage-database-users.html) Capella.Les utilisateurs d'une organisation ont besoin que les informations d'identification relatives au rôle organisationnel leur soient attribuées s'ils souhaitent accéder aux données des compartiments d'un cluster en particulier, soit à distance, soit via l'interface utilisateur de Couchbase Capella. Cela est distinct des informations d'identification de base de données, qui sont généralement utilisées par les applications et les intégrations. La création de l'utilisateur organisationnel vous permet de créer et de gérer les buckets cibles sur votre cluster Couchbase Capella. | Administrateur Couchbase | | Si vous utilisez l'option de migration 2, installez Couchbase Shell. | Vous pouvez installer Couchbase Shell sur n'importe quel système disposant d'un accès réseau à la fois à votre serveur Couchbase autogéré et aux clusters Couchbase Capella. Pour plus d'informations, consultez [Installer Couchbase Shell version 1.0.0-beta.5](https://couchbase.sh/docs/#_installation) dans la documentation de Couchbase Shell.Vérifiez que Couchbase Shell est installé en [testant une connexion à votre cluster autogéré](https://couchbase.sh/docs/#_connecting_to_a_cluster) dans un terminal de ligne de commande. | Administrateur Couchbase, administrateur système | | Autoriser les adresses IP. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Pour plus d'informations sur les adresses IP autorisées, consultez [Configurer les adresses IP autorisées](https://docs.couchbase.com/cloud/get-started/configure-cluster-access.html#allow-ip-address) dans la documentation de Couchbase. | Administrateur Couchbase, administrateur système | | Configurez les certificats. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase, administrateur système | | Créez le fichier de configuration pour Couchbase Shell. | Créez un fichier point de configuration dans le répertoire personnel de l'installation de Couchbase Shell (par exemple,). `//.cbsh/config` Pour plus d'informations, consultez [Config dotfiles](https://couchbase.sh/docs/#_the_config_dotfiles) dans la documentation de Couchbase.Ajoutez les propriétés de connexion pour les clusters source et cible au fichier de configuration. Vous pouvez utiliser l'exemple de fichier de configuration qui se trouve dans la section *Informations supplémentaires* et modifier les paramètres de vos clusters. Enregistrez le fichier de configuration avec les paramètres mis à jour `.cbsh` dans le dossier (par exemple,`//.cbsh/config`). | Administrateur Couchbase, administrateur système | | Créez des compartiments cibles. | Pour chaque bucket source, créez un bucket cible dans votre cluster Couchbase Capella en suivant les instructions de la section [Créer un bucket](https://docs.couchbase.com/cloud/clusters/data-service/manage-buckets.html#add-bucket) dans la documentation Couchbase.Les configurations de vos compartiments cibles doivent correspondre aux noms des compartiments, aux paramètres de mémoire et aux paramètres de résolution des conflits des compartiments de votre cluster Couchbase Server autogéré. | Administrateur Couchbase | | Créez des étendues et des collections. | Chaque compartiment contient une étendue et une collection par défaut avec le keyspace. `_default._default` Si vous utilisez d'autres espaces clés pour votre portée et votre collection, vous devez créer des espaces clés identiques dans le cluster Capella cible.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)
scopes --clusters "On-Prem-Cluster" --bucket  | select scope | where scope != "_default" | each { |it| scopes create $it.scope --clusters "Capella-Cluster" }
collections --clusters "On-Prem-Cluster" --bucket  | select scope collection | where $it.scope != "_default" | where $it.collection != "_default" | each { |it| collections create $it.collection --clusters "Capella-Cluster" --bucket  --scope $it.scope }
| Administrateur Couchbase | ### Migrer les données depuis Enterprise Edition | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Ouvrez les ports TCP sur les nœuds du cluster Couchbase Server autogérés. | Assurez-vous que les ports appropriés sont ouverts pour la communication XDCR sur les nœuds du cluster Couchbase Server autogéré. Pour plus d'informations, consultez la documentation sur les [ports du serveur Couchbase](https://docs.couchbase.com/server/current/install/install-ports.html#ports-listed-by-communication-path). | Administrateur Couchbase, administrateur système | | Si vous utilisez Couchbase Server Enterprise Edition, configurez Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | | Démarrez Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | ### Migrez les index à l'aide de l'option 1 | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Migrez les index de clusters autogérés vers Couchbase Capella. | Nous recommandons cette procédure si vous avez moins de 50 index à migrer. Si vous avez plus de 50 index à migrer, nous vous recommandons d'utiliser l'option de migration 2.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase, administrateur système | ### Migrez les index à l'aide de l'option 2 | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Migrez les définitions d'index. | Nous recommandons cette procédure si vous avez plus de 50 index à migrer. Si vous avez moins de 50 index à migrer, nous vous recommandons d'utiliser l'option de migration 1.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase, administrateur système | | Créez les définitions d'index. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase, administrateur système | ### Migrer les index de recherche en texte intégral | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Migrez les index de recherche en texte intégral des clusters autogérés vers Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | ### Migrer les données depuis Couchbase Community Edition | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Exportez des données depuis l'édition communautaire autogérée de Couchbase Server. | Le XDCR crypté n'est pas disponible dans Couchbase Community Edition. Vous pouvez exporter des données depuis Couchbase Community Edition, puis les importer manuellement dans Couchbase Capella.Pour exporter des données depuis le compartiment source, utilisez `cbexport` la ligne de commande.La commande suivante est fournie à titre d'exemple.
cbexport json \
--cluster localhost \
--bucket  \
--format lines \
--username  \
--password  \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json
Notez que`cbkey`, `cbscope``cbcoll`, et `cbexported_data.json` sont des libellés arbitraires. Ils seront référencés plus tard dans le processus, donc si vous choisissez de les nommer différemment, prenez-en note. | Administrateur Couchbase | | Importez des données dans Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Pour les fichiers volumineux, Couchbase Capella prend en charge l'importation en ligne de commande à l'aide de cURL. Vous pouvez explorer les options d'importation plus en détail dans la section [Importer des données](https://docs.couchbase.com/cloud/clusters/data-service/import-data-documents.html) dans la documentation de Couchbase Capella. | Administrateur Couchbase | ### Tester et vérifier la migration | Sous-tâche | Description | Compétences requises | | --- | --- | --- | | Vérifiez la migration des données. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | | Vérifiez la migration de l'index. | **Dans le plan de contrôle Couchbase Capella, dans la liste déroulante **Outils** de votre cluster cible, choisissez Indexes.** Vérifiez que les index sont migrés et créés. | Administrateur Couchbase | | Vérifiez les résultats de la requête. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | | Vérifiez les résultats de recherche en texte intégral (applicable si vous avez migré des index FTS). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrateur Couchbase | ## Ressources connexes **Préparer la migration** + [Commencez avec l'essai gratuit de Couchbase Capella](https://cloud.couchbase.com/sign-up) + [Exigences relatives aux fournisseurs de cloud pour Couchbase Capella](https://docs.couchbase.com/cloud/reference/aws.html) + [Directives relatives aux tailles de Couchbase Capella](https://docs.couchbase.com/cloud/clusters/sizing.html) **Migrer les données et les index** + [Canapé XDCR](https://docs.couchbase.com/cloud/clusters/xdcr/xdcr.html) + [Documentation de Couchbase Shell](https://couchbase.sh/docs/) **Couchbase SLAs Capella et assistance** + Contrats de niveau de [service Couchbase Capella](https://www.couchbase.com/capellasla) () SLAs + [Politique de support du service Couchbase Capella](https://www.couchbase.com/support-policy/cloud) ## Informations supplémentaires Le code suivant est un exemple de [fichier de configuration pour Couchbase Shell](https://couchbase.sh/docs/#_the_config_dotfiles).  ``` Version = 1 [[clusters]] identifier = "On-Prem-Cluster" hostnames = [""] default-bucket = "travel-sample" username = "" password = "" tls-cert-path = "/" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s" [[clusters]] identifier = "Capella-Cluster" hostnames = [""] default-bucket = "travel-sample" username = "" password = "" tls-cert-path = "/" data-timeout = "2500ms" connect-timeout = "7500ms" query-timeout = "75s" ``` Avant d'enregistrer le fichier de configuration, utilisez le tableau suivant pour vous assurer que vous avez ajouté vos propres informations de cluster source et cible.   | | | | --- |--- | | | Utilisez l'adresse IP de votre cluster Couchbase Server autogéré. | | | Utilisez l'utilisateur administrateur pour votre cluster Couchbase Server autogéré. | | | Utilisez le chemin absolu vers le fichier de certificat racine enregistré pour votre cluster Couchbase Server autogéré. | | | Utilisez le point de connexion de votre cluster Couchbase Capella. | | | Utilisez l'utilisateur de base de données pour votre cluster Couchbase Capella. | | | Utilisez le mot de passe utilisateur de la base de données pour votre cluster Couchbase Capella. | | | Utilisez le chemin absolu vers le fichier de certificat racine enregistré pour votre cluster Couchbase Capella. |