Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Migrieren Sie von Couchbase Server zu Couchbase Capella am AWS
Erstellt von Battulga Purevragchaa (AWS), Mark Gamble und Saurabh Shanbhag () AWS
Übersicht
Couchbase Capella ist ein vollständig verwaltetes Programm ohne SQL Datenbank als Service (DBaaS) für unternehmenskritische Anwendungen (z. B. Benutzerprofile oder Online-Kataloge und Inventarverwaltung). Couchbase Capella verwaltet Ihre DBaaS Arbeitslast in einem von Couchbase verwalteten Amazon Web Services () -Konto. AWS Capella macht es einfach, die Replikation mit mehreren Clustern, mehreren AWS Regionen, Multicloud und Hybrid-Cloud über eine einzige Oberfläche auszuführen und zu verwalten.
Couchbase Capella hilft Ihnen dabei, Ihre Couchbase Server-Anwendungen sofort zu skalieren, sodass Sie innerhalb von Minuten Cluster mit mehreren Knoten erstellen können. Couchbase Capella unterstützt alle Couchbase Server-Funktionen, einschließlich SQL++
Dieses Muster beschreibt die Schritte und bewährten Methoden für die Migration einer selbstverwalteten Couchbase Server-Umgebung
Dieses Muster bietet die folgenden zwei Migrationsoptionen:
Option 1 ist geeignet, wenn Sie weniger als 50 Indizes migrieren müssen.
Option 2 ist geeignet, wenn Sie mehr als 50 Indizes migrieren müssen.
Sie können auch Beispieldaten auf Ihrem selbst verwalteten Couchbase-Server einrichten
Wenn Sie die Migrationsoption 2 wählen oder Bereiche oder Sammlungen verwenden, die nicht dem Standardwert entsprechen, müssen Sie die Beispielkonfigurationsdatei verwenden, die sich im Abschnitt Zusätzliche Informationen befindet.
Voraussetzungen und Einschränkungen
Voraussetzungen
Ein vorhandenes kostenpflichtiges Couchbase Capella-Konto. Sie können auch ein Couchbase Capella-Konto erstellen und die kostenlose Couchbase Capella-Testversion nutzen AWS und dann auf
ein kostenpflichtiges Konto upgraden, um Ihren Cluster für die Migration zu konfigurieren. Um mit der Testversion zu beginnen, folgen Sie den Anweisungen unter Erste Schritte mit Couchbase Capella. Eine bestehende, selbstverwaltete Couchbase Server-Umgebung, entweder vor Ort oder bei einem Cloud-Dienstanbieter bereitgestellt.
Für Migrationsoption 2 Couchbase Shell und eine Konfigurationsdatei. Um die Konfigurationsdatei zu erstellen, können Sie die Beispieldatei verwenden, die sich im Abschnitt Zusätzliche Informationen befindet.
Vertrautheit mit der Verwaltung von Couchbase Server und Couchbase Capella.
Vertrautheit mit dem Öffnen von TCP Ports und dem Ausführen von Befehlen in einer Befehlszeilenschnittstelle (). CLI
Für den Migrationsprozess sind außerdem die in der folgenden Tabelle beschriebenen Rollen und Fachkenntnisse erforderlich.
Rolle | Fachwissen | Verantwortlichkeiten |
Couchbase-Administrator |
|
|
Systemadministrator, IT-Administrator |
|
|
Einschränkungen
Dieses Muster wird verwendet, um Daten, Indizes und Couchbase-Volltextsuchindizes von Couchbase Server
auf Couchbase Capella zu migrieren. AWS Das Muster gilt nicht für die Migration von Couchbase Eventing Service oder Couchbase Analytics. Couchbase Capella ist in mehreren Regionen verfügbar. AWS up-to-dateInformationen zu den Regionen, die Capella unterstützt, finden Sie unter Amazon Web Services
in der Couchbase-Dokumentation.
Produktversionen
Architektur
Quelltechnologie-Stack
Couchbase-Server
Zieltechnologie-Stack
Couchbase Capella
Zielarchitektur
Sie greifen über die Capella Control Plane auf Couchbase Capella zu. Sie können die Capella Control Plane verwenden, um Folgendes zu tun:
Kontrollieren und überwachen Sie Ihr Konto.
Verwalten Sie Cluster und Daten, Indizes, Benutzer und Gruppen, Zugriffsberechtigungen, Überwachung und Ereignisse.
Cluster werden erstellt.
Die Capella-Datenebene befindet sich in dem von AWS Couchbase verwalteten Konto. Nachdem Sie einen neuen Cluster erstellt haben, stellt Couchbase Capella ihn in mehreren Availability Zones in der ausgewählten Region bereit. AWS
Sie können Couchbase-Anwendungen in Ihrem Konto entwickeln und bereitstellen. VPC AWS In der Regel wird dabei über VPC Peering auf die Capella-Datenebene zugegriffen. VPC
Tools
Couchbase Cross Data Center Replication (XDCR)
hilft bei der Replikation von Daten über Cluster hinweg, die sich bei verschiedenen Cloud-Anbietern und verschiedenen Rechenzentren befinden. Es wird verwendet, um Daten aus selbstverwalteten Couchbase Server-Clustern nach Couchbase Capella zu migrieren. Anmerkung
XDCRkann nicht mit Couchbase Server Community Edition für die Migration zu Couchbase Capella verwendet werden. Stattdessen können Sie cbexport verwenden.
Weitere Informationen finden Sie im Abschnitt Daten aus der Community Edition migrieren. Couchbase Shell
ist eine Befehlszeilen-Shell für Couchbase Server und Couchbase Capella für den Zugriff auf lokale und entfernte Couchbase-Cluster. In diesem Muster wird Couchbase Shell zur Migration von Indizes verwendet. cbexport
ist ein Couchbase-Hilfsprogramm zum Exportieren von Daten aus einem Couchbase-Cluster. In den Couchbase Server-Tools enthalten. CLI
Epen
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Bewerten Sie die Größe des selbstverwalteten Couchbase Server-Clusters. | Melden Sie sich bei der Couchbase-Webkonsole für Couchbase
Sie verwenden Ihre selbst verwalteten Couchbase Server-Clusterkonfigurationen als allgemeinen Leitfaden für die Dimensionierung und Konfiguration des Zielclusters auf Couchbase Capella. | Couchbase-Administrator |
Zeichnen Sie die Couchbase-Dienstverteilung auf dem selbstverwalteten Couchbase Server-Cluster auf. |
| Couchbase-Administrator |
Notieren Sie sich die IP-Adressen der selbstverwalteten Couchbase Server-Clusterknoten. | (Ignorieren Sie diesen Schritt, wenn Sie die Community Edition verwenden.) Notieren Sie sich die IP-Adresse für jeden Knoten in Ihrem Cluster. Sie werden später zur Zulassungsliste auf Ihrem Couchbase Capella-Cluster hinzugefügt. | Couchbase-Administrator, Systemadministrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Auswahl einer Vorlage. |
| Couchbase-Administrator |
Wählen und konfigurieren Sie die Knoten. | Wählen und konfigurieren Sie die Knoten so, dass sie zu Ihrer selbstverwalteten Couchbase Server-Cluster-Umgebung passen, einschließlich der Anzahl der Knoten, der Dienstverteilung, der Rechenleistung und des SpeichersRAM. Couchbase Capella verwendet bewährte Methoden zur multidimensionalen Skalierung. | Couchbase-Administrator |
Stellen Sie den Cluster bereit. | Wählen Sie eine Supportzone und ein Supportpaket aus und stellen Sie dann den Cluster bereit. Ausführliche Schritte und Anweisungen finden Sie in der Couchbase-Dokumentation unter Cluster erstellen WichtigWenn Sie die kostenlose Testversion von Couchbase Capella verwenden, müssen Sie sie in ein kostenpflichtiges Konto umwandeln, bevor Sie mit der Migration beginnen. Um Ihr Konto zu konvertieren, öffnen Sie in der Couchbase Capella Control Plane den Bereich Abrechnung und wählen Sie dann Aktivierungs-ID hinzufügen. Die Aktivierungs-ID wird an Ihre Rechnungskontakt-E-Mail-Adresse gesendet, nachdem Sie einen Kaufvertrag mit Couchbase Sales abgeschlossen haben oder nachdem Sie einen Kauf über AWS Marketplace getätigt haben. | Couchbase-Administrator |
Erstellen Sie einen Benutzer mit Datenbankanmeldedaten. | Ein Benutzer mit Datenbankanmeldedaten ist spezifisch für einen Cluster und besteht aus einem Benutzernamen, einem Passwort und einer Reihe von Bucket-Rechten. Dieser Benutzer ist erforderlich, um Buckets zu erstellen und auf Bucket-Daten zuzugreifen. Erstellen Sie in der Couchbase Capella Control Plane Datenbankanmeldedaten für den neuen Cluster, indem Sie den Anweisungen unter Datenbankanmeldedaten konfigurieren AnmerkungEinem Organisationsbenutzer müssen Anmeldeinformationen für die Organisationsrolle zugewiesen werden, wenn er entweder remote oder über die Couchbase Capella-Benutzeroberfläche auf Bucket-Daten in einem bestimmten Cluster zugreifen möchte. Dies ist unabhängig von Datenbankanmeldedaten, die normalerweise von Apps und Integrationen verwendet werden. Wenn Sie den Organisationsbenutzer erstellen, können Sie die Ziel-Buckets auf Ihrem Couchbase Capella-Cluster erstellen und verwalten. | Couchbase-Administrator |
Wenn Sie die Migrationsoption 2 verwenden, installieren Sie Couchbase Shell. | Sie können Couchbase Shell auf jedem System installieren, das Netzwerkzugriff sowohl auf Ihren selbst verwalteten Couchbase-Server als auch auf die Couchbase Capella-Cluster hat. Weitere Informationen finden Sie unter Installieren von Couchbase Shell Version 1.0.0-beta.5 in der Couchbase Shell-Dokumentation Stellen Sie sicher, dass Couchbase Shell installiert ist, indem Sie eine Verbindung zu Ihrem selbstverwalteten Cluster in einem Befehlszeilenterminal testen | Couchbase-Administrator, Systemadministrator |
IP-Adressen zulassen. |
Weitere Informationen zu zulässigen IP-Adressen finden Sie unter Zulässige IP-Adressen konfigurieren in der Couchbase-Dokumentation | Couchbase-Administrator, Systemadministrator |
Zertifikate konfigurieren. |
| Couchbase-Administrator, Systemadministrator |
Erstellen Sie die Konfigurationsdatei für Couchbase Shell. | Erstellen Sie eine Konfigurations-Punktdatei im Home-Verzeichnis der Couchbase Shell-Installation (z. B.). Fügen Sie der Konfigurationsdatei Verbindungseigenschaften für die Quell- und Zielcluster hinzu. Sie können die Beispielkonfigurationsdatei im Abschnitt Zusätzliche Informationen verwenden und die Einstellungen für Ihre Cluster bearbeiten. Speichern Sie die Konfigurationsdatei mit den aktualisierten Einstellungen in dem | Couchbase-Administrator, Systemadministrator |
Ziel-Buckets erstellen. | Erstellen Sie für jeden Quell-Bucket einen Ziel-Bucket in Ihrem Couchbase Capella-Cluster, indem Sie den Anweisungen unter Bucket erstellen Ihre Ziel-Bucket-Konfigurationen müssen mit den Bucket-Namen, Speichereinstellungen und Konfliktlösungseinstellungen der Buckets in Ihrem selbstverwalteten Couchbase Server-Cluster übereinstimmen. | Couchbase-Administrator |
Bereiche und Sammlungen erstellen. | Jeder Bucket enthält einen Standardbereich und eine Standardsammlung mit dem
| Couchbase-Administrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Öffnen Sie die TCP Ports auf den selbstverwalteten Couchbase Server-Clusterknoten. | Stellen Sie sicher, dass die entsprechenden Ports für die XDCR Kommunikation auf den Knoten des selbstverwalteten Couchbase Server-Clusters geöffnet sind. Weitere Informationen finden Sie in der Dokumentation zu den Couchbase | Couchbase-Administrator, Systemadministrator |
Wenn Sie Couchbase Server Enterprise Edition verwenden, richten Sie Couchbase ein. XDCR |
| Couchbase-Administrator |
Starten Sie Couchbase. XDCR |
| Couchbase-Administrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Migrieren Sie selbstverwaltete Cluster-Indizes zu Couchbase Capella. | WichtigWir empfehlen diesen Vorgang, wenn Sie weniger als 50 Indizes migrieren müssen. Wenn Sie mehr als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 2 zu verwenden.
| Couchbase-Administrator, Systemadministrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Migrieren Sie die Indexdefinitionen. | WichtigWir empfehlen diesen Vorgang, wenn Sie mehr als 50 Indizes migrieren müssen. Wenn Sie weniger als 50 Indizes migrieren müssen, empfehlen wir Ihnen, die Migrationsoption 1 zu verwenden.
| Couchbase-Administrator, Systemadministrator |
Erstellen Sie die Indexdefinitionen. |
| Couchbase-Administrator, Systemadministrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Migrieren Sie selbstverwaltete Cluster-Volltextsuchindizes zu Couchbase Capella. |
| Couchbase-Administrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Exportieren Sie Daten aus der selbstverwalteten Couchbase Server Community Edition. | Verschlüsselt XDCR ist in der Couchbase Community Edition nicht verfügbar. Sie können Daten aus der Couchbase Community Edition exportieren und die Daten dann manuell in Couchbase Capella importieren. Verwenden Der folgende Befehl dient als Beispiel.
Beachten Sie | Couchbase-Administrator |
Daten in Couchbase Capella importieren. |
Für große Dateien unterstützt Couchbase Capella den Befehlszeilenimport mit c. URL Weitere Informationen zu den Importoptionen finden Sie unter Daten importieren | Couchbase-Administrator |
Aufgabe | Beschreibung | Erforderliche Fähigkeiten |
---|---|---|
Überprüfen Sie die Datenmigration. |
| Couchbase-Administrator |
Überprüfen Sie die Indexmigration. | Wählen Sie in der Couchbase Capella Control Plane in der Dropdownliste Tools für Ihren Zielcluster die Option Indizes aus. Stellen Sie sicher, dass die Indizes migriert und erstellt wurden. | Couchbase-Administrator |
Überprüfen Sie die Abfrageergebnisse. |
| Couchbase-Administrator |
Überprüfen Sie die Ergebnisse der Volltextsuche (gilt, wenn Sie Indizes migriert FTS haben). |
| Couchbase-Administrator |
Zugehörige Ressourcen
Bereiten Sie die Migration vor
Migrieren Sie die Daten und Indizes
Couchbase Capella und Support SLAs
Couchbase
Capella-Serviceverträge () SLAs
Zusätzliche Informationen
Der folgende Code ist eine Beispielkonfigurationsdatei für
Version = 1
[[clusters]]
identifier = "On-Prem-Cluster"
hostnames = ["<SELF_MANAGED_COUCHBASE_CLUSTER>"]
default-bucket = "travel-sample"
username = "<SELF_MANAGED_ADMIN>"
password = "<SELF_MANAGED_ADMIN_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_SELF_MANAGED_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
[[clusters]]
identifier = "Capella-Cluster"
hostnames = ["<COUCHBASE_CAPELLA_ENDPOINT>"]
default-bucket = "travel-sample"
username = "<CAPELLA_DATABASE_USER>"
password = "<CAPELLA_DATABASE_USER_PWD>"
tls-cert-path = "/<ABSOLUTE_PATH_TO_COUCHBASE_CAPELLA_ROOT_CERT>"
data-timeout = "2500ms"
connect-timeout = "7500ms"
query-timeout = "75s"
Bevor Sie die Konfigurationsdatei speichern, stellen Sie anhand der folgenden Tabelle sicher, dass Sie Ihre eigenen Quell- und Zielclusterinformationen hinzugefügt haben.
<SELF_MANAGED_COUCHBASE_CLUSTER> | Verwenden Sie die IP-Adresse für Ihren selbstverwalteten Couchbase Server-Cluster. |
<SELF_MANAGED_ADMIN> | Verwenden Sie den Administratorbenutzer für Ihren selbstverwalteten Couchbase Server-Cluster. |
< ABSOLUTE _ PATH SELF _ZU_ _ _ _ > MANAGED ROOT CERT | Verwenden Sie den absoluten Pfad zur gespeicherten Stammzertifikatsdatei für Ihren selbstverwalteten Couchbase Server-Cluster. |
<COUCHBASE_CAPELLA_ENDPOINT> | Verwenden Sie den Verbindungsendpunkt für Ihren Couchbase Capella-Cluster. |
<CAPELLA_DATABASE_USER> | Verwenden Sie den Datenbankbenutzer für Ihren Couchbase Capella-Cluster. |
<CAPELLA_DATABASE_USER_PWD> | Verwenden Sie das Datenbankbenutzerpasswort für Ihren Couchbase Capella-Cluster. |
< ABSOLUTE _ PATH COUCHBASE _ZU_ _ _ _ > CAPELLA ROOT CERT | Verwenden Sie den absoluten Pfad zur gespeicherten Root-Zertifikatsdatei für Ihren Couchbase Capella-Cluster. |