In diesem Thema werden die minimalen Clusterkonfigurationen für Apigee Hybrid beschrieben. Diese Mindestkonfigurationen gelten für alle unterstützten Kubernetes-Plattformen. Die Empfehlungen in diesem Thema gelten für Nicht-Produktionsinstallationen wie Test- oder Testszenarien. Beachten Sie diese Empfehlungen, wenn Sie die Schritte der Apigee-Hybridinstallation ausführen.
Knotenpools
Ein Knotenpool besteht aus einer Gruppe von Knoten in einem Cluster, die alle dieselbe Konfiguration haben. Standardmäßig weist Hybrid allen Pods den Standardknotenpool zu. Sie können jedoch dedizierte Knotenpools erstellen und ihnen Hybridkomponenten zuweisen, um so Ressourcen zu verteilen.
Normalerweise definieren Sie separate Knotenpools, wenn Sie Pods mit unterschiedlichen Ressourcenanforderungen haben. Die apigee-cassandra-Pods erfordern beispielsweise nichtflüchtigen Speicher, die anderen Apigee Hybrid-Pods jedoch nicht. Daher empfehlen wir Ihnen, einen zustandsorientierten Knotenpool für Cassandra und einen zustandslosen Knotenpool für die übrigen Hybridlaufzeitdienste zu erstellen. Weitere Informationen finden Sie unter Dedizierte Knotenpools konfigurieren.
Im folgenden Abschnitt werden Konfigurationen für zustandsorientierte und zustandslose Knotenpools aufgelistet.
Mindestkonfigurationen
Verwenden Sie bei der Einrichtung Ihres Clusters folgende Mindestkonfigurationen:
Konfiguration
Zustandsorientierter Knotenpool
Zustandsloser Knotenpool
Zweck
Ein zustandsorientierter Knotenpool, der für die Cassandra-Datenbank verwendet wird.
Ein zustandsloser Knotenpool, der vom Laufzeitnachrichtenverarbeiter verwendet wird.
2.000 IOPS mit SAN oder direkt angehängtem Speicher. NFS wird nicht empfohlen, selbst wenn es die erforderlichen IOPS unterstützen kann.
2.000 IOPS mit SAN oder direkt angehängtem Speicher. NFS wird nicht empfohlen, selbst wenn es die erforderlichen IOPS unterstützen kann.
Netzwerkbandbreite für jeden Maschineninstanztyp
1 Gbit/s
1 Gbit/s
Cassandra-Netzwerkanforderungen
In diesem Abschnitt werden die Netzwerkanforderungen und -empfehlungen beim Einrichten von Apigee Hybrid erläutert.
Netzwerkbandbreite
Cassandra verwendet das Gossip-Protokoll für den Austausch von Informationen mit anderen Knoten zur Netzwerktopologie. Die Verwendung von Gossip sowie die verteilte Natur von Cassandra, das mit mehreren Knoten für Lese- und Schreibvorgänge kommuniziert, führen zu einer großen Datenübertragung über das Netzwerk.
Cassandra benötigt mindestens 1 Gbit/s Netzwerkbandbreite für jede Maschineninstanz. In GKE hat beispielsweise der empfohlene Mindestmaschinentyp e2-standard-4 eine Mindestbandbreite von 1 Gbit/s. Für Produktionsinstallationen wird ein höherer Gbit/s empfohlen.
Die maximale Latenz bzw. die Latenz des 99. Perzentils für Cassandra sollte unter 100 Millisekunden liegen.
Sichere Netzwerkverbindung zwischen Regionen
Sorgen Sie bei der Installation von Hybrid in mehreren Regionen dafür, dass die Verbindungen zwischen Regionen sicher sind:
Verwenden Sie eine Virtual Private Network-Lösung, z. B. Google Virtual Private Cloud (VPC), um die Verbindung zwischen Regionen zu sichern.
Öffnen Sie eine Firewall, damit Cassandra-Knoten eine Verbindung zwischen Regionen in nicht überlappenden Subnetzen herstellen können und diese Netzwerk-IP-Adressen auflösen können.
Verwenden Sie immer Port 7001 für Cassandra.
Alle anderen Ports sind lokal in der Region.
Siehe auch Sichere Portnutzung.
Cassandra NTP-Anforderungen
Cassandra-Daten werden basierend auf dem Zeitstempel des Systems synchronisiert. Prüfen Sie, ob die Zeit über alle Pods und Regionen innerhalb des Cassandra-Clusters synchronisiert wird. Zeitverzögerungen zwischen den Knoten und Regionen führen zu Dateninkonsistenzen.
Konfiguration skalieren
Wenn Sie Ihre anfängliche Konfiguration basierend auf zusätzlichen Kapazitäten oder Durchsatzanforderungen skalieren müssen, finden Sie unter folgenden Themen weitere Informationen:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-21 (UTC)."],[[["\u003cp\u003eApigee hybrid requires minimum cluster configurations for both stateful (Cassandra) and stateless node pools, with specific recommendations for non-production environments like trials or testing.\u003c/p\u003e\n"],["\u003cp\u003eStateful node pools, dedicated to the Cassandra database, require a minimum of 1 node per zone (3 per region), 4 CPUs, 16 RAM, and dynamic storage with 2000 minimum disk IOPS for non-production, and the storage needs to be either directly attached or with SAN.\u003c/p\u003e\n"],["\u003cp\u003eStateless node pools, used by the runtime message processor, also need a minimum of 1 node per zone (3 per region), 4 CPUs, 16 RAM, and storage managed by ApigeeDeployment CRD, as well as requiring 2000 minimum disk IOPS for non-production and the storage needs to be either directly attached or with SAN.\u003c/p\u003e\n"],["\u003cp\u003eCassandra nodes need a minimum network bandwidth of 1 Gbps per machine instance and low latency (below 100 milliseconds), and when used in multiple regions, connections between regions should be secured via a VPN solution.\u003c/p\u003e\n"],["\u003cp\u003eFor time consistency and data synchronization, it is important that time is synchronized across all pods and regions in a Cassandra cluster, as well as consider using TCP keepalive settings to prevent firewalls from dropping connections.\u003c/p\u003e\n"]]],[],null,["# Minimum cluster configurations\n\n| You are currently viewing version 1.12 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis topic describes minimum cluster configurations for\nApigee hybrid. These minimum configurations apply to all of the supported\n[Kubernetes platforms](/apigee/docs/hybrid/supported-platforms). The recommendations\nin this topic apply for non-production installations, such as trial or testing scenarios. Keep\nthese recommendations in mind when performing the Apigee hybrid installation steps.\n\nAbout node pools\n----------------\n\n\nA node pool is a group of nodes within a cluster that all have the same configuration. By\ndefault, hybrid assigns all pods to the default node pool; however, you can create dedicated\nnode pools and assign hybrid components to them as a way of distributing resources.\n\n\nTypically, you define dedicated node pools when you have pods with differing resource\nrequirements. For example, the `apigee-cassandra` pods require persistent storage, while\nthe other Apigee hybrid pods do not. For this reason, we recommend that you create\na stateful node pool for Cassandra and a stateless node pool for the rest of the hybrid\nruntime services. See [Configure dedicated node pools](/apigee/docs/hybrid/v1.12/configure-dedicated-nodes) for\ndetails.\n\n\nThe following section lists configurations for both stateful and stateless node pools.\n\nMinimum configurations\n----------------------\n\n\nUse these minimum configurations when setting up your cluster:\n\n| **Note:** For **production** environments, we recommend a minimum of two clusters.\n\nCassandra network requirements\n------------------------------\n\nThis section discusses network requirements and recommendations to follow when setting up\nApigee hybrid.\n\n### Network bandwidth\n\n\nCassandra uses the\n[Gossip protocol](https://en.wikipedia.org/wiki/Gossip_protocol) to\nexchange information with other nodes about network topology. The use of Gossip plus the\ndistributed nature of Cassandra---which involves talking to multiple\nnodes for read and write operations---results in a lot of data transfer through the network.\n\nCassandra requires a minimum of 1 Gbps of network bandwidth for each machine instance. For example,\non GKE, the minimum recommended machine type, `e2-standard-4`, has a minimum bandwidth\nof 1 Gbps. For production installations, a higher Gbps is recommended.\n\nThe maximum or 99th percentile latency for Cassandra should be below 100 milliseconds.\n\n### Secure network connectivity between regions\n\nWhen installing hybrid in [multiple regions](/apigee/docs/hybrid/v1.12/multi-region), ensure that the connections between\nregions is secure:\n\n- Use a virtual private network solution, such as Google [Virtual Private Cloud](/vpc/docs/overview) (VPC), to secure connectivity between regions.\n- Open a firewall to ensure that Cassandra nodes can connect between regions in non-overlapping subnets and can resolve those network IPs.\n- Always use port 7001 for Cassandra. All other ports are local to the region. See also [Secure ports usage](/apigee/docs/hybrid/v1.12/ports).\n\nCassandra NTP requirements\n--------------------------\n\n\nCassandra data synchronizes based on the timestamp of the system. Ensure that the time is\nsynchronized across all pods and all regions within the Cassandra cluster. Time delays\nbetween the nodes and regions causes data inconsistencies.\n| **Tip:** If firewalls is used, try setting up the TCP keepalive settings for the stateful nodes similar to the following: \n|\n| ```\n| net.ipv4.tcp_keepalive_time=60\n| net.ipv4.tcp_keepalive_probes=3\n| net.ipv4.tcp_keepalive_intvl=10\n| \n| ```\n| This could help prevent a firewall from considering the connections idle and dropping them.\n\nScaling the configuration\n-------------------------\n\n\nIf you need to scale your initial configuration based on additional capacity or throughput needs,\nsee the following topics:\n\n- [Configuring Cassandra for production](/apigee/docs/hybrid/v1.12/cassandra-production)\n- [Scaling Cassandra pods](/apigee/docs/hybrid/v1.12/cassandra-scaling)\n- [Configuring dedicated node pools](/apigee/docs/hybrid/v1.12/configure-dedicated-nodes)\n- [Scale and autoscale runtime services](/apigee/docs/hybrid/v1.12/scale-and-autoscale)\n- [Multi-region deployments](/apigee/docs/hybrid/v1.12/multi-region)"]]
