As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Migre do Couchbase Server para o Couchbase Capella na AWS *Battulga Purevragchaa e Saurabh Shanbhag, Amazon Web Services* *Mark Gamble, Nenhum* ## Resumo O Couchbase Capella é um banco de dados NoSQL totalmente gerenciado como serviço (DBaaS) para aplicativos de missão crítica (por exemplo, perfis de usuário ou catálogos on-line e gerenciamento de inventário). O Couchbase Capella gerencia sua carga de trabalho DBaa S em uma conta da Amazon Web Services (AWS) gerenciada pelo Couchbase. O Capella facilita a execução e o gerenciamento da replicação de vários clusters, várias regiões da AWS, multicloud e nuvem híbrida em uma única interface. O Couchbase Capella ajuda você a escalar instantaneamente seus aplicativos do Couchbase Server, ajudando você a criar clusters de vários nós em minutos. O Couchbase Capella oferece suporte a todos os recursos do Couchbase Server, incluindo [SQL\$1\$1](https://www.couchbase.com/products/n1ql), [Full Text Search](https://www.couchbase.com/products/full-text-search), [Eventing Service](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) e [Analytics Service](https://www.couchbase.com/products/analytics). Também elimina a necessidade de gerenciar instalações, atualizações, backups e manutenção geral do banco de dados.  Esse padrão descreve as etapas e as melhores práticas para migrar um ambiente autogerenciado do [Couchbase Server](https://www.couchbase.com/products/server) para a Nuvem AWS. O padrão fornece um processo repetível para migrar dados e índices dos clusters do Couchbase Server, executados on-premises ou na nuvem, para o Couchbase Capella. O uso dessas etapas ajuda a evitar problemas durante a migração e acelera o processo geral de migração. Esse padrão fornece as duas opções de migração a seguir: + **A opção 1** é apropriada se você tiver menos de 50 índices para migrar.  + **A opção 2** é apropriada se você tiver mais de 50 índices para migrar.  Você também pode [configurar dados de amostra](https://docs.couchbase.com/server/current/manage/manage-settings/install-sample-buckets.html) em seu Couchbase Server autogerenciado para acompanhar o guia de migração. Se você escolher a **opção de migração 2** ou se estiver usando escopos ou coleções diferentes do valor padrão, deverá usar o arquivo de configuração de exemplo, que está na seção *Informações adicionais*. ## Pré-requisitos e limitações **Pré-requisitos ** + Uma conta paga existente do Couchbase Capella. Você também pode criar uma [conta do Couchbase Capella na AWS](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) e usar o teste gratuito do Couchbase Capella e, em seguida, fazer o upgrade para uma conta paga para configurar seu cluster para a migração. Para começar com a versão de teste, siga as instruções em [Introdução ao Couchbase Capella](https://docs.couchbase.com/cloud/get-started/create-account.html). + Um ambiente existente do Couchbase Server autogerenciado on-premises ou implantado em um provedor de serviços em nuvem.  + Para a opção de migração 2, Couchbase Shell e um arquivo de configuração. Para criar o arquivo de configuração, você pode usar o arquivo de exemplo que está na seção *Informações adicionais*. + Familiaridade com a administração do Couchbase Server e do Couchbase Capella. + Familiaridade com abrir portas TCP e executar comandos em uma interface de linha de comando (CLI). O processo de migração também exige as funções e a experiência descritas na tabela a seguir. | | | Perfil | Experiência | Responsabilidades | | --- |--- |--- | | Administrador do Couchbase | Familiaridade com o Couchbase Server e o Couchbase CapellaO conhecimento básico da linha de comando é útil, mas não obrigatório | Tarefas específicas do Couchbase Server e do Capella | | Administrador de sistemas, administrador de TI | Familiaridade com o ambiente e a administração autogerenciados do sistema Couchbase Server | Abrindo portas e determinando endereços IP em nós de cluster autogerenciados do Couchbase Server | **Limitações** + Esse padrão é usado para migrar dados, índices e índices [Couchbase Full Text Search](https://docs.couchbase.com/server/current/fts/full-text-intro.html) do Couchbase Server para o Couchbase Capella na AWS. O padrão não se aplica à migração do [Couchbase Eventing Service](https://docs.couchbase.com/server/current/eventing/eventing-overview.html) ou ao [Couchbase Analytics.](https://docs.couchbase.com/server/current/analytics/introduction.html) + O Couchbase Capella está disponível em várias regiões da AWS. Para up-to-date obter informações sobre as regiões às quais a Capella oferece suporte, consulte [Amazon Web Services na documentação](https://docs.couchbase.com/cloud/reference/aws.html) do Couchbase. **Versões do produto** + [Couchbase Server (Community ou Enterprise) Edition versão 5.x ou superior](https://docs.couchbase.com/server/current/release-notes/relnotes.html) ## Arquitetura **Pilha de tecnologia de origem** + Couchbase Server **Pilha de tecnologias de destino** + Couchbase Capella **Arquitetura de destino** ![\[Migração do Couchbase Capella para o cluster do Couchbase no plano de dados Capella na AWS em quatro etapas.\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/images/pattern-img/14ac5a81-eade-4708-9335-f5602fa07824/images/95cd7f33-742e-4d10-8e2c-37c7b4d9df45.png) 1. Você acessa o Couchbase Capella usando o ambiente de gerenciamento **Capella**. É possível usar o ambiente de gerenciamento Capella para fazer o seguinte: + Controlar e monitorar sua conta. + Gerenciar clusters e dados, índices, usuários e grupos, permissões de acesso, monitoramento e eventos. 1. Clusters são criados. 1. O **plano de dados Capella** está na conta da AWS gerenciada pela Couchbase. Depois de criar um novo cluster, o Couchbase Capella o implanta em várias zonas de disponibilidade na região da AWS selecionada. 1. Você pode desenvolver e implantar aplicativos Couchbase em uma VPC na sua conta da AWS. Normalmente, essa VPC acessa o plano de dados Capella por meio do [emparelhamento de VPC.](https://docs.couchbase.com/cloud/clouds/private-network.html) ## Ferramentas + O [Couchbase Cross Data Center Replication (XDCR)](https://docs.couchbase.com/cloud/current/clusters/xdcr/xdcr.html) ajuda a replicar dados em clusters localizados em diferentes provedores de nuvem e datacenters. Ele é usado para migrar dados para o Couchbase Capella a partir de clusters autogerenciados do Couchbase Server. **nota** O XDCR não pode ser usado com o Couchbase Server Community Edition para migrar para o Couchbase Capella. Em vez disso, você pode usar o [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html). Para obter mais informações, consulte o épico *migrar dados da Community Edition*. + O [Couchbase Shell](https://couchbase.sh/docs/) é um shell de linha de comando para o Couchbase Server e o Couchbase Capella acessarem clusters locais e remotos do Couchbase. Nesse padrão, o Couchbase Shell é usado para migrar índices. + [cbexport](https://docs.couchbase.com/server/current/tools/cbexport.html) é um utilitário do Couchbase para exportar dados do cluster do Couchbase. Incluído nas ferramentas da [CLI do Couchbase Server](https://docs.couchbase.com/server/current/cli/cli-intro.html). ## Épicos ### Preparar-se para a migração | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Avalie o tamanho do cluster autogerenciado do Couchbase Server. | Faça login no [Couchbase Web Console](https://docs.couchbase.com/server/current/manage/manage-ui/manage-ui.html) para Couchbase Server e avalie os nós e buckets do seu cluster autogerenciado. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Você usará suas configurações de cluster autogerenciadas do Couchbase Server como um guia geral para dimensionar e configurar o cluster de destino no Couchbase Capella.Para obter ajuda com um exercício mais detalhado de dimensionamento do Couchbase Capella, entre em [contato com o Couchbase](https://www.couchbase.com/contact). | Administrador do Couchbase | | Registre a distribuição do Couchbase Service no cluster autogerenciado do Couchbase Server. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | | Registre os endereços IP dos nós do cluster autogerenciado do Couchbase Server. | (Ignore essa etapa se você estiver usando o Community Edition.) Registre o endereço IP de cada nó em seu cluster. Eles serão adicionados à lista de permissões em seu cluster Couchbase Capella posteriormente. | Administrador do Couchbase, administrador de sistemas | ### Implemente e configure recursos no Couchbase Capella | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Escolher um modelo. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | | Escolha e configure os nós. | Escolha e configure os nós para corresponder ao seu ambiente de cluster autogerenciado do Couchbase Server, incluindo o número de nós, distribuição de serviços, computação ou RAM e armazenamento.O Couchbase Capella usa as melhores práticas de [escalabilidade multidimensional](https://docs.couchbase.com/cloud/clusters/scale-cluster.html#scale-a-cluster). Serviços e nós só podem ser escolhidos de acordo com as melhores práticas de implantação. Isso pode significar que você não pode corresponder exatamente às configurações do cluster autogerenciado do Couchbase Server. | Administrador do Couchbase | | Implantar o cluster | Escolha uma zona de suporte e um pacote de suporte e, em seguida, implante o cluster. Para obter instruções e etapas detalhadas, consulte [Criar um cluster](https://docs.couchbase.com/cloud/clusters/create-cluster.html) na documentação do Couchbase.Se você estiver usando o teste gratuito do Couchbase Capella, deverá convertê-lo em uma conta paga antes de iniciar sua migração. Para converter sua conta, abra a seção **Faturamento** do ambiente de gerenciamento do Couchbase Capella e escolha **Adicionar ID de ativação.** [A ID de ativação é enviada para seu endereço de e-mail de contato de cobrança após você concluir um contrato de compra com a Couchbase Sales ou depois de fazer uma compra por meio do AWS Marketplace.](https://aws.amazon.com/marketplace/pp/prodview-xrhx5zgue5c26) | Administrador do Couchbase | | Crie um usuário com credencial de banco de dados. | Um usuário de credencial de banco de dados é específico de um cluster e consiste em um nome de usuário, senha e um conjunto de privilégios de bucket. Esse usuário é necessário para criar buckets e acessar os dados do bucket. No ambiente de gerenciamento do Couchbase Capella, crie uma credencial de banco de dados para o novo cluster seguindo as instruções em [Configurar credenciais de banco de dados](https://docs.couchbase.com/cloud/clusters/manage-database-users.html) na documentação do Couchbase Capella.Um usuário da organização precisa de credenciais de função organizacional atribuídas a ele se quiser acessar dados do bucket em um cluster específico, remotamente ou por meio da interface do Couchbase Capella. Isso é separado das credenciais do banco de dados, que normalmente são usadas por aplicativos e integrações. A criação do usuário organizacional permite que você crie e gerencie os buckets de destino em seu cluster Couchbase Capella. | Administrador do Couchbase | | Se estiver usando a opção de migração 2, instale o Couchbase Shell. | Você pode instalar o Couchbase Shell em qualquer sistema que tenha acesso de rede ao seu Couchbase Server autogerenciado e aos clusters Couchbase Capella. Para obter mais informações, consulte [Instalar o Couchbase Shell versão 1.0.0-beta.5](https://couchbase.sh/docs/#_installation) na documentação do Couchbase Shell.Confirme se o Couchbase Shell está instalado [testando uma conexão com seu cluster autogerenciado](https://couchbase.sh/docs/#_connecting_to_a_cluster) em um terminal de linha de comando. | Administrador do Couchbase, administrador de sistemas | | Permitir endereços IP. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Para obter mais informações sobre endereços IP permitidos, consulte [Configurar endereços IP permitidos](https://docs.couchbase.com/cloud/get-started/configure-cluster-access.html#allow-ip-address) na documentação do Couchbase. | Administrador do Couchbase, administrador de sistemas | | Configurar certificados. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase, administrador de sistemas | | Criar o arquivo de configuração do Couchbase Shell. | Crie um dotfile de configuração no diretório inicial da instalação do Couchbase Shell (por exemplo, `//.cbsh/config`). Para obter mais informações, consulte [Configurar dotfiles](https://couchbase.sh/docs/#_the_config_dotfiles) na documentação do Couchbase.Adicione propriedades de conexão dos clusters de origem e de destino ao arquivo de configuração. Você pode usar o arquivo de configuração de exemplo que está na seção *Informações adicionais* e editar as configurações dos seus clusters. Salve o arquivo de configuração com as configurações atualizadas na pasta `.cbsh` (por exemplo, `//.cbsh/config`). | Administrador do Couchbase, administrador de sistemas | | Crie buckets de destino. | Para cada bucket de origem, crie um bucket de destino em seu cluster Couchbase Capella seguindo as instruções em [Criar um bucket](https://docs.couchbase.com/cloud/clusters/data-service/manage-buckets.html#add-bucket) na documentação do Couchbase.As configurações do bucket de destino devem corresponder aos nomes dos buckets, às configurações de memória e às configurações de resolução de conflitos dos buckets em seu cluster autogerenciado do Couchbase Server. | Administrador do Couchbase | | Crie escopos e coleções. | Cada bucket contém um escopo e uma coleção padrão com o espaço-chave `_default._default`. Se você estiver usando qualquer outro espaço-chave para seu escopo e coleção, deverá criar espaços-chave idênticos no cluster Capella de destino.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/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 }
| Administrador do Couchbase | ### Migre os dados da Enterprise Edition | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Abra portas TCP nos nós de cluster autogerenciados do Couchbase Server. | Garanta que as portas apropriadas estejam abertas para comunicação XDCR nos nós do cluster autogerenciado do Couchbase Server. Para obter mais informações, consulte a [documentação de portas do Couchbase Server](https://docs.couchbase.com/server/current/install/install-ports.html#ports-listed-by-communication-path). | Administrador do Couchbase, administrador de sistemas | | Se você estiver usando o Couchbase Server Enterprise Edition, configure o Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | | Inicie o Couchbase XDCR. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | ### Migre os índices usando a opção 1 | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Migre índices de cluster autogerenciados para o Couchbase Capella. | Nós recomendamos esse processo se você tiver menos de 50 índices para migrar. Se você tiver mais de 50 índices para migrar, recomendamos usar a opção de migração 2.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase, administrador de sistemas | ### Migre os índices usando a opção 2 | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Migre as definições do índice. | Nós recomendamos esse processo se você tiver mais de 50 índices para migrar. Se você tiver menos de 50 índices para migrar, recomendamos usar a opção de migração 1.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase, administrador de sistemas | | Crie as definições do índice. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase, administrador de sistemas | ### Migre índices de pesquisa de texto completo | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Migre os índices de pesquisa de texto completo do cluster autogerenciado para o Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | ### Migre dados do Couchbase Community Edition | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Exporte dados do Couchbase Server Community Edition autogerenciado. | O XDCR criptografado não está disponível no Couchbase Community Edition. Você pode exportar dados do Couchbase Community Edition e depois importar manualmente os dados para o Couchbase Capella.Para exportar dados do bucket de origem, use `cbexport` na linha de comando.O comando a seguir é um exemplo.
cbexport json \
--cluster localhost \
--bucket  \
--format lines \
--username  \
--password  \
--include-key cbkey \
--scope-field cbscope \
--collection-field cbcoll \
--output cbexported_data.json
Observe que `cbkey`, `cbscope`, `cbcoll`, e `cbexported_data.json` são rótulos arbitrários. Eles serão referenciados posteriormente no processo, portanto, se você optar por nomeá-los de forma diferente, anote-os. | Administrador do Couchbase | | Importe dados para o Couchbase Capella. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html)Para arquivos grandes, o Couchbase Capella suporta importação de linha de comando usando cURL. Você pode explorar as opções de importação com mais detalhes em [Importar dados](https://docs.couchbase.com/cloud/clusters/data-service/import-data-documents.html) na documentação do Couchbase Capella. | Administrador do Couchbase | ### Testar e verificar a migração | Tarefa | Description | Habilidades necessárias | | --- | --- | --- | | Verificar a migração de dados. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | | Verifique a migração do índice. | No ambiente de gerenciamento do Couchbase Capella, na lista suspensa **Ferramentas** do seu cluster de destino, escolha **Índices**. Verifique se os índices foram migrados e criados. | Administrador do Couchbase | | Verificar resultados da consulta. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | | Verifique os resultados da pesquisa em texto completo (aplicável se você migrou os índices do FTS). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/patterns/migrate-from-couchbase-server-to-couchbase-capella-on-aws.html) | Administrador do Couchbase | ## Recursos relacionados **Prepare a migração** + [Comece com o teste gratuito do Couchbase Capella](https://cloud.couchbase.com/sign-up) + [Requisitos do provedor de nuvem para o Couchbase Capella](https://docs.couchbase.com/cloud/reference/aws.html) + [Diretrizes de dimensionamento do Couchbase Capella](https://docs.couchbase.com/cloud/clusters/sizing.html) **Migre os dados e os índices** + [Couchbase XDCR](https://docs.couchbase.com/cloud/clusters/xdcr/xdcr.html) + [Documentação do Couchbase Shell](https://couchbase.sh/docs/) **Couchbase SLAs Capella e suporte** + Contratos de nível de [serviço do Couchbase Capella](https://www.couchbase.com/capellasla) () SLAs + [Política de suporte do Couchbase Capella Service](https://www.couchbase.com/support-policy/cloud) ## Mais informações O seguinte código é um exemplo de [arquivo de configuração bean para 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" ``` Antes de salvar o arquivo de configuração, use a tabela a seguir para garantir que você tenha adicionado suas próprias informações do cluster de origem e destino.   | | | | --- |--- | | | Use o endereço IP do seu cluster autogerenciado do Couchbase Server. | | | Use o usuário administrador para seu cluster autogerenciado do Couchbase Server. | | | Use o caminho absoluto para o arquivo de certificado raiz salvo para seu cluster autogerenciado do Couchbase Server. | | | Use o endpoint de conexão para seu cluster Couchbase Capella. | | | Use o usuário do banco de dados para seu cluster Couchbase Capella. | | | Use a senha de usuário do banco de dados para seu cluster Couchbase Capella. | | | Use o caminho absoluto para o arquivo de certificado raiz salvo para seu cluster Couchbase Capella. |