Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Migrazione da Couchbase Server a Couchbase Capella su AWS *Battulga Purevragcha e Saurabh Shanbhag, Amazon Web Services* *Mark Gamble, Nessuno* ## Riepilogo Couchbase Capella è un database NoSQL come servizio (DBaaS) completamente gestito per applicazioni mission critical (ad esempio, profili utente o cataloghi online e gestione dell'inventario). Couchbase Capella gestisce il tuo carico di lavoro DBaa S in un account Amazon Web Services (AWS) gestito da Couchbase. Capella semplifica l'esecuzione e la gestione della replica su più cluster, più regioni AWS, multicloud e cloud ibrido all'interno di un'unica interfaccia. Couchbase Capella ti aiuta a scalare istantaneamente le tue applicazioni Couchbase Server, aiutandoti a creare cluster multinodo in pochi minuti. [https://www.couchbase.com/products/full-text-search](https://www.couchbase.com/products/full-text-search) Inoltre elimina la necessità di gestire installazioni, aggiornamenti, backup e manutenzione generale del database.  Questo modello descrive i passaggi e le migliori pratiche per la migrazione di un ambiente [Couchbase Server autogestito al cloud AWS](https://www.couchbase.com/products/server). Il modello fornisce un processo ripetibile per la migrazione di dati e indici dai cluster di Couchbase Server, in esecuzione in locale o nel cloud, a Couchbase Capella. L'utilizzo di questi passaggi consente di evitare problemi durante la migrazione e velocizza il processo di migrazione complessivo. Questo modello fornisce le due opzioni di migrazione seguenti: + **L'opzione 1** è appropriata se avete meno di 50 indici da migrare.  + **L'opzione 2** è appropriata se avete più di 50 indici da migrare.  Puoi anche [configurare dati di esempio](https://docs.couchbase.com/server/current/manage/manage-settings/install-sample-buckets.html) sul tuo Couchbase Server autogestito da seguire insieme alla guida alla migrazione. *Se scegli **l'opzione di migrazione 2** o se utilizzi ambiti o raccolte diversi dal valore predefinito, devi utilizzare il file di configurazione di esempio, che si trova nella sezione Informazioni aggiuntive.* ## Prerequisiti e limitazioni **Prerequisiti** + Un account a pagamento Couchbase Capella esistente. Puoi anche creare un [account Couchbase Capella su AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) e utilizzare la versione di prova gratuita di Couchbase Capella, quindi passare a un account a pagamento per configurare il cluster per la migrazione. [Per iniziare con la versione di prova, segui le istruzioni contenute in Getting Started with Couchbase Capella.](https://docs.couchbase.com/cloud/get-started/create-account.html) + Un ambiente Couchbase Server esistente autogestito in locale o distribuito su un provider di servizi cloud.  + Per l'opzione di migrazione 2, Couchbase Shell e un file di configurazione. Per creare il file di configurazione, puoi utilizzare il file di esempio che si trova nella sezione *Informazioni aggiuntive*. + Familiarità con l'amministrazione di Couchbase Server e Couchbase Capella. + Familiarità con l'apertura di porte TCP e l'esecuzione di comandi in un'interfaccia a riga di comando (CLI). Il processo di migrazione richiede anche i ruoli e le competenze descritti nella tabella seguente. | | | Ruolo | Competenza | Responsabilità | | --- |--- |--- | | Amministratore di Couchbase | Familiarità con Couchbase Server e Couchbase CapellaLa conoscenza di base della riga di comando è utile ma non richiesta | Attività specifiche di Couchbase Server e Capella | | Amministratore di sistema, amministratore IT | Familiarità con l'ambiente e l'amministrazione del sistema Couchbase Server autogestiti | Apertura delle porte e determinazione degli indirizzi IP sui nodi del cluster Couchbase Server autogestiti | **Limitazioni** + Questo modello viene utilizzato per migrare dati, indici e indici Couchbase [Full Text Search da Couchbase Server](https://docs.couchbase.com/server/current/fts/full-text-intro.html) a Couchbase Capella su AWS. [https://docs.couchbase.com/server/current/eventing/eventing-overview.html](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) + Couchbase Capella è disponibile in diverse regioni AWS. Per up-to-date informazioni sulle regioni supportate da Capella, consulta [Amazon Web Services nella documentazione](https://docs.couchbase.com/cloud/reference/aws.html) di Couchbase. **Versioni del prodotto** + [Couchbase Server (Community o Enterprise) Edition versione 5.x o successiva](https://docs.couchbase.com/server/current/release-notes/relnotes.html) ## Architecture **Stack tecnologico di origine** + Server Couchbase **Stack tecnologico Target** + Divano Capella **Architettura Target** ![\[Migrazione di Couchbase Capella al cluster Couchbase nel piano dati Capella su AWS in quattro passaggi.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/14ac5a81-eade-4708-9335-f5602fa07824/images/95cd7f33-742e-4d10-8e2c-37c7b4d9df45.png) 1. **Puoi accedere a Couchbase Capella utilizzando il Capella Control Plane.** È possibile utilizzare il Capella Control Plane per effettuare le seguenti operazioni: + Controlla e monitora il tuo account. + Gestisci cluster e dati, indici, utenti e gruppi, autorizzazioni di accesso, monitoraggio ed eventi. 1. I cluster vengono creati. 1. Il **Capella Data Plane** si trova nell'account AWS gestito da Couchbase. Dopo aver creato un nuovo cluster, Couchbase Capella lo distribuisce su più zone di disponibilità nella regione AWS selezionata. 1. Puoi sviluppare e distribuire applicazioni Couchbase in un VPC nel tuo account AWS. [In genere, questo VPC accede al Capella Data Plane tramite peering VPC.](https://docs.couchbase.com/cloud/clouds/private-network.html) ## Tools (Strumenti) + [Couchbase Cross Data Center Replication (XDCR) aiuta a replicare](https://docs.couchbase.com/cloud/current/clusters/xdcr/xdcr.html) i dati tra cluster che si trovano in diversi provider di cloud e diversi data center. Viene utilizzato per migrare i dati in Couchbase Capella da cluster Couchbase Server autogestiti. **Nota** XDCR non può essere utilizzato con Couchbase Server Community Edition per migrare a Couchbase Capella. Invece[, puoi](https://docs.couchbase.com/server/current/tools/cbexport.html) usare cbexport. Per ulteriori informazioni, consulta l'epic *Migrazione dei dati dalla Community Edition*. + [Couchbase Shell è una shell](https://couchbase.sh/docs/) a riga di comando per Couchbase Server e Couchbase Capella per accedere ai cluster Couchbase locali e remoti. In questo modello, Couchbase Shell viene utilizzata per migrare gli indici. + [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html) è un'utilità Couchbase per l'esportazione di dati dal cluster Couchbase. Incluso negli strumenti [CLI di Couchbase Server](https://docs.couchbase.com/server/current/cli/cli-intro.html). ## Epiche ### Prepara la migrazione | Operazione | Description | Competenze richieste | | --- | --- | --- | | Valuta le dimensioni del cluster Couchbase Server autogestito. | Accedi alla [Couchbase Web Console per Couchbase](https://docs.couchbase.com/server/current/manage/manage-ui/manage-ui.html) Server e valuta i nodi e i bucket del cluster autogestito. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Utilizzerai le configurazioni del cluster Couchbase Server autogestite come guida generale per il dimensionamento e la configurazione del cluster di destinazione su Couchbase Capella.[Per assistenza con un esercizio di dimensionamento di Couchbase Capella più dettagliato, contatta Couchbase.](https://www.couchbase.com/contact) | Amministratore di Couchbase | | Registra la distribuzione del servizio Couchbase sul cluster Couchbase Server autogestito. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | | Registra gli indirizzi IP dei nodi del cluster Couchbase Server autogestiti. | (Ignora questo passaggio se utilizzi Community Edition.) Registra l'indirizzo IP per ogni nodo del cluster. Verranno aggiunti all'elenco degli utenti consentiti sul cluster Couchbase Capella in un secondo momento. | Amministratore di Couchbase, amministratore di sistema | ### Distribuisci e configura le risorse su Couchbase Capella | Operazione | Description | Competenze richieste | | --- | --- | --- | | Scegliere un modello. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | | Scegli e configura i nodi. | Scegli e configura i nodi in modo che corrispondano al tuo ambiente cluster Couchbase Server autogestito, inclusi il numero di nodi, la distribuzione dei servizi, l'elaborazione o la RAM e lo storage.[Couchbase Capella utilizza le migliori pratiche di scalabilità multidimensionale.](https://docs.couchbase.com/cloud/clusters/scale-cluster.html#scale-a-cluster) I servizi e i nodi possono essere scelti solo in base alle migliori pratiche di implementazione. Ciò potrebbe significare che non è possibile abbinare esattamente le configurazioni del cluster Couchbase Server autogestito. | Amministratore di Couchbase | | Implementa il cluster. | Scegli una zona di supporto e un pacchetto di supporto, quindi distribuisci il cluster. Per passaggi e istruzioni dettagliati, consulta [Creare un cluster nella documentazione](https://docs.couchbase.com/cloud/clusters/create-cluster.html) di Couchbase.Se utilizzi la versione di prova gratuita di Couchbase Capella, devi convertirla in un account a pagamento prima di iniziare la migrazione. **Per convertire il tuo account, apri la sezione **Fatturazione** del piano di controllo di Couchbase Capella, quindi scegli Aggiungi ID di attivazione.** [L'ID di attivazione viene inviato al tuo indirizzo email di contatto per la fatturazione dopo aver completato un contratto di acquisto con Couchbase Sales o dopo aver effettuato un acquisto tramite AWS Marketplace.](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) | Amministratore di Couchbase | | Crea un utente di credenziali del database. | Un utente di credenziali del database è specifico di un cluster ed è composto da un nome utente, una password e un set di privilegi del bucket. Questo utente è necessario per creare bucket e accedere ai dati dei bucket. Nel piano di controllo di Couchbase Capella, crea una credenziale di database per il nuovo cluster seguendo le istruzioni in [Configurare le credenziali del database](https://docs.couchbase.com/cloud/clusters/manage-database-users.html) nella documentazione di Couchbase Capella.A un utente dell'organizzazione devono essere assegnate le credenziali del ruolo organizzativo se desidera accedere ai dati dei bucket su un particolare cluster, in remoto o tramite l'interfaccia utente di Couchbase Capella. Questo è separato dalle credenziali del database, che vengono in genere utilizzate da app e integrazioni. La creazione dell'utente organizzativo ti consente di creare e gestire i bucket di destinazione sul tuo cluster Couchbase Capella. | Amministratore di Couchbase | | Se utilizzi l'opzione di migrazione 2, installa Couchbase Shell. | Puoi installare Couchbase Shell su qualsiasi sistema che abbia accesso di rete sia al tuo Couchbase Server autogestito che ai cluster Couchbase Capella. Per ulteriori informazioni, consulta [Installa Couchbase Shell versione 1.0.0-beta.5 nella documentazione di Couchbase Shell](https://couchbase.sh/docs/#_installation).Verifica che Couchbase Shell sia installato [testando una connessione al cluster autogestito in un](https://couchbase.sh/docs/#_connecting_to_a_cluster) terminale a riga di comando. | Amministratore di Couchbase, amministratore di sistema | | Consenti indirizzi IP. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Per ulteriori informazioni sugli indirizzi IP consentiti, consulta [Configurare gli indirizzi IP consentiti](https://docs.couchbase.com/cloud/get-started/configure-cluster-access.html#allow-ip-address) nella documentazione di Couchbase. | Amministratore di Couchbase, Amministratore di sistema | | Configura i certificati. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase, amministratore di sistema | | Crea il file di configurazione per Couchbase Shell. | Crea un dotfile di configurazione nella home directory dell'installazione di Couchbase Shell (ad esempio,). `//.cbsh/config` Per ulteriori informazioni, consulta [Config dotfiles](https://couchbase.sh/docs/#_the_config_dotfiles) nella documentazione di Couchbase.Aggiungi le proprietà di connessione per i cluster di origine e di destinazione al file di configurazione. Puoi utilizzare il file di configurazione di esempio che si trova nella sezione *Informazioni aggiuntive* e modificare le impostazioni per i tuoi cluster. Salva il file di configurazione con le impostazioni aggiornate nella `.cbsh` cartella (ad esempio,`//.cbsh/config`). | Amministratore di Couchbase, amministratore di sistema | | Crea bucket di destinazione. | Per ogni bucket di origine, crea un bucket di destinazione nel cluster Couchbase Capella seguendo le istruzioni in [Creare un](https://docs.couchbase.com/cloud/clusters/data-service/manage-buckets.html#add-bucket) bucket nella documentazione di Couchbase.Le configurazioni dei bucket di destinazione devono corrispondere ai nomi dei bucket, alle impostazioni di memoria e alle impostazioni di risoluzione dei conflitti dei bucket nel cluster Couchbase Server autogestito. | Amministratore di Couchbase | | Crea ambiti e raccolte. | Ogni bucket contiene un ambito e una raccolta predefiniti con lo spazio delle chiavi. `_default._default` Se utilizzi altri spazi chiave per l'ambito e la raccolta, devi creare spazi chiave identici nel cluster Capella di destinazione.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/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 }
| Amministratore di Couchbase | ### Esegui la migrazione dei dati da Enterprise Edition | Operazione | Description | Competenze richieste | | --- | --- | --- | | Apri le porte TCP sui nodi del cluster Couchbase Server autogestiti. | Assicurati che le porte appropriate siano aperte per la comunicazione XDCR sui nodi del cluster Couchbase Server autogestito. [Per ulteriori informazioni, consulta la documentazione sulle porte del server Couchbase.](https://docs.couchbase.com/server/current/install/install-ports.html#ports-listed-by-communication-path) | Amministratore di Couchbase, amministratore di sistema | | Se utilizzi Couchbase Server Enterprise Edition, configura Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | | Avvia Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | ### Migra gli indici utilizzando l'opzione 1 | Operazione | Description | Competenze richieste | | --- | --- | --- | | Migra gli indici di cluster autogestiti su Couchbase Capella. | Consigliamo questa procedura se hai meno di 50 indici da migrare. Se hai più di 50 indici da migrare, ti consigliamo di utilizzare l'opzione di migrazione 2.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase, amministratore di sistema | ### Esegui la migrazione degli indici utilizzando l'opzione 2 | Operazione | Description | Competenze richieste | | --- | --- | --- | | Esegui la migrazione delle definizioni degli indici. | Consigliamo questa procedura se hai più di 50 indici da migrare. Se hai meno di 50 indici da migrare, ti consigliamo di utilizzare l'opzione di migrazione 1.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase, amministratore di sistema | | Crea le definizioni degli indici. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase, amministratore di sistema | ### Migrazione degli indici di ricerca full-text | Operazione | Description | Competenze richieste | | --- | --- | --- | | Migra gli indici di ricerca full-text del cluster autogestiti su Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | ### Migra i dati da Couchbase Community Edition | Operazione | Description | Competenze richieste | | --- | --- | --- | | Esporta i dati da Couchbase Server Community Edition autogestito. | L'XDCR crittografato non è disponibile in Couchbase Community Edition. È possibile esportare i dati da Couchbase Community Edition e quindi importarli manualmente in Couchbase Capella.Per esportare i dati dal bucket di origine, usali nella riga di comando. `cbexport`Il comando seguente viene fornito come esempio.
cbexport json \
--cluster localhost \
--bucket  \
--format lines \
--username  \
--password  \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json
Nota che`cbkey`, `cbscope``cbcoll`, e `cbexported_data.json` sono etichette arbitrarie. Verrà fatto riferimento a esse più avanti nel processo, quindi se scegli di denominarle in modo diverso, prendine nota. | Amministratore di Couchbase | | Importa i dati in Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Per file di grandi dimensioni, Couchbase Capella supporta l'importazione da riga di comando tramite cURL. Puoi esplorare le opzioni di importazione in modo più dettagliato in [Importa dati](https://docs.couchbase.com/cloud/clusters/data-service/import-data-documents.html) nella documentazione di Couchbase Capella. | Amministratore di Couchbase | ### Testa e verifica la migrazione | Operazione | Description | Competenze richieste | | --- | --- | --- | | Verifica la migrazione dei dati. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | | Verifica la migrazione dell'indice. | **Nel piano di controllo di Couchbase Capella, nell'elenco a discesa **Strumenti** per il cluster di destinazione, scegli Indici.** Verifica che gli indici siano migrati e creati. | Amministratore di Couchbase | | Verifica i risultati della query. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | | Verifica i risultati della ricerca in testo completo (applicabile se hai migrato gli indici FTS). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Amministratore di Couchbase | ## Risorse correlate **Prepara la migrazione** + [Inizia con la versione di prova gratuita di Couchbase Capella](https://cloud.couchbase.com/sign-up) + [Requisiti del provider di cloud per Couchbase Capella](https://docs.couchbase.com/cloud/reference/aws.html) + [Linee guida per il dimensionamento di Couchbase Capella](https://docs.couchbase.com/cloud/clusters/sizing.html) **Migra i dati e gli indici** + [Couchbase XDCR](https://docs.couchbase.com/cloud/clusters/xdcr/xdcr.html) + [Documentazione Couchbase Shell](https://couchbase.sh/docs/) **Couchbase Capella e supporto SLAs ** + Accordi sui livelli di servizio di [Couchbase Capella](https://www.couchbase.com/capellasla) () SLAs + [Politica di supporto del servizio Couchbase Capella](https://www.couchbase.com/support-policy/cloud) ## Informazioni aggiuntive Il codice seguente è un esempio di [file di configurazione per](https://couchbase.sh/docs/#_the_config_dotfiles) Couchbase Shell.  ``` 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" ``` Prima di salvare il file di configurazione, utilizzate la tabella seguente per assicurarvi di aver aggiunto le informazioni sul cluster di origine e di destinazione.   | | | | --- |--- | | | Usa l'indirizzo IP per il tuo cluster Couchbase Server autogestito. | | | Usa l'utente amministratore per il tuo cluster Couchbase Server autogestito. | | | Usa il percorso assoluto del file di certificato root salvato per il tuo cluster Couchbase Server autogestito. | | | Usa l'endpoint di connessione per il tuo cluster Couchbase Capella. | | | Usa l'utente del database per il tuo cluster Couchbase Capella. | | | Usa la password utente del database per il tuo cluster Couchbase Capella. | | | Usa il percorso assoluto del file di certificato root salvato per il tuo cluster Couchbase Capella. |